Hermes Agent

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

Overview

Hermes Agent is an open-source AI agent built by Nous Research 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.

Why Hermes Agent + TensorX?

🧠 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

Prerequisites

Linux, macOS, or WSL2 (native Windows not supported)
Git
A TensorX API key (sign up here)

Installation

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

Configuration

Option 1: Setup Wizard

hermes setup

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

Setting

Value

Base URL

https://api.tensorx.ai/v1

API Key

Your TensorX API key

Model

z-ai/glm-5.1

Option 2: Environment Variables

export OPENAI_BASE_URL=https://api.tensorx.ai/v1
export OPENAI_API_KEY=your-tensorx-api-key-here

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

Option 3: Config File

Edit ~/.hermes/config.yaml:

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

Replace your-tensorx-api-key-here with your actual TensorX API key from app.tensorx.ai.

Usage

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:

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

Verify your environment variables:
```
echo $OPENAI_BASE_URL
echo $OPENAI_API_KEY
```
Run diagnostics:
```
hermes doctor
```

Model Errors

Switch models with:

hermes model

Good afternoon