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

# Hermes Agent

> Connect Hermes Agent to the AsterWise API.

Before you start, install the tool and create an API key with prepaid balance in the [AsterWise app](https://app.asterwise.dev).

<Note>Based on the tool’s documented custom-provider setup. Live AsterWise compatibility has not yet been tested for this tool.</Note>

## Which API does this use?

This guide selects **Chat Completions** through the custom endpoint’s `chat_completions` transport. The base URL is `https://api.asterwise.dev/v1`. The client builds the full endpoint: `https://api.asterwise.dev/v1/chat/completions`.

The model name chooses AsterCode or AsterWork, not the protocol. Use the base URL in the configuration below, rather than the full endpoint.

## 1. Open the provider wizard

Exit any running chat and run:

```bash theme={"dark"}
hermes model
```

## 2. Choose a custom endpoint

Select **Custom endpoint** and enter:

| Setting  | Value                          |
| -------- | ------------------------------ |
| Base URL | `https://api.asterwise.dev/v1` |
| API key  | Your AsterWise API key         |
| Model    | `aster-code`                   |

If the wizard asks for an API format, select **Chat Completions**. In current provider configuration this is `transport: chat_completions`. Save the configuration. Use `aster-work` instead if you prefer AsterWork.

## 3. Start a new session

```bash theme={"dark"}
hermes
```

Use `hermes model` to change provider settings; the in-chat `/model` command is not the initial provider setup wizard.

Hermes can configure auxiliary models separately. Check those settings if background tasks use a different provider from your main chat. AsterWise’s API key does not configure separate search or other external services.

## Check the connection

Ask “Reply with hello” first. Confirm a response appears and find the request in **Usage** in AsterWise. Then try a small coding task before a larger project.

For authentication errors, run `hermes model` again, check the saved custom endpoint and key, then start a new session. See [troubleshooting](/errors-fallback).

## Official reference

Configuration reviewed on September 16, 2026. [Hermes provider setup](https://github.com/NousResearch/hermes-agent/blob/main/website/docs/integrations/providers.md).