Hermes Agent Integration

Hermes Agent is an open-source autonomous agent framework by Nous Research. Designed for resilient multi-turn task execution, function calling, tool use, and voice messaging, Hermes can be operated through two primary methods: Hosted Cloud Agent on the Neosantara dashboard or Local CLI and Web UI.

Deployment Comparison

Method	Execution Environment	Prerequisites	Defining Feature
Hosted Cloud Agent	Cloud E2B microVM	Telegram bot token only	1-click launch, automatic STT via `whisper-large-v3-turbo`, and scale-to-zero lifecycle.
Local CLI & Web UI	Local machine or server	Python & Hermes installer	Terminal interactive loop, local web UI on port 9119, and local filesystem access.

Option 1: 1-Click Hosted Agent on Dashboard

Neosantara provides a managed Hermes deployment wizard running on isolated E2B microVM sandboxes.

1. Retrieve Telegram Credentials

Chat with @BotFather on Telegram to create a new bot and copy your Bot Token.
Chat with @userinfobot to get your numerical User ID.

2. Run the Deployment Wizard

Open app.neosantara.xyz/cloud/hermes and complete the 3-step configuration:

Step 1 (Connect): Enter your Bot Token and Telegram Owner ID. The system validates the token against the live Telegram API.
Step 2 (Configure):
- Primary Model: Select a function-calling model (such as deepseek-v4.1-flash).
- Fallback Model: Choose an optional secondary model to handle transient upstream limits.
- System Prompt: Define your agent persona and mission boundaries.
- Iteration Limits & Timeout: Configure maximum reasoning steps per turn.
- Timezone: Set the operational timezone (e.g., Asia/Jakarta).
Step 3 (Review & Deploy): Review your settings and click Deploy Agent.

3. Automatic Speech Transcription (STT)

Hosted Hermes agents automatically connect to Neosantara’s audio transcription endpoint using whisper-large-v3-turbo. You can send voice notes directly to your Telegram bot, and Hermes transcribes incoming speech before executing required actions.

Option 2: Local Setup (CLI & Web UI)

To run Hermes locally on your development machine or dedicated server:

1. Install Hermes Agent

Download and execute the official installation script:

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

2. Configure Environment Variables

Point the OpenAI-compatible client to the Neosantara gateway:

export OPENAI_BASE_URL="https://api.neosantara.xyz/v1"
export OPENAI_API_KEY="nsk_your_api_key_here"
export HERMES_MODEL="deepseek-v4.1-flash"

3. Launch the Interactive CLI

Start a terminal session in your current directory:

hermes

4. Launch the Local Web UI

Hermes includes a local web interface for tracking conversations and tool inspection:

hermes serve

Navigate to http://localhost:9119 in your browser to interact with the local agent console.

Recommended Models

Hermes Agent requires models with native function calling support:

Model Identifier	Function Calling	Context Window	Recommended Use Case
`deepseek-v4.1-flash`	Yes (Native)	1M tokens	Primary choice for deep code analysis, debugging, and multi-step tool execution.
`gemini-3.8-flash`	Yes (Native)	1M tokens	Best for low-latency interactive conversations and rapid text parsing.
`gpt-5.4-mini`	Yes (Native)	128k tokens	Cost-effective option for background scheduled checks and notifications.

Next Steps

Goal	Guide
Cloud agent architecture	Cloud Agents Guide
OpenClaw integration	OpenClaw Guide
Pi terminal coding agent	Pi Coding Agent Guide
Agno agent orchestration	Agno Guide

Model Context Protocol

Coding Assistants & IDEs

Autonomous & Cloud Agents

Deployment Comparison

Option 1: 1-Click Hosted Agent on Dashboard

1. Retrieve Telegram Credentials

2. Run the Deployment Wizard

3. Automatic Speech Transcription (STT)

Option 2: Local Setup (CLI & Web UI)

1. Install Hermes Agent

2. Configure Environment Variables

3. Launch the Interactive CLI

4. Launch the Local Web UI

Recommended Models

Next Steps

​Deployment Comparison

​Option 1: 1-Click Hosted Agent on Dashboard

​1. Retrieve Telegram Credentials

​2. Run the Deployment Wizard

​3. Automatic Speech Transcription (STT)

​Option 2: Local Setup (CLI & Web UI)

​1. Install Hermes Agent

​2. Configure Environment Variables

​3. Launch the Interactive CLI

​4. Launch the Local Web UI

​Recommended Models

​Next Steps

Deployment Comparison

Option 1: 1-Click Hosted Agent on Dashboard

1. Retrieve Telegram Credentials

2. Run the Deployment Wizard

3. Automatic Speech Transcription (STT)

Option 2: Local Setup (CLI & Web UI)

1. Install Hermes Agent

2. Configure Environment Variables

3. Launch the Interactive CLI

4. Launch the Local Web UI

Recommended Models

Next Steps