iamlukethedev / Herald-OS

Herald OS 
 An agent-native operating system, with Hermes Agent as the interface.
Herald OS is an operating system built around an AI agent. Instead of working through menus and
folders yourself, you talk or type to Hermes, and it works across the whole machine: it opens apps,
finds and organises files, watches what is running, remembers what matters to you, runs routines on
a schedule, and builds software while you watch. Every action that changes something goes through a
permission system you control.
> [!NOTE]
> **Herald OS is an independent project by Luke The Dev.** It is
> not an official Hermes or Nous Research product, and it is not affiliated with, sponsored by or
> endorsed by Nous Research. Herald OS runs on Hermes Agent,
> the open-source agent Nous Research publishes, which is installed alongside it.
> **Status: alpha (0.1).** Expect rough edges, and keep backups of anything you let an agent
> touch.
## Install
Every download is on the releases page.
Pick the way that matches your machine:
| Your machine | What to install |
| --- | --- |
| A Mac, Apple Silicon or Intel | Herald OS for macOS |
| A PC you can give to Herald OS | The Herald OS Linux installer |
| Arch Linux | The Arch package |
| Omarchy | The Arch package, then one command |
| Another Linux | The tarball |
| An Apple Silicon Mac, to try the whole OS | The virtual machine in UTM |
| An Intel Mac, to try the whole OS | The x86_64 virtual machine |
| A Windows 11 PC, to try the whole OS | The virtual machine in Hyper-V |
Hermes needs a model provider whichever you pick: a Nous Portal
account, or an API key for 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, and Settings > Hermes &
agents > Model provider switches to another provider or takes its API key, a custom endpoint's
included.
### macOS
You need macOS 13 (Ventura) or later, on Apple Silicon or Intel (On an Intel Mac).
**1. Install Hermes Agent** and choose a model, if you don't have it yet:
 [code] 
**2. Install Herald OS.** Download `HeraldOS- -mac-arm64.dmg` (Apple Silicon) or
`HeraldOS- -mac-x64.dmg` (Intel) from the
releases page, open it and drag Herald OS to
Applications. Apple menu > About This Mac says which you have: "Chip: Apple M…" is Apple Silicon,
"Processor: … Intel …" is Intel.
**3. Let it open.** This build is not notarized by Apple yet, so macOS stops it the first time.
Run this once, then open Herald OS from Applications:
 [code] 
Or, without Terminal: open Herald OS once and close the warning, then go to System Settings >
Privacy & Security, scroll to Security, click Open Anyway next to "Herald OS was blocked", and
confirm with your password. Since macOS Sequoia, right-click > Open no longer skips the warning.
Herald OS takes over the screen: `Cmd+Ctrl+F` leaves or re-enters fullscreen and `Cmd+Q` quits. On
its first start it adds its system tools to Hermes (`~/.hermes/plugins/herald-os-bridge`)