Installation

One-liner (recommended)

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

The install script handles everything automatically:

1. Detects your OS (macOS, Linux, WSL)
2. Installs uv if not already available
3. Installs kyber-chat from PyPI via uv tool install
4. Walks you through provider selection and API key setup
5. Writes ~/.kyber/config.json (settings) and ~/.kyber/.env (secrets) with locked-down permissions
6. 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:

uv tool 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:

uv tool install kyber-chat

Then initialize:

kyber onboard

This creates:

• ~/.kyber/config.json — non-sensitive settings (provider, model, channels, etc.)
• ~/.kyber/.env — secrets file with 600 permissions (API keys, tokens)
• ~/.kyber/workspace/ — agent workspace with template files

From source

For development:

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

Requirements

• An API key from any supported provider
• uv is installed automatically by the install script, or get it from astral.sh/uv