Kling 4.0 is LIVE — Unbelievably Real Video | Try Now →
Sign In
DashboardExploreAI GeneratorHotDesktop AppBilling
Agent Setup

Connect Aider to WaveSpeed LLM API

Copy the recommended ~/.aider.conf.yml setup for Aider, route requests to /v1/chat/completions, and verify local agent calls in WaveSpeed Logs.

API KeyTest Model

Terminal pair-programming tool that edits your git repo with any OpenAI-compatible model.

Config file

~/.aider.conf.yml

Protocol

OpenAI-compatible chat completions

Endpoint

/v1/chat/completions

Manual setup

1

Create a WaveSpeed access key

2

Export the required key locally

3

Paste config into~/.aider.conf.yml

4

Run aider and check Logs

OpenAI-compatible chat completions

Usage appears in Dashboard and Logs

Switch models without rewriting agent code

One-command setup

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

  1. 1

    Install the WaveSpeed CLI

    npm install -g @wavespeed/cli
  2. 2

    Sign in

    wavespeed login
  3. 3

    Configure Aider

    wavespeed setup aider

No Node.js? See other install options

Manual setup

Edit ~/.aider.conf.yml
# File: ~/.aider.conf.yml
openai-api-base: "https://llm.wavespeed.ai/v1"
openai-api-key: "wsk_live_..."
model: "openai/deepseek/deepseek-v4.1-flash-1017"
Replace wsk_live_... with your real WaveSpeed API key before saving this config file.

Agent integration guide

Use Aider with WaveSpeed LLM API

This guide shows how to connect Aider to WaveSpeed AI with ~/.aider.conf.yml, 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.

1

Create a WaveSpeed access key

2

Export the required key locally

3

Paste config into

~/.aider.conf.yml
4

Run aider and check Logs

What this Aider setup configures

Protocol

OpenAI-compatible chat completions

Endpoint

/v1/chat/completions

Model

deepseek/deepseek-v4.1-flash-1017

The copy-ready configuration above is the only Aider file you need to edit for the recommended setup: ~/.aider.conf.yml. Keep the API key in your shell environment so it is not committed to a repository.

Troubleshooting

The API key is not being picked up

Export WAVESPEED_API_KEY in the same shell where you run Aider. If you use a shell profile, reload the terminal before starting the agent.

Requests fail with a protocol or endpoint error

Check that Aider is using OpenAI-compatible chat completions and endpoint /v1/chat/completions. Protocol mismatches are the most common cause of 404 or payload errors.

The selected model does not work

Confirm the model id exists in WaveSpeed Models, then paste the exact id into ~/.aider.conf.yml. You can start with the default model shown on this page.

No requests appear in Logs

Make sure Aider is using the WaveSpeed base URL and your current API key. Then send a new prompt from the local agent and refresh Logs.

Can this Aider guide show up in search?

Yes. This page is built as an indexable setup guide for users searching for Aider custom provider, OpenAI-compatible endpoint, base URL, and local agent configuration workflows.

View all agent setup guidesBrowse models