<div align="center"> <img src="docs/assets/images/RepoMaster.png" alt="RepoMaster Logo" width="600"/> <h1 align="center" style="color: #2196F3; font-size: 24px; font-weight: 600; margin: 20px 0; line-height: 1.4;"> 🌟 RepoMaster: <span style="color: #555; font-weight: 400; font-size: 18px;"><em>Make 100M+ GitHub Repositories Work for You</em></span> </h1> <p align="center" style="font-size: 16px; color: #666; margin: 10px 0; font-weight: 500;"> 🚀 <em>Turn GitHub Repositories into Your Personal AI Toolbox</em> </p> <p style="margin: 20px 0;"> <a href="https://arxiv.org/pdf/2505.21577"><img src="https://img.shields.io/badge/arXiv-2505.21577-B31B1B.svg?style=flat-square&logo=arxiv&logoColor=white" /></a> <a href="https://github.com/openai/mle-bench"><img src="https://img.shields.io/badge/Benchmark-MLE--Bench-FF6B35.svg?style=flat-square&logo=openai&logoColor=white" /></a> <a href="https://github.com/QuantaAlpha/GitTaskBench"><img src="https://img.shields.io/badge/Benchmark-GitTaskBench-4A90E2.svg?style=flat-square&logo=github&logoColor=white" /></a> <a href="#"><img src="https://img.shields.io/badge/License-MIT-00A98F.svg?style=flat-square&logo=opensourceinitiative&logoColor=white" /></a> <a href="#"><img src="https://img.shields.io/github/stars/QuantaAlpha/RepoMaster?style=flat-square&logo=github&color=FFD700" /></a> </p>  <p style="font-size: 16px; color: #666; margin: 15px 0; font-weight: 500;"> 🌐 <a href="README.md" style="text-decoration: none; color: #0066cc;">English</a> | <a href="README_CN.md" style="text-decoration: none; color: #0066cc;">中文</a> </p> </div>

📰 News

2025.09.19 🎉 Excited to announce that our papers have been accepted to <u>NeurIPS 2025</u> — 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

<div align="center"> <h3>🎯 Discover · Understand · Execute - Make Open Source Work for You</h3> <p style="font-size: 16px; color: #666; max-width: 800px; margin: 0 auto; line-height: 1.6;"> RepoMaster transforms how you solve coding tasks by <strong>automatically finding the right GitHub tools</strong> and making them work together seamlessly. Just describe what you want, and watch as open source repositories become your intelligent assistants. </p> <p style="font-size: 16px; color: #2196F3; max-width: 800px; margin: 15px auto; line-height: 1.6; font-weight: 600;"> 💬 Describe Task → 🧠 AI Analysis → 🔍 Auto Discovery → ⚡ Smart Execution → ✅ Perfect Results </p> </div> <br/> <img src="docs/assets/images/performance_01.jpg" alt="RepoMaster performance" style="background-color: #ffffff; display: block; margin: 0 auto;" />

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

<div align="center"> <h3>💬 Natural Language → 🤖 Autonomous Execution → ✨ Real Results</h3> <p style="font-size: 16px; color: #666; margin: 20px 0; max-width: 700px;"> 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. </p> </div>

| 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 |

<div align="center" style="background: linear-gradient(135deg, #FF6B6B 0%, #4ECDC4 100%); border-radius: 15px; padding: 20px; margin: 20px auto; max-width: 700px;"> <p style="color: white; margin: 5px 0; font-size: 16px;">From <strong>"Writing Code from Scratch"</strong> → To <strong>"Making Open Source Work"</strong></p> </div>

🎨 Neural Style Transfer Case Study

<div align="center"> <table style="border: none; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 15px; padding: 20px; margin: 20px 0;"> <tr> <td align="center" width="33%" style="padding: 10px;"> <h4 style="color: white; margin-bottom: 10px;">📷 Original Image</h4> <div style="background: white; border-radius: 10px; padding: 5px;"> <img src="docs/assets/images/origin.jpg" width="180px" style="border-radius: 5px;" /> </div> </td> <td align="center" width="33%" style="padding: 10px;"> <h4 style="color: white; margin-bottom: 10px;">🎨 Style Reference</h4> <div style="background: white; border-radius: 10px; padding: 5px;"> <img src="docs/assets/images/style.jpg" width="180px" style="border-radius: 5px;" /> </div> </td> <td align="center" width="33%" style="padding: 10px;"> <h4 style="color: white; margin-bottom: 10px;">✨ Final Result</h4> <div style="background: white; border-radius: 10px; padding: 5px;"> <img src="docs/assets/images/transfer.jpg" width="180px" style="border-radius: 5px;" /> </div> </td> </tr> </table> </div>

🎬 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

</div>

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

🤝 Contributing

<div align="center"> <h3>🌟 Join Our Mission to Revolutionize Code Intelligence</h3> <p style="color: #666; margin: 15px 0;"> We believe in the power of community-driven innovation. Your contributions help make RepoMaster smarter, faster, and more capable. </p> </div>

🚀 Ways to Contribute

🐛 Bug Reports: Help us identify and fix issues by reporting them.
💡 Feature Requests: Have a great idea? [Suggest a new feature](https://github.com/Quant

RepoMaster

Install / Use

README