Metadata-Version: 2.4
Name: agent-evolve
Version: 1.0.0
Summary: A comprehensive toolkit for evolving and tracking AI agents
Author: Agent Evolution Team
Author-email: Agent Evolution Team <team@agentevolve.com>
License: MIT
Project-URL: Homepage, https://github.com/yourusername/agent-evolve
Project-URL: Documentation, https://agent-evolve.readthedocs.io/
Project-URL: Repository, https://github.com/yourusername/agent-evolve.git
Project-URL: Bug Tracker, https://github.com/yourusername/agent-evolve/issues
Keywords: ai,agent,evolution,machine-learning,optimization
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: streamlit>=1.28.0
Requires-Dist: streamlit-ace>=0.1.1
Requires-Dist: plotly>=5.0.0
Requires-Dist: pandas>=1.3.0
Requires-Dist: openai>=1.0.0
Requires-Dist: openevolve>=0.1.0
Requires-Dist: langchain-openai>=0.1.0
Requires-Dist: langchain-core>=0.1.0
Requires-Dist: python-dotenv>=0.19.0
Requires-Dist: yfinance>=0.2.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Dynamic: author
Dynamic: license-file
Dynamic: requires-python

# 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

```bash
pip install agent-evolve
```

### Basic Usage

1. **Mark functions for evolution** by adding the `@evolve` decorator:

```python
from agent_evolve import evolve

@evolve()
def my_function(x: int) -> str:
    return f"Hello {x}"
```

2. **Extract evolution targets**:

```bash
agent-evolve extract /path/to/your/code
```

3. **Run the evolution pipeline**:

```bash
agent-evolve pipeline my_function
```

4. **View results in the dashboard**:

```bash
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.
