Home · Help · Installing Hermes Agent
Installing Hermes Agent on a vServer
Hermes Agent is an open-source AI agent by Nous Research (MIT license). It carries out tasks in the terminal, keeps knowledge across sessions, creates its own skills for recurring tasks and can be operated via Telegram, Discord, Slack, WhatsApp or Signal. On a vServer it runs around the clock, even when your own computer is switched off.
Which server is suitable
The language model runs at the provider, such as Anthropic, OpenAI, OpenRouter or Nous Portal. The server only runs the agent itself: a Python process that sends requests to the provider's interface and processes the answers. In continuous operation with Telegram it needs about 450 MB of RAM according to our measurement and hardly any CPU time.
- Suitable: vServer XS with 1 vCPU, 2 GB RAM and 40 GB NVMe, as a container with Debian 13 or Ubuntu.
- More memory is needed for browser control with Chromium (a few hundred MB extra while it runs) and for self-hosted memory services with their own database.
- Not intended for a vServer are local language models. They need a graphics card with at least 8 GB of memory. This guide therefore uses a provider's interface.
1. Prepare the server
As root, update, install the prerequisites and create a dedicated user for the agent. The agent runs commands. With its own user without administrator rights, the rest of the server stays protected.
apt update && apt full-upgrade
apt install git curl libatomic1
adduser hermes
loginctl enable-linger hermes
loginctl enable-linger keeps the user's services running after logging out and after a reboot.
2. Install Hermes
Log in as the user hermes, for example via SSH or with su - hermes, and run the official installation script:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
The script brings Python, Node.js and the other tools itself and stores everything under ~/.hermes. If you do not need browser control, you save space with:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
3. Set up the model provider
hermes setup
The wizard asks for provider, model and access key. Hermes stores keys and tokens in ~/.hermes/.env and all other settings in ~/.hermes/config.yaml. You can change the provider later with hermes model. hermes starts a chat in the terminal, which lets you check the setup right away.
4. Operate via Telegram and run continuously
The gateway connects Hermes to Telegram and the other messengers. The setup asks for the access credentials, for Telegram this is the bot token from @BotFather. Then install sets up the gateway as a systemd service:
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
The log is shown by journalctl --user -u hermes-gateway -f.
5. Connect to your Glowfish customer account
Via the AI interface (MCP) Hermes works with your customer account: server status, web hosting, domains, mailboxes, game servers, invoices and support tickets. The interface is free of charge for customers.
- In the customer portal under AI applications, create a key. Choose a name, rights and validity, and under Only from IP addresses enter the address of your vServer. The key is shown only once.
- Enter the key in
~/.hermes/.env:GLOWFISH_MCP_TOKEN=IHR-SCHLUESSEL - Add the server in
~/.hermes/config.yaml. Hermes inserts the value from.envitself, so the key does not appear in the configuration:mcp_servers: glowfish: url: "https://mcp.glowfish.de/mcp" headers: Authorization: "Bearer ${GLOWFISH_MCP_TOKEN}" - Check the connection:
hermes mcp test glowfish
A running gateway picks up the changed configuration by itself after about a minute. In an open chat, /reload-mcp reloads the servers immediately.
Examples
- “How are my servers doing?”
- “Which invoices are open?”
- “Set up info@my-domain.com.”
- “Restart the Valheim server.”
- “Send me the status of my servers every morning at 8.”
You confirm modifying actions in the chat. Orders only go through with an SMS code, passwords never via the chat. Every action is logged under AI applications, where you can disconnect at any time.
Updating
hermes update
The command fetches the latest stable version and restarts the gateway.
Frequently asked questions
- What does it cost to run?
- The vServer XS costs €6.00 per month. On top of that come the model provider's costs, by usage or subscription.
- Container or KVM?
- The container is sufficient. You only need KVM for your own kernel modules, for example for a VPN.
- Can Hermes also set up my vServer at Glowfish by itself?
- On its own server Hermes works directly in the terminal. Via the AI interface it can also run commands on other servers if you enable them for this in the customer portal.
See also: Connect AI assistants to Glowfish First steps on your vServer Setting up a Debian server