This release is a pre-release and may not be stable for production use.
Synth SDK 0.23 development branch
Local SDK-first Index implementation. The pinned 0.23 development wheel is an engineering qualification candidate and must not be published as a release.
The new client targets the closed index.v1 contract on /api/v1; it refuses
legacy responses and does not fall back. Backend adoption and native/cached/live
acceptance are pending. This worktree also implements the first Swarms core,
output/file delivery and unified MCP adapter. The initial caller model override
accepts gpt-6-luna, with openai as the supported provider override.
Omitted overrides preserve backend project defaults; resolved metadata is not
an override allowlist. Hosted MCP requires the backend authorization/service
adapter; its native OAuth/API-key journeys remain unqualified.
from synth_ai import SynthClient
from synth_ai.sdk.index import PublicSearchOptions
with SynthClient.anonymous() as client:
result = client.index.search("reproducible retrieval evidence", options=PublicSearchOptions())
print(result.response)
This requires an index.v1 backend. Keyed calls require KeyedSearchOptions with an exact Money charge ceiling. Durable search and mutation recovery are keyed. Use typed content refs for current-rights retrieval; citations grant no access. Synchronous clients own a cancellable HTTP pool; synchronous client injection is not supported. Async clients use native async HTTP and may borrow an AsyncClient. Local observer timeouts and close never cancel durable remote work.
For explicit HTTPX use, synth_ai.transports.DeadlineHTTPTransport supplies the
same owned, cancellable network implementation. Set a finite HTTPX read timeout;
it bounds the whole exchange, including headers and body. Close the HTTPX client
to release its pool and join its network thread. Arbitrary non-cooperative
synchronous transports cannot be preempted; synchronous client injection into
SynthClient is deliberately unsupported. Observer total, idle, reconnect and
event-count bounds remain independent of explicit remote cancellation.
The retired source remains on legacy/sdk-pre-0230-20261013; no broad compatibility
aliases, old CLI or split MCP are shipped.
- Implementation and contract choices
- Backend delta map
- Testing expectations
- Unified MCP implementation and auth integration
Tests live in the dedicated testing repository and install the selected wheel in an owned isolated environment. SDK unit/contract passes are not backend or end-to-end qualification. No backend services/data/deployment are changed here.
Per-request capacity is available through a caller-owned
synth_ai.types.rate_limits.ResponseMetadata passed as
MutationOptions(response_metadata=capacity) or ReadOptions(response_metadata=capacity).
Use one instance per concurrent request. Typed errors and MCP error payloads also
retain bounded rate-limit values. These fields never change the result body.
1 maintainer
Metadata
1 maintainer
Release files for synth-ai 0.23.0.dev2026101502
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| synth_ai-0.23.0.dev2026101502.tar.gz | 122.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| synth_ai-0.23.0.dev2026101502-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 285.3 kB
Release files / synth_ai-0.23.0.dev2026101502.tar.gz
| Download URL | synth_ai-0.23.0.dev2026101502.tar.gz |
|---|---|
| Size | 122.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
145426669e5550fa8b11b403e8b1dd0593a463489aec753f52890e21f8d61b85
|
|
BLAKE2b-256 checksum How to use checksums |
b136883d7b4f4bc344aa0c9fbf25dccacc40751d8900d298698edb4189e41daf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency logRelease files / synth_ai-0.23.0.dev2026101502-py3-none-any.whl
| Download URL | synth_ai-0.23.0.dev2026101502-py3-none-any.whl |
|---|---|
| Size | 162.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8ad30cc36b0b6e636600095d7ef4a17d12c672c26a943e01d12bad7e52e1ecbb
|
|
BLAKE2b-256 checksum How to use checksums |
6f5716e30b11b5afde38423cec3841a90d838e2aba2632fa66d13007912ac4d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 15, 2026.
Transparency log
