How to Set Up Hermes Agent from Scratch (2026 Guide)

To set up Hermes Agent from scratch, you need three things: a server that stays online 24/7, an LLM to act as the brain, and about 20 minutes. The fastest path in 2026 is Hostinger's one-click Hermes Agent VPS template, which deploys the agent as a Docker container with zero manual installs, after which you run the built-in setup wizard, connect Telegram, and start prompting. This guide walks the whole flow, based on Hostinger's official Hermes documentation and the r/hermesagent community setup megathreads updated for v0.18.0 in July 2026.

What Hermes Agent Is (and the 5 Pillars)

Hermes Agent is an open-source, provider-agnostic AI agent built by Nous Research that runs tasks, executes code, browses the web, and chats with you over Telegram, Discord, Slack, WhatsApp, Signal, or email. Unlike a chatbot, it acts: it has terminal access, file access, and a scheduler, and it is MIT-licensed and free. As of July 2026 the current release is v0.18.0.

Five pillars explain why people run it 24/7 instead of just opening ChatGPT:

• Memory: persistent context across sessions, so it actually knows you. Deep dive in our Hermes memory system guide.
• Skills: reusable capabilities it saves and loads on demand (see the skills guide).
• Soul: a configurable persona and behavior layer, so your agent is yours, not a template.
• Crons: a built-in scheduler for recurring jobs like morning briefings and weekly reports.
• Self-improvement loop: after finishing a task, it can turn what it learned into a new skill and use it next time.

If you are still deciding between agents, our OpenClaw vs Hermes Agent comparison covers the tradeoffs. For a plain-English intro, start with what is Hermes Agent.

Step 1: Get a VPS to Run It On

Hermes Agent needs a machine that never sleeps, and Hostinger's official guidance is a VPS with at least 2 CPU cores and 8 GB of RAM. That maps to the KVM 2 plan (2 vCPU, 8 GB RAM, 100 GB NVMe), which is $8.79/mo during the summer sale as of July 2026. This is the same setup step everyone lands on, so do it first: grab the Hermes Agent VPS template here, currently up to 70% off with the summer sale.

You can technically run Hermes on your laptop, but the gateway (the part that answers your Telegram messages) dies when your laptop sleeps. A $9/mo server ends that problem permanently. Our full plan-by-plan breakdown is in the Hermes Agent on Hostinger VPS guide, and the cost math lives in our Hermes Agent cost breakdown.

Requirements if you bring your own server instead:

Step 2: Deploy with the One-Click Template

The one-click template installs Hermes Agent as a Docker container automatically: after checkout, Hostinger provisions the VPS, pulls the image, and starts the container alongside its supporting services, per Hostinger's official Hermes Agent KB article. During deployment you set an admin username and password for the web terminal; keep them safe.

When it finishes, open your VPS dashboard, go to Docker Manager, and click Open next to the Hermes project. That drops you straight into the Hermes CLI in a browser terminal. No SSH, no dependencies, no Python versions.

Prefer to install by hand on any Linux box? The official curl one-liner does the same job:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

The Docker route vs the native install is a real decision with real tradeoffs; we compare them head-to-head in Hermes Agent Docker setup: one-click template vs manual install.

Step 3: Choose the Model (the Brain)

Hermes Agent is free, but the model powering it usually is not, and model choice is where most beginners stall. The first time you open Hermes it launches a setup wizard with two paths: Quick setup (sign in through the Nous Portal, no API keys, a working model picked for you) and Full setup (connect your own provider: OpenRouter, OpenAI, Anthropic, Ollama, or a custom endpoint).

Three sensible starting points:

• Nous Portal (Quick setup): zero-config, free to start, and on paid plans the Tool Gateway bundles web search, image generation, and a cloud browser with no extra keys.
• Your existing ChatGPT/Codex subscription: the cost hack popularized in the big 2026 switcher videos is to route Hermes through a subscription you already pay for instead of per-token API billing, which keeps heavy daily use at a flat price.
• OpenRouter: one key, 200+ models, easy to swap with hermes model or /model in-session.

One hard-won community rule from the r/hermesagent from-scratch megathread: small 8B-class models fail at tool calling. If your agent chats but never actually does anything, the model is too weak. Our best models for Hermes Agent ranking covers the current picks.

On Hostinger, there is a third option: nexos.ai credits purchased with the VPS act as a gateway to Claude, Gemini, and GPT models, and the API key is filled in automatically during deployment.

Step 4: Verify with a CLI Chat

Verify the agent works in the CLI before you connect anything else; this is the single most repeated piece of advice in both Hostinger's tutorial and the community threads. Start a session and fire a prompt that forces a tool call:

hermes
# then inside the session:
# "What's in my current directory?"

You should see a welcome banner listing the model, tools, and loaded skills, and the agent should actually run the command. Type /help to see what it can do, and /exit to leave. If you get empty responses or connection errors, the cause is almost always a wrong API key: run hermes doctor --fix to auto-diagnose and repair, or hermes setup to reconfigure the provider.

Step 5: Connect Telegram

Telegram is the most popular way to talk to Hermes because setup takes two minutes and the agent becomes a contact in your pocket. The flow, straight from the community setup guide:

1. Message @BotFather on Telegram and send /newbot. Name your bot and copy the token it gives you.
2. Run hermes gateway setup, select Telegram, and paste the token.
3. Get your numeric user ID by messaging @userinfobot on Telegram, then add it to the gateway allowlist in ~/.hermes/config.yaml so only you can command your agent.
4. Run hermes gateway run to start the bot, then message it from your phone.

Skipping the allowlist is a genuine security hole: anyone who finds the bot username could otherwise issue commands to a machine with terminal access. Full walkthrough with screenshots in our Hermes Agent Telegram setup guide.

Step 6: Back Up to GitHub

Everything that makes your agent yours lives in one directory: ~/.hermes holds the config, memory, skills, and sessions, with secrets separated into ~/.hermes/.env. The GitHub-backup-first workflow used across the 2026 setup courses is simple: create a private repo, generate a fine-grained personal access token scoped to only that repo, then hand it to the agent as config rather than pasting it into chat:

hermes config set GITHUB_TOKEN github_pat_XXXX

Then literally ask Hermes to "back up your memory and config to my private repo every night" and let it build the cron. Storing the token with hermes config set keeps it in the env file instead of the conversation history. More patterns in our Hermes Agent GitHub guide.

First Prompts to Try

The fastest way to learn Hermes is to ask Hermes; the community's number one onboarding tip is literally "install it and ask it about your concerns." Good first prompts:

• "What tools do you have enabled, and what can you help me with?"
• "Every weekday at 9am, message me my top three priorities based on what I told you yesterday." (your first cron)
• "Research the top three competitors to [your product] and summarize what they charge."
• "Create a skill for formatting my weekly report, then show me how you saved it."

Common First-Timer Mistakes

Five mistakes account for the majority of Hermes setup help requests on r/hermesagent and in Hostinger's own troubleshooting docs:

• Adding features before the CLI chat works. Connect Telegram or crons only after a verified terminal conversation, or you cannot tell which layer broke.
• Double installation. Installing via two methods creates conflicting ~/.hermes directories. Uninstall cleanly before switching methods.
• Tools disabled or stale sessions. Tools load at session start: after hermes tools changes, run /reset or the old session keeps the old toolset.
• Skipping the gateway allowlist. Without allowed_user_ids, anyone who finds your bot can talk to it.
• Weak free models. If the agent will not use tools, upgrade the model before debugging anything else.

Limitations and When Not to Bother

Hermes Agent is not a good fit if you want a polished consumer app: it is a power tool with a terminal-first culture, and you are the sysadmin. Budget for model costs on top of the server, expect occasional breakage after updates, and treat an agent with terminal access as a security surface: enable the Tirith command scanner defaults, keep gateway allowlists on, and give it separate accounts rather than your primary credentials. If you only need chat, a plain ChatGPT subscription is simpler; Hermes earns its keep when you want memory, crons, and hands that type.

Related Guides

• How to Run Hermes Agent on a Hostinger VPS (One-Click, ~10 Minutes)
• Hermes Agent Docker Setup: One-Click Template vs Manual Install
• Hermes Agent Telegram Setup Guide
• Hermes Agent Setup Guide (Original Walkthrough)