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.8

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.8
File	Size	Uploaded
pygent_ai-0.3.8.tar.gz	647.1 kB	Sep 7, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for pygent-ai 0.3.8
File	Interpreter	ABI	Platform	Reset
pygent_ai-0.3.8-cp311-abi3-win_amd64.whl 2.2 MB Sep 7, 2026	CPython 3.11	abi3	Windows x86-64	Details
pygent_ai-0.3.8-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.8-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.8-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.8-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.8.tar.gz

Download URL	pygent_ai-0.3.8.tar.gz
Size	647.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`95a156b9bc8b4515514110a135198bbbe2f8f6cb2ec56be0d401c304f715f4d9`
BLAKE2b-256 checksum How to use checksums	`975da28a774c4965d86d2a718aadae6f4b5a1c6fe2e6b1f751dd2f200ae60d2d`
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/7675c7cffd07c5d782563d0885960e5c7d7bc727

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/7675c7cffd07c5d782563d0885960e5c7d7bc727/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34090625273/attempts/3

Artifact

Subject: pygent_ai-0.3.8.tar.gz
SHA-256 checksum: 95a156b9bc8b4515514110a135198bbbe2f8f6cb2ec56be0d401c304f715f4d9 Verifying attestations

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

Download URL	pygent_ai-0.3.8-cp311-abi3-win_amd64.whl
Size	2.2 MB
Tags	CPython 3.11 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`712c86ac348b8cf255d052457c46f410f19ae264ff699fb10714a76b38c62668`
BLAKE2b-256 checksum How to use checksums	`9b57c25ae701f1a744e63cc57bd97fc18335934a02fba7539920f504ec1857ff`
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/7675c7cffd07c5d782563d0885960e5c7d7bc727

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/7675c7cffd07c5d782563d0885960e5c7d7bc727/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34090625273/attempts/3

Artifact

Subject: pygent_ai-0.3.8-cp311-abi3-win_amd64.whl
SHA-256 checksum: 712c86ac348b8cf255d052457c46f410f19ae264ff699fb10714a76b38c62668 Verifying attestations

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

Download URL	pygent_ai-0.3.8-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	`88215a33cfebdb42591a0ec20f3e9338e1da50d6673485d6c76be9da6901e042`
BLAKE2b-256 checksum How to use checksums	`fd02bd0ea949d6d85d0a65902395c6eacb0a30694fd541b09d8969b80f024200`
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/7675c7cffd07c5d782563d0885960e5c7d7bc727

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/7675c7cffd07c5d782563d0885960e5c7d7bc727/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34090625273/attempts/3

Artifact

Subject: pygent_ai-0.3.8-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
SHA-256 checksum: 88215a33cfebdb42591a0ec20f3e9338e1da50d6673485d6c76be9da6901e042 Verifying attestations

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

Download URL	pygent_ai-0.3.8-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	`d221b06f3650cac0d0b36f5a2bebe8917ce88b212416cea0dc8d126d3b8168d2`
BLAKE2b-256 checksum How to use checksums	`9458a4411192a8b65f1d06216cebf288a03e0625d78a72d34d11eb127d36b83f`
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/7675c7cffd07c5d782563d0885960e5c7d7bc727

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/7675c7cffd07c5d782563d0885960e5c7d7bc727/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34090625273/attempts/3

Artifact

Subject: pygent_ai-0.3.8-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
SHA-256 checksum: d221b06f3650cac0d0b36f5a2bebe8917ce88b212416cea0dc8d126d3b8168d2 Verifying attestations

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

Download URL	pygent_ai-0.3.8-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	`5b47bb924efa10b923278469d08a3eacb05f3773679c210f0a51e01bd267d40a`
BLAKE2b-256 checksum How to use checksums	`6c917a527a0343d05d9ef04908ba42c077616eddb305d9f8d5649a05abea4d30`
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/7675c7cffd07c5d782563d0885960e5c7d7bc727

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/7675c7cffd07c5d782563d0885960e5c7d7bc727/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34090625273/attempts/3

Artifact

Subject: pygent_ai-0.3.8-cp311-abi3-macosx_11_0_arm64.whl
SHA-256 checksum: 5b47bb924efa10b923278469d08a3eacb05f3773679c210f0a51e01bd267d40a Verifying attestations

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

Download URL	pygent_ai-0.3.8-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	`766169d857db9a4aef0224bd030fdf664b32f9600515376f9c80aaa6a666062d`
BLAKE2b-256 checksum How to use checksums	`6d9524d59d614e9c219ba1ecbe5a53b9291201db66a275385eed6a97ff1b7aa0`
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/7675c7cffd07c5d782563d0885960e5c7d7bc727

Workflow

Publishing configuration: github.com/pygent-ai/pygent/blob/7675c7cffd07c5d782563d0885960e5c7d7bc727/.github/workflows/python-publish.yml
Publishing logs: github.com/pygent-ai/pygent/actions/runs/34090625273/attempts/3

Artifact

Subject: pygent_ai-0.3.8-cp311-abi3-macosx_10_12_x86_64.whl
SHA-256 checksum: 766169d857db9a4aef0224bd030fdf664b32f9600515376f9c80aaa6a666062d Verifying attestations