6.9 KiB
MetaChain: Fully-Automated, Zero-Code Agent Framework
Welcome to MetaChain! MetaChain is a Fully-Automated and highly Self-Developing framework that enables users to create and deploy LLM agents through Natural Language Alone.
✨Features
- Top 1 🏆 open-sourced method in GAIA benchmark, with performance comparable to OpenAI's Deep Research.
- Top 1 🏆 Agentic-RAG with native self-managing vector database, outperforming LangChain.
- Create ready-to-use tools, agents and workflows using natural language only.
- Support for ALL LLMs (OpenAI, Anthropic, vLLM, Grok, Huggingface ...)
- Support both function-calling and ReAct.
- Dynamic, extensible, and lightweight - your personal agent system.
- Try it now!
🔥 News
- [2025, Feb 10]: 🎉🎉We've released MetaChain!, including framework, evaluation codes and CLI mode!
⚡ Quick Start
Installation
MetaChain Installation
git clone https://github.com/HKUDS/MetaChain.git
cd MetaChain
pip install -e .
Docker Installation
We use Docker to containerize the agent-interactive environment. So please install Docker first. And pull the pre-built image with the following command.
docker pull tjbtech1/metachain:latest
API Keys Setup
Create a 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
Just run the following command to start the CLI mode. (use shell script cd path/to/MetaChain && sh playground/cli/metachain_cli.sh)
current_dir=$(dirname "$(readlink -f "$0")")
cd $current_dir
cd ../..
export DOCKER_WORKPLACE_NAME=workplace
export EVAL_MODE=True
export BASE_IMAGES=tjbtech1/metachain:latest
export COMPLETION_MODEL=claude-3-5-sonnet-20241022
export DEBUG=False # If you want to see detailed messages of agents' actions, set to True
export MC_MODE=True # If you want to ignore the retry information of LLM connection, set to True
export AI_USER=tjb-tech # Your Github username
port=12345 # The port of the agent-interactive environment
python playground/cli/metachain_cli.py --container_name quick_start --model ${COMPLETION_MODEL} --test_pull_name mirror_branch_0207 --debug --port ${port} --git_clone
After the CLI mode is started, you can see the start page of MetaChain:
🔍 How to Use MetaChain
1. User Mode (SOTA 🏆 Open Deep Research)
MetaChain have a out-of-the-box multi-agent system, which you could choose user mode in the start page to use it. This multi-agent system is a general AI assistant, having the same functionality with OpenAI's Deep Research and the comparable performance with it in GAIA benchmark.
2. Agent Editor
3. Workflow Editor
☑️ Todo List
📖 Documentation
🤝 How to Join the Community
OpenHands is a community-driven project, and we welcome contributions from everyone. We do most of our communication through Slack, so this is the best place to start, but we also are happy to have you contact us on Discord or Github:
- 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.
See more about the community in COMMUNITY.md or find details on contributing in CONTRIBUTING.md.
🙏 Acknowledgements
OpenHands is built by a large number of contributors, and every contribution is greatly appreciated! We also build upon other open source projects, and we are deeply thankful for their work.
For a list of open source projects and licenses used in OpenHands, please see our CREDITS.md file.
🌟 Cite