Pygent 0.2

Pygent is a PyTorch-like framework for composing stateless LLM agents from reusable Module graphs. Version 0.2 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.2 第一原则 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, Module, UserMessage


class Echo(Module[UserMessage, AIMessage]):
    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 the same graph to LocalRuntime when the application needs bounded concurrency, cancellation, deadlines, remote placement, durable history, or advanced Execution control. Both modes execute the same forward() graph and return (message, context); see the 0.2 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pygent_ai-0.2.16.tar.gz (589.6 kB view details)

Uploaded Aug 19, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pygent_ai-0.2.16-cp311-abi3-win_amd64.whl (2.2 MB view details)

Uploaded Aug 19, 2026 CPython 3.11+Windows x86-64

pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded Aug 19, 2026 CPython 3.11+manylinux: glibc 2.17+ x86-64

pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.7 MB view details)

Uploaded Aug 19, 2026 CPython 3.11+manylinux: glibc 2.17+ ARM64

pygent_ai-0.2.16-cp311-abi3-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded Aug 19, 2026 CPython 3.11+macOS 11.0+ ARM64

pygent_ai-0.2.16-cp311-abi3-macosx_10_12_x86_64.whl (2.4 MB view details)

Uploaded Aug 19, 2026 CPython 3.11+macOS 10.12+ x86-64

File details

Details for the file pygent_ai-0.2.16.tar.gz.

File metadata

Download URL: pygent_ai-0.2.16.tar.gz
Upload date: Aug 19, 2026
Size: 589.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pygent_ai-0.2.16.tar.gz
Algorithm	Hash digest
SHA256	`b902f7e7117bc650fb675dd0160d2df0ecf300cf3ea3873eacc71aed91e0c84a`
MD5	`bd2b615388d503ed8d314c7fced26733`
BLAKE2b-256	`19cf7051ed316270eaff35cf44dc2b5d5888de9410243815b078ebf5e242e878`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygent_ai-0.2.16.tar.gz:

Publisher: python-publish.yml on pygent-ai/pygent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pygent_ai-0.2.16.tar.gz
- Subject digest: b902f7e7117bc650fb675dd0160d2df0ecf300cf3ea3873eacc71aed91e0c84a
- Sigstore transparency entry: 2512954479
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: pygent-ai/pygent@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Branch / Tag: refs/tags/v0.2.16
- Owner: https://github.com/pygent-ai
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Trigger Event: release

File details

Details for the file pygent_ai-0.2.16-cp311-abi3-win_amd64.whl.

File metadata

Download URL: pygent_ai-0.2.16-cp311-abi3-win_amd64.whl
Upload date: Aug 19, 2026
Size: 2.2 MB
Tags: CPython 3.11+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pygent_ai-0.2.16-cp311-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`b997ecbbe4103584238cbbf585d973d2c7b6d862f25a48d304284c0fb688f535`
MD5	`13fb2cc30c6182f3cbf393030e3f23f1`
BLAKE2b-256	`8d5e8e59f26cb56afd162ca5705e1d3509f675b61033810245f7ef6ebc6efbe8`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygent_ai-0.2.16-cp311-abi3-win_amd64.whl:

Publisher: python-publish.yml on pygent-ai/pygent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pygent_ai-0.2.16-cp311-abi3-win_amd64.whl
- Subject digest: b997ecbbe4103584238cbbf585d973d2c7b6d862f25a48d304284c0fb688f535
- Sigstore transparency entry: 2512961585
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: pygent-ai/pygent@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Branch / Tag: refs/tags/v0.2.16
- Owner: https://github.com/pygent-ai
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Trigger Event: release

File details

Details for the file pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Aug 19, 2026
Size: 2.6 MB
Tags: CPython 3.11+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`5f01f07a2bf10a77200e973f5947d69b32007f4a4b09f9984aec6ece9fc641bd`
MD5	`f4de37ace42665ce043addebadf27c51`
BLAKE2b-256	`2fc6285a8b988764344a7a5fb1143a9f00bfa2029153b63c65ae7f53d8ff69d1`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: python-publish.yml on pygent-ai/pygent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: 5f01f07a2bf10a77200e973f5947d69b32007f4a4b09f9984aec6ece9fc641bd
- Sigstore transparency entry: 2512960273
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: pygent-ai/pygent@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Branch / Tag: refs/tags/v0.2.16
- Owner: https://github.com/pygent-ai
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Trigger Event: release

File details

