Docs
OfficialJev Repos & SDKs
Python SDK Guide
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.
- Format
- Docs
- Reading time
- 1 min
- Published by
- TypeSafe AI
- Last verified
- Sep 2026
Works forJev for Scoring
Used inJev for Software & DevTools
Highlights
- Install with uv add typesafe-sdk or pip install typesafe-sdk.
- AsyncTypeSafeClient covers async code; TypeSafeClient is synchronous.
- The quickstart asks three questions in one request and reads response.nouls, response.choices, and response.scores.
Quickstart
python
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"],
),
},Questions about this entry
Short answers drawn from the linked project or page.
Yes. AsyncTypeSafeClient covers async code while TypeSafeClient is synchronous, and both use the same question helpers. Install with uv add typesafe-sdk or pip install typesafe-sdk.
Grouped by type. The quickstart asks Noul, Choice, and Score questions in one request and reads response.nouls, response.choices, and response.scores respectively.
Add the http2 extra when installing, as in pip install typesafe-sdk[http2]. The base package works without it, and the usage guide documents how to use HTTP/2.
Set TYPESAFE_API_KEY in your environment after creating one in the TypeSafe console. The quickstart reads it automatically, so no key is passed in the client code.
Only in the client and call syntax: async uses async with AsyncTypeSafeClient() and await client.system_one(...), while sync uses with TypeSafeClient() and a direct call. The questions and printed fields are identical.
To the Usage guide, for typed responses, model selection, retries, HTTP/2, and error handling. This page stays a short install-and-quickstart walkthrough.
On GitHub, linked from the guide's intro. The page itself focuses on installing the package and running a quickstart rather than on source details.
Reactions & coverage
Posts, threads, and videos about this entry from around the web.
X: Getting started: install the skill
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
Official sync and async Python client for the TypeSafe API with typed questions, retry policies, and inferred answers. `pip install typesafe-sdk`.
Jev Repos & SDKs#official#sdk#python
Release notes for the official Python SDK, from the 14 September 2026 public release through the Pydantic migration and the HTTP/2 extra.
Jev Repos & SDKsDocs#official#docs#sdk
Official
From 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.