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

# Hermes Agent Manual Configuration Guide

> AceDataCloud Coding Plan API guide - Ace Data Cloud

## 1. Obtain an API Key

Open the [Ace Data Cloud application list](https://platform.acedata.cloud/console/applications), enter an available application, and copy the API Key.

![Obtain Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. Save the Key

Write the following in `~/.hermes/.env`:

```dotenv theme={null}
ACEDATACLOUD_API_KEY=your API Key
```

## 3. Configure the Provider

Add the following to `~/.hermes/config.yaml`:

```yaml theme={null}
providers:
  acedatacloud:
    api: https://api.acedata.cloud/v1
    key_env: ACEDATACLOUD_API_KEY
    transport: chat_completions
    default_model: MODEL_ID

model:
  provider: custom:acedatacloud
  default: MODEL_ID
```

Go to the [model catalog](https://platform.acedata.cloud/models) to view model names (for example, `claude-opus-5`, `gpt-6-sol`), and replace all `MODEL_ID` values with the same name; for precise verification, use the `id` value in the `/v1/models` response. This value is the model name used by the API `model` parameter, not the UUID of the service or API. Do not write real Keys into YAML or commit `.env`.

## 4. Verify

```bash theme={null}
hermes config check
hermes -z "Reply only OK" --provider custom:acedatacloud --model MODEL_ID --ignore-rules
```

If you receive a 401, check `~/.hermes/.env`; if the configuration does not take effect, completely exit and restart Hermes.

## Official References

* [Hermes Configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration/)
* [Hermes Providers](https://hermes-agent.nousresearch.com/docs/integrations/providers/)


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