Details for the file pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Aug 19, 2026
Size: 2.7 MB
Tags: CPython 3.11+, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`00a73b2298e358074dd32a86e3741e79dba7baa9f29034a4f83ac4f272c14ac7`
MD5	`7b3189bda31f33cb0ef56c1f98e0d86e`
BLAKE2b-256	`bc6db39d9437d6d60a909e9b9c11b7efb0b32533223f2525a359f9a5cb1d15c4`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: python-publish.yml on pygent-ai/pygent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pygent_ai-0.2.16-cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: 00a73b2298e358074dd32a86e3741e79dba7baa9f29034a4f83ac4f272c14ac7
- Sigstore transparency entry: 2512955843
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: pygent-ai/pygent@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Branch / Tag: refs/tags/v0.2.16
- Owner: https://github.com/pygent-ai
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Trigger Event: release

File details

Details for the file pygent_ai-0.2.16-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: pygent_ai-0.2.16-cp311-abi3-macosx_11_0_arm64.whl
Upload date: Aug 19, 2026
Size: 2.4 MB
Tags: CPython 3.11+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pygent_ai-0.2.16-cp311-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`610ce4dca49a03903214d126fbbede93b18e291826b6e3b93cb199148b03c411`
MD5	`d861bce93305596fda5f7b355bcbfae6`
BLAKE2b-256	`bfffcd5239cd096ff9587e630e1c6715c0fa49cb2a7d33e752f319410ba62846`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygent_ai-0.2.16-cp311-abi3-macosx_11_0_arm64.whl:

Publisher: python-publish.yml on pygent-ai/pygent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pygent_ai-0.2.16-cp311-abi3-macosx_11_0_arm64.whl
- Subject digest: 610ce4dca49a03903214d126fbbede93b18e291826b6e3b93cb199148b03c411
- Sigstore transparency entry: 2512958734
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: pygent-ai/pygent@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Branch / Tag: refs/tags/v0.2.16
- Owner: https://github.com/pygent-ai
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Trigger Event: release

File details

Details for the file pygent_ai-0.2.16-cp311-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: pygent_ai-0.2.16-cp311-abi3-macosx_10_12_x86_64.whl
Upload date: Aug 19, 2026
Size: 2.4 MB
Tags: CPython 3.11+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pygent_ai-0.2.16-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`01299a88620c542a7a33794c1eeb9102e12472f9fa829c057e76b1e2e34f3f9f`
MD5	`4fb8bff7da34793b539744673654bea8`
BLAKE2b-256	`a55509971ba52bee3e2e3e7fb01e8245c1d3864f72a295b811b10c21737f36ad`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pygent_ai-0.2.16-cp311-abi3-macosx_10_12_x86_64.whl:

Publisher: python-publish.yml on pygent-ai/pygent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pygent_ai-0.2.16-cp311-abi3-macosx_10_12_x86_64.whl
- Subject digest: 01299a88620c542a7a33794c1eeb9102e12472f9fa829c057e76b1e2e34f3f9f
- Sigstore transparency entry: 2512957647
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: pygent-ai/pygent@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Branch / Tag: refs/tags/v0.2.16
- Owner: https://github.com/pygent-ai
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@13fe6ff7659f9f4a738a4ea5a63b499aa19d7398
- Trigger Event: release

Release history Release notifications | RSS feed

0.2.17

Aug 20, 2026

This release

0.2.16

Aug 19, 2026

0.2.15

Aug 16, 2026

0.2.14

Aug 14, 2026

0.2.13

Aug 13, 2026

0.2.12

Aug 13, 2026

0.2.11

Aug 11, 2026

0.2.10

Aug 11, 2026

0.2.9

Aug 10, 2026

0.2.8

Aug 9, 2026

0.2.7

Aug 9, 2026

0.2.6

Aug 9, 2026

0.2.5

Aug 8, 2026

0.2.4

Aug 8, 2026

0.2.3

Aug 8, 2026

0.2.2

Aug 7, 2026

0.2.1

Aug 7, 2026

0.2.0

Aug 5, 2026

0.1.15

Jun 28, 2026

0.1.14

Jun 15, 2026

0.1.13

Jun 8, 2026

0.1.12

Jun 5, 2026

0.1.11

May 31, 2026

0.1.10

May 31, 2026

0.1.9

May 29, 2026

0.1.8

May 28, 2026

0.1.7

May 28, 2026

0.1.6

May 28, 2026

0.1.5

May 27, 2026

0.1.4

Apr 20, 2026

0.1.3

Mar 15, 2026

0.1.2

Mar 15, 2026

0.1.1

Mar 14, 2026

pygent-ai 0.2.16

Pygent 0.2

First principles

Quickstart

Documentation

Development

Key dates

1 maintainer

Requires

Provides Extra

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed