Which config file does Crush use?

Use ~/.config/crush/crush.json for the recommended WaveSpeed AI setup. The configuration points Crush to endpoint /v1/chat/completions.

Which protocol should Crush use?

Crush should use OpenAI-compatible chat completions. This page uses endpoint /v1/chat/completions to match that protocol.

How do I verify Crush is connected?

Run Crush locally and open WaveSpeed Logs. Successful requests should appear with the selected model and usage details.

Agent Setup

Connect Crush to WaveSpeed LLM API

Copy the recommended ~/.config/crush/crush.json setup for Crush, route requests to /v1/chat/completions, and verify local agent calls in WaveSpeed Logs.

API Key Test Model

Charm's terminal coding agent with OpenAI-compatible providers.

Config file

~/.config/crush/crush.json

Protocol

OpenAI-compatible chat completions

Endpoint

/v1/chat/completions

Manual setup

Create a WaveSpeed access key

Export the required key locally

Paste config into~/.config/crush/crush.json

Run crush and check Logs

Model

OpenAI-compatible chat completions

Usage appears in Dashboard and Logs

Switch models without rewriting agent code

One-command setup

Configures Crush, checks that it works, and backs up your previous settings. Add --undo to restore them.

1
Install the WaveSpeed CLI
npm install -g @wavespeed/cli
2
Sign in
wavespeed login
3
Configure Crush
wavespeed setup crush

No Node.js? See other install options

Manual setup

Edit ~/.config/crush/crush.json

// File: ~/.config/crush/crush.json
{
  "providers": {
    "wavespeed": {
      "name": "WaveSpeed",
      "type": "openai-compat",
      "base_url": "https://llm.wavespeed.ai/v1",
      "api_key": "$WAVESPEED_API_KEY",
      "models": [
        {
          "id": "deepseek/deepseek-v4.1-flash-1017",
          "name": "deepseek/deepseek-v4.1-flash-1017",
          "context_window": 128000,
          "default_max_tokens": 16000
        }
      ]
    }
  },
  "models": {
    "large": { "provider": "wavespeed", "model": "deepseek/deepseek-v4.1-flash-1017" },
    "small": { "provider": "wavespeed", "model": "deepseek/deepseek-v4.1-flash-1017" }
  }
}

Do not replace the variable name

WAVESPEED_API_KEY is the environment variable name that the agent reads. Keep this name in the config file, and put your real API key in your shell instead.

Temporary for this terminal

Works until you close this terminal window.

export WAVESPEED_API_KEY="wsk_live_..."

Keep it after restart

Writes the key into your shell profile so new terminals can read it.

echo 'export WAVESPEED_API_KEY="wsk_live_..."' >> ~/.zshrc
source ~/.zshrc

Use Crush with WaveSpeed LLM API

This guide shows how to connect Crush to WaveSpeed AI with ~/.config/crush/crush.json, OpenAI-compatible chat completions, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1, and default model deepseek/deepseek-v4.1-flash-1017. Copy the configuration above, export your API key, run the agent, then verify requests in Logs.

Connect Crush to WaveSpeed LLM API

Manual setup

Use Crush with WaveSpeed LLM API

What this Crush setup configures

Troubleshooting

Can this Crush guide show up in search?