RepoMaster

RepoMaster

RepoMaster: The open-source AI agent that masters GitHub. It turns any code repository into a powerful tool, achieving a new level of autonomous task-solving. An open alternative to Claude-Code.

Stars: 167

Visit
 screenshot

RepoMaster is an AI agent that leverages GitHub repositories to solve complex real-world tasks. It transforms how coding tasks are solved by automatically finding the right GitHub tools and making them work together seamlessly. Users can describe their tasks, and RepoMaster's AI analysis leads to auto discovery and smart execution, resulting in perfect outcomes. The tool provides a web interface for beginners and a command-line interface for advanced users, along with specialized agents for deep search, general assistance, and repository tasks.

README:

RepoMaster Logo

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

πŸš€ Turn GitHub Repositories into Your Personal AI Toolbox

🌐 English | δΈ­ζ–‡

πŸ“° News

  • 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


Quick Start Live Demo Documentation

πŸš€ Overview

🎯 Discover · Understand · Execute - Make Open Source Work for You

RepoMaster transforms how you solve coding tasks by automatically finding the right GitHub tools and making them work together seamlessly. Just describe what you want, and watch as open source repositories become your intelligent assistants.

πŸ’¬ Describe Task β†’ 🧠 AI Analysis β†’ πŸ” Auto Discovery β†’ ⚑ Smart Execution β†’ βœ… Perfect Results


RepoMaster performance


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

πŸ’¬ Natural Language β†’ πŸ€– Autonomous Execution β†’ ✨ Real Results

Simply describe your task in natural language. RepoMaster's AI automatically analyzes your request, intelligently routes to optimal solution paths, and orchestrates the perfect GitHub tools to bring your ideas to life.

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

From "Writing Code from Scratch" β†’ To "Making Open Source Work"

🎨 Neural Style Transfer Case Study

πŸ“· Original Image

🎨 Style Reference

✨ Final Result

🎬 Complete Execution Demo | πŸ“Ί YouTube Demo

https://github.com/user-attachments/assets/a21b2f2e-a31c-4afd-953d-d143beef781a

Complete process of RepoMaster autonomously executing neural style transfer task

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


🀝 Contributing

🌟 Join Our Mission to Revolutionize Code Intelligence

We believe in the power of community-driven innovation. Your contributions help make RepoMaster smarter, faster, and more capable.

πŸš€ Ways to Contribute

πŸ› οΈ Development Setup

Quick Developer Environment Setup
# Fork and clone the repository
git clone https://github.com/your-username/RepoMaster.git
cd RepoMaster

# Install development dependencies
pip install -e ".[dev]"

# Set up pre-commit hooks for code quality
pre-commit install

# Run tests to ensure everything works
pytest tests/

# Start developing! πŸš€

πŸ“‹ New to open source? Check our Contributing Guidelines for detailed instructions and best practices.


πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ“ž Support


πŸ™ Acknowledgments

Special thanks to:


🌐 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


πŸ“– 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}
}

⭐ If RepoMaster helps you, please give us a star!

Made with ❀️ by the QuantaAlpha Team

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for RepoMaster

Similar Open Source Tools

For similar tasks

For similar jobs