RepoMaster

---

🚀 Overview

---

Quick Start

Installation

git clone https://github.com/QuantaAlpha/RepoMaster.git
cd RepoMaster
pip install -r requirements.txt

Configuration

Copy the example configuration file and customize it with your API keys:

cp configs/env.example configs/.env
# Edit the configuration file with your preferred editor
nano configs/.env  # or use vim, code, etc.

Required API Keys:

# Primary AI Provider (Required)
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-5

# External Services (Required for deep search functionality)
SERPER_API_KEY=your_serper_key          # Google search integration
JINA_API_KEY=your_jina_key              # Web content extraction

# Optional: Additional AI Providers
# ANTHROPIC_API_KEY=your_claude_key     # Anthropic Claude support
# DEEPSEEK_API_KEY=your_deepseek_key    # DeepSeek integration
# GEMINI_API_KEY=your_gemini_key        # Google Gemini support

💡 Tip: The configs/env.example file contains all available configuration options with detailed comments.

Launch

Web Interface (Recommended for beginners):

python launcher.py --mode frontend
# Access the web dashboard at: http://localhost:8501

Command Line Interface (Recommended for advanced users):

python launcher.py --mode backend --backend-mode unified
# Provides intelligent multi-agent orchestration via terminal

Specialized Agent Access:

python launcher.py --mode backend --backend-mode deepsearch      # Deep Search Agent
python launcher.py --mode backend --backend-mode general_assistant  # Programming Assistant
python launcher.py --mode backend --backend-mode repository_agent   # Repository Agent

📘 Need help? Check our comprehensive User Guide for advanced configuration, troubleshooting, and detailed usage examples.

---

🎯 Quick Demo

Task Description	RepoMaster Action	Result
“Help me scrape product prices from this webpage”	🔍 Find scraping tools → 🔧 Auto-configure → ✅ Extract data	Structured CSV output
“Transform photo into Van Gogh style”	🔍 Find style transfer repos → 🎨 Process images → ✅ Generate art	Artistic masterpiece

🎨 Neural Style Transfer Case Study

🎬 Complete Execution Demo | 📺 YouTube Demo

For advanced usage, configuration options, and troubleshooting, see our User Guide.

---

🤝 Contributing

🚀 Ways to Contribute

• 🐛 Bug Reports: Help us identify and fix issues by reporting them.
• 💡 Feature Requests: Have a great idea? Suggest a new feature.

---

🙏 Acknowledgments

Special thanks to:

• AutoGen - Multi-agent framework
• OpenHands - Software engineering agents
• SWE-Agent - GitHub issue resolution
• MLE-Bench - ML engineering benchmarks

---

🌐 About QuantaAlpha

• QuantaAlpha was founded in April 2025 by a team of professors, postdocs, PhDs, and master’s students from Tsinghua University, Peking University, CAS, CMU, HKUST, and more.

🌟 Our mission is to explore the “quantum” of intelligence and pioneer the “alpha” frontier of agent research — from CodeAgents to self-evolving intelligence, and further to financial and cross-domain specialized agents, we are committed to redefining the boundaries of AI.

✨ In 2025, we will continue to produce high-quality research in the following directions:

• CodeAgent: End-to-end autonomous execution of real-world tasks
• DeepResearch: Deep reasoning and retrieval-augmented intelligence
• Agentic Reasoning / Agentic RL: Agent-based reasoning and reinforcement learning
• Self-evolution and collaborative learning: Evolution and coordination of multi-agent systems

📢 We welcome students and researchers interested in these directions to join us!

🔗 Team Homepage: QuantaAlpha 📧 Email: [email protected]

---

📖 Citation

If you find RepoMaster useful in your research, please cite our work:

@article{wang2025repomaster,
  title={RepoMaster: Autonomous Exploration and Understanding of GitHub Repositories for Complex Task Solving},
  author={Huacan Wang and Ziyi Ni and Shuo Zhang and Lu, Shuo and Sen Hu and  Ziyang He and Chen Hu and Jiaye Lin and Yifu Guo and Ronghao Chen and Xin Li and Daxin Jiang and Yuntao Du and Pin Lyu},
  journal={arXiv preprint arXiv:2505.21577},
  year={2025},
  doi={10.48550/arXiv.2505.21577},
  url={https://arxiv.org/abs/2505.21577}
}

---

Star History

---