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.

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.

Documentation

渐进式 Agent 开发教程 — 从零密钥离线示例到工具、流式、Runtime 与动态模型配置
Layered documentation
Execution contract
Module, Context, Runtime
Agent, LLM, Tool
Executionnable service example
Runnable tutorial example
Native full-path load system

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.

Metadata

Release files for pygent-ai 0.3.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pygent-ai 0.3.9
File	Size	Uploaded
pygent_ai-0.3.9.tar.gz	656.7 kB	Sep 7, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for pygent-ai 0.3.9
File	Interpreter	ABI	Platform	Reset
pygent_ai-0.3.9-cp311-abi3-win_amd64.whl 2.2 MB Sep 7, 2026	CPython 3.11	abi3	Windows x86-64	Details
pygent_ai-0.3.9-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 2.6 MB Sep 7, 2026	CPython 3.11	abi3	Linux glibc 2.17+ x86-64	Details
pygent_ai-0.3.9-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 2.7 MB Sep 7, 2026	CPython 3.11	abi3	Linux glibc 2.17+ ARM64	Details
pygent_ai-0.3.9-cp311-abi3-macosx_11_0_arm64.whl 2.4 MB Sep 7, 2026	CPython 3.11	abi3	macOS 11.0+ ARM64	Details
pygent_ai-0.3.9-cp311-abi3-macosx_10_12_x86_64.whl 2.4 MB Sep 7, 2026	CPython 3.11	abi3	macOS 10.12+ x86-64	Details

Total release size: 13.0 MB

Release files / pygent_ai-0.3.9.tar.gz

Download URL	pygent_ai-0.3.9.tar.gz
Size	656.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`9f8226703b6acdb242095aea2914daf79a4422b0a1afc59b15ed77968684c8d6`
BLAKE2b-256 checksum How to use checksums	`04594ff12bfe22164794320f3578c5edb69b50dc4181aeb27244f0ba110f92bc`
Upload date	Sep 7, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pygent-ai/pygent
Publishing commit: github.com/pygent-ai/pygent/tree/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34118831602/attempts/1

Artifact

Subject: pygent_ai-0.3.9.tar.gz
SHA-256 checksum: 9f8226703b6acdb242095aea2914daf79a4422b0a1afc59b15ed77968684c8d6 Verifying attestations

Release files / pygent_ai-0.3.9-cp311-abi3-win_amd64.whl

Download URL	pygent_ai-0.3.9-cp311-abi3-win_amd64.whl
Size	2.2 MB
Tags	CPython 3.11 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`1e8a057ff44681e9f204aee2b44027bc90251f9ff7fd29d6664c263e52947c18`
BLAKE2b-256 checksum How to use checksums	`2c26fa8989232d0a405b987ab3c7aaa2feb24e93256f149ba3fb54f91d8bffb9`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pygent-ai/pygent
Publishing commit: github.com/pygent-ai/pygent/tree/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34118831602/attempts/1

Artifact

Subject: pygent_ai-0.3.9-cp311-abi3-win_amd64.whl
SHA-256 checksum: 1e8a057ff44681e9f204aee2b44027bc90251f9ff7fd29d6664c263e52947c18 Verifying attestations

Release files / pygent_ai-0.3.9-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	pygent_ai-0.3.9-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	2.6 MB
Tags	CPython 3.11 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum How to use checksums	`e7626e54f868a1b6ec651bda53101cd91718ee07f3c04da1718753530658a34e`
BLAKE2b-256 checksum How to use checksums	`891d8ecbb36710a47a56c0f6f70a78d52ae534ddbd63639d6c3b946c1ffff48d`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pygent-ai/pygent
Publishing commit: github.com/pygent-ai/pygent/tree/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34118831602/attempts/1

Artifact

Subject: pygent_ai-0.3.9-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
SHA-256 checksum: e7626e54f868a1b6ec651bda53101cd91718ee07f3c04da1718753530658a34e Verifying attestations

Release files / pygent_ai-0.3.9-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	pygent_ai-0.3.9-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	2.7 MB
Tags	CPython 3.11 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum How to use checksums	`0fee28485e906d9bea560d34c4ac0ae4b6ad1371b41b3bb2d8ecea70bb557447`
BLAKE2b-256 checksum How to use checksums	`f5020654bfb8c8c1b1b45829af2b17c95e637e0ae33264c6a6e14a918dabb947`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pygent-ai/pygent
Publishing commit: github.com/pygent-ai/pygent/tree/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34118831602/attempts/1

Artifact

Subject: pygent_ai-0.3.9-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
SHA-256 checksum: 0fee28485e906d9bea560d34c4ac0ae4b6ad1371b41b3bb2d8ecea70bb557447 Verifying attestations

Release files / pygent_ai-0.3.9-cp311-abi3-macosx_11_0_arm64.whl

Download URL	pygent_ai-0.3.9-cp311-abi3-macosx_11_0_arm64.whl
Size	2.4 MB
Tags	CPython 3.11 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`a43cfd4ad9ffc71c00ed708b25d04833c56b2a9f9d52f6b168905758d4bacf4e`
BLAKE2b-256 checksum How to use checksums	`f539bd6d89c5b239f528549ea29ca11c8c7e808eba17407bf896c58d8e437de5`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pygent-ai/pygent
Publishing commit: github.com/pygent-ai/pygent/tree/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34118831602/attempts/1

Artifact

Subject: pygent_ai-0.3.9-cp311-abi3-macosx_11_0_arm64.whl
SHA-256 checksum: a43cfd4ad9ffc71c00ed708b25d04833c56b2a9f9d52f6b168905758d4bacf4e Verifying attestations

Release files / pygent_ai-0.3.9-cp311-abi3-macosx_10_12_x86_64.whl

Download URL	pygent_ai-0.3.9-cp311-abi3-macosx_10_12_x86_64.whl
Size	2.4 MB
Tags	CPython 3.11 abi3 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`5f748d908ef5d3ec1e63795164718e7b76b9c6db04abf2a7a4f256a7c5911630`
BLAKE2b-256 checksum How to use checksums	`645c25c644662e0c522602b2fc300f9dac1baa17a53f9f0f71cda52e41f3dcc5`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pygent-ai/pygent
Publishing commit: github.com/pygent-ai/pygent/tree/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/9aeb637ae345f0bad8ab3a0fb9416c2ea91ae84b/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34118831602/attempts/1

Artifact

Subject: pygent_ai-0.3.9-cp311-abi3-macosx_10_12_x86_64.whl
SHA-256 checksum: 5f748d908ef5d3ec1e63795164718e7b76b9c6db04abf2a7a4f256a7c5911630 Verifying attestations