~$ hermes --alans-way --open-source

OPEN ALAN

Hermes, Alan's way — now open source.

Cloud brain. Private Mac tools. Stock Hermes.
Your agents live on your VM, reach into your Mac while it's awake, and keep working when the lid closes. One conversation on Telegram, a fleet that never sleeps — built on the Hermes you already run.

I. WHAT IT IS

OPENALAN IS A COMPANION, NOT A FORK.
A removable layer around a stock Hermes install: native plugins, hooks, skills and MCP — no patches to the agent, no second cloud brain, nothing you can't uninstall.

The VPS stays the authoritative mind — transcript, memory, cloud work. The Mac exposes only what you approve, over a private connection you already trust. Close the laptop and the work doesn't die; it routes home to the VM and keeps moving.

II. CAPABILITIES
◉

TELEGRAM, THE GATEWAY

Message it from any device — it never breaks. The most consistent front door for Hermes, with bot feedback and signals built in.

◫

ONE HOME, MANY WORKPLACES

Bots live on your VM and borrow your Mac while it's awake. Close the lid — cloud work keeps going; Mac-scoped jobs wait visibly, never silently re-homed.

▣

AGENT BROWSER

Real Chromium tabs each bot drives with a named, colored cursor — page tints while it works. Take over revokes its input instantly; give to agent hands it back.

◧

WINDOW INTO THE MACHINE

A noVNC viewer floats over the workspace — watch the VPS desktop live, or take control with real mouse, scroll and keys. Paste only when you click it.

◈

NATIVE PROACTIVITY

An optional plugin gives your existing primary initiative — reviews memory, tasks and watches, then picks one useful action or stays silent. Bounded: quiet hours, daily caps, pause/resume.

⑂

STOCK HERMES, NO FORK

Companion + gateway only. Your Hermes stays upstream — upgrade it freely, remove the layer freely.

⌗

THE BOUNDARY IS THE FEATURE

Three read-only Mac tools. One approved directory. Verified SSH with host keys, no shell, no writes, no credentials in view. Least privilege isn't a setting — it's the architecture.

III. HOW IT WORKS
┌──────────────┐         ┌────────────────────┐         ┌───────────────────────┐
│   TELEGRAM   │         │    VPS · HERMES    │         │   MAC · COMPANION     │
│ phone · mac  │ ──────> │ brain + transcript │ ──────> │ approved directory ·  │
│  one convo   │ <────── │ cloud execution    │         │ 3 read-only MCP tools │
└──────▲───────┘         └─────────┬──────────┘         └──────────▲────────────┘
       │                          │        SSH · verified          │
       │   Web A: the same         │         host keys             │ browser-MCP:
       │   chats inside the app    │                               │ bot drives
       │                           │   noVNC desktop stream        │ local Mac tabs
       │                           │   (watch · take control)      │
       │                           ▼                               │
       │               ┌────────────────────────────────────────────┘
       └─────────────> │              MAC DESKTOP APP                 │
                       │  same chats · agent Chromium tabs ·          │
                       │  VPS desktop viewer                          │
                       └──────────────────────────────────────────────┘

Operator setup — you bring SSH keys and merge a printed config; the companion installs no daemons and creates nothing itself. Needs Python 3.11+ and a running stock Hermes.

PLATFORMS · LINUX VPS BRAIN × MACOS LOCAL — APPLE SILICON BUILD
SOON · INTEL MAC · WINDOWS · LINUX LOCAL

01

Install the companion on Mac and VPS — a small Python CLI, nothing more. pip install .[mcp]

02

Approve one directory. Wire a private SSH route with verified host keys — the companion creates nothing itself.

03

Merge the printed config into stock Hermes. verify-mac proves the route. Desktop app optional.

IV. THE FIELD
COMPARATIO — CARVED IN STONE
OPEN ALAN GROKBOT MUSE HERMES
(STOCK)
Open source, self-hosted◆——◆
Runs on your own VM◆——◆
Message it from any device◆◐◐◐
One brain, many workplaces◆◆——
Drives real browser tabs on your Mac◆◐—◐
Watch & control the VPS desktop◆◐—◐
Cloud work survives a closed laptop◆——◐
Bounded proactivity (quiet hours, caps)◆◐◐—
Least-privilege local tools◆——◐
Skills · hooks · MCP extensibility◆◐—◆
◆ YES  ·  ◐ PARTIAL / MANUAL / CLAIMED  ·  — NO  ·  ALPHA — VERIFIED LIMITS IN DOCS

"Grokbot, Dot, Muse, or Instinct can never beat this."
— the launch