ConfigurationFull Reference

Full Configuration Reference

The complete ~/.kyber/config.json schema with all fields and defaults:

{
  "agents": {
    "defaults": {
      "workspace": "~/.kyber/workspace",
      "model": "google/gemini-3-flash-preview",
      "provider": "openrouter",
      "maxTokens": 8192,
      "temperature": 0.7,
      "maxToolIterations": 20
    }
  },
  "providers": {
    "openrouter": { "apiKey": "", "apiBase": null },
    "anthropic":  { "apiKey": "" },
    "openai":     { "apiKey": "" },
    "deepseek":   { "apiKey": "" },
    "gemini":     { "apiKey": "" },
    "groq":       { "apiKey": "" },
    "zhipu":      { "apiKey": "", "apiBase": null },
    "vllm":       { "apiKey": "", "apiBase": null }
  },
  "channels": {
    "discord": {
      "enabled": false,
      "token": "",
      "allowFrom": [],
      "allowGuilds": [],
      "allowChannels": [],
      "requireMentionInGuilds": true,
      "maxAttachmentMb": 20,
      "typingIndicator": true
    },
    "telegram": {
      "enabled": false,
      "token": "",
      "allowFrom": [],
      "proxy": null
    },
    "whatsapp": {
      "enabled": false,
      "bridgeUrl": "ws://localhost:3001",
      "allowFrom": []
    },
    "feishu": {
      "enabled": false,
      "appId": "",
      "appSecret": "",
      "encryptKey": "",
      "verificationToken": "",
      "allowFrom": []
    }
  },
  "gateway": {
    "host": "0.0.0.0",
    "port": 18790
  },
  "dashboard": {
    "host": "127.0.0.1",
    "port": 18890,
    "authToken": "",
    "allowedHosts": []
  },
  "tools": {
    "web": {
      "search": {
        "apiKey": "",
        "maxResults": 5
      }
    },
    "exec": {
      "timeout": 60,
      "restrictToWorkspace": false
    }
  }
}

Environment variable overrides

Any field can be overridden using environment variables with the KYBER_ prefix and __ as a nested delimiter:

export KYBER_AGENTS__DEFAULTS__MODEL="gpt-4o"
export KYBER_PROVIDERS__OPENAI__API_KEY="sk-xxx"

Environment variables take precedence over the config file.

WorkspaceOverview