Differences

This shows you the differences between two versions of the page.

--- hermes_installation_on_windows_11 [29 June 2026 / 15:40:04] – kadek
+++ hermes_installation_on_windows_11 [09 July 2026 / 18:44:46] (current) – kadek
@@ Line 1: / Line 1: @@
 ===== Hermes Installation on Windows 11 =====
-We will install Hermes on Docker to avoid it change your main environment. This setup will use OpenRouter and configured the free model for starting, you may change the model in Hermes prompt anytime. The configuration will also use Telegram as the messaging gateway.
+This guide walks you through installing Hermes in a Docker container, keeping it fully isolated from your host system while preserving a clean main environment. The installation is configured to use OpenRouter with a free AI model by default, making it easy to get started at no cost. You can switch to a different supported model at any time directly from the Hermes prompt. Finally, we'll configure Telegram as the messaging gateway so you can interact with your personal AI assistant from anywhere.
-To connect Hermes with Telegram:
+=== #1 Create a Telegram Bot ===
-  * In Telegram, search @BotFather (the one with the verified tick)
+  * Open Telegram.
-  * Send this command: /newbot
+  * Search for @BotFather (the verified account).
-  * Pick a name
+  * Send:
-  * Copy the token, we will add the token to our configuration.
-Create the folder for your Hermes:
+  /newbot
+  * Choose a bot name and username.
+  * Copy the bot token. You will use it later in the .env file.
+=== #2 Create the Hermes Data Folder ===
+Replace YourUsername with your Windows username:
   mkdir C:\Users\YourUsername\hermes-data
-Run the setup wizard:
+=== #3 Run the setup wizard ===
+The setup wizard will create the initial configuration files inside your hermes-data directory:
   docker run -it --rm -v C:\Users\YourUsername\hermes-data:/opt/data nousresearch/hermes-agent:latest setup
-Create a custom Docker network:
+=== #4 Create docker-compose.yml ===
-  docker network create hermes-net
+Create a file named:
-  ocker network connect hermes-net hermes-agent
-Create or edit the docker-compose.yml
+  C:\Users\YourUsername\hermes-data\docker-compose.yml
-  services:
+Paste the following:
-    hermes:
-      image: nousresearch/hermes-agent:latest
-      container_name: hermes
-      restart: unless-stopped
-      volumes:
-        - C:\Users\KdeK\hermes-data:/opt/data
-      ports:
-        - "8642:8642"
-        - "9119:9119"
-      stdin_open: true
-      tty: true
-Create or edit the .env file, get the value from the specified service:
+services:
+  hermes-cli:
+    image: nousresearch/hermes-agent:latest
+    container_name: hermes-cli
+    stdin_open: true
+    tty: true
+    volumes:
+      - C:\Users\YourUsername\hermes-data:/opt/data
+  hermes-gateway:
+    image: nousresearch/hermes-agent:latest
+    container_name: hermes-gateway
+    command: gateway run
+    restart: unless-stopped
+    volumes:
+      - C:\Users\YourUsername\hermes-data:/opt/data
+  hermes-dashboard:
+    image: nousresearch/hermes-agent:latest
+    container_name: hermes-dashboard
+    command: dashboard --host 0.0.0.0 --port 9119 --no-open
+    restart: unless-stopped
+    ports:
+      - "9119:9119"
+    volumes:
+      - C:\Users\YourUsername\hermes-data:/opt/data
+=== #5 Configure the Environment Variables ===
+Create a file named:
+  C:\Users\YourUsername\hermes-data\.env
+Example of the values:
   OPENROUTER_API_KEY=sk-or-v1-ABCDEFGabcdefg0123456789
@@ Line 48: / Line 71: @@
   TELEGRAM_ALLOWED_USERS=123456789
-Start the docker:
+Where:
-  cd hermes-data
+  - OPENROUTER_API_KEY is obtained from OpenRouter.
+  - TELEGRAM_BOT_TOKEN is obtained from BotFather.
+  - TELEGRAM_ALLOWED_USERS is your Telegram numeric User ID.
+=== #6 Start Hermes ===
+  cd C:\Users\YourUsername\hermes-data
   docker compose up -d
+Wait 10–20 seconds for Hermes to initialize.
+=== #7 Verify Hermes ===
+View the logs for Gateway & Dashboard:
+  docker logs hermes-gateway --tail 10
+  docker logs hermes-dashboard --tail 10
+=== #8 Pair Telegram ===
+Open your Telegram bot and send:
+  /sethome
+Hermes may ask you to complete the initial pairing. Once complete, your private chat becomes the default Home channel.
+=== #9 Open the Hermes CLI (Optional) ===
+To access the Hermes command-line interface:
+  docker exec -it hermes hermes
+This connects to the running Hermes instance without stopping the Telegram gateway. Type /exit to exit the CLI.
+----
+=== Daily Startup ===
+After Windows starts:
+  - Start Docker Desktop.
+  - Wait until Docker Desktop reports Engine running.
+  - Open PowerShell, and run these commands:
+  cd C:\Users\YourUsername\hermes-data
+  docker compose up -d
+A successful startup should display messages similar to:
+  PS C:\Users\YourUsername\hermes-data> docker compose up -d
+  [+] up 4/4
+   ✔ Network hermes-data_default Created                                                                              0.0s
+   ✔ Container hermes-gateway    Started                                                                              0.6s
+   ✔ Container hermes-cli        Started                                                                              0.6s
+   ✔ Container hermes-dashboard  Started                                                                              0.8s
+Hermes, the Dashboard, and the Telegram Gateway will start automatically.
+Access the dashboard via this URL: http://localhost:9119
+=== Daily Shutdown ===
+You may simply shut down Windows.
+Docker will gracefully stop the Hermes container.
+Alternatively:
+  docker compose down
+=== Updating Hermes ===
+To update Hermes to the latest version:
+  docker compose pull
+=== Backup ===
+Back up the following directory periodically:
+  C:\Users\YourUsername\hermes-data
+This folder contains your configuration, memories, sessions, and database.