Installation

Get Kollab up and running on your system.

01 Install With uv (Recommended)

uv installs Kollab in its own isolated environment, and fetches Python 3.12 itself if you don't have it. Don't have uv? See the uv installation guide.

# Install Kollab

uv tool install kollab

02 Install Script (No Python Needed)

The script installs a single-file kollab binary into ~/.local/bin on macOS 11 or later and on Linux (glibc 2.28 or later), x86_64 or arm64. It checks the download's SHA-256 and that the binary starts before it replaces anything. Anywhere else it installs the Python package with uv, pipx or pip.

# Install the binary

curl -sS https://raw.githubusercontent.com/kollaborai/kollab/main/install.sh | bash

03 Homebrew (Apple Silicon Macs)

On an Apple Silicon Mac you can install from the Kollabor tap.

# Add the Kollabor tap

brew tap kollaborai/tap

# Install Kollab

brew install kollaborai/tap/kollab

04 pipx or pip

pipx also keeps Kollab in its own isolated environment. pip installs into the active Python, so it inherits whatever is already there. Both need Python 3.12 or later.

# Install from PyPI

pipx install kollab

pip install kollab

Windows users: Make sure you have Python 3.12+ installed and added to your PATH.

05 Verify Installation

Confirm Kollab is installed correctly by checking the version, then start it. With no provider set up yet, Kollab opens the /setup wizard by itself.

kollab --version

kollab

System Requirements

macOS / Linux

Python 3.12 or higher (uv fetches it; the install script needs none)
Terminal with ANSI color support
100MB free disk space

Windows

Windows 10 or later
Python 3.12 or higher
Windows Terminal recommended