Repo2Run

Repo2Run

🚀 News

Our paper: "Repo2Run: Automated Building Executable Environment for Code Repository at Scale" has been accepted by **NeurIPS 2025** main track as a **spotlight**!

An LLM-based build agent system that helps manage and automate build processes in containerized environments. This project provides tools for handling dependencies, resolving conflicts, and managing build configurations.

😊 Features

• Docker-based sandbox environment for isolated builds
• Automated dependency management and conflict resolution
• Support for Python version management
• Waiting list and conflict list management for package dependencies
• Error format handling and output collection

Prerequisites

• Python 3.x
• Docker
• Git

Installation

1. Clone the repository:

git clone https://github.com/bytedance/repo2run.git
cd repo2run

1. Install the required dependencies:

pip install -r requirements.txt

🔧 Usage

The main entry point is through the build agent's main script. You can run it with the following arguments:

python build_agent/main.py --full_name  --sha  --root_path  --llm 

Where:

• repository_full_name: The full name of the repository (e.g., user/repo)
• sha: The commit SHA
• root_path: The root path for the build process
• llm_name: The name of the LLM model to use for configuration (default: gpt-4o-2024-05-13)

🔍 Note

💡 For example, you can use the following repository—which is relatively easy to set up—to verify whether there are a