Installation

Dependencies and Machine Configuration

Before pip install, you need to pre-install on your machine:

• Git
• Python>=3.12
• Docker

The docker dependency means running on containerized cluster pods is NOT feasible. Usually running one instances takes 4 GPUs with 16GB RAM, and the large repos like ClickHouse takes even 10 CPUs and 64GB RAM... The disk I/O rate is also critical for docker commit operations, so SSD (>= 1TB) disk is always preferred. In a word, the performance of your machine directly determines the success rate.

The next sub-section helps you install and configure Docker, the most complicated dependency, on your machine.

Install Docker Service

Now RepoLaunch supports Linux, Windows and Android build. Android images are built from Linux images, so the settings are the same as Linux. Linux images and Android images can run on linux docker and Docker Desktop (windows/macos).

Linux install

sudo apt update
sudo apt install -y ca-certificates curl

# Add Docker's official GPG key
sudo install -m 0755 -d /etc/apt/keyrings

sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
    -o /etc/apt/keyrings/docker.asc

sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add Docker repository
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

# Install Docker Engine
sudo apt update
sudo apt install -y \
    docker-ce \
    docker-ce-cli \
    containerd.io \
    docker-buildx-plugin \
    docker-compose-plugin

sudo systemctl enable --now docker
sudo systemctl enable --now containerd
sudo usermod -aG docker $USER
docker ps
docker image ls

MacOS install

Download and run the Docker Desktop installer from Docker website. Open Docker Desktop.

Verify docker is running normally in the terminal:

docker ps
docker image ls

Windows install.

Please refer to Windows Container Setup

Finally, Install RepoLaunch

Choose one of the installation methods below.

Install from Source Code

git clone https://github.com/microsoft/RepoLaunch
cd RepoLaunch
pip install -e .

Install from PyPI

pip install repolaunch

Verify the installation:

python -c "from launch import api; print(api.__file__)"

The command should print the path to launch/api.py, for example venv_path/lib/python3.12/site-packages/launch/api.py.