> For the complete documentation index, see [llms.txt](https://docs.origintrail.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.origintrail.io/connect-agents-and-systems/hermes.md).

# Hermes

Connect Hermes so its agents can retain project knowledge, query shared evidence, and contribute findings through your DKG node. You can continue using Hermes while choosing when knowledge stays private or becomes part of a collaboration.

Prerequisites: a working Hermes installation and configured model access. The DKG adapter can bootstrap a node and configure the selected Hermes profile. The 10.0.23 baseline supports DKG memory tools, primary-memory integration, and Node UI chat through the local bridge or configured gateway.

```bash
npm install -g @origintrail-official/dkg
dkg hermes setup --network testnet
dkg hermes status
dkg hermes verify
```

Setup replaces the memory provider by default. Use `--preserve-provider` if you intend to retain the existing provider; that is a different memory configuration. Use `--profile <name>` consistently for a non-default profile. Existing nodes retain their network.

Start Hermes using its installed runtime's instructions. For the API gateway path, ensure `API_SERVER_ENABLED=true` in the selected Hermes environment and run:

```bash
hermes gateway run --replace -v
```

## Verify

Confirm node health, adapter verification, and a chat reply from the connected profile. Then complete the [quickstart](https://docs.origintrail.io/start-here/quickstart.md) and repeat its query in a fresh conversation. Check both memory tool access and the actual memory provider; successful chat alone does not verify memory persistence.

If chat is unavailable, check the selected profile and bridge/gateway health with `dkg hermes doctor`. See the [adapter reference](https://github.com/OriginTrail/dkg/blob/main/packages/adapter-hermes/README.md) for runtime prerequisites, profiles, transport modes, and configuration.

## Disconnect

```bash
dkg hermes disconnect
```

Use the same `--profile` selection as setup. Reconnect with `dkg hermes reconnect`; use `dkg hermes uninstall` when removing adapter wiring. Inspect the resulting status rather than deleting runtime configuration by hand.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.origintrail.io/connect-agents-and-systems/hermes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
