Back to packageRELEASE DETAILS

1.0.0

PyPI

agent-evolve

A comprehensive toolkit for evolving and tracking AI agents

Published5 Aug 2025

Direct dependencies14

Transitive dependenciesNot calculated

README

Version 1.0.0 documentation

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 @evolve decorator:

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 decorator
generate-training-data - Generate training data for extracted functions
generate-evaluators - Generate evaluation functions
generate-configs - Generate OpenEvolve configuration files
evolve - Run evolution optimization on a specific tool
pipeline - Run the complete pipeline (training data → evaluator → config → evolution)
dashboard - Launch the interactive Streamlit dashboard
analyze - 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.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 14

Native requirements

14 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
streamlit Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`streamlit>=1.28.0`	runtime
streamlit-ace Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`streamlit-ace>=0.1.1`	runtime
plotly Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`plotly>=5.0.0`	runtime
pandas Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`pandas>=1.3.0`	runtime
openai Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`openai>=1.0.0`	runtime
openevolve Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`openevolve>=0.1.0`	runtime
langchain-openai Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`langchain-openai>=0.1.0`	runtime
langchain-core Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`langchain-core>=0.1.0`	runtime
python-dotenv Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`python-dotenv>=0.19.0`	runtime
yfinance Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`yfinance>=0.2.0`	runtime
pytest Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`pytest>=6.0; extra == "dev"`	runtime
pytest-asyncio Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`pytest-asyncio; extra == "dev"`	runtime
black Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`black; extra == "dev"`	runtime
flake8 Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`flake8; extra == "dev"`	runtime