Quick Start

Once installed, you’re three steps from chatting.

1. Add your API key

If you used the install script, this is already done. Otherwise, add your key to ~/.kyber/.env:

KYBER_PROVIDERS__OPENROUTER__API_KEY=sk-or-v1-your-key-here

Then set your provider and model in ~/.kyber/config.json:

{
  "providers": {
    "openrouter": {
      "chatModel": "google/gemini-3-flash-preview"
    }
  },
  "agents": {
    "defaults": {
      "provider": "openrouter"
    }
  }
}

Notice that API keys never go in config.json — they live in .env with restricted file permissions. See Security for details.

2. Chat

Send a single message:

kyber agent -m "Hello from Kyber"

Or start an interactive session:

kyber agent

3. Start the gateway (for chat channels)

If you want to use Discord, Telegram, or WhatsApp:

kyber gateway

The gateway runs the agent and all enabled chat channels on port 18790.

Start the dashboard

To manage configuration from a web UI:

kyber dashboard

Opens at http://127.0.0.1:18890. A bearer token is generated automatically on first run. The dashboard lets you configure providers with model dropdowns, manage channels, and restart services.

Check status

kyber status

Shows your configured provider, model, enabled channels, workspace path, and whether your secrets file is set up correctly.

Introduction Providers