Pygent 0.3
Pygent is a PyTorch-like framework for composing LLM agents with no hidden per-call state from reusable Module graphs. Version 0.3 provides a single Execution owner for direct and managed calls, an asyncio Runtime, observable model/tool events, OpenAI-compatible adapters, portable tools and MCP adapters, ReAct, SQLite recovery, and HTTP/SSE workers.
Resource benchmark
Pygent 0.3.10 had the highest composite score among qualifying durable-runtime configurations at both tested loads. It recorded the lowest run time, P95, process-tree CPU, and peak RSS in each table.
| Concurrent requests | Durable rank | Run | P95 | CPU | Peak RSS | Disk writes |
|---|---|---|---|---|---|---|
| 200 | 1 of 4 | 3.828 s | 3.758 s | 4.906 s | 102.2 MB | 95.958 MB |
| 1,000 | 1 of 3 | 23.070 s | 22.603 s | 23.453 s | 211.1 MB | 718.838 MB |
This is not an all-metrics win: Pygent wrote 95.958 MB and 718.838 MB, respectively—74.2% and 156.8% more than LangGraph. The benchmark measures framework overhead on Windows with a local OpenAI-compatible mock, not model quality or production capacity, and the durable semantics are not identical. See the full methodology, tables, qualification rules, limitations, and optimization targets.
First principles
Pygent 0.3 第一原则 is the repository's highest authority. Module-specific first principles, SDK contracts, tests, examples, and code derive from it.
Quickstart
from pygent import AIMessage, Context, RecurrentModule, UserMessage
class Echo(RecurrentModule):
async def forward(self, message, context):
output = AIMessage(content=message.content.upper())
return output, context + message + output
message, context = await Echo().invoke(UserMessage(content="hello"), Context())
Direct invoke(), stream(), and start() need no Runtime. Bind a Module to LocalRuntime when its call contract is supported and the application needs bounded concurrency, cancellation, deadlines, remote placement, durable history, or advanced Execution control. This standard recurrent example returns (message, context); ordinary Module inputs and results are user-defined. See the Execution contract.
Install pygent-ai[video] to enable PyAV-backed video inspection and normalization
in the standard read tool. The base package does not install PyAV; an independently
installed av package or system ffmpeg/ffprobe is detected automatically.
Documentation
- 渐进式 Agent 开发教程 — 从零密钥离线示例到工具、流式、Runtime 与动态模型配置
- Layered documentation
- Execution contract
- Module, Context, Runtime
- Agent, LLM, Tool
- Executionnable service example
- Runnable tutorial example
- Native full-path load system
- Cross-framework resource benchmark
Development
uv sync --all-extras
uv run pytest -q
uv run ruff check src tests examples benchmarks
uv run mypy src benchmarks
uv build
python -m examples.service.main
uv run --extra performance python -m benchmarks run synthetic-smoke
Python 3.11+ is required. Apache-2.0; see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for pygent-ai 0.3.18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pygent_ai-0.3.18.tar.gz | 910.6 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| pygent_ai-0.3.18-cp311-abi3-win_amd64.whl | CPython 3.11 | abi3 | Windows x86-64 | Details |
| pygent_ai-0.3.18-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| pygent_ai-0.3.18-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.11 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| pygent_ai-0.3.18-cp311-abi3-macosx_11_0_arm64.whl | CPython 3.11 | abi3 | macOS 11.0+ ARM64 | Details |
| pygent_ai-0.3.18-cp311-abi3-macosx_10_12_x86_64.whl | CPython 3.11 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 13.6 MB
Release files / pygent_ai-0.3.18.tar.gz
| Download URL | pygent_ai-0.3.18.tar.gz |
|---|---|
| Size | 910.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
05f6ef9322d24f51688b8d0c794665471d5b92241382a785c97867ff2604599f
|
|
BLAKE2b-256 checksum How to use checksums |
a9fe4faae1512aaf28e4fa88ff17a66baf3e00a800adf0b3d4b4e70a5a0425f5
|
| 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 Sep 17, 2026.
Transparency logRelease files / pygent_ai-0.3.18-cp311-abi3-win_amd64.whl
| Download URL | pygent_ai-0.3.18-cp311-abi3-win_amd64.whl |
|---|---|
| Size | 2.3 MB |
| Tags | CPython 3.11 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
d0cc68a84a9210ff9de88ac4faa40a6d94631d2ba0994152112dc2ca5ba5fde5
|
|
BLAKE2b-256 checksum How to use checksums |
162f790dd6ec48a357f07fcdef2c3e1908e050ed70a279dbc6fe140aa6af5c5b
|
| 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 Sep 17, 2026.
Transparency logRelease files / pygent_ai-0.3.18-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | pygent_ai-0.3.18-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.7 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
0000b1ac58888bdfd31c9bfc56c04e51c3be0722f0b28a56326f4ae265f00e73
|
|
BLAKE2b-256 checksum How to use checksums |
200209274c4eddc94cec06a821c3f8b09dc95a4ebe928e07aeb7a5a69a1c2953
|
| 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 Sep 17, 2026.
Transparency logRelease files / pygent_ai-0.3.18-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | pygent_ai-0.3.18-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
b3272b8780b08d7eb7dd431be624efe6d8f8bf4fdec20b3375c9fdd0a6048cf9
|
|
BLAKE2b-256 checksum How to use checksums |
cbf2fe3199671dee4343c390bddc7089da368fbdc3cd6d5389304d6732705766
|
| 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 Sep 17, 2026.
Transparency logRelease files / pygent_ai-0.3.18-cp311-abi3-macosx_11_0_arm64.whl
| Download URL | pygent_ai-0.3.18-cp311-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | CPython 3.11 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
cb7286afa3b401183a7ac25b0fe07cf7e9a79cbebb77ba6d10cb4b99279cfec1
|
|
BLAKE2b-256 checksum How to use checksums |
ffbf59290f80b9277b9501db71a7d413bdd4bf5f81aee6cf46bd701cc68e5251
|
| 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 Sep 17, 2026.
Transparency logRelease files / pygent_ai-0.3.18-cp311-abi3-macosx_10_12_x86_64.whl
| Download URL | pygent_ai-0.3.18-cp311-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 2.5 MB |
| Tags | CPython 3.11 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
9aea7f8b63f4d577e73e06370b6ea2659767ca019942e0ebbaeb32be9aa76892
|
|
BLAKE2b-256 checksum How to use checksums |
e8af0c7d2cb6ae50ee0aeb7e146d8d3b0bc9e2068c9d9745fe9133d8abc3430c
|
| 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 Sep 17, 2026.
Transparency log
