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

# Hermes Agent

> Hermes Agent is an open-source self-improving AI agent from Nous Research. It learns autonomously, evolves continuously, and features a persistent memory system.

<Frame>
  <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-4.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=593b7a9dbb3603ca8d2c86a074cb3658" alt="Image" width="1145" height="196" data-path="images/image-4.png" />
</Frame>

# Quick Start

## Step 1: Install Hermes

Open your terminal and run the following command:

### Linux / macOS / WSL2

```text theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

### Android / Termux

```text theme={null}
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

> Native Windows is **not supported**. Please install [<u>WSL2</u>](https://learn.microsoft.com/en-us/windows/wsl/install) and run Hermes Agent from within WSL2.

## Step 2: Choose a Provider

After a successful installation, select Quick setup -> More providers -> Custom endpoint.

<Frame>
  <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-5.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=81fa6c7733ffc2c94116a2e76591fe10" alt="Image" title="Image" style={{ width:"95%" }} width="1110" height="534" data-path="images/image-5.png" />

  <Frame>
    <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-7.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=d28c0a9ce5447a444565f15d00b5529f" alt="Image" title="Image" style={{ width:"97%" }} width="1130" height="544" data-path="images/image-7.png" />
  </Frame>

  <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-12.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=0c440b71c904fef9f0d1cec4ae7bbea0" alt="Image" title="Image" style={{ width:"96%" }} width="1138" height="608" data-path="images/image-12.png" />
</Frame>

## Step 3: Configure AIHubMix Parameters

1. Enter the API base URL: `https://aihubmix.com/v1`.
2. Enter your [AIHUBMIX\_API\_KEY](https://console.aihubmix.com/token): sk-\*\*\*.
   <Frame>
     <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-22.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=243f2de84cdf7ee7790a342cfcee6368" alt="Image" width="1132" height="672" data-path="images/image-22.png" />
   </Frame>
3. Enter the model ID to select the model you want to use.

<Frame>
  <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-16.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=841c9702b281fa64a099de57052b5fc6" alt="Image" width="1098" height="676" data-path="images/image-16.png" />
</Frame>

## Step 4: Set Up the Messaging Platform

Configure the messaging platform as needed (use Skip as a reference) -> Whether to run now (select Y)

<Frame>
  <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-17.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=59e28074cf34dc960ff1ea62599fe884" alt="Image" width="1132" height="592" data-path="images/image-17.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-18.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=6f4e204e7bf9c359d8e7bb54ebc34b48" alt="Image" width="1144" height="672" data-path="images/image-18.png" />
</Frame>

## Step 5: Run a Test

1. Enter `hermes` in the terminal to open the Hermes Agent interactive interface.
   <Frame>
     <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-23.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=f80a06f3e16e7f97b96b8eb401f78cf7" alt="Image" width="1130" height="660" data-path="images/image-23.png" />
   </Frame>
2. Type a message into the input box. If the model responds normally, the installation was successful.

<Frame>
  <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-20.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=28d5d8f6e16d46b19a4b41d03e054885" alt="Image" width="1138" height="542" data-path="images/image-20.png" />
</Frame>

# Common Commands

Code block

```text theme={null}
hermes model          # 选择模型供应商
hermes tools          # 配置要启动的工具
hermes gateway setup  # 设置消息平台
hermes config set     # 设置各个配置参数
hermes setup          # 运行完整设置向导，一次性配置所有内容
```

# Hermes Evolution Dashboard

To make the self-improvement process of **Hermes Agent** clearly visible, AIHubMix has released a companion "horse-raising" tool—the **Hermes Evolution Dashboard**.

It transforms the dull `~/.hermes/` directory into a living, dynamic "evolution tree."

In this system:

✅ **Visual Evolution**: Built on D3.js to observe the agent's growth trajectory in real time—skills bloom like new leaves, memory thickens the trunk, and you can dynamically track skill source code and health status.

✅ **Global Perspective**: Full transparency into token trends, model costs, and tool distribution. Paired with an activity heatmap, it supports multi-dimensional analysis of operational data.

✅ **Maximum Restraint**: **A purely read-only design.** Intuitively manage memory capacity and retrieval priority without touching your core configuration, with full control over cross-conversation full-text search.

This is an experiment in "visualized intelligence," and our gift to the agent developer community.

🔗 **Visit GitHub for the source code:** [https://github.com/AIhubmix/hermes-dashboard](https://github.com/AIhubmix/hermes-dashboard)

<Frame>
  <img src="https://mintcdn.com/aihubmix/R1hoxStg-Wtz3LNy/images/image-21.png?fit=max&auto=format&n=R1hoxStg-Wtz3LNy&q=85&s=60124db7e22e6ff629f70f8ee90374e4" alt="Image" width="2908" height="1336" data-path="images/image-21.png" />
</Frame>

***

Last updated: 2026-06-01