TypeSafe Python SDK

​

Quickstart

1. Install the SDK:
   • uv
   • pip

   uv add typesafe-sdk
   

   pip install typesafe-sdk
   
   Extras (for example, typesafe-sdk[http2]) supported:
   • http2: enable HTTP/2 support
   • pil: send Pillow images
   • zstd: compress request bodies on Python 3.13 and earlier
2. Set TYPESAFE_API_KEY in your environment (create it here)
3. Call the System One API:
   • Async
   • Sync

   With AsyncTypeSafeClient:

   from typesafe_sdk import AsyncTypeSafeClient, Choice, Noul, Score
   
   
   async def main() -> None:
       async with AsyncTypeSafeClient() as client:
           response = await client.system_one(
               state={"document": "I was charged twice. Please fix this ASAP."},
               questions={
                   "billing": Noul(instructions="Is this ticket about billing?"),
                   "tone": Choice(
                       instructions="What is the customer's tone?",
                       criteria={"calm": None, "frustrated": None, "angry": None},
                   ),
                   "urgency": Score(
                       instructions="How urgent is this ticket?",
                       criteria=["can wait", "this week", "today"],
                   ),
               },
           )
   
       print(response.nouls["billing"].noul)
       print(response.choices["tone"].choice)
       print(response.scores["urgency"].score)
   

   With TypeSafeClient:

   from typesafe_sdk import Choice, Noul, Score, TypeSafeClient
   
   with TypeSafeClient() as client:
       response = client.system_one(
           state={"document": "I was charged twice. Please fix this ASAP."},
           questions={
               "billing": Noul(instructions="Is this ticket about billing?"),
               "tone": Choice(
                   instructions="What is the customer's tone?",
                   criteria={"calm": None, "frustrated": None, "angry": None},
               ),
               "urgency": Score(
                   instructions="How urgent is this ticket?",
                   criteria=["can wait", "this week", "today"],
               ),
           },
       )
   
   print(response.nouls["billing"].noul)
   print(response.choices["tone"].choice)
   print(response.scores["urgency"].score)
   

​

What’s next

• Choose a System One model
• Send media inputs
• Use typed responses
• Configure retry policy
• Optimize performance