> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Hermes Agent to APIONE

> Set up a custom OpenAI-compatible endpoint in Hermes Agent.

## Prepare

Install and initialize Hermes Agent using the [official project](https://github.com/NousResearch/hermes-agent). Prepare an APIONE key and a tool-capable model ID.

## Run the model wizard

```bash theme={null}
hermes model
```

Select **Custom endpoint**, choose manual address entry, and provide:

| Setting | Value |
| - | - |
| API Base URL | `https://api.apione.ai/v1` |
| API Key | Your APIONE key |
| Model | Your actual APIONE model ID |

If a protocol selector is available, use OpenAI-compatible Chat Completions. Use the APIONE custom endpoint and API key; no additional OAuth sign-in is required.

![Hermes Agent terminal prompt for APIONE Base URL and API Key](https://mintcdn.com/apione/l_tpyU_NU9GJriKq/images/integrations/screenshots/hermes-apione-custom-endpoint.png?fit=max\&auto=format\&n=l_tpyU_NU9GJriKq\&q=85\&s=184463d03b20c748744cce9ba4c9a550)

Hermes Agent Custom endpoint wizard. Enter the APIONE Base URL, then fill in the API Key.

## Verify chat and tools

Restart `hermes` and ask it to reply with OK only. Then ask it to list files in a test directory, reviewing tool permissions and results. Connect messaging channels or long-running tasks afterward.

## Common problems

* If a model is absent from the list, enter its ID manually or check key permissions.
* If text works but tools fail, check tool support and parameter compatibility.
* If requests still use the previous provider, rerun the wizard, check the active provider, and restart the session.
* For 401 or 404, check the key and /v1 path respectively. Do not append /chat/completions to the Base URL.

***

[Integration directory](https://apione.ai/docs/en/guides/clients.md) · [Choose a model](https://apione.ai/docs/en/models/catalog.md) · [Troubleshooting](https://apione.ai/docs/en/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.