> ## 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.
# Set Up Hermes Agent
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:**
* A Mac or Linux machine (or a VPS)
* A GMI Cloud account: [https://console.gmicloud.ai](https://console.gmicloud.ai)
* A Telegram account: [https://telegram.org](https://telegram.org)
* About 10 minutes
## 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.
```text theme={null}
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/](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.
Once it finishes, reload your shell:
```text theme={null}
source ~/.bashrc # or source ~/.zshrc on Mac
```
Verify the install worked:
```text theme={null}
hermes --version
```
## Step 2: Run the Setup Wizard
Start the configuration wizard:
```text theme={null}
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**.
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](https://console.gmicloud.ai/user-setting/api-keys)
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.
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:
```text theme={null}
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.
You can also set or change your model at any time after setup:
```text theme={null}
hermes model
```
Or permanently in `~/.hermes/config.yaml`:
```text theme={null}
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](https://console.gmicloud.ai)
Once you are done, just type in your terminal to start and test Hermes:
```text theme={null}
hermes
```
## Step 7: Choose Telegram as Your Messaging Platform
When the wizard asks which messaging platform to use, select **Telegram**.
## Step 8: Create a Telegram Bot
Go to Telegram and open a chat with **@BotFather**: [https://t.me/BotFather](https://t.me/BotFather)
Click Start, then type:
```text theme={null}
/newbot
```
Follow the prompts to give your bot a name and a username. BotFather will reply with a bot token that looks like this:
```text theme={null}
7123456789:AAH1bG...
```
Copy that token. You will need it in the next step.
## Step 9: Configure Your Telegram Settings
Open your Hermes environment file:
```text theme={null}
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:
```text theme={null}
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](https://t.me/userinfobot)
Click Start, and it will instantly reply with your numeric ID. Copy that number and paste it in as your `TELEGRAM_ALLOWED_USERS` value.
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:
```text theme={null}
hermes gateway
```
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:
```text theme={null}
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](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.
Once it finishes, reload your shell:
```text theme={null}
source ~/.bashrc # or source ~/.zshrc on Mac
```
Verify the install worked:
```text theme={null}
hermes --version
```
## Step 2: Run the Setup Wizard
Start the configuration wizard:
```text theme={null}
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**.
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](https://console.gmicloud.ai/user-setting/api-keys)
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.
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:
```text theme={null}
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.
You can also set or change your model at any time after setup:
```text theme={null}
hermes model
```
Or permanently in `~/.hermes/config.yaml`:
```text theme={null}
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](https://console.gmicloud.ai)
Once you are done, just type in your terminal to start and test Hermes:
```text theme={null}
hermes
```
## Step 7: Choose Telegram as Your Messaging Platform
When the wizard asks which messaging platform to use, select **Telegram**.
## Step 8: Create a Telegram Bot
Go to Telegram and open a chat with **@BotFather**: [https://t.me/BotFather](https://t.me/BotFather)
Click Start, then type:
```text theme={null}
/newbot
```
Follow the prompts to give your bot a name and a username. BotFather will reply with a bot token that looks like this:
```text theme={null}
7123456789:AAH1bG...
```
Copy that token. You will need it in the next step.
## Step 9: Configure Your Telegram Settings
Open your Hermes environment file:
```text theme={null}
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:
```text theme={null}
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](https://t.me/userinfobot)
Click Start, and it will instantly reply with your numeric ID. Copy that number and paste it in as your `TELEGRAM_ALLOWED_USERS` value.
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:
```text theme={null}
hermes gateway
```
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:
```text theme={null}
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](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.