evoagentx 0.1.0__tar.gz

evoagentx-0.1.0/LICENSE

@@ -0,0 +1,82 @@
+MIT License
+
+Copyright (c) 2025 EvoAgentX 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+copies of the Software, and to permit persons to whom the Software is 
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in 
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 
+THE SOFTWARE. 
+
+---
+
+## Third-party Licenses
+
+This project includes modified code from the following open-source projects:
+
+### 1. AFlow 
+
+Repository: https://github.com/geekan/MetaGPT/tree/main/metagpt/ext/aflow
+License: 
+
+MIT License (for parts derived from AFlow)
+
+Copyright (c) 2024 Chenglin Wu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+
+### 2. LiveCodeBench 
+
+Repository: https://github.com/LiveCodeBench/LiveCodeBench 
+License: 
+
+MIT License
+
+Copyright (c) 2024 LiveCodeBench
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

evoagentx-0.1.0/PKG-INFO

@@ -0,0 +1,528 @@
+Metadata-Version: 2.4
+Name: evoagentx
+Version: 0.1.0
+Summary: A framework for evolving agentic workflows with LLMs.
+Author-email: EvoAgentX Team <evoagentx.ai@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/EvoAgentX/EvoAgentX
+Project-URL: Documentation, https://EvoAgentX.github.io/EvoAgentX/
+Project-URL: Repository, https://github.com/EvoAgentX/EvoAgentX
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: sympy
+Requires-Dist: overdue
+Requires-Dist: scipy
+Requires-Dist: setuptools
+Requires-Dist: tree_sitter
+Requires-Dist: tree_sitter_python
+Requires-Dist: antlr4-python3-runtime==4.11
+Requires-Dist: tenacity
+Requires-Dist: networkx>=3.3
+Requires-Dist: nltk>=3.9.1
+Requires-Dist: numpy>=1.26.4
+Requires-Dist: openai>=1.55.3
+Requires-Dist: litellm>=1.55.6
+Requires-Dist: pydantic>=2.9.0
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: matplotlib>=3.10.0
+Requires-Dist: transformers>=4.47.1
+Requires-Dist: datasets>=3.4.0
+Requires-Dist: faiss-cpu==1.8.0.post1
+Requires-Dist: docker>=6.1.2
+Requires-Dist: fastapi>=0.115.11
+Requires-Dist: motor>=3.7.0
+Requires-Dist: uvicorn>=0.34.0
+Requires-Dist: sqlalchemy>=2.0.38
+Requires-Dist: python-jose>=3.3.0
+Requires-Dist: passlib>=1.7.4
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: bcrypt>=4.0.1
+Requires-Dist: celery>=5.3.4
+Requires-Dist: redis>=5.0.0
+Requires-Dist: httpx>=0.24.1
+Requires-Dist: asgi-lifespan>=1.0.1
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: jwt>=1.3.1
+Requires-Dist: dashscope>=1.23.4
+Requires-Dist: textgrad>=0.1.8
+Requires-Dist: dspy
+Requires-Dist: googlesearch-python
+Requires-Dist: wikipedia
+Requires-Dist: mcp
+Requires-Dist: beautifulsoup4
+Requires-Dist: neo4j
+Requires-Dist: ollama
+Requires-Dist: llama-index
+Requires-Dist: llama-index-vector-stores-faiss
+Requires-Dist: llama-index-graph-stores-neo4j
+Requires-Dist: sentence-transformers
+Requires-Dist: docx2txt
+Requires-Dist: python-pptx
+Requires-Dist: Pillow
+Requires-Dist: PyPDF2
+Requires-Dist: selenium
+Requires-Dist: html2text
+Requires-Dist: fastmcp
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-subtests; extra == "dev"
+Requires-Dist: pytest-json-report; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+<!-- Add logo here -->
+<div align="center">
+  <a href="https://github.com/EvoAgentX/EvoAgentX">
+    <img src="./assets/EAXLoGo.svg" alt="EvoAgentX" width="50%">
+  </a>
+</div>
+
+<h2 align="center">
+    Building a Self-Evolving Ecosystem of AI Agents
+</h2>
+
+<div align="center">
+
+[![EvoAgentX Homepage](https://img.shields.io/badge/EvoAgentX-Homepage-blue?logo=homebridge)](https://evoagentx.org/)
+[![Docs](https://img.shields.io/badge/-Documentation-0A66C2?logo=readthedocs&logoColor=white&color=7289DA&labelColor=grey)](https://EvoAgentX.github.io/EvoAgentX/)
+[![Discord](https://img.shields.io/badge/Chat-Discord-5865F2?&logo=discord&logoColor=white)](https://discord.gg/XWBZUJFwKe)
+[![Twitter](https://img.shields.io/badge/Follow-@EvoAgentX-e3dee5?&logo=x&logoColor=white)](https://x.com/EvoAgentX)
+[![Wechat](https://img.shields.io/badge/WeChat-EvoAgentX-brightgreen?logo=wechat&logoColor=white)](./assets/wechat_info.md)
+[![GitHub star chart](https://img.shields.io/github/stars/EvoAgentX/EvoAgentX?style=social)](https://star-history.com/#EvoAgentX/EvoAgentX)
+[![GitHub fork](https://img.shields.io/github/forks/EvoAgentX/EvoAgentX?style=social)](https://github.com/EvoAgentX/EvoAgentX/fork)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg?)](https://github.com/EvoAgentX/EvoAgentX/blob/main/LICENSE)
+<!-- [![EvoAgentX Homepage](https://img.shields.io/badge/EvoAgentX-Homepage-blue?logo=homebridge)](https://EvoAgentX.github.io/EvoAgentX/) -->
+<!-- [![hf_space](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-EvoAgentX-ffc107?color=ffc107&logoColor=white)](https://huggingface.co/EvoAgentX) -->
+</div>
+
+<div align="center">
+
+<h3 align="center">
+
+<a href="./README.md" style="text-decoration: underline;">English</a> | <a href="./README-zh.md">简体中文</a>
+
+</h3>
+
+</div>
+
+<h4 align="center">
+  <i>An automated framework for evaluating and evolving agentic workflows.</i>
+</h4>
+
+<p align="center">
+  <img src="./assets/framework_en.jpg">
+</p>
+
+
+## 🔥 Latest News
+- **[Aug 2025]** 🎉 **The EvoAgentX Team has published the latest survey of self-evolving AI Agents** on [arxiv](https://arxiv.org/abs/2508.07407)!
+- **[July 2025]** 🎉 **EvoAgentX** is on [arxiv](https://arxiv.org/abs/2507.03616)!
+- **[July 2025]** 🎉 **EvoAgentX** has achieved 1,000 stars!
+- **[May 2025]** 🎉 **EvoAgentX** has been officially released!
+
+## ⚡ Get Started
+- [🔥 Latest News](#-latest-news)
+- [⚡ Get Started](#-get-started)
+- [Installation](#installation)
+- [LLM Configuration](#llm-configuration)
+  - [API Key Configuration](#api-key-configuration)
+  - [Configure and Use the LLM](#configure-and-use-the-llm)
+- [Automatic WorkFlow Generation](#automatic-workflow-generation)
+- [Tool-Enabled Workflows Generation:](#tool-enabled-workflows-generation)
+- [Demo Video](#demo-video)
+  - [✨ Final Results](#-final-results)
+- [Evolution Algorithms](#evolution-algorithms)
+  - [📊 Results](#-results)
+- [Applications](#applications)
+- [Tutorial and Use Cases](#tutorial-and-use-cases)
+- [🎯 Roadmap](#-roadmap)
+- [🙋 Support](#-support)
+  - [Join the Community](#join-the-community)
+  - [Add the meeting to your calendar](#add-the-meeting-to-your-calendar)
+  - [Contact Information](#contact-information)
+  - [Community Call](#community-call)
+- [🙌 Contributing to EvoAgentX](#-contributing-to-evoagentx)
+- [📖 Citation](#-citation)
+- [📚 Acknowledgements](#-acknowledgements)
+- [📄 License](#-license)
+
+
+
+## Installation
+
+We recommend installing EvoAgentX using `pip`:
+
+```bash
+pip install git+https://github.com/EvoAgentX/EvoAgentX.git
+```
+
+For local development or detailed setup (e.g., using conda), refer to the [Installation Guide for EvoAgentX](./docs/installation.md).
+
+<details>
+<summary>Example (optional, for local development):</summary>
+
+```bash
+git clone https://github.com/EvoAgentX/EvoAgentX.git
+cd EvoAgentX
+# Create a new conda environment
+conda create -n evoagentx python=3.11
+
+# Activate the environment
+conda activate evoagentx
+
+# Install the package
+pip install -r requirements.txt
+# OR install in development mode
+pip install -e .
+```
+</details>
+
+## LLM Configuration
+
+### API Key Configuration 
+
+To use LLMs with EvoAgentX (e.g., OpenAI), you must set up your API key.
+
+<details>
+<summary>Option 1: Set API Key via Environment Variable</summary> 
+
+- Linux/macOS: 
+```bash
+export OPENAI_API_KEY=<your-openai-api-key>
+```
+
+- Windows Command Prompt: 
+```cmd 
+set OPENAI_API_KEY=<your-openai-api-key>
+```
+
+-  Windows PowerShell:
+```powershell
+$env:OPENAI_API_KEY="<your-openai-api-key>" # " is required 
+```
+
+Once set, you can access the key in your Python code with:
+```python
+import os
+OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
+```
+</details>
+
+<details>
+<summary>Option 2: Use .env File</summary> 
+
+- Create a .env file in your project root and add the following:
+```bash
+OPENAI_API_KEY=<your-openai-api-key>
+```
+
+Then load it in Python:
+```python
+from dotenv import load_dotenv 
+import os 
+
+load_dotenv() # Loads environment variables from .env file
+OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
+```
+</details>
+<!-- > 🔐 Tip: Don't forget to add `.env` to your `.gitignore` to avoid committing secrets. -->
+
+### Configure and Use the LLM
+Once the API key is set, initialise the LLM with:
+
+```python
+from evoagentx.models import OpenAILLMConfig, OpenAILLM
+
+# Load the API key from environment
+OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
+
+# Define LLM configuration
+openai_config = OpenAILLMConfig(
+    model="gpt-4o-mini",       # Specify the model name
+    openai_key=OPENAI_API_KEY, # Pass the key directly
+    stream=True,               # Enable streaming response
+    output_response=True       # Print response to stdout
+)
+
+# Initialize the language model
+llm = OpenAILLM(config=openai_config)
+
+# Generate a response from the LLM
+response = llm.generate(prompt="What is Agentic Workflow?")
+```
+> 📖 More details on supported models and config options: [LLM module guide](./docs/modules/llm.md).
+
+
+## Automatic WorkFlow Generation 
+Once your API key and language model are configured, you can automatically generate and execute multi-agent workflows in EvoAgentX.
+
+🧩 Core Steps:
+1. Define a natural language goal
+2. Generate the workflow with `WorkFlowGenerator`
+3. Instantiate agents using `AgentManager`
+4. Execute the workflow via `WorkFlow`
+
+💡 Minimal Example:
+```python
+from evoagentx.workflow import WorkFlowGenerator, WorkFlowGraph, WorkFlow
+from evoagentx.agents import AgentManager
+
+goal = "Generate html code for the Tetris game"
+workflow_graph = WorkFlowGenerator(llm=llm).generate_workflow(goal)
+
+agent_manager = AgentManager()
+agent_manager.add_agents_from_workflow(workflow_graph, llm_config=openai_config)
+
+workflow = WorkFlow(graph=workflow_graph, agent_manager=agent_manager, llm=llm)
+output = workflow.execute()
+print(output)
+```
+
+You can also:
+- 📊 Visualise the workflow: `workflow_graph.display()`
+- 💾 Save/load workflows: `save_module()` / `from_file()`
+
+> 📂 For a complete working example, check out the [`workflow_demo.py`](https://github.com/EvoAgentX/EvoAgentX/blob/main/examples/workflow_demo.py)
+
+## Tool-Enabled Workflows Generation:
+
+In more advanced scenarios, your workflow agents may need to use external tools. EvoAgentX allows Automatic tool integration: Provide a list of toolkits to WorkFlowGenerator. The generator will consider these and include them in the agents if appropriate.
+
+For instance, to enable an Arxiv toolkit:
+```python
+from evoagentx.tools import ArxivToolkit
+
+# Initialize a command-line toolkit for file operations
+arxiv_toolkit = ArxivToolkit()
+
+# Generate a workflow with the toolkit available to agents
+wf_generator = WorkFlowGenerator(llm=llm, tools=[arxiv_toolkit])
+workflow_graph = wf_generator.generate_workflow(goal="Find and summarize the latest research on AI in the field of finance on arXiv")
+
+# Instantiate agents with access to the toolkit
+agent_manager = AgentManager(tools=[arxiv_toolkit])
+agent_manager.add_agents_from_workflow(workflow_graph, llm_config=openai_config)
+
+workflow = WorkFlow(graph=workflow_graph, agent_manager=agent_manager, llm=llm)
+output = workflow.execute()
+print(output)
+```
+
+In this setup, the workflow generator may assign the `ArxivToolkit` to relevant agents, enabling them to execute shell commands as part of the workflow (e.g. creating directories and files)
+
+## Human-in-the-Loop (HITL) Support:
+
+In advanced scenarios, EvoAgentX supports integrating human-in-the-loop interactions within your agent workflows. This means you can pause an agent’s execution for manual approval or inject user-provided input at key steps, ensuring critical decisions are vetted by a human when needed.
+
+All human interactions are managed through a central `HITLManager` instance. The HITL module includes specialized agents like `HITLInterceptorAgent` for approval gating and `HITLUserInputCollectorAgent` for collecting user data.
+
+For instance, to require human approval before an email-sending agent executes its action:
+```python
+from evoagentx.hitl import HITLManager, HITLInterceptorAgent, HITLInteractionType, HITLMode
+
+hitl_manager = HITLManager()
+hitl_manager.activate()  # Enable HITL (disabled by default)
+
+# Interceptor agent to approve/reject the DummyEmailSendAction of DataSendingAgent
+interceptor = HITLInterceptorAgent(
+    target_agent_name="DataSendingAgent",
+    target_action_name="DummyEmailSendAction",
+    interaction_type=HITLInteractionType.APPROVE_REJECT,
+    mode=HITLMode.PRE_EXECUTION    # ask before action runs
+)
+# Map the interceptor’s output field back to the workflow’s input field for continuity
+hitl_manager.hitl_input_output_mapping = {"human_verified_data": "extracted_data"}
+
+# Add the interceptor to the AgentManager and include HITL in the workflow execution
+agent_manager.add_agent(interceptor)
+workflow = WorkFlow(graph=workflow_graph, agent_manager=agent_manager, llm=llm, hitl_manager=hitl_manager)
+```
+When this interceptor triggers, the workflow will pause and prompt in the console for `[a]pprove` or `[r]eject` before continuing. If approved, the flow proceeds using the human-verified data; if rejected, the action is skipped or handled accordingly.
+
+> 📂 For a complete working example, check out the [`tutorial
+/hitl.md`](https://github.com/EvoAgentX/EvoAgentX/blob/615b06d29264f47e58a6780bd24f0e73cbf7deee/docs/tutorial/hitl.md)
+
+## Demo Video
+
+
+[![Watch on YouTube](https://img.shields.io/badge/-Watch%20on%20YouTube-red?logo=youtube&labelColor=grey)](https://www.youtube.com/watch?v=Wu0ZydYDqgg)
+[![Watch on Bilibili](https://img.shields.io/badge/-Watch%20on%20Bilibili-00A1D6?logo=bilibili&labelColor=white)](https://www.bilibili.com/video/BV1mEJizyE7H/?vd_source=02f8f3a7c8865b3af6378d9680393f5a)
+
+<div align="center">
+  <video src="https://github.com/user-attachments/assets/906a6086-e98d-4df3-84b0-808020ddd520.mp4" autoplay loop muted playsinline width="600">
+    Your browser does not support the video tag.
+  </video>
+</div>
+
+In this demo, we showcase the workflow generation and execution capabilities of EvoAgentX through two examples:
+
+- Application 1: Intelligent Job Recommendation from Resume
+- Application 2: Visual Analysis of A-Share Stocks
+
+
+### ✨ Final Results
+
+<table>
+  <tr>
+    <td align="center">
+      <img src="./assets/demo_result_1.png" width="400"><br>
+      <strong>Application&nbsp;1:</strong><br>Job Recommendation
+    </td>
+    <td align="center">
+      <img src="./assets/demo_result_2.jpeg" width="400"><br>
+      <strong>Application&nbsp;2:</strong><br>Stock Visual Analysis
+    </td>
+  </tr>
+</table>
+
+## Evolution Algorithms 
+
+We have integrated some existing agent/workflow evolution algorithms into EvoAgentX, including [TextGrad](https://www.nature.com/articles/s41586-025-08661-4), [MIPRO](https://arxiv.org/abs/2406.11695) and [AFlow](https://arxiv.org/abs/2410.10762).
+
+To evaluate the performance, we use them to optimize the same agent system on three different tasks: multi-hop QA (HotPotQA), code generation (MBPP) and reasoning (MATH). We randomly sample 50 examples for validation and other 100 examples for testing. 
+
+> Tip: We have integrated these benchmark and evaluation code in EvoAgentX. Please refer to the [benchmark and evaluation tutorial](https://github.com/EvoAgentX/EvoAgentX/blob/main/docs/tutorial/benchmark_and_evaluation.md) for more details.
+
+### 📊 Results 
+
+| Method   | HotPotQA<br>(F1%) | MBPP<br>(Pass@1 %) | MATH<br>(Solve Rate %) |
+|----------|--------------------|---------------------|--------------------------|
+| Original | 63.58              | 69.00               | 66.00                    |
+| TextGrad | 71.02              | 71.00               | 76.00                    |
+| AFlow    | 65.09              | 79.00               | 71.00                    |
+| MIPRO    | 69.16              | 68.00               | 72.30       
+
+Please refer to the `examples/optimization` folder for more details. 
+
+## Applications 
+
+We use our framework to optimize existing multi-agent systems on the [GAIA](https://huggingface.co/spaces/gaia-benchmark/leaderboard) benchmark. We select [Open Deep Research](https://github.com/huggingface/smolagents/tree/main/examples/open_deep_research) and [OWL](https://github.com/camel-ai/owl), two representative multi-agent framework from the GAIA leaderboard that is open-source and runnable. 
+
+We apply EvoAgentX to optimize their prompts. The performance of the optimized agents on the GAIA benchmark validation set is shown in the figure below.
+
+<table>
+  <tr>
+    <td align="center" width="50%">
+      <img src="./assets/open_deep_research_optimization_report.png" alt="Open Deep Research Optimization" width="100%"><br>
+      <strong>Open Deep Research</strong>
+    </td>
+    <td align="center" width="50%">
+      <img src="./assets/owl_optimization_result.png" alt="OWL Optimization" width="100%"><br>
+      <strong>OWL Agent</strong>
+    </td>
+  </tr>
+</table>
+
+> Full Optimization Reports: [Open Deep Research](https://github.com/eax6/smolagents) and [OWL](https://github.com/TedSIWEILIU/owl).  
+
+## Tutorial and Use Cases
+
+> 💡 **New to EvoAgentX?** Start with the [Quickstart Guide](./docs/quickstart.md) for a step-by-step introduction.
+
+
+Explore how to effectively use EvoAgentX with the following resources:
+
+| Cookbook | Colab Notebook | Description |
+|:---|:---|:---|
+| **[Build Your First Agent](./docs/tutorial/first_agent.md)** | **[Build Your First Agent](./docs/ColabNotebook/tutorial_notebooks/first_agent.ipynb)** | Quickly create and manage agents with multi-action capabilities. |
+| **[Build Your First Workflow](./docs/tutorial/first_workflow.md)** | **[Build Your First Workflow](./docs/ColabNotebook/tutorial_notebooks/first_workflow.ipynb)** | Learn to build collaborative workflows with multiple agents. |
+| **[Working with Tools](./docs/tutorial/tools.md)** | **[Working with Tools](./docs/ColabNotebook/tutorial_notebooks/tools.ipynb)** | Master EvoAgentX's powerful tool ecosystem for agent interactions |
+| **[Automatic Workflow Generation](./docs/quickstart.md#automatic-workflow-generation-and-execution)** | **[Automatic Workflow Generation](./docs/ColabNotebook/tutorial_notebooks/quickstart.ipynb)** | Automatically generate workflows from natural language goals. |
+| **[Benchmark and Evaluation Tutorial](./docs/tutorial/benchmark_and_evaluation.md)** | **[Benchmark and Evaluation Tutorial](./docs/ColabNotebook/tutorial_notebooks/benchmark_and_evaluation.ipynb)** | Evaluate agent performance using benchmark datasets. |
+| **[TextGrad Optimizer Tutorial](./docs/tutorial/textgrad_optimizer.md)** | **[TextGrad Optimizer Tutorial](./docs/ColabNotebook/tutorial_notebooks/textgrad_optimizer.ipynb)** | Automatically optimise the prompts within multi-agent workflow with TextGrad. |
+| **[AFlow Optimizer Tutorial](./docs/tutorial/aflow_optimizer.md)** | **[AFlow Optimizer Tutorial](./docs/ColabNotebook/tutorial_notebooks/aflow_optimizer.ipynb)** | Automatically optimise both the prompts and structure of multi-agent workflow with AFlow. |
+| **[Human-In-The-Loop support](./docs/tutorial/hitl.md)** | | Enable HITL functionalities in your WorkFlow.
+<!-- | **[SEW Optimizer Tutorial](./docs/tutorial/sew_optimizer.md)** | Create SEW (Self-Evolving Workflows) to enhance agent systems. | -->
+
+🛠️ Follow the tutorials to build and optimize your EvoAgentX workflows.
+
+🚀 We're actively working on expanding our library of use cases and optimization strategies. **More coming soon — stay tuned!**
+
+## 🎯 Roadmap
+- [ ] **Modularize Evolution Algorithms**: Abstract optimization algorithms into plug-and-play modules that can be easily integrated into custom workflows. 
+- [ ] **Develop Task Templates and Agent Modules**: Build reusable templates for typical tasks and standardized agent components to streamline application development.
+- [ ] **Integrate Self-Evolving Agent Algorithms**: Incorporate more recent and advanced agent self-evolution across multiple dimensions, including prompt tuning, workflow structures, and memory modules. 
+- [ ] **Enable Visual Workflow Editing Interface**: Provide a visual interface for workflow structure display and editing to improve usability and debugging. 
+
+
+
+## 🙋 Support
+
+### Join the Community
+
+📢 Stay connected and be part of the **EvoAgentX** journey!  
+🚩 Join our community to get the latest updates, share your ideas, and collaborate with AI enthusiasts worldwide.
+
+- [Discord](https://discord.gg/XWBZUJFwKe) — Chat, discuss, and collaborate in real-time.
+- [X (formerly Twitter)](https://x.com/EvoAgentX) — Follow us for news, updates, and insights.
+- [WeChat](https://github.com/EvoAgentX/EvoAgentX/blob/main/assets/wechat_info.md) — Connect with our Chinese community.
+
+### Add the meeting to your calendar
+
+📅 Click the link below to add the EvoAgentX Weekly Meeting (Sundays, 16:30–17:30 GMT+8) to your calendar:
+
+👉 [Add to your Google Calendar](https://calendar.google.com/calendar/u/0/r/eventedit?text=EvoAgentX+周会（腾讯会议）&dates=20250629T083000Z/20250629T093000Z&details=会议链接：https://meeting.tencent.com/dm/5UuNxo7Detz0&location=Online&recur=RRULE:FREQ=WEEKLY;BYDAY=SU;UNTIL=20270523T093000Z&ctz=Asia/Shanghai)
+
+👉 [Add to your Tencent Meeting](https://meeting.tencent.com/dm/5UuNxo7Detz0)
+
+👉 [Download the EvoAgentX_Weekly_Meeting.ics file](./EvoAgentX_Weekly_Meeting.ics)
+
+### Contact Information
+
+If you have any questions or feedback about this project, please feel free to contact us. We highly appreciate your suggestions!
+
+- **Email:** evoagentx.ai@gmail.com
+
+We will respond to all questions within 2-3 business days.
+
+### Community Call
+- [Bilibili](https://space.bilibili.com/3493105294641286/favlist?fid=3584589186&ftype=create&spm_id_from=333.788.0.0)
+- [Youtube](https://studio.youtube.com/playlist/PL_kuPS05qA1hyU6cLX--bJ93Km2-md8AA/edit)
+## 🙌 Contributing to EvoAgentX
+Thanks go to these awesome contributors
+
+<a href="https://github.com/EvoAgentX/EvoAgentX/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=EvoAgentX/EvoAgentX" />
+</a>
+
+We appreciate your interest in contributing to our open-source initiative. We provide a document of [contributing guidelines](https://github.com/EvoAgentX/EvoAgentX/blob/main/CONTRIBUTING.md) which outlines the steps for contributing to EvoAgentX. Please refer to this guide to ensure smooth collaboration and successful contributions. 🤝🚀
+
+[![Star History Chart](https://api.star-history.com/svg?repos=EvoAgentX/EvoAgentX&type=Date)](https://www.star-history.com/#EvoAgentX/EvoAgentX&Date)
+
+## 📖 Citation
+
+Please consider citing our work if you find EvoAgentX helpful:
+
+📄 [EvoAgentX](https://arxiv.org/abs/2507.03616)
+📄 [Survey Paper](https://arxiv.org/abs/2508.07407)
+
+```bibtex
+@article{wang2025evoagentx,
+  title={EvoAgentX: An Automated Framework for Evolving Agentic Workflows},
+  author={Wang, Yingxu and Liu, Siwei and Fang, Jinyuan and Meng, Zaiqiao},
+  journal={arXiv preprint arXiv:2507.03616},
+  year={2025}
+}
+@article{fang202survey,
+      title={A Comprehensive Survey of Self-Evolving AI Agents: A New Paradigm Bridging Foundation Models and Lifelong Agentic Systems}, 
+      author={Jinyuan Fang and Yanwen Peng and Xi Zhang and Yingxu Wang and Xinhao Yi and Guibin Zhang and Yi Xu and Bin Wu and Siwei Liu and Zihao Li and Zhaochun Ren and Nikos Aletras and Xi Wang and Han Zhou and Zaiqiao Meng},
+      year={2025},
+      journal={arXiv preprint arXiv:2508.07407},
+      url={https://arxiv.org/abs/2508.07407}, 
+}
+```
+
+## 📚 Acknowledgements 
+This project builds upon several outstanding open-source projects: [AFlow](https://github.com/FoundationAgents/MetaGPT/tree/main/metagpt/ext/aflow), [TextGrad](https://github.com/zou-group/textgrad), [DSPy](https://github.com/stanfordnlp/dspy), [LiveCodeBench](https://github.com/LiveCodeBench/LiveCodeBench), and more. We would like to thank the developers and maintainers of these frameworks for their valuable contributions to the open-source community.
+
+## 📄 License
+
+Source code in this repository is made available under the [MIT License](./LICENSE).