Hermes3D is a free, open-source virtual office for your AI agents: instead of watching logs, you walk through a live 3D office where your agents work, run standups, review pull requests and pass tasks to each other. The latest update adds a 2D pixel office mode for low-power machines. I showed it in the video below. Here’s what Hermes3D is, how to install it from GitHub and how to connect it to Hermes.
Key takeaways
- Hermes3D is MIT-licensed and free, by Luke The Dev.
- Watch agents in a 3D office — or switch to the new 2D pixel office.
- Connect to Hermes, a custom runtime, or a demo gateway with no agent at all.
- Use Tailscale and an access token before exposing it beyond your machine.
What Hermes3D is
Hermes3D is the visual layer for an AI team. Your agents appear as workers moving through a shared office; you can see who’s busy, who’s stuck and what’s been handed to whom. It’s built by Luke The Dev — the same developer behind Herald OS — and the README is clear that it’s an independent community project, not made by the teams behind the agent backends it connects to.
| Hermes3D at a glance | |
|---|---|
| What it is | A 3D (and now 2D pixel) virtual office where you watch your AI agents work |
| Made by | Luke The Dev (iamlukethedev) — independent, not affiliated with the agent backends it connects to |
| Licence | MIT, free and open source |
| Release | Hermes3D 1.0.0 |
| GitHub | github.com/iamlukethedev/Hermes3D — 575+ stars, 120+ forks |
| Backends | Hermes (default), a custom HTTP runtime, or a built-in demo gateway |
| Built with | Next.js, React, TypeScript, Three.js / React Three Fiber, and Phaser for the 2D office |
What you can do in Hermes3D
- Watch agents work in real time in a shared 3D office.
- Switch to the 2D pixel office — a Gather-style view of the same agents for low-power machines (Settings → Office renderer).
- Run standups with agents connected to GitHub and Jira.
- Review pull requests from inside the office.
- Monitor QA pipelines and logs.
- Train agents in the gym to build new skills.
- Reset sessions with the janitor system.
- Edit office layouts in the office builder.
- Use the built-in Hermes Kanban board.
Want this working in your business, not just bookmarked? Running a team of AI agents in your business is exactly what we build together inside the AI Profit Boardroom — 3,400+ members, four live calls a week, and a full one-hour DeepSeek Harness course in the classroom.
Prefer it mapped 1-on-1 first? Book a free strategy session and we’ll plan it for your exact situation.
Join the AI Profit Boardroom →Book a Free Strategy Session →
How to install Hermes3D from GitHub
You need Node.js 20+ and npm 10+. Then:
git clone https://github.com/iamlukethedev/Hermes3D.git hermes3d
cd hermes3d
npm install
cp .env.example .env
npm run devOpen http://localhost:3000 and set the gateway URL and token in Studio. Hermes3D doesn’t install Hermes for you — have your Hermes backend running first.
Connect Hermes3D to Hermes
Hermes is the default backend. Run the bundled adapter alongside the app:
npm run hermes-adapter
npm run devThe adapter talks to the Hermes HTTP API (http://localhost:8642 by default). In the connect screen, choose the Hermes backend and use ws://localhost:18789. To make the office react to chats you have in Hermes Desktop, the TUI or the CLI, install the optional office bridge plugin from the repo.
Try Hermes3D without Hermes: demo mode
Just want to look around? Run the demo gateway, which creates demo agents with streaming chat and office presence:
npm run demo-gateway
npm run devConnect Studio to ws://localhost:18789 and choose the Demo backend.
Running Hermes3D remotely
- Tailscale (recommended): on the gateway host run
tailscale serve --yes --bg --https 443 http://127.0.0.1:18789, then usewss://<host>.ts.netin Studio. - SSH tunnel:
ssh -L 18789:127.0.0.1:18789 user@host, then usews://localhost:18789. - Sharing with other devices: start Studio with
HOST=0.0.0.0and setSTUDIO_ACCESS_TOKENfirst.
Set STUDIO_ACCESS_TOKEN and UPSTREAM_ALLOWLIST before exposing Hermes3D beyond your own machine. The README notes the gateway token is loaded into browser memory, so treat the browser as part of the trust boundary.
Hermes3D limitations
It’s a young project, and the README lists its own limits: the 3D office and the office builder are still separate stacks, voice transcription isn’t bundled, and the Spotify jukebox’s local login needs repeating when its token expires. None of that stops the core idea working — seeing your agents work — but expect some rough edges.
Hermes3D vs other agent interfaces
Hermes3D is about visibility: seeing a team of agents at once. Herald OS turns Hermes into your whole computer’s interface; Hermes Desktop is the official app; and my Agent OS runs Hermes alongside other agents with chat, voice and automations. Many people run Hermes3D next to one of those — see my best Hermes Agent UI guide. For the v1.0 launch story, see my Hermes agent office guide.
Who Hermes3D is for
Hermes3D is best for people running several agents at once — a research bot, a content bot, a coding bot — who want to see the whole team without opening ten terminals. It’s also great for demos: showing a client or your audience an office full of agents working is far more convincing than a log file. If you only run one agent, a normal dashboard is enough; Hermes3D shines once you have a team.
Developers will also like the runtime seam: you can point it at your own orchestrator through the custom HTTP runtime, so it isn’t limited to Hermes.
Hermes3D troubleshooting
If the app loads but won’t connect, the problem is usually between Studio and the gateway: check the gateway URL and token in Studio settings. An EPROTO or “wrong version number” error usually means you used wss:// against a non-TLS endpoint. Protocol-version errors mean your gateway is too old — update it, run the bundled Hermes adapter, or use the demo gateway. And a 401 “Studio access token required” means STUDIO_ACCESS_TOKEN is on and your browser is missing the access cookie.
My verdict on Hermes3D
Hermes3D is the most fun way to watch an AI team work, and the new 2D pixel mode makes it usable on almost any machine. Start in demo mode, connect Hermes when you’re ready, and lock it down before sharing it.
FAQ: hermes3d
What is Hermes3D?
A free, open-source 3D (and 2D pixel) office where you watch and interact with your AI agents.
Is Hermes3D free?
Yes — it’s MIT-licensed on GitHub.
Who made Hermes3D?
Luke The Dev (iamlukethedev); it’s an independent community project.
Does Hermes3D need Hermes Agent?
Hermes is the default backend, but you can use a custom runtime or the built-in demo gateway.
How do I install Hermes3D?
Clone the GitHub repo, run npm install, copy .env.example to .env and run npm run dev.
Two ways I can help from here. Join the AI Profit Boardroom — it’s where your AI agent team gets built with 3,400+ members doing the same.
Or grab a free strategy session and bring your questions.
Join the AI Profit Boardroom →Book a Free Strategy Session →
About Julian Goldie
I’m Julian Goldie — founder of Goldie Agency, best-selling author, and an AI educator with 428K+ YouTube subscribers. I’ve spent 10+ years in SEO and online business and I test every AI agent on my own work before I recommend it. Join the AI Profit Boardroom for the daily builds, or book a free strategy session to talk through yours.
Related reading
Last updated October 2026. This page is a living guide to hermes3d — the facts here move fast and it is updated as they do.
