typesafe-ai/typesafe-sdk-python
Organization repository on GitHub
The official Python library for the TypeSafe API
- Forks
- 49
- Last pushed
- Updated Oct 2026
Repo stats from the GitHub API, cached Oct 2026.Homepage
Jev directory
OfficialJev Repos & SDKs
TypeSafe Python SDK
Official sync and async Python client for the TypeSafe API with typed questions, retry policies, and inferred answers. `pip install typesafe-sdk`.
- Stars
- 298
- Language
- Python
- License
- MIT
- Reading time
- 2 min
- Published by
- TypeSafe AI
- Last verified
- Sep 2026
About this project
Add the http2 extra (typesafe-sdk[http2]) to enable HTTP/2 support. Set TYPESAFEAPIKEY in your environment, then instantiate and use the client: learn what TypeSafe is, what it can do, and how to use it in TypeSafe docs.
Quoted from the project's README. Read the full README.
Works forJev for Scoring
Used inJev for Software & DevTools
Highlights
- Install with pip install typesafe-sdk or uv add typesafe-sdk; both sync TypeSafeClient and async AsyncTypeSafeClient are provided.
- Answers split by question kind: response.nouls[...].noul, response.choices[...].choice, and response.scores[...].score.
- Questions are built as objects: Noul(instructions=...), Choice(instructions=..., criteria={...}), Score(instructions=..., criteria=[...]).
- RetryPolicy defaults: max_retries 2, backoff_initial 0.5s doubling to backoff_max 5.0s, jitter 0.25, retrying 408, 429, and 500-599.
- The client works as a context manager (with / async with), and RetryPolicy.timeout defaults to a 30-second total retry budget per call.
Quickstart
python
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)Watch out
The async client is a separate class (AsyncTypeSafeClient), and RetryPolicy.timeout caps the total retry budget at 30 seconds by default.
Questions about this entry
Short answers drawn from the linked project or page.
As response.nouls[...].noul, response.choices[...].choice, and response.scores[...].score. Both sync TypeSafeClient and async AsyncTypeSafeClient are provided, and the client works as a context manager with with or async with.
max_retries 2, 0.5s initial backoff doubling to a 5.0s maximum, jitter 0.25, retrying 408, 429, and 500-599, with RetryPolicy.timeout capping the total retry budget at 30 seconds per call by default.
Add it with uv add typesafe-sdk, or install with pip install typesafe-sdk; the quickstart notes it needs Python 3.10 or newer while the README shows the uv path.
Install the http2 extra with typesafe-sdk[http2]; the README links to the SDK usage page's HTTP/2 section for details.
TypeSafeClient works as a context manager, so a with block opens and closes it; the README's example wraps the system_one call in with TypeSafeClient() as client.
A map of option keys to None, such as {"billing": None, "technical": None, "other": None}; the option key is the text and the description is optional.
From the TYPESAFE_API_KEY environment variable; the README says to set it before instantiating and using the client.
More Jev resources like this
AsyncTypeSafeClient: async system_one calls, model listing, per-call retry and timeout overrides, and an optional Pydantic response model.
Jev Repos & SDKsDocs#official#docs#sdk
Official
How the Python SDK types questions: Noul, Choice, and Score as objects or dictionaries, including optional JSON instructions and criteria.
Jev Repos & SDKsDocs#official#docs#sdk
Official
The Python response models: SystemOneResponse groups answers by id, and records the model name, token usage, and request id.
Jev Repos & SDKsDocs#official#docs#sdk
Official
The full usage guide for the Python SDK, covering typed calls, model selection, retries, error handling, logging, environment variables, and forward compatibility.
Jev Repos & SDKsDocs#official#docs#sdk
Official
Usage guide for typesafe-sdk: sync and async clients, uv and pip installs, and one request mixing Noul, Choice, and Score questions with answers grouped by type.
Jev Repos & SDKsDocs#official#docs#sdk
Official
A local server and Python package that runs open models with Hugging Face Transformers or PyTorch and returns Choice, Score, and Noul answers read from next-token logits instead of generated JSON.
Jev Repos & SDKs#community#python#open-models
Community
featherless-ai/simple-jevPython
featherless-ai/simple-jevPythonFrom the Jev guides
Original write-ups on what this entry is for.
From the Jev AI model community
Posts from builders shipping with Jev right now.