Which config file does Goose use?

Use ~/.config/goose/config.yaml for the recommended WaveSpeed AI setup. The configuration points Goose to endpoint /v1/chat/completions.

Which protocol should Goose use?

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

How do I verify Goose is connected?

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

Agent Setup

Connect Goose to WaveSpeed LLM API

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

API Key Test Model

Block's open-source agent with custom OpenAI-compatible providers.

Config file

~/.config/goose/config.yaml

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/goose/config.yaml

Run goose and check Logs

Model

OpenAI-compatible chat completions

Usage appears in Dashboard and Logs

Switch models without rewriting agent code

One-command setup

Configures Goose, 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 Goose
wavespeed setup goose

No Node.js? See other install options

Manual setup

Edit ~/.config/goose/config.yaml

# File: ~/.config/goose/config.yaml
GOOSE_PROVIDER: "wavespeed"
GOOSE_MODEL: "deepseek/deepseek-v4.1-flash-1017"

# File: custom_providers/wavespeed.json (next to config.yaml)
{
  "name": "wavespeed",
  "engine": "openai",
  "display_name": "WaveSpeed",
  "api_key_env": "WAVESPEED_API_KEY",
  "base_url": "https://llm.wavespeed.ai/v1/chat/completions",
  "models": [{ "name": "deepseek/deepseek-v4.1-flash-1017", "context_limit": 128000 }],
  "supports_streaming": true
}

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 Goose with WaveSpeed LLM API

This guide shows how to connect Goose to WaveSpeed AI with ~/.config/goose/config.yaml, 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 Goose to WaveSpeed LLM API

Manual setup

Use Goose with WaveSpeed LLM API

What this Goose setup configures

Troubleshooting

Can this Goose guide show up in search?