AGNT5 Python SDK
Build reliable AI agents and durable workflows in Python. The AGNT5 SDK provides typed components, workflow checkpoints, retries, streaming, tools, human-in-the-loop coordination, evaluation, and runtime observability.
Requirements
- Python 3.11 or newer
- An AGNT5 runtime for deployed execution
Installation
pip install agnt5
Quick start
Define a function. Type hints are used to derive its input and output schema.
from agnt5 import FunctionContext, function
@function(retries=3, backoff="exponential")
async def greet(ctx: FunctionContext, name: str) -> dict[str, str]:
ctx.logger.info("greeting user", extra={"name": name})
return {"message": f"Hello, {name}!"}
Register application components with a worker for runtime-backed execution:
import asyncio
from agnt5 import Worker
async def main() -> None:
worker = Worker(service_name="hello-python")
await worker.run()
asyncio.run(main())
Decorated functions, workflows, agents, tools, and scorers are registered when
their modules are imported. See examples/app.py for a
complete application entrypoint.
Invoke a deployed component
from agnt5 import Client
client = Client(
gateway_url="https://gw.agnt5.com",
api_key="agnt5_sk_...",
deployment_id="deployment-id",
)
result = client.run("greet", {"name": "Ada"})
print(result)
Client also supports asynchronous submission, status and result polling,
streaming events, batches, cancellation, workflow resume, chat, and evaluation.
Configuration can be supplied explicitly or through AGNT5_GATEWAY_URL,
AGNT5_API_KEY, and AGNT5_DEPLOYMENT_ID.
Core APIs
| API | Purpose |
|---|---|
@function |
Typed, retryable units of work |
@workflow |
Durable multi-step orchestration and checkpointing |
Agent and @agent |
Model and tool orchestration |
@tool |
Typed tools with generated schemas |
ctx.state |
Durable workflow and component state |
ctx.memory |
Conversation and application memory |
Client / AsyncClient |
Invoke and observe deployed components |
Worker |
Register components and serve runtime dispatch |
The shared Rust runtime foundation lives in
agnt5dev/sdk-core. Vendor sandbox
adapters live in
agnt5dev/sdk-integrations.
Examples and documentation
examples/contains functions, workflows, agents, tools, streaming, HITL, MCP, chat, and evaluation examples.docs/contains SDK-specific guides.- AGNT5 documentation covers platform concepts and deployment.
Development
uv sync --all-groups
uv run ruff check src tests
uv run pytest tests/unit -q
uv build --sdist
Development builds use a sibling checkout of
sdk-core.
Contributing
See CONTRIBUTING.md. Report security issues according to SECURITY.md.
License
Licensed under the Apache License 2.0.
1 maintainer
Release files for agnt5 0.11.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agnt5-0.11.0.tar.gz | 877.1 kB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agnt5-0.11.0-cp310-abi3-manylinux_2_28_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| agnt5-0.11.0-cp310-abi3-manylinux_2_28_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| agnt5-0.11.0-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
Total release size: 54.2 MB
Release files / agnt5-0.11.0.tar.gz
| Download URL | agnt5-0.11.0.tar.gz |
|---|---|
| Size | 877.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c17570f0f02811e97e1d715f2750c0e19e5b93494c9a6de2dc7c3a8583b3a093
|
|
BLAKE2b-256 checksum How to use checksums |
527f34451c1a13e11c350ecd3e71efb258b8a2a7adc59b8eb00c0160a18bd36e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / agnt5-0.11.0-cp310-abi3-manylinux_2_28_x86_64.whl
| Download URL | agnt5-0.11.0-cp310-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 18.0 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
602f9d7b60472feecaea653ace6be5c210a4da01a1a41c3749aeedf28a7adaf4
|
|
BLAKE2b-256 checksum How to use checksums |
a6d1c3fb1650dc49573a68ad834995af33c8800e02c60d3541d957c2370f9f67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / agnt5-0.11.0-cp310-abi3-manylinux_2_28_aarch64.whl
| Download URL | agnt5-0.11.0-cp310-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 19.0 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
28b0dc1e6bbd2a0df2a565b69a647e817cd8c490a7492a6e4307ead19aaed45f
|
|
BLAKE2b-256 checksum How to use checksums |
ef7f759017239d2680928a153df2a7c64321cdc96a0277c85a63dbda04b976e8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / agnt5-0.11.0-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | agnt5-0.11.0-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 16.3 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a010e34d372ed5334bf2453cd704b1fab8d5f4f125e79172c5d96c9955b079f5
|
|
BLAKE2b-256 checksum How to use checksums |
d350a03cb186277c56c6e3389657c9ab277b9dd6064fd0fe0bbd921cbd082765
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
