Genesis Docs

Models / Providers

Chutes

Chutes exposes open-source model catalogs through an OpenAI-compatible API. Genesis supports both browser OAuth and direct API-key auth for the bundled chutes provider.

Property Value
Provider chutes
API OpenAI-compatible
Base URL https://llm.chutes.ai/v1
Auth OAuth or API key (see below)

Getting started

OAuth

Run the OAuth onboarding flow

genesis onboard --auth-choice chutes

Genesis launches the browser flow locally, or shows a URL + redirect-paste flow on remote/headless hosts. OAuth tokens auto-refresh through Genesis auth profiles.

Verify the default model

After onboarding, the default model is set to chutes/zai-org/GLM-4.7-TEE and the bundled Chutes catalog is registered.

API key

Get an API key

Create a key at chutes.ai/settings/api-keys.

Run the API key onboarding flow

genesis onboard --auth-choice chutes-api-key

Verify the default model

After onboarding, the default model is set to chutes/zai-org/GLM-4.7-TEE and the bundled Chutes catalog is registered.

Both auth paths register the bundled Chutes catalog and set the default model to chutes/zai-org/GLM-4.7-TEE. Runtime environment variables: CHUTES_API_KEY, CHUTES_OAUTH_TOKEN.

Discovery behavior

When Chutes auth is available, Genesis queries the Chutes catalog with that credential and uses the discovered models. If discovery fails, Genesis falls back to a bundled static catalog so onboarding and startup still work.

Default aliases

Genesis registers three convenience aliases for the bundled Chutes catalog:

Alias Target model
chutes-fast chutes/zai-org/GLM-4.7-FP8
chutes-pro chutes/deepseek-ai/DeepSeek-V3.2-TEE
chutes-vision chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506

Built-in starter catalog

The bundled fallback catalog includes current Chutes refs:

Model ref
chutes/zai-org/GLM-4.7-TEE
chutes/zai-org/GLM-5-TEE
chutes/deepseek-ai/DeepSeek-V3.2-TEE
chutes/deepseek-ai/DeepSeek-R1-0528-TEE
chutes/moonshotai/Kimi-K2.5-TEE
chutes/chutesai/Mistral-Small-3.2-24B-Instruct-2506
chutes/Qwen/Qwen3-Coder-Next-TEE
chutes/openai/gpt-oss-120b-TEE

Config example

{
  agents: {
    defaults: {
      model: { primary: "chutes/zai-org/GLM-4.7-TEE" },
      models: {
        "chutes/zai-org/GLM-4.7-TEE": { alias: "Chutes GLM 4.7" },
        "chutes/deepseek-ai/DeepSeek-V3.2-TEE": { alias: "Chutes DeepSeek V3.2" },
      },
    },
  },
}

OAuth overrides

You can customize the OAuth flow with optional environment variables:

Variable Purpose
CHUTES_CLIENT_ID Custom OAuth client ID
CHUTES_CLIENT_SECRET Custom OAuth client secret
CHUTES_OAUTH_REDIRECT_URI Custom redirect URI
CHUTES_OAUTH_SCOPES Custom OAuth scopes

See the Chutes OAuth docs for redirect-app requirements and help.

Notes

  • API-key and OAuth discovery both use the same chutes provider id.
  • Chutes models are registered as chutes/<model-id>.
  • If discovery fails at startup, the bundled static catalog is used automatically.