What you’ll need

  • An Apple Silicon Mac for the one-command VM route below — the quickest way to try it. (Other paths exist: a Linux PC via the installer ISO, Arch via makepkg, Omarchy, a tarball for other distros, or the macOS app as a .dmg. The README’s install table covers all seven.)
  • A model provider for Hermes. A Nous Portal account, or an API key from a provider Hermes supports — OpenRouter, OpenAI, Anthropic, a local model, and others. Herald OS shows a sign-in card the first time Hermes needs one.
  • A backup mindset. Herald OS is alpha (0.1); the author’s own warning: expect rough edges, and keep backups of anything you let an agent touch.

Step 1 — install Hermes Agent, the engine

Herald OS doesn’t fork Hermes — it runs a standard Hermes Agent install and adds its system abilities as a regular Hermes plugin (herald-os-bridge). Install it first and pick a model:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc
hermes setup

Step 2 — boot the whole OS in a virtual machine

On an Apple Silicon Mac, one command downloads the latest release’s VM disk (about 2.7 GB) and boots it with Apple’s virtualization, so the graphics are accelerated:

brew install qemu zstd
git clone https://github.com/iamlukethedev/Herald-OS.git && cd Herald-OS
bash linux/vm/try.sh

The first start sets itself up in a few minutes, Hermes Agent included. The machine boots to the Herald splash screen and signs you straight in — niri arranges the windows, Herald draws the menu bar, dock, notifications, and app launcher. Cmd+Ctrl+F leaves or re-enters fullscreen; Cmd+Q quits.

Step 3 — give Hermes a model

The first time Hermes needs to think, Herald OS shows a sign-in card: connect your Nous Portal account or paste a provider API key. From here on, every conversation, mission, and automation bills to that provider — the Usage page shows what Hermes used this week and month, what’s left on your plan, and warns at 90%.

Step 4 — take the tour: Overview, command bar, missions

The Overview is the home screen. Turn on “pick up where you left off” and Hermes looks at your recent documents, project folders (with their git state), conversations, and today’s calendar, then puts up to three threads of work on the Overview — Continue reopens a thread’s conversation, folder, and files, and its suggested next step starts only when you click it. The command bar handles every action in the OS: open pages and apps, add memories, run automations, start missions. Say “hey Hermes” and talk — it answers out loud and can operate the interface (“open missions”, “remember that my sister’s birthday is in May”).

Close-up of the Herald OS Overview: Hermes greeting, prompt box, and active missions
The Overview: Hermes greets you, a prompt box waits, and anything you ask for becomes a mission. Project screenshot by iamlukethedev/Herald-OS (MIT).

Step 5 — make it build something: Studio

Say “build a website for a hair salon” and watch it happen in one window: the project’s files, the code as it is written, the commands it runs, and a live preview. When a program crashes, a notification offers to have Hermes read the crash report and explain, in plain words, what went wrong and whether it’s worth reporting. Also in the box: Herald Canvas (a GPU image editor that opens and exports Photoshop files) and Herald Office (Docs, Sheets, Slides for Word/Excel/PowerPoint files — ask Hermes for a cover letter and watch each change land as an undoable step).

Step 6 — test the permission system

This is the part that makes an agent-OS livable. Ask Hermes to create and move a file, then to trash something:

  • read tools (system info, file search) and act tools (opening an app) run straight away and are logged.
  • mutate tools (create, move, rename) ask first — allow for the session or always.
  • destructive tools (stopping a process, moving files to the Trash) ask every time.
  • Some locations are always refused: ~/.ssh, your keychains, Hermes’s own credentials.

Settings > Privacy shows the policy and the audit log (~/.hermes/herald-os/audit.jsonl). One privacy note worth knowing: “pick up where you left off” reads names and dates — recent files and folders, project branches and commit messages, conversation titles, today’s event titles — never file contents, window titles, or the screen, and sends them to your Hermes model provider. It’s off until you turn it on, and Settings > Privacy turns it back off.

Close-up of the Herald OS Files app with Documents, Downloads, and Herald-OS folders
The Files app — one of the standard pages alongside Hermes, Missions, Memory, Automations, and Connections. Project screenshot by iamlukethedev/Herald-OS (MIT).

Prefer a different install?

  • macOS app: download HeraldOS-<version>-mac-arm64.dmg from the releases page, drag to Applications. It’s not notarized by Apple yet, so run xattr -dr com.apple.quarantine "/Applications/Herald OS.app" once first.
  • Arch: git clone the repo, cd Herald-OS/packaging/arch/herald-os-bin && makepkg -si, then herald-os setup. Choose Herald OS on your login screen for the full session (it needs niri) or herald-os-app inside your current desktop.
  • Omarchy: install the Arch package, then herald-os omarchy install — Super+Alt+H opens it.
  • Other Linux: download the tarball, verify the .sha256, extract to /opt/herald-os, run sudo /opt/herald-os/resources/herald-os-linux/bin/herald-os-tarball install, then herald-os setup.
  • A real PC: join the two .iso.part* files with cat, verify with shasum -a 256 -c, and install — Fedora underneath, everything you see is Herald. Updates come as whole system versions: herald-os update installs one, herald-os rollback goes back.

What you built

A running copy of an operating system where the agent is the interface: Hermes at the centre with Missions, Memory, Files, Automations, and Connections around it, a command bar for every action, Studio for building software while you watch, and a four-tier permission system with an audit log keeping the agent honest. One-click installs for tools like Claude Code, Codex, and local models are in the control menu when you want them.

Honest limitations

  • It’s alpha 0.1. Expect rough edges — and heed the author’s warning about backups before you let Hermes touch anything you care about.
  • Not a Nous Research product. Herald OS is an independent project by Luke The Dev; it isn’t affiliated with, sponsored by, or endorsed by Nous Research. It just runs their open-source Hermes Agent.
  • The agent isn’t free. Every thought bills your model provider — budget for it like any API usage, and watch the Usage page.
  • Platform caveats. The Mac app isn’t notarized yet; the one-command VM needs Apple Silicon (Intel Macs: install the Linux ISO in UTM, or build from source); the Arch package isn’t on the AUR yet.

Herald OS’s bet is that the desktop metaphor has run its course — that the next OS is a conversation with an agent that has hands. Five days and 429 stars suggest a lot of people want to see if that bet pays off. Now you can boot it and decide for yourself.