Connect Hermes Agent to APIONE - APIONE AI

Prepare

Install and initialize Hermes Agent using the official project. Prepare an APIONE key and a tool-capable model ID.

Run the model wizard

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 — 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 · Choose a model · Troubleshooting