# Hermes Agent

Use Tensorix models with Hermes Agent — the self-improving AI agent by Nous Research.

***

## Overview

[Hermes Agent](https://github.com/NousResearch/hermes-agent) is an open-source AI agent built by [Nous Research](https://nousresearch.com) that learns from experience, creates skills autonomously, and works across CLI, Telegram, Discord, Slack, and WhatsApp. It supports custom OpenAI-compatible endpoints via environment variables or config.

{% hint style="success" %}
**Why Hermes Agent + Tensorix?**

* 🧠 **Self-improving** — Creates and refines skills from experience
* 📱 **Multi-platform** — CLI, Telegram, Discord, Slack, WhatsApp gateway
* 🔄 **Learning loop** — Agent-curated memory with cross-session recall
* ⏰ **Scheduled tasks** — Built-in cron scheduler with natural language
* 🔒 **Privacy-first** — Self-hosted agent + EU-hosted models
  {% endhint %}

***

## Prerequisites

* **Linux, macOS, or WSL2** (native Windows not supported)
* **Git**
* A Tensorix API key ([sign up here](https://app.tensorix.ai/register))

***

## Installation

```bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
```

***

## Configuration

### Option 1: Setup Wizard

```bash
hermes setup
```

When prompted for provider, choose **Custom/OpenAI-compatible** and enter:

| Setting      | Value                        |
| ------------ | ---------------------------- |
| **Base URL** | `https://api.tensorix.ai/v1` |
| **API Key**  | Your Tensorix API key        |
| **Model**    | `z-ai/glm-5.1`               |

### Option 2: Environment Variables

```bash
export OPENAI_BASE_URL=https://api.tensorix.ai/v1
export OPENAI_API_KEY=your-tensorix-api-key-here
```

To make permanent, add to `~/.bashrc` or `~/.zshrc`.

### Option 3: Config File

Edit `~/.hermes/config.yaml`:

```yaml
model:
  provider: auto
  default: z-ai/glm-5.1
  base_url: https://api.tensorix.ai/v1
```

{% hint style="warning" %}
Replace `your-tensorix-api-key-here` with your actual Tensorix API key from [app.tensorix.ai](https://app.tensorix.ai/dashboard).
{% endhint %}

***

## Usage

```bash
hermes                  # Start interactive CLI
hermes model            # Switch model
hermes gateway          # Start messaging gateway (Telegram, Discord, etc.)
hermes doctor           # Diagnose issues
```

***

## Recommended Models

| Use Case          | Model                         | Why                               |
| ----------------- | ----------------------------- | --------------------------------- |
| **General use** ⭐ | `z-ai/glm-5.1`                | Coding, reasoning, skill creation |
| **Reasoning**     | `deepseek/deepseek-r1-0528`   | Complex analysis, planning        |
| **Balanced**      | `deepseek/deepseek-chat-v3.1` | Good all-round performance        |
| **Fast tasks**    | `minimax/minimax-m2`          | Quick responses, background tasks |
| **Long context**  | `moonshotai/kimi-k2.5`        | Large context, vision support     |

***

## Messaging Gateway

Connect your agent to messaging platforms:

```bash
hermes gateway
```

Hermes Agent supports Telegram, Discord, Slack, and WhatsApp — all from a single gateway process with cross-platform conversation continuity.

***

## Troubleshooting

### Agent Not Responding

1. Verify your environment variables:

   ```bash
   echo $OPENAI_BASE_URL
   echo $OPENAI_API_KEY
   ```
2. Run diagnostics:

   ```bash
   hermes doctor
   ```

### Model Errors

Switch models with:

```bash
hermes model
```

***

## See Also

* [Hermes Agent GitHub](https://github.com/NousResearch/hermes-agent)
* [Nous Research](https://nousresearch.com)
* [Tensorix Models](https://tensorix.ai/models)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tensorix.ai/ai-agents-and-chatbots/hermes-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.