Codespaces Hermes Server
skappafrost/codespaces-hermes-server
Step-by-step guide to running Hermes Agent on GitHub Codespaces with Tailscale remote access
Codespaces Hermes Server is a seven-part guide, in English and Vietnamese, for running Hermes Agent on a GitHub Codespace and connecting to it remotely over Tailscale. A devcontainer config installs Hermes and starts the server automatically.
What Codespaces Hermes Server does
The repository turns a GitHub Codespace into a personal Hermes backend without a VPS. A .devcontainer folder holds devcontainer.json, postCreate.sh, which installs Hermes Agent once, and postStart.sh, which starts Tailscale and hermes serve --port 9119 on every restart. Tailscale gives the Codespace a stable 100.x.x.x address, and Hermes Desktop or the CLI on your own computer connects to http://100.x.x.x:9119 with a username and password.
The guide has seven parts: creating a GitHub account, creating a private repository, setting up the .devcontainer, configuring the idle timeout, creating a Codespace, installing Hermes and connecting remotely, and managing the Codespace with the gh CLI using start and stop shortcuts. It is designed around GitHub Free limits, which the README gives as 120 core-hours per month, and it includes a Free versus Pro comparison and a SECURITY.md.
Key features
- Devcontainer that installs Hermes Agent on first create
- Tailscale and hermes serve start automatically on every Codespace restart
- Remote connection from Hermes Desktop or the CLI over a Tailscale address with no public IP
- Seven-part guide in English and Vietnamese
- gh CLI start and stop shortcuts for the Codespace
When to use it
- Running a personal Hermes backend without renting a VPS
- Connecting Hermes Desktop on a laptop to a remote server over a private Tailscale network
- Following a beginner-oriented walkthrough for setting up a remote Hermes agent
Who it is for: Beginners who want a remote Hermes Agent backend on GitHub's free tier instead of a paid server.
How it fits with Hermes Agent
A deployment guide for Hermes Agent: the Codespace installs Hermes, runs hermes serve and is reached from Hermes Desktop or the CLI.
Requirements: A GitHub account with Codespaces, and Tailscale on both the Codespace and your computer
Note: The setup depends on GitHub Codespaces and Tailscale, and the README cites a free-tier allowance of 120 core-hours per month.
FAQ
What is Codespaces Hermes Server?
Codespaces Hermes Server is a step-by-step guide for turning a GitHub Codespace into a personal Hermes Agent backend. It uses a devcontainer to install Hermes and Tailscale to reach it remotely, and it is written in English and Vietnamese.
Does Codespaces Hermes Server work with Hermes Agent?
Yes, it is a deployment guide for Hermes Agent. The Codespace runs hermes serve on port 9119, and Hermes Desktop or the CLI on your computer connects to it over Tailscale.
Is Codespaces Hermes Server free and open source?
The repository is MIT licensed. The guide is designed around GitHub Free, with the README citing 120 core-hours per month, and around Tailscale, and both services have their own pricing pages.
Similar deployment for Hermes Agent
All deploymentWindows-native adaptation of Hermes Agent with a PowerShell installer and browser Web UI
stubbi Hermes OperatorKubernetes operator for Hermes Agent with security defaults, S3 backups and OCI auto-update
markwang2658 Hermes Windows NativeWindows-native Hermes Agent and WebUI bundle with a shared venv and one-click PowerShell start
Godde3s Hermes StackHermes Agent, 9Router and OmniRouter on a free Hugging Face Space with a deploy wizard and hourly backups
arjunkomath Hermes Agent Railway TemplateOne-click Railway template that deploys the official Hermes Agent image with its dashboard
hermeum HermeumKubernetes platform for creating, running and managing autonomous Hermes agents for a team
Related guides: How to run Hermes Agent securely · How to install Hermes Agent · Connect Hermes agents on several machines with Hermes Desktop