🌟 RepoMaster: Make 100M+ GitHub Repositories Work for You

🚀 Turn GitHub Repositories into Your Personal AI Toolbox

🌐 English | 中文

📰 News

• 2025.09.19 🎉 Excited to announce that our papers have been accepted to NeurIPS 2025 — RepoMaster as a Spotlight (≈3.2%) and SE-Agent as a Poster (≈24.52%)!
• 2025.08.28 🎉 We open-sourced RepoMaster — an AI agent that leverages GitHub repos to solve complex real-world tasks.
• 2025.08.26 🎉 We open-sourced GitTaskBench — a repo-level benchmark & tooling suite for real-world tasks.
• 2025.08.10 🎉 We open-sourced SE-Agent — a self-evolution trajectory framework for multi-step reasoning.

🔗 Ecosystem: RepoMaster · GitTaskBench · SE-Agent · Team Homepage

🚀 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

🎨 Neural Style Transfer Case Study

📷 Original Image

🎨 Style Reference

✨ Final Result

🎬 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: quantaalpha.ai@gmail.com

📖 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