index.md

title: Welcome to AgentEvolver!

💡 What is AgentEvolver?

AgentEvolver is an end-to-end, self-evolving training framework that unifies self-questioning, self-navigating, and self-attributing into a cohesive system. It empowers agents to autonomously improve their capabilities, aiming for efficient, cost-effective, and continuous capability evolution.

✨ Why AgentEvolver

🧠 AgentEvolver provides three Self-Evolving Mechanisms from Environment to Policy:

• Automatic Task Generation (Self-Questioning) – Explore the environment and autonomously create diverse tasks, eliminating costly manual dataset construction.
• Experience-guided Exploration (Self-Navigating) – Summarize and reuse cross-task experience, guiding higher-quality rollouts and improving exploration efficiency.
• Attribution-based Credit Assignment (Self-Attributing) – Process long trajectories to uncover the causal contribution of intermediate steps, enabling fine-grained and efficient policy optimization.

🔧 Architecture Design

AgentEvolver adopts a service-oriented dataflow architecture, seamlessly integrating environment sandboxes, LLMs, and experience management into modular services.

• Environment Compatibility – Standardized interfaces for seamless integration with a wide range of external environments and tool APIs.
• Flexible Context Manager – Built-in utilities for managing multi-turn contexts and complex interaction logic, supporting diverse deployment scenarios.
• Modular & Extensible Architecture – Decoupled components allow easy customization, secondary development, and future algorithm upgrades.

🌟 Benchmark Performance

Performance comparison on the AppWorld and BFCL-v3 benchmarks. AgentEvolver achieves superior results while using substantially fewer parameters than larger baseline models.

Performance on two benchmarks. Columns show avg@8 and best@8 for each benchmark, plus their averages (Avg.). All values are in percent (%). Bolded numbers highlight the best results.

Model	Params	AppWorld		BFCL v3
		avg@8	best@8	avg@8	best@8
Qwen2.5-7B	7B	1.8	5.6	29.8	42.4
+Questioning	7B	23.2	40.3	49.0	60.6
+Questioning&Navigating	7B	26.3	43.1	53.3	61.0
+Questioning&Attributing	7B	25.7	43.7	56.8	65.3
AgentEvolver (overall)	7B	32.4	51.2	57.9	69.0
Qwen2.5-14B	14B	18.0	31.4	41.6	54.1
+Questioning	14B	44.3	65.5	60.3	72.1
+Questioning&Navigating	14B	45.4	65.3	62.8	74.5
+Questioning&Attributing	14B	47.8	65.6	64.9	76.3
AgentEvolver (overall)	14B	48.7	69.4	66.5	76.7

🚀 Quick Start

Step 1. Basic Dependency Installation

Make sure you have conda and cuda toolkit installed.

Then, set up the training environment by running the script

bash install.sh

Step 2. Setup Env-Service (Appworld as example)

The script below sets up an environment for appworld.

cd env_service/environments/appworld && bash setup.sh

Step 3. Setup ReMe (Optional)

Set up the ReMe for experience management by running the script:

bash external/reme/install_reme.sh

For more detailed installation, please refer to ReMe.

Step 4. Begin Training! 🚀 🚀

Copy the example.env file to .env and modify the parameters, including your API key, conda path.

Using AgentEvolver launcher to start environment, log dashboard and training process altogether.

# minimal example without ReMe (using built-in datasets within environments).
python launcher.py --conf examples/train-basic.yaml --with-appworld

# full example with ReMe (questioning + navigating + attributing)
python launcher.py --conf examples/self-question-nav-attr.yaml --with-appworld

🧩 Advanced Usage

🔧 Manual Execution

For users requiring fine-grained control over the training pipeline, we provide standalone execution scripts:

• bash examples/run_basic.sh - Execute basic RL pipeline with GRPO using built-in datasets within environments.
• bash examples/run_overall.sh - Run the complete self-evolving AgentEvolver pipeline with fully customizable configurations.

Refer to the QuickStart for detailed usage instructions and configuration parameters.

📄 Documentation

For detailed usage and customization, please refer to the following guidelines:

• Environment Service - Set up and manage environment instances, integrate custom environments
• Task Manager - Explore environments, generate synthetic tasks, and curate training data for agent evolution
• Experience Manager - Configure experience pool management and self-navigating mechanisms
• Advantage Processor - Implement self-attributing mechanisms with ADCA-GRPO for fine-grained credit assignment

For API documentation and more details, visit our documentation site.

🙏 Acknowledgements

This project builds upon the excellent work of several open-source projects:

• ReMe - for experience summarization and management;
• veRL - for distributed RL training;
• mkdocs - for documentation.