Chutes

Chutes exposes open-source model catalogs through an OpenAI-compatible API. Velaclaw 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
API key

Run the OAuth onboarding flow

velaclaw onboard --auth-choice chutes

Velaclaw launches the browser flow locally, or shows a URL + redirect-paste flow on remote/headless hosts. OAuth tokens auto-refresh through Velaclaw 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.

Get an API key

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

Run the API key onboarding flow

velaclaw 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, Velaclaw queries the Chutes catalog with that credential and uses the discovered models. If discovery fails, Velaclaw falls back to a bundled static catalog so onboarding and startup still work.

Default aliases

Velaclaw 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.

Model providers

Provider rules, model refs, and failover behavior.

Configuration reference

Full config schema including provider settings.

Chutes

Chutes dashboard and API docs.

Chutes API keys

Create and manage Chutes API keys.

Overview

Concepts and configuration

Providers

Chutes

Chutes

Getting started

Discovery behavior

Default aliases

Built-in starter catalog

Config example

Model providers

Configuration reference

Chutes

Chutes API keys

​Chutes

​Getting started

​Discovery behavior

​Default aliases

​Built-in starter catalog

​Config example

​Related

Model providers

Configuration reference

Chutes

Chutes API keys

Chutes

Getting started

Discovery behavior

Default aliases

Built-in starter catalog

Config example

Related