Skip to main content
Get RepoMaster up and running in minutes. This guide will walk you through installation, configuration, and running your first task.

​
What is RepoMaster?

RepoMaster is an AI agent that transforms how you solve coding tasks by automatically finding the right GitHub tools and making them work together seamlessly. Simply describe what you want, and watch as open source repositories become your intelligent assistants.
RepoMaster features a sophisticated multi-agent system where specialized AI agents work in harmony:
  • Deep Search Agent - Advanced web research and data retrieval
  • Programming Assistant Agent - Code generation and debugging
  • Repository Exploration Agent - Autonomous code exploration and task execution

​
Prerequisites

Before you begin, ensure you have:
  • Python 3.11 or higher
  • Git installed
  • Internet connection for repository cloning
  • API keys for required services (see configuration below)
1

Clone the repository

Clone RepoMaster from GitHub and navigate to the project directory:
git clone https://github.com/QuantaAlpha/RepoMaster.git
cd RepoMaster
2

Install dependencies

Install all required Python packages using pip:
pip install -r requirements.txt
This installs key dependencies including:
  • pyautogen~=0.7.6 - Multi-agent framework
  • streamlit - Web interface
  • langchain and langchain-community - LLM orchestration
  • pandas, beautifulsoup4, and other utilities
3

Configure API keys

Copy the example configuration file and add your API keys:
cp configs/env.example configs/.env
Edit configs/.env with your preferred text editor:
nano configs/.env  # or use vim, code, etc.
Required configuration:
# Primary AI Provider (choose one)
DEFAULT_API_PROVIDER=openai

# OpenAI Configuration
OPENAI_API_KEY=your_openai_api_key_here
OPENAI_MODEL=gpt-5
OPENAI_BASE_URL=https://api.openai.com/v1

# External Services (Required for deep search functionality)
SERPER_API_KEY=your_serper_key    # Get at: https://serper.dev/login
JINA_API_KEY=your_jina_key        # Get at: https://jina.ai/
The SERPER_API_KEY and JINA_API_KEY are required for RepoMaster’s deep search capabilities. Without these keys, some features will not work.
Optional AI providers:
# Claude Configuration
ANTHROPIC_API_KEY=your_claude_key
ANTHROPIC_MODEL=claude-4-sonnet
4

Launch RepoMaster

Choose your preferred interface:
5

Run your first task

Now you’re ready to solve tasks with RepoMaster! Here’s a simple example:Example task: Neural style transfer
Transform my photo into Van Gogh style using neural style transfer
RepoMaster will:
  1. Analyze your task requirements
  2. Search for appropriate style transfer repositories
  3. Clone and configure the tools
  4. Execute the task autonomously
  5. Deliver the artistic result
For your first task, try something simple like:
  • “Help me scrape product prices from a webpage”
  • “Generate a QR code for my website”
  • “Convert a CSV file to JSON format”

​
Quick command reference

Here are the most common commands you’ll use: 
# Launch web dashboard (default port: 8501)
python launcher.py --mode frontend

# Custom port and host
python launcher.py --mode frontend --streamlit-port 8502 --streamlit-host 0.0.0.0

# Increase file upload limit to 500MB
python launcher.py --mode frontend --max-upload-size 500

​
What’s next?

Now that you have RepoMaster running, explore these resources:

Installation guide

Detailed installation instructions and troubleshooting

Configuration

Advanced configuration options and API setup

Usage examples

Real-world examples and use cases

API reference

Complete API documentation

​
Need help?

If you encounter any issues:

Build docs developers (and LLMs) love

Get started for freeTalk to us