Installation

One-liner (recommended)

curl -fsSL https://kyber.chat/install.sh | bash

The install script handles everything automatically:

Detects your OS (macOS, Linux, WSL)
Installs Python 3.11+ if missing
Installs uv or pipx if neither is available
Installs kyber-chat from PyPI
Walks you through provider selection and API key setup
Writes ~/.kyber/config.json and creates the workspace
Optionally sets up systemd (Linux) or launchd (macOS) services

Windows

The install script is a bash script and doesn’t run natively on Windows. Use one of these options:

WSL (recommended)

Install Windows Subsystem for Linux if you haven’t already:

wsl --install

Then open your WSL terminal and run the one-liner as normal:

curl -fsSL https://kyber.chat/install.sh | bash

The installer detects WSL automatically and sets up systemd services just like a regular Linux install.

Git Bash / manual

If you’d rather not use WSL, install the package directly with Python:

pip install kyber-chat
kyber onboard

Note that system services (auto-start on boot) are not supported outside of WSL on Windows. You’ll need to start the gateway and dashboard manually:

kyber gateway &
kyber dashboard &

Manual install

If you prefer to install manually:

pipx install kyber-chat    # recommended — isolated environment
uv tool install kyber-chat  # alternative using uv
pip install kyber-chat      # plain pip (works but not isolated)

Then initialize:

kyber onboard

This creates ~/.kyber/config.json and the workspace at ~/.kyber/workspace/.

From source

For development:

git clone git@github.com:cyph3rasi/kyber.git
cd kyber
pip install -e .

Requirements

Python 3.11 or newer
An API key from any supported provider

Introduction Quick Start