dna-client (Python)
The official Python client for the DNA REST API (dna api serve).
Spec-parity twin of the TypeScript dna-client:
both cover the same surface, derived from the same OpenAPI document
(docs/openapi.json, dumped from the FastAPI app) — so consumers stop
hand-rolling HTTP.
- Typed inputs,
httpx-based, sync, context-manageable. - Complete — a named method for EVERY operation in the spec, reads and
writes alike.
client.request(...)remains as a low-level escape hatch, but no route depends on it. - Guarded — a drift test re-dumps the live schema and fails CI if the committed spec is stale, and fails if any operation (of any HTTP method) has no named method. Adding a write route cannot pass silently.
Install
pip install dna-client # or: uv add dna-client
Only runtime dep is httpx. Python >= 3.12.
Usage
from dna_client import DnaClient
with DnaClient(
"http://127.0.0.1:8080",
token="…", # optional — for --auth token/config
scope="dna-development", # optional default applied to every call
) as dna:
agents = dna.list_agents()
prompt = dna.agent_prompt("jarvis")
hits = dna.search_memories("tenancy invariant", k=3)
board = dna.get_board("dna-development", recent=6)
# Writes are named methods too — no escape hatch needed.
dna.remember_memory("a lesson worth keeping", area="ops")
dna.delete_memory("s-foo")
dna.set_insight_state("i-42", "actioned")
# Workspace routes are identity-scoped: the boundary comes from the caller's
# verified claims, so they never take the client's default scope/tenant.
ws = dna.create_workspace("Acme") # id is minted server-side
dna.create_invite(ws["workspace_id"], "teammate@acme.com", role="member")
Routes with security semantics say so in their docstring — e.g.
create_project() is 403 without an active workspace membership, and
revoke_workspace_member() is 409 on the last remaining owner.
A non-2xx response raises DnaApiError (carrying .status and the API's
{"detail": ...} payload).
Note on return types
Every DNA REST handler returns an untyped JSON object (dict[str, Any]), so the
OpenAPI response schemas are opaque. Request inputs (query/path params) are
typed; response bodies are dict[str, Any]. Tighten the API's response models to
tighten these.
Parity
This client and the TypeScript twin are generated from the SAME
docs/openapi.json — spec-parity, not byte-parity. See
Using the DNA client.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file dna_client-0.52.0.tar.gz.
File metadata
- Download URL: dna_client-0.52.0.tar.gz
- Upload date:
- Size: 40.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
654cc2df21e062999c039fcc25f43890bba86d302f24cf95a018635b967ef29c
|
|
| MD5 |
606f6f913dcaf93927dc67137eb35151
|
|
| BLAKE2b-256 |
978a18f4be13d60deaf4f5dd7a10fd46daa5e981f769a2a56c221edcd1afca5c
|
Provenance
The following attestation bundles were made for dna_client-0.52.0.tar.gz:
Publisher:
release-client.yml on ruinosus/dna
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dna_client-0.52.0.tar.gz -
Subject digest:
654cc2df21e062999c039fcc25f43890bba86d302f24cf95a018635b967ef29c - Sigstore transparency entry: 2336175895
- Sigstore integration time:
-
Permalink:
ruinosus/dna@f272ecde2fb2424052b6f13c0253080b2ef7c5b8 -
Branch / Tag:
refs/tags/v0.52.0 - Owner: https://github.com/ruinosus
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-client.yml@f272ecde2fb2424052b6f13c0253080b2ef7c5b8 -
Trigger Event:
push
-
Statement type:
File details
Details for the file dna_client-0.52.0-py3-none-any.whl.
File metadata
- Download URL: dna_client-0.52.0-py3-none-any.whl
- Upload date:
- Size: 17.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
238d2b100c85cf4e6ce93e2bd48babc737b90437ad664ae1ed89f05259fc8130
|
|
| MD5 |
5d61dae2e77b477abff723649136a610
|
|
| BLAKE2b-256 |
674ae498581d0bf38de804e761a0977b8714d4ca397da66fedc9c94970931ed7
|
Provenance
The following attestation bundles were made for dna_client-0.52.0-py3-none-any.whl:
Publisher:
release-client.yml on ruinosus/dna
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dna_client-0.52.0-py3-none-any.whl -
Subject digest:
238d2b100c85cf4e6ce93e2bd48babc737b90437ad664ae1ed89f05259fc8130 - Sigstore transparency entry: 2336175937
- Sigstore integration time:
-
Permalink:
ruinosus/dna@f272ecde2fb2424052b6f13c0253080b2ef7c5b8 -
Branch / Tag:
refs/tags/v0.52.0 - Owner: https://github.com/ruinosus
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-client.yml@f272ecde2fb2424052b6f13c0253080b2ef7c5b8 -
Trigger Event:
push
-
Statement type:
