Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through installing Hermes Agent, connecting it to GMI Cloud as your model provider, and setting up Telegram so you can chat with your agent from your phone. What you will need:

​
Watch the Video

If you prefer to follow along visually, the full setup is recorded below.

​
Step 1: Install Hermes Agent

Open your terminal and run the one-line installer. 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Or the one-line from the Hermes Website: https://hermes-agent.nousresearch.com/ The installer will automatically detect and install any dependencies it needs, including Python, Node, and Git. The whole thing takes about a minute.
Screenshot 2026 05 01 At 3 34 35 PM
Once it finishes, reload your shell: 
source ~/.bashrc   # or source ~/.zshrc on Mac
Verify the install worked: 
hermes --version

​
Step 2: Run the Setup Wizard

Start the configuration wizard: 
hermes setup
Press Enter to begin. The wizard walks you through the following steps.

​
Step 3: Select GMI Cloud as Your Provider

When the wizard asks you to select a provider, scroll down and choose GMI Cloud.
Screenshot 2026 05 01 At 3 35 18 PM
The wizard will then ask for your GMI Cloud API key.

​
Step 4: Get Your GMI Cloud API Key

Go to: https://console.gmicloud.ai/user-setting/api-keys
Screenshot 2026 05 01 At 3 35 59 PM
If you are not already logged in, sign in with your credentials. Once you are in, click Create API Key, give it a name like hermes-01, and copy the key.
Screenshot 2026 05 01 At 3 36 16 PM
Head back to your terminal and paste the key when prompted. Note that the terminal will not show any characters when you paste. That is normal. Just paste and press Enter.

​
Step 5: Set the Base URL

After the API key, the wizard will ask for a base URL. You do not need to change anything here. Just press Enter to use the default GMI Cloud endpoint: 
https://api.gmi-serving.com/v1

​
Step 6: Select Your Model

GMI Cloud gives you access to a wide range of models. During setup, you can pick the one you want to use. If you are not sure, a strong general-purpose choice is one of the Claude or DeepSeek models available in your GMI account.
Screenshot 2026 05 01 At 3 37 47 PM
You can also set or change your model at any time after setup: 
hermes model
Or permanently in ~/.hermes/config.yaml: 
model:
  provider: "gmi"
  default: "your-model-id-here"
To see all available models on your GMI account, check the model catalog at: https://console.gmicloud.ai Once you are done, just type in your terminal to start and test Hermes: 
hermes
Screenshot 2026 05 01 At 3 41 06 PM

​
Step 7: Choose Telegram as Your Messaging Platform

When the wizard asks which messaging platform to use, select Telegram.
Screenshot 2026 05 01 At 3 42 01 PM

​
Step 8: Create a Telegram Bot

Go to Telegram and open a chat with @BotFather: https://t.me/BotFather
Screenshot 2026 05 01 At 3 55 17 PM
Click Start, then type: 
/newbot
Follow the prompts to give your bot a name and a username. BotFather will reply with a bot token that looks like this: 
7123456789:AAH1bG...
Copy that token. You will need it in the next step.

​
Step 9: Configure Your Telegram Settings

Open your Hermes environment file: 
nano ~/.hermes/.env
Find the Telegram section and fill in the following two values. Remove the # from the front of each line if they are commented out: 
TELEGRAM_BOT_TOKEN=your_token_from_botfather
TELEGRAM_ALLOWED_USERS=your_numeric_telegram_id
To get your numeric Telegram user ID, open Telegram and message @userinfobot: https://t.me/userinfobot
Screenshot 2026 05 01 At 3 56 33 PM
Click Start, and it will instantly reply with your numeric ID. Copy that number and paste it in as your TELEGRAM_ALLOWED_USERS value.
Screenshot 2026 05 01 At 3 57 31 PM
Save the file with Ctrl+O, then exit with Ctrl+X.

​
Step 10: Start the Gateway

Start the Hermes gateway so your agent can receive messages from Telegram: 
hermes gateway
Screenshot 2026 05 01 At 3 58 03 PM
You should see confirmation that Telegram is connected and the gateway is running.

​
Step 11: Send Your First Message

Open Telegram and search for your bot by the username you created in BotFather. Click Start. Send it a message. You should get a response within a few seconds.

​
Step 12: Try a Real Task

Here is an example to see the self-improving skill system in action. Send your bot this message: 
Every morning at 9am, find the top 3 AI news stories, summarize them, and send me a briefing here on Telegram.
Hermes will set up a scheduled cron job, run it, and confirm. The next morning, your briefing arrives automatically. And because Hermes saved what it learned as a reusable skill, similar scheduling tasks will be faster next time.

​
Troubleshooting

Gateway shows “No messaging platforms enabled” This means your TELEGRAM_BOT_TOKEN is missing or commented out in ~/.hermes/.env. Open the file and make sure the line does not start with a # and that the token is pasted correctly. API key rejected (401 error) Run hermes setup again to re-enter your GMI Cloud API key. Double-check that you have added credits to your GMI account at https://console.gmicloud.ai before generating the key. Hermes crashes on launch with an OSError This usually means Hermes is being launched from a non-standard terminal, such as VS Code’s integrated terminal. Try running it from a plain Terminal window instead. Wrong API key or want to change it Edit ~/.hermes/.env directly and update the GMI_API_KEY value, or run hermes setup to go through the wizard again.