Deploy Hermes Agent Locally on Windows with WSL + Ollama and Connect Telegram

Sat, 18 Apr 2026 00:48:22 +0800

If you want to run Hermes Agent on Windows with as little friction as possible, a practical path is:

keep Windows as the host system
run Ubuntu inside WSL
use Ollama to serve the local model
let Hermes Agent connect directly to the local Ollama endpoint

This approach keeps the environment relatively clean, lets you run most commands in a Linux-style workflow, and avoids preparing a separate Linux machine.

Overall flow

You can split the setup into 4 steps:

Enable WSL and install Ubuntu
Install Python, Node.js, Git, and other basics inside Ubuntu
Install Ollama and pull a local model
Install Hermes Agent, then connect Telegram

If your goal is simply to get Hermes Agent running first, by the end of step 3 you are already close.

1. Install WSL and Ubuntu

Run this in PowerShell with administrator privileges:

`1`	`wsl --install`

After the installation finishes, restart the PC, then continue with Ubuntu:

`1`	`wsl --install -d Ubuntu`

After that, open Ubuntu in WSL. Most of the remaining commands are run there.

2. Update Ubuntu and install the base environment

Update the system first:

1
2

sudo apt update
sudo apt upgrade -y

Then install Python, extraction tools, Node.js, and Git.

Install Python

`1`	`sudo apt install python3-pip python3-venv -y`

Install zstd

`1`	`sudo apt install -y zstd`

Install Node.js

1
2

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

Install Git

1
2

sudo apt update
sudo apt install -y git

You can quickly verify the installation with:

1
2
3

node -v
npm -v
git --version

3. Install Ollama and pull Gemma 4

Install Ollama:

`1`	`curl -fsSL https://ollama.com/install.sh \| sh`

If you want a local model for Hermes Agent, starting with Gemma 4 is reasonable.

For example:

`1`	`ollama run gemma4:e4b`

If your machine is weaker, you can also try:

`1`	`ollama run gemma4:e2b`

Larger variants include:

1
2

ollama run gemma4:26b
ollama run gemma4:31b

For most normal Windows + WSL setups, gemma4:e4b is usually the more practical starting point.

4. Install and configure Hermes Agent

Install it with:

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

After installation, point it to the local Ollama endpoint:

`1`	`http://127.0.0.1:11434`

Use the local model name you actually installed, for example:

`1`	`gemma4:e4b`

If the installer asks you to refresh the shell, run:

`1`	`source ~/.bashrc`

Common Hermes Agent commands

These are the commands you will use most often:

Start

hermes

Re-enter setup

`1`	`hermes setup`

Configure the chat gateway

`1`	`hermes setup gateway`

Update

`1`	`hermes update`

Basic Telegram connection steps

If you want Hermes Agent to send and receive messages through Telegram, the core step is still:

`1`	`hermes setup gateway`

Then prepare the two Telegram-side items you need:

create a bot with BotFather
get your User ID with @userinfobot

Once you have those basics, continue filling them into the Hermes Agent gateway setup.

Who this setup fits

This workflow is a good fit if:

Windows is your main desktop system
you do not want to maintain a separate Linux host
you want to get a local Agent running first, then expand to chat platforms
you prefer local models instead of depending on cloud APIs

If you mainly want to experience a local Agent rather than build a full production deployment immediately, this path is already practical enough.

A few things to keep in mind

WSL is still a compatibility layer, so in extreme cases it may not behave exactly like native Linux
whether a large model runs smoothly still depends on your RAM, VRAM, and CPU / GPU
gemma4:e4b is a realistic starting point, but actual experience still depends on the machine
Hermes Agent platform integration is an extension step; getting the local model path working first, then adding Telegram, is usually more stable

Conclusion

If you want to deploy Hermes Agent locally on Windows with as little friction as possible, the smoother order is:

WSL -> Ubuntu -> Ollama -> Gemma 4 -> Hermes Agent -> Telegram

Get the local model running first, then add the gateway integration. That usually gives you a much higher success rate. For most users, this is easier to troubleshoot than piling on every component at the beginning, and it also leaves room for later expansion.

Original reference

This post is rewritten and organized based on:

Xchaoge Blog: 太简单了！Hermes Agent 本地部署（无需API）接入 Telegram + 微信

Telegram on KnightLi Blog