Unsure Python client

You can't optimize what you don't measure. Unsure runs structured classifications on Jev in a few hundred milliseconds, records confidence per field, queues uncertain answers for review, and replays new prompts against those corrections before they ship.

pip install unsure_client

from typing import Literal

from pydantic import BaseModel
from unsure_client import Unsure


class Triage(BaseModel):
    urgent: bool
    team: Literal["billing", "support", "sales"]


client = Unsure(api_key="YOUR_UNSURE_KEY")
decision = client.decide(
    prompt="I paid the invoice, but my account is still locked.",
    schema=Triage,
)
print(decision.output)

# Correct a field using its name as the keyword.
client.feedback(decision_id=decision.id, team="support")

# Replay an improved prompt against reviewed decisions in the same group.
group = client.group(decision.group_id)["group"]
run = client.prototype(
    decision.group_id,
    template=group["template"] + "\nPaid but locked out? Route to support.",
)
print(client.prototype_run(run["id"]))

No context manager is required. Reuse the client across calls and call client.close() when finished to release its connections. with Unsure(...) is also supported for automatic cleanup.

The default base URL is https://app.unsure.dev. For a local or self-hosted instance, pass base_url="http://localhost:5080".

Noul and Score describe additional Jev output types:

from typing import Annotated
from unsure_client import Noul, Score


class Review(BaseModel):
    needs_human: Noul
    severity: Annotated[float, Score("Low", "Medium", "High")]

For a saved pipeline, call client.run(pipeline="PIPELINE_ID", input={...}). Read the result from result["output"]; its decision_ids can be reviewed with client.feedback(...).

Requests raise httpx.HTTPStatusError for API errors, including HTTP 402 when credits are required. decision_id and note are reserved feedback metadata; pass nested corrections with **{"routing.team": "support"}. Each call corrects one field.

Python 3.12 or newer is required. See the API reference.