TypeSafe AI Python SDK

Python SDK for TypeSafe AI.

Quickstart

Install the SDK:

uv add aphrody-typesafe-sdk

Add the http2 extra (aphrody-typesafe-sdk[http2]) to enable HTTP/2 support.

Set TYPESAFE_API_KEY in your environment, then instantiate and use the client:

from typesafe_sdk import Choice, TypeSafeClient

with TypeSafeClient() as client:
    response = client.system_one(
        state={"document": "I was charged twice. Please fix this ASAP."},
        questions={
            "category": Choice(
                instructions="What is this ticket about?",
                criteria={"billing": None, "technical": None, "other": None},
            ),
        },
    )

print(response.choices["category"].choice)

learn what TypeSafe is, what it can do, and how to use it in TypeSafe docs.

Documentation

Learn more in SDK docs.