OfficialJev Repos & SDKs
Python SDK Common Types
Shared Python SDK types: JSONValue, a nested JSON-like value that may be None, and descriptions built from strings or JSON values.
- Format
- Docs
- Published by
- TypeSafe AI
- Last verified
- Oct 2026
Works forJev for Classification
Used inJev for Software & DevTools
- Languages
- Python
Highlights
- JSONValue is a JSON-like value. It may be nested and may contain None.
- A description is either a plain string or a mapping or sequence of JSONValue entries.
Watch out
A short type page. Question and response shapes are on the neighboring SDK pages.
Questions about this entry
Short answers drawn from the linked project or page.
A JSON-like value that may be nested and may contain None. A description is either a plain string or a mapping or sequence of JSONValue entries.
On the neighboring pages: questions and responses each have their own reference page, and this one stays a short type reference.
It is either a plain string or a mapping or sequence of JSONValue entries. That lets state and question descriptions be simple text or structured JSON without a separate type.
Yes. The JSON schema is recursive: array items and object values are themselves JSONValue, covering strings, integers, numbers, booleans, arrays, and objects, any of which may be null.
They are module attributes, not Pydantic models: aliases for JSON-like values rather than instantiable classes. The concrete question and answer models live on the other Types pages.
In the state passed to system_one and in the descriptions attached to Noul, Choice, and Score criteria, all of which accept JSONContent: a bare string or a structured object or array.
Yes. State itself cannot be None, but because JSONValue allows null, values inside a state object may be None even though the state value you pass may not.
More Jev resources like this
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
RetryPolicy for the Python SDK: attempt count, exponential backoff with jitter, which HTTP statuses retry, and a total time budget.
Jev Repos & SDKsDocs#official#docs#sdk
Official
The Python SDK error hierarchy: HTTP status classes, rate-limit wait hints, connection and timeout errors, and response-body validation failures.
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
Default settings and environment variable names for the Python SDK, including the API root, model alias, and per-request timeout.
Jev Repos & SDKsDocs#official#docs#sdk
Official
TypeSafeClient, the synchronous Python client: ask questions, list models, and set the key, model, retry policy, and HTTP timeout.
Jev Repos & SDKsDocs#official#docs#sdk
Official
From the Jev guides
Original write-ups on what this entry is for.
Closed weights have not stopped the ecosystem from rebuilding the shape in the open. API-compatible servers, retrained heads on small models, and inference-time tricks that skip generation entirely.
Jev Repos & SDKs#open-models#research#local
Read article
From the Jev community
Posts from builders shipping with Jev right now.