HKUDS/AutoAgent

HKUDS/AutoAgent được TopGit xếp vào nhóm công cụ AI, với 9.8k sao trên GitHub, viết chủ yếu bằng Python. "AutoAgent: Fully-Automated and Zero-Code LLM Agent Framework"
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Snapshot
Cộng tác viên hàng đầu
Xem cộng tác viên hàng đầu
AutoAgent: Fully-Automated & Zero-Code
LLM Agent Framework
Welcome to AutoAgent! AutoAgent is a Fully-Automated and highly Self-Developing framework that enables users to create and deploy LLM agents through Natural Language Alone.
✨Key Features of AutoAgent
-
💬 Natural Language-Driven Agent Building
Automatically constructs and orchestrates collaborative agent systems purely through natural dialogue, eliminating the need for manual coding or technical configuration. -
🚀 Zero-Code Framework
Democratizes AI development by allowing anyone, regardless of coding experience, to create and customize their own agents, tools, and workflows using natural language alone. -
⚡ Self-Managing Workflow Generation
Dynamically creates, optimizes and adapts agent workflows based on high-level task descriptions, even when users cannot fully specify implementation details. -
🔧 Intelligent Resource Orchestration
Enables controlled code generation for creating tools, agents, and workflows through iterative self-improvement, supporting both single agent creation and multi-agent workflow generation. -
🎯 Self-Play Agent Customization
Enables controlled code generation for creating tools, agents, and workflows through iterative self-improvement, supporting both single agent creation and multi-agent workflow generation.
🚀 Unlock the Future of LLM Agents. Try 🔥AutoAgent🔥 Now!
🔥 News
- [2025, Feb 17]: 🎉🎉We've updated and released AutoAgent v0.2.0 (formerly known as MetaChain). Detailed changes include: 1) fix the bug of different LLM providers from issues; 2) add automatic installation of AutoAgent in the container environment according to issues; 3) add more easy-to-use commands for the CLI mode. 4) Rename the project to AutoAgent for better understanding.
- [2025, Feb 10]: 🎉🎉We've released MetaChain!, including framework, evaluation codes and CLI mode! Check our paper for more details.
📑 Table of Contents
- ✨ Features
- 🔥 News
- 🔍 How to Use AutoAgent
- 1.
user mode(Deep Research Agents) - 2.
agent editor(Agent Creation without Workflow) - 3.
workflow editor(Agent Creation with Workflow)
- 1.
- ⚡ Quick Start
- Installation
- API Keys Setup
- Start with CLI Mode
- ☑️ Todo List
- 🔬 How To Reproduce the Results in the Paper
- 📖 Documentation
- 🤝 Join the Community
- 🙏 Acknowledgements
- 🌟 Cite
🔍 How to Use AutoAgent
1. user mode (Deep Research Agents)
AutoAgent features a ready-to-use multi-agent system accessible through user mode on the start page. This system serves as a comprehensive AI research assistant designed for information retrieval, complex analytical tasks, and comprehensive report generation.
- 🚀 High Performance: Matches Deep Research using Claude 3.5 rather than OpenAI's o3 model.
- 🔄 Model Flexibility: Compatible with any LLM (including Deepseek-R1, Grok, Gemini, etc.)
- 💰 Cost-Effective: Open-source alternative to Deep Research's $200/month subscription
- 🎯 User-Friendly: Easy-to-deploy CLI interface for seamless interaction
- 📁 File Support: Handles file uploads for enhanced data interaction
🎥 Deep Research (aka User Mode)
2. agent editor (Agent Creation without Workflow)
The most distinctive feature of AutoAgent is its natural language customization capability. Unlike other agent frameworks, AutoAgent allows you to create tools, agents, and workflows using natural language alone. Simply choose agent editor or workflow editor mode to start your journey of building agents through conversations.
You can use agent editor as shown in the following figure.
Input what kind of agent you want to create. |
Automated agent profiling. |
Output the agent profiles. |
Create the desired tools. |
Input what do you want to complete with the agent. (Optional) |
Create the desired agent(s) and go to the next step. |
3. workflow editor (Agent Creation with Workflow)
You can also create the agent workflows using natural language description with the workflow editor mode, as shown in the following figure. (Tips: this mode does not support tool creation temporarily.)
Input what kind of workflow you want to create. |
Automated workflow profiling. |
Output the workflow profiles. |
Input what do you want to complete with the workflow. (Optional) |
Create the desired workflow(s) and go to the next step. |
⚡ Quick Start
Installation
AutoAgent Installation
git clone https://github.com/HKUDS/AutoAgent.git
cd AutoAgent
pip install -e .
Docker Installation
We use Docker to containerize the agent-interactive environment. So please install Docker first. You don't need to manually pull the pre-built image, because we have let Auto-Deep-Research automatically pull the pre-built image based on your architecture of your machine.
API Keys Setup
Create an environment variable file, just like .env.template, and set the API keys for the LLMs you want to use. Not every LLM API Key is required, use what you need.
# Required Github Tokens of your own
GITHUB_AI_TOKEN=
# Optional API Keys
OPENAI_API_KEY=
DEEPSEEK_API_KEY=
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
HUGGINGFACE_API_KEY=
GROQ_API_KEY=
XAI_API_KEY=
Start with CLI Mode
[🚨 News: ] We have updated a more easy-to-use command to start the CLI mode and fix the bug of different LLM providers from issues. You can follow the following steps to start the CLI mode with different LLM providers with much less configuration.
Command Options:
You can run auto main to start full part of AutoAgent, including user mode, agent editor and workflow editor. Btw, you can also run auto deep-research to start more lightweight user mode, just like the Auto-Deep-Research project. Some configuration of this command is shown below.
--container_name: Name of the Docker container (default: 'deepresearch')--port: Port for the container (default: 12346)COMPLETION_MODEL: Specify the LLM model to use, you should follow the name of Litellm to set the model name. (Default:claude-3-5-sonnet-20241022)DEBUG: Enable debug mode for detailed logs (default: False)API_BASE_URL: The base URL for the LLM provider (default: None)FN_CALL: Enable function calling (default: None). Most of time, you could ignore this option because we have already set the default value based on the model name.git_clone: Clone the AutoAgent repository to the local environment (only support with theauto maincommand, default: True)test_pull_name: The name of the test pull. (only support with theauto maincommand, default: 'autoagent_mirror')
More details about git_clone and test_pull_name]
In the agent editor and workflow editor mode, we should clone a mirror of the AutoAgent repository to the local agent-interactive environment and let our AutoAgent automatically update the AutoAgent itself, such as creating new tools, agents and workflows. So if you want to use the agent editor and workflow editor mode, you should set the git_clone to True and set the test_pull_name to 'autoagent_mirror' or other branches.
auto main with different LLM Providers
Then I will show you how to use the full part of AutoAgent with the auto main command and different LLM providers. If you want to use the auto deep-research command, you can refer to the Auto-Deep-Research project for more details.
Anthropic
- set the
ANTHROPIC_API_KEYin the.envfile.
ANTHROPIC_API_KEY=your_anthropic_api_key
- run the following command to start Auto-Deep-Research.
auto main # default model is claude-3-5-sonnet-20241022
OpenAI
- set the
OPENAI_API_KEYin the.envfile.
OPENAI_API_KEY=your_openai_api_key
- run the following command to start Auto-Deep-Research.
COMPLETION_MODEL=gpt-4o auto main
Mistral
- set the
MISTRAL_API_KEYin the.envfile.
MISTRAL_API_KEY=your_mistral_api_key
- run the following command to start Auto-Deep-Research.
COMPLETION_MODEL=mistral/mistral-large-2407 auto main
Gemini - Google AI Studio
- set the
GEMINI_API_KEYin the.envfile.
GEMINI_API_KEY=your_gemini_api_key
- run the following command to start Auto-Deep-Research.
COMPLETION_MODEL=gemini/gemini-2.0-flash auto main
Huggingface
- set the
HUGGINGFACE_API_KEYin the.envfile.
HUGGINGFACE_API_KEY=your_huggingface_api_key
- run the following command to start Auto-Deep-Research.
COMPLETION_MODEL=huggingface/meta-llama/Llama-3.3-70B-Instruct auto main
Groq
- set the
GROQ_API_KEYin the.envfile.
GROQ_API_KEY=your_groq_api_key
- run the following command to start Auto-Deep-Research.
COMPLETION_MODEL=groq/deepseek-r1-distill-llama-70b auto main
OpenAI-Compatible Endpoints (e.g., Grok)
- set the
OPENAI_API_KEYin the.envfile.
OPENAI_API_KEY=your_api_key_for_openai_compatible_endpoints
- run the following command to start Auto-Deep-Research.
COMPLETION_MODEL=openai/grok-2-latest API_BASE_URL=https://api.x.ai/v1 auto main
OpenRouter (e.g., DeepSeek-R1)
We recommend using OpenRouter as LLM provider of DeepSeek-R1 temporarily. Because official API of DeepSeek-R1 can not be used efficiently.
- set the
OPENROUTER_API_KEYin the.envfile.
OPENROUTER_API_KEY=your_openrouter_api_key
- run the following command to start Auto-Deep-Research.
COMPLETION_MODEL=openrouter/deepseek/deepseek-r1 auto main
DeepSeek
- set the
DEEPSEEK_API_KEYin the.envfile.
DEEPSEEK_API_KEY=your_deepseek_api_key
- run the following command to start Auto-Deep-Research.
COMPLETION_MODEL=deepseek/deepseek-chat auto main
After the CLI mode is started, you can see the start page of AutoAgent:
Start Page of AutoAgent.
Tips
Import browser cookies to browser environment
You can import the browser cookies to the browser environment to let the agent better access some specific websites. For more details, please refer to the cookies folder.
Add your own API keys for third-party Tool Platforms
If you want to create tools from the third-party tool platforms, such as RapidAPI, you should subscribe tools from the platform and add your own API keys by running process_tool_docs.py.
python process_tool_docs.py
More features coming soon! 🚀 Web GUI interface under development.
☑️ Todo List
AutoAgent is continuously evolving! Here's what's coming:
- 📊 More Benchmarks: Expanding evaluations to SWE-bench, WebArena, and more
- 🖥️ GUI Agent: Supporting Computer-Use agents with GUI interaction
- 🔧 Tool Platforms: Integration with more platforms like Composio
- 🏗️ Code Sandboxes: Supporting additional environments like E2B
- 🎨 Web Interface: Developing comprehensive GUI for better user experience
Have ideas or suggestions? Feel free to open an issue! Stay tuned for more exciting updates! 🚀
🔬 How To Reproduce the Results in the Paper
GAIA Benchmark
For the GAIA benchmark, you can run the following command to run the inference.
cd path/to/AutoAgent && sh evaluation/gaia/scripts/run_infer.sh
For the evaluation, you can run the following command.
cd path/to/AutoAgent && python evaluation/gaia/get_score.py
Agentic-RAG
For the Agentic-RAG task, you can run the following command to run the inference.
Step1. Turn to this page and download it. Save them to your datapath.
Step2. Run the following command to run the inference.
cd path/to/AutoAgent && sh evaluation/multihoprag/scripts/run_rag.sh
Step3. The result will be saved in the evaluation/multihoprag/result.json.
📖 Documentation
A more detailed documentation is coming soon 🚀, and we will update in the Documentation page.
🤝 Join the Community
We want to build a community for AutoAgent, and we welcome everyone to join us. You can join our community by:
- Join our Slack workspace - Here we talk about research, architecture, and future development.
- Join our Discord server - This is a community-run server for general discussion, questions, and feedback.
- Read or post Github Issues - Check out the issues we're working on, or add your own ideas.
Misc
🙏 Acknowledgements
Rome wasn't built in a day. AutoAgent stands on the shoulders of giants, and we are deeply grateful for the outstanding work that came before us. Our framework architecture draws inspiration from OpenAI Swarm, while our user mode's three-agent design benefits from Magentic-one's insights. We've also learned from OpenHands for documentation structure and many other excellent projects for agent-environment interaction design, among others. We express our sincere gratitude and respect to all these pioneering works that have been instrumental in shaping AutoAgent.
🌟 Cite
@misc{AutoAgent,
title={{AutoAgent: A Fully-Automated and Zero-Code Framework for LLM Agents}},
author={Jiabin Tang, Tianyu Fan, Chao Huang},
year={2025},
eprint={202502.05957},
archivePrefix={arXiv},
primaryClass={cs.AI},
url={https://arxiv.org/abs/2502.05957},
}
Repo liên quan
Dify is an open-source LLM app platform that packages a visual workflow/agent builder, RAG pipeline, model provider management, and app-level APIs into one self-hostable (or cloud) stack, aimed at teams who want to skip stitching those pieces together themselves.
JavaGuide là một repository tổng hợp kiến thức phỏng vấn Java và backend được duy trì bởi cộng đồng, bao phủ gần như toàn bộ các chủ đề mà một ứng viên backend cần nắm vững: từ Java core (collections, concurrency, JVM), hệ điều hành và mạng máy tính, cho đến cơ sở dữ liệu (MySQL, Redis), kiến trúc phân tán, và các công cụ devops như Docker, Git. Điểm mạnh rõ rệt là mỗi phần đều đi kèm bài tổng hợp câu hỏi phỏng vấn được đánh dấu "必看" (bắt buộc đọc), kèm theo phân tích source code chi tiết cho các cấu trúc dữ liệu phổ biến như HashMap, ConcurrentHashMap, và các topic nâng cao như AQS, JMM. Repository cũng mở rộng sang AI application development với một repo riêng (AIGuide) về LLM, Agent, RAG và MCP, phản ánh xu hướng hiện tại trong việc tuyển dụng backend. Nhược điểm là nội dung rất dàn trải — hơn 100 file markdown trải dài từ BigDecimal đến Elasticsearch, nên nếu bạn đã có nền tảng vững ở một số phần, việc lọc đúng nội dung cần ôn tập đòi hỏi thêm effort. Cá nhân tôi thấy đây là tài liệu tốt nhất để "làm quen" với toàn cảnh backend Java trước khi đi sâu vào từng chủ đề riêng lẻ, nhưng không nên dùng nó thay cho việc đọc source code thật hoặc tài liệu chính thức.
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
Shubhamsaboo/awesome-llm-apps is a substantial collection of over 100 open-source AI agents, agent skills, and Retrieval Augmented Generation (RAG) applications. Hand-built, end-to-end tested, and licensed under Apache-2.0, this Python-based repository supports a range of LLMs including Claude, Gemini, GPT, DeepSeek, Llama, and Qwen. It offers a wide array of examples, from single-file starter agents and advanced multi-agent teams to voice AI agents, generative UIs, autonomous game-playing agents, and various RAG implementations. The collection also includes LLM optimization tools, fine-tuning recipes, and crash courses on agent frameworks, providing practical, ready-to-deploy solutions for common LLM development challenges.
Trả lời nhanh
Cùng nhóm AI Tools còn repo nào?
HKUDS/AutoAgent thuộc nhóm AI Tools trên TopGit, cùng 2 topic GitHub. Trang Trending và Topics liệt kê các repo cùng số sao và cùng ngôn ngữ để so sánh.
Đọc thêm về HKUDS/AutoAgent ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/HKUDS/AutoAgent là nguồn chính thức.
HKUDS/AutoAgent có phải mã nguồn mở không?
Có — HKUDS/AutoAgent phát hành theo license MIT, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/HKUDS/AutoAgent.
HKUDS/AutoAgent có trang demo không?
Dự án có trang chủ ở https://arxiv.org/abs/2502.05957. Tab "Readme" ở trang này thường có ảnh chụp và hướng dẫn bắt đầu nhanh.
HKUDS/AutoAgent dùng license gì?
HKUDS/AutoAgent phát hành theo license MIT. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
HKUDS/AutoAgent là gì?
HKUDS/AutoAgent (HKUDS/AutoAgent) là dự án Python trên GitHub. Theo mô tả gốc: "AutoAgent: Fully-Automated and Zero-Code LLM Agent Framework"
Vì sao HKUDS/AutoAgent được xếp vào nhóm AI Tools?
TopGit xếp HKUDS/AutoAgent vào nhóm AI Tools dựa trên GitHub topics và mô tả của repo (gắn thẻ: "agent", "llms"). Việc phân loại dựa trên metadata thật của repo, không phải đoán theo cảm tính biên tập.
Đọc đầy đủ README ở tab phía trên.
Chưa chắc AutoAgent có hợp với bạn?
Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về AutoAgent.