Installation

Requirements

• Python 3.11–3.14 (3.11 or 3.12 on Intel Macs). The installer and kolega-code update choose a compatible version for you, and uv downloads one if none is installed.
• An API key for at least one supported provider

uv tool install uses uv’s newest Python unless you choose one. Pass a supported version when that is 3.15 or newer, and always on Intel Macs: the document conversion dependency has no Intel wheels for Python 3.14, and its 3.13 wheels require macOS 13 or later.

uv tool install --python 3.14 kolega-code
# Intel Mac:
uv tool install --python 3.12 kolega-code

Install

Installer

curl -fsSL https://kolega.ai/code/install.sh | sh

uv

uv tool install kolega-code

From source

git clone https://github.com/kolega-ai/kolega-code.git
cd kolega-code
uv sync --extra dev
uv run kolega-code --version

Note

The installer supports macOS and Linux. On Windows, use WSL for the terminal UI or install directly with uv tool install kolega-code.

Verify the install

Once installed, confirm the CLI is on your PATH:

kolega-code --version

Then check your project configuration:

kolega-code doctor --project .

doctor reports your project path, where session state is stored, whether Textual is installed, your stored model selection, and whether the required API keys are present. See doctor for details.

Upgrade or uninstall

If you installed with the script or uv tool install, update the CLI with the built-in command:

kolega-code update

Running the installer again also updates an existing install to the latest released version. To uninstall, use uv:

uv tool uninstall kolega-code

Next steps

1. Install the CLI (above).

2. Connect a provider/model — either with first-run onboarding or the in-app Settings screen, or via environment variables.

3. Run your first session — follow the Quick Start.