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 |
In async workflows, use await ctx.state.set_async(key, value) and
await ctx.state.delete_async(key). These await the runtime's durable
acknowledgment while allowing other workflows to run. Reads remain local via
ctx.state.get(key). The existing synchronous set and delete methods remain
supported, but block their calling thread while waiting for persistence.
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.12.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.12.0.tar.gz | 884.4 kB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agnt5-0.12.0-cp310-abi3-manylinux_2_28_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| agnt5-0.12.0-cp310-abi3-manylinux_2_28_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| agnt5-0.12.0-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
Total release size: 54.4 MB
Release files / agnt5-0.12.0.tar.gz
| Download URL | agnt5-0.12.0.tar.gz |
|---|---|
| Size | 884.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bca093477aac6bff53a813e8e5ec09b6b09ab3930037da7d044929ab4e9d9bae
|
|
BLAKE2b-256 checksum How to use checksums |
434a25e58d7d7b2069d41b7c0df5b26f01d3f363273b4e43a522fc508e5230cb
|
| 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.12.0-cp310-abi3-manylinux_2_28_x86_64.whl
| Download URL | agnt5-0.12.0-cp310-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 18.1 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
c8f91b697c54309ef2ac5d8bdc4490e22ac1ac689b33b3d864365aac51506b3e
|
|
BLAKE2b-256 checksum How to use checksums |
ab69b3d52d264f812d92f45031e2e7efe8fd051dcc400c7977ed7df2f6cdbf09
|
| 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.12.0-cp310-abi3-manylinux_2_28_aarch64.whl
| Download URL | agnt5-0.12.0-cp310-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 19.1 MB |
| Tags | CPython 3.10 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
8eb7d3183b5e7ea20b026382b34603520c892419a60c5097a6d814142a2b5980
|
|
BLAKE2b-256 checksum How to use checksums |
1f81a2a0a81cc6218529ac1c3a6c57d80a1edb7885afc45bd0f02d6f87cc8f48
|
| 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.12.0-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | agnt5-0.12.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 |
27835b289512b414e35ede95648bd6d114363f210154e61eaf785632cc4a6705
|
|
BLAKE2b-256 checksum How to use checksums |
151a8c98fd7fb44affe728a488796d0281ee4b92e30c719229cdcce3d4e37188
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
