moss-classify

Python SDK for the Moss question classifier and normalizer service.

Installation

pip install moss-classify

Quick Start

import asyncio
from moss_classify_rest import MossClassifyClient

async def main():
    client = MossClassifyClient(
        project_id="your-project-id",
        project_key="your-project-key",
    )

    # Classify an utterance
    result = await client.classify("What is your pricing?")
    print(result.label)       # "question"
    print(result.confidence)  # 0.92
    print(result.is_question) # True

    # Classify + normalize with conversation context
    result = await client.classify(
        "you use aws right?",
        context=["Agent: We provide cloud infrastructure.", "Customer: yeah so like"],
    )
    print(result.normalized_question)  # "Do you use AWS?"

    await client.close()

asyncio.run(main())

Context Manager

async with MossClassifyClient(project_id="...", project_key="...") as client:
    result = await client.classify("What is the pricing?")

API Reference

MossClassifyClient(project_id, project_key, *, base_url, timeout)

await client.classify(text, *, context) -> ClassifyResult

ClassifyResult

Authentication

The client authenticates lazily on the first classify() call — it exchanges your project_id and project_key for a short-lived JWT token (1 hour). The token is cached and refreshed automatically before it expires. You can also call await client.init() to pre-authenticate.