Python SDK

pip install classer

import classer

# Uses CLASSER_API_KEY environment variable
result = classer.classify(
    text="I can't log in",
    labels=["billing", "technical", "sales"]
)

print(result.label)      # "technical"
print(result.confidence) # 0.94

export CLASSER_API_KEY=your-api-key

from classer import ClasserClient

client = ClasserClient(
    api_key="your-api-key",
    base_url="https://api.classer.ai",  # optional
    timeout=30.0  # optional, in seconds
)

result = client.classify(
    text="I can't log in to my account",
    labels=["billing", "technical", "sales"],
    descriptions={                          # optional
        "billing": "Payment or invoice issues",
        "technical": "Login, bugs, errors",
        "sales": "Pricing or plan questions",
    },
    model="qwen",                           # optional (default: "qwen")
)

result.label        # "technical"
result.confidence   # 0.94
result.tokens       # 142
result.latency_ms   # 87.0
result.cached       # False

result = client.classify(
    text="I can't log in",
    classifier="support-tickets",       # or "support-tickets@v2"
)

result = client.tag(
    text="Breaking: Tech stocks surge amid AI boom",
    labels=["politics", "technology", "finance", "sports"],
    threshold=0.3,                          # optional (default: 0.3)
    descriptions={"technology": "Tech industry news"},  # optional
    model="qwen",                           # optional
)

for t in result.labels:
    print(f"{t.label}: {t.confidence}")
# technology: 0.92
# finance: 0.78

result.tokens       # 200
result.latency_ms   # 203.0
result.cached       # False

import classer

result = classer.classify(text="...", labels=["a", "b"])
result = classer.tag(text="...", labels=["a", "b"], threshold=0.5)

from classer import ClasserClient, ClasserError

client = ClasserClient(api_key="your-key")

try:
    result = client.classify(
        text="Hello",
        labels=["greeting", "question"]
    )
except ClasserError as e:
    print(f"Error: {e.message}")
    print(f"Status: {e.status}")    # HTTP status code (e.g. 400, 401, 422, 429)
    print(f"Detail: {e.detail}")    # Error detail from the API

@dataclass
class ClassifyResponse:
    label: Optional[str] = None
    confidence: Optional[float] = None
    tokens: int = 0
    latency_ms: float = 0.0
    cached: bool = False

@dataclass
class TagResponse:
    labels: list[TagLabel]  # empty list when nothing matches
    tokens: int = 0
    latency_ms: float = 0.0
    cached: bool = False

@dataclass
class TagLabel:
    label: str
    confidence: float

class ClasserError(Exception):
    message: str
    status: Optional[int]
    detail: Optional[str]