AI Tool Setup
Hermes Agent
Configure Hermes Agent with Felo API Platform model access.
Use this guide when Hermes Agent lets you add an OpenAI-compatible provider.
Before You Start
You need one Felo API Platform key. The same key works across model protocols, agent clients, Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page, and SuperAgent APIs.
export FELO_API_KEY="YOUR_API_KEY"Recommended Setup
| Item | Value |
|---|---|
| Best for | agent experiments, local workflows, and multi-tool orchestration |
| Protocol | OpenAI-compatible Chat Completions |
| Base URL | https://openapi.felo.ai/api/v1 |
| Model example | claude-sonnet-4-6 |
| API key | Your FELO_API_KEY |
Configure Hermes Agent
Set the environment variables first:
export FELO_API_KEY="YOUR_API_KEY"
export OPENAI_API_KEY="$FELO_API_KEY"
export OPENAI_BASE_URL="https://openapi.felo.ai/api/v1"Client fields
| Field | Value |
|---|---|
| Provider | OpenAI-compatible |
| API key | Your FELO_API_KEY |
| Base URL | https://openapi.felo.ai/api/v1 |
| Model | claude-sonnet-4-6 |
If Hermes Agent supports custom request headers, no extra header is required beyond bearer authentication.
Verify the Setup
Run a small task after saving the configuration:
Start Hermes Agent and select your Felo provider.If the tool starts and answers with the selected model, the provider setup is ready.
Troubleshooting
| Issue | What to check |
|---|---|
| Authentication fails | Confirm the key is copied correctly and exported as FELO_API_KEY |
| Tool calls the wrong provider | Check that the Felo provider is selected for the current workspace or session |
| Base URL error | Use https://openapi.felo.ai/api/v1 for OpenAI-compatible clients and https://openapi.felo.ai/api for Anthropic-compatible clients |
| Model not found | Choose a model that appears in your Felo model list |
| The tool ignores local config | Move provider settings to the user-level config if the client requires it |