Agent Evolve
A comprehensive toolkit for evolving and tracking AI agents through evolutionary programming and automated optimization.
Features
- 🧬 Evolutionary Optimization: Automatically improve your AI agents using OpenEvolve
- 📊 Interactive Dashboard: Real-time tracking and visualization of evolution progress
- 🎯 Smart Extraction: Automatically find and extract functions marked for evolution
- 🔧 Auto-Generation: Generate evaluators, training data, and configurations automatically
- 📈 Metrics Tracking: Comprehensive metrics collection and analysis
- 🚀 CLI Interface: Easy-to-use command-line tools for all operations
Quick Start
Installation
pip install agent-evolve
Basic Usage
- Mark functions for evolution by adding the
@evolvedecorator:
from agent_evolve import evolve
@evolve()
def my_function(x: int) -> str:
return f"Hello {x}"
- Extract evolution targets:
agent-evolve extract /path/to/your/code
- Run the evolution pipeline:
agent-evolve pipeline my_function
- View results in the dashboard:
agent-evolve dashboard
CLI Commands
extract- Extract functions marked with @evolve decoratorgenerate-training-data- Generate training data for extracted functionsgenerate-evaluators- Generate evaluation functionsgenerate-configs- Generate OpenEvolve configuration filesevolve- Run evolution optimization on a specific toolpipeline- Run the complete pipeline (training data → evaluator → config → evolution)dashboard- Launch the interactive Streamlit dashboardanalyze- Analyze tracking data
Dashboard Features
- Evolution Pipeline: Step-by-step progress tracking
- Code Comparison: Side-by-side diffs of original vs evolved code
- Metrics & Timeline: Performance improvements over time
- Interactive Tools: Generate evaluators, run evolution, and more
Requirements
- Python 3.8+
- OpenAI API key (for evaluator generation)
- OpenEvolve package
License
MIT License - see LICENSE file for details.
Contributing
Contributions welcome! Please read our contributing guidelines and submit pull requests.
Metadata
Release files for agent-evolve 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agent_evolve-1.0.0.tar.gz | 92.1 kB | Without provenance | Details for agent_evolve-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agent_evolve-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for agent_evolve-1.0.0-py3-none-any.whl |
Total release size: 195.1 kB
Release files / agent_evolve-1.0.0.tar.gz
| Download URL | agent_evolve-1.0.0.tar.gz |
|---|---|
| Size | 92.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
079744561e9c3fe2afea9fcf1385771c056dddbcbb4a27422a95118fd27888b8
|
|
BLAKE2b-256 checksum How to use checksums |
a8fbdb35ebcfc8ac136d6ed73bba732f6355f3e104a94193c62d84b3f63459e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.4
|
Release files / agent_evolve-1.0.0-py3-none-any.whl
| Download URL | agent_evolve-1.0.0-py3-none-any.whl |
|---|---|
| Size | 103.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
84f2981f5f248fdd8504145d116973bba573b2eee663f3d46f119a7ec520b998
|
|
BLAKE2b-256 checksum How to use checksums |
4a74d05bed1aa3f41f806c5c229d6de85038ba900b094dff0483b292458e5e72
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.4
|
Security for agent-evolve 1.0.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.