Metadata-Version: 2.4
Name: mutagent
Version: 0.5.1
Summary: A Python AI Agent framework for runtime self-iterating code
Author: tiwb
License-Expression: MIT
Project-URL: Homepage, https://github.com/tiwb/mutagent
Project-URL: Repository, https://github.com/tiwb/mutagent
Keywords: ai,agent,llm,runtime,hot-reload
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mutobj~=0.5.0
Requires-Dist: httpx[socks]>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Provides-Extra: tui
Requires-Dist: textual>=0.40; extra == "tui"
Provides-Extra: web
Requires-Dist: fastapi>=0.100; extra == "web"
Requires-Dist: uvicorn>=0.20; extra == "web"
Provides-Extra: web-extract
Requires-Dist: readability-lxml>=0.8; extra == "web-extract"
Requires-Dist: markdownify>=1.0; extra == "web-extract"
Dynamic: license-file

# mutagent

A Python AI Agent framework that enables LLMs to self-iterate Python code at runtime.

> **Note:** This package is in early development. Stay tuned for updates.

## Overview

**mutagent** (mutation + agent) provides a runtime environment where AI agents can view, modify, and hot-reload Python code, forming an efficient development loop.

Key concepts:
- **Agent as Developer** - LLM operates Python modules like a developer iterating code
- **Runtime Iterable** - Hot-swap implementations without restart via declaration-implementation separation
- **Self-Evolving Tools** - Agent can create, iterate, and evolve its own tools

## Installation

```bash
pip install mutagent
```

## Development

```bash
pip install -e ".[dev]"
pytest
```

## Release

Tag 触发自动发布（PyPI Trusted Publishers，无需 token）：

```bash
git tag v0.2.x
git push origin v0.2.x
```

源码版本保持 `x.y.999`，CI 从 tag 提取正式版本号替换后构建发布。

## License

MIT
