Official Python SDK for building and deploying agents on the Circuit platform
Project description
Circuit Agent SDK - Python
Official Python SDK for building and deploying agents on the Circuit platform.
See the full documentation at docs.circuit.org.
Internal Environment Variables
These variables are supported for internal development and deployed runtime wiring. They are intentionally not documented on the public docs site.
| Variable | Purpose | Default |
|---|---|---|
CIRCUIT_AGENT_API_URL |
Override the Agent API URL for non-deployed SDK requests. Required alongside CIRCUIT_API_URL when targeting staging with circuit run (e.g. https://agents.staging.circuit.org). |
https://agents.circuit.org |
CIRCUIT_AUTH_FILE |
Override the auth filename used for local filesystem auth lookup | unset |
CIRCUIT_DEV_API_KEY |
Add an X-API-Key header for local development |
unset |
CIRCUIT_DEPLOYED |
Auto-set for deployed agents to force internal VPC routing | unset |
CIRCUIT_AGENT_SLUG |
Auto-set for deployed agents and sent as X-Agent-Slug |
unset |
Base URL resolution order:
config.base_urlCIRCUIT_DEPLOYED=trueor Lambda runtime detection, which routes tohttp://transaction-service.agent.internalCIRCUIT_AGENT_API_URLhttps://agents.circuit.org
Filesystem auth filename resolution order:
CIRCUIT_AUTH_FILEauth-local.jsonwhenCIRCUIT_AGENT_API_URLorCIRCUIT_API_URLcontainslocalhostor127.0.0.1auth-production.json
The SDK checks ~/.config/circuit/<filename> first, then ~/.circuit/<filename>.
Release history Release notifications | RSS feed
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 circuit_agent_sdk-2.3.0.tar.gz.
File metadata
- Download URL: circuit_agent_sdk-2.3.0.tar.gz
- Upload date:
- Size: 198.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
41dc8d4f9c9b495f40c1ce62a7c6e347e8b8797eb8cf33438cbfb2ccaec3a47a
|
|
| MD5 |
834b0a64f95a6604440785417e393a87
|
|
| BLAKE2b-256 |
9f1d681d191bcd2026296af5f66b7185e083c08ee3916794d0cf107c7c94cb0f
|
File details
Details for the file circuit_agent_sdk-2.3.0-py3-none-any.whl.
File metadata
- Download URL: circuit_agent_sdk-2.3.0-py3-none-any.whl
- Upload date:
- Size: 69.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
211c134649a9bb465ebe7c354796a1d74fcb655eb0e17f35abaa19733a351fda
|
|
| MD5 |
7a0c2461342f9962a03cb038b9e0ad14
|
|
| BLAKE2b-256 |
2c60eb383bb83b78b99530dc8776560f0371661e34d0713f61cb9cb15501d0f2
|
