# Connect Ditto to Hermes Agent

> Add the Ditto Hermes skill tap, install the Ditto skill, create a Hermes API key, and verify Hermes can use Ditto through the Ditto CLI.

---

Hermes Agent uses Ditto through a Hermes skill that calls the [Ditto CLI](/docs/ditto-cli). This is separate from MCP setup.

## Before You Start

You need Hermes Agent installed.

You can create your Ditto account during the connection flow.

## Install The Skill

Add the Ditto skill tap, then install the skill:

```bash
hermes skills tap add ditto-assistant/ditto-hermes
hermes skills install ditto-assistant/ditto-hermes/ditto
```

The skill source is [ditto-assistant/ditto-hermes](https://github.com/ditto-assistant/ditto-hermes). Hermes' skill system supports GitHub taps, so the tap command subscribes Hermes to that repository and the install command pulls the `ditto` skill from it.

If you need to verify or repair the CLI directly, use the [Ditto CLI docs](/docs/ditto-cli).

## Create A Key

Hermes prompts for the required `DITTO_API_KEY` during skill setup.

1. Open [app.heyditto.ai/connect/hermes](https://app.heyditto.ai/connect/hermes).
2. Sign in.
3. Create a new key and copy it.
4. Paste it into the Hermes prompt.

The app connect page for this integration is [app.heyditto.ai/connect/hermes](https://app.heyditto.ai/connect/hermes).

If you missed the prompt or need to rotate the value:

```bash
hermes skills config ditto
```

## Verify

Check the CLI can reach Ditto:

```bash
ditto status
```

Then make a real account-backed request:

```bash
ditto subjects "test" --output json
```

Hermes can now use Ditto memory when the conversation calls for it. See [Ditto CLI verification](/docs/ditto-cli#verify) for the standalone command output shape.

## Troubleshooting

| Symptom                                | Fix                                                                                                                                                                  |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hermes skills tap add` fails          | Confirm Hermes can reach GitHub and the tap URL `ditto-assistant/ditto-hermes` is typed exactly.                                                                     |
| `ditto: command not found`             | Use the manual repair steps in [Ditto CLI troubleshooting](/docs/ditto-cli#troubleshooting).                                                                         |
| Hermes did not ask for the API key     | Run `hermes skills config ditto` to re-open the skill config prompt.                                                                                                 |
| `error: no Ditto API key configured`   | Re-run `hermes skills config ditto`, or create a key at [app.heyditto.ai/connect/hermes](https://app.heyditto.ai/connect/hermes) and run `ditto login <key>`.        |
| Requests fail after working previously | Run `ditto status`. If the key was revoked, rotate it with `ditto logout` followed by `ditto login <new-key>`, then update Hermes with `hermes skills config ditto`. |

## Reference Links

- [Ditto Hermes skill repo](https://github.com/ditto-assistant/ditto-hermes)
- [Hermes Agent docs](https://hermes-agent.nousresearch.com/docs)
- [Hermes skills system](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)
- [Ditto CLI](/docs/ditto-cli)