Seedream 5.0 Pro is LIVE | Try in Image Generator →
Sign In
DashboardExploreAI GeneratorHotDesktop AppAPI KeysBilling
Agent setup

Connect Hermes to WaveSpeed LLM API

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

API keyTest model
Config file

~/.hermes/config.yaml

Protocol

OpenAI-compatible chat completions

Endpoint

/v1/chat/completions

Quick start

1

Create a WaveSpeed access key

2

Export the required key locally

3

Paste config into~/.hermes/config.yaml

4

Run hermes chat and check Logs

OpenAI-compatible chat completions

Usage appears in Dashboard and Logs

Switch models without rewriting agent code

Edit ~/.hermes/config.yaml
# File: ~/.hermes/config.yaml
model:
  default: "anthropic/claude-opus-4.8"
  provider: wavespeed
custom_providers:
  - name: wavespeed
    base_url: https://llm.wavespeed.ai/v1
    key_env: WAVESPEED_API_KEY
    api_mode: chat_completions

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.

1

Temporary for this terminal

Works until you close this terminal window.

export WAVESPEED_API_KEY="wsk-..."
2

Keep it after restart

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

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

Agent integration guide

Use Hermes with WaveSpeed LLM API

This guide shows how to connect Hermes to WaveSpeed AI with ~/.hermes/config.yaml, OpenAI-compatible chat completions, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1, and default model anthropic/claude-opus-4.8. 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

~/.hermes/config.yaml
4

Run hermes chat and check Logs

What this Hermes setup configures

Protocol

OpenAI-compatible chat completions

Endpoint

/v1/chat/completions

Model

anthropic/claude-opus-4.8

The copy-ready configuration above is the only Hermes file you need to edit for the recommended setup: ~/.hermes/config.yaml. 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 Hermes. If you use a shell profile, reload the terminal before starting the agent.

Requests fail with a protocol or endpoint error

Check that Hermes 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 ~/.hermes/config.yaml. You can start with the default model shown on this page.

No requests appear in Logs

Make sure Hermes 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 Hermes guide show up in search?

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

View all agent setup guidesBrowse models
Use Hermes with WaveSpeed LLM API