~$ 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 running. Shut the lid — tasks route back to the cloud automatically.

▣

AGENT BROWSER

A real browser your agents drive, app-style. Watch them work the page — or take the wheel whenever you want.

◧

WINDOW INTO THE MACHINE

A controllable live view of each bot's virtual desktop. Near-seamless handoff between local and remote.

◈

NATIVE PROACTIVITY

A lead bot that oversees the fleet and finds work worth doing, 24/7. Deeper than a skill or a cron job — a temperament.

⑂

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    │
│  any device │───────>│   brain + transcript   │───────>│  approved directory │
│             │<───────│   cloud execution      │<───────│  read-only MCP ×3   │
└─────────────┘        └───────────┬────────────┘        └─────────────────────┘
                                   │  private SSH · verified host keys
                          ┌────────┴────────┐
                          │  DESKTOP APP    │
                          │  fleet · desks  │
                          │  agent browser  │
                          └─────────────────┘
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. Done.

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◆◆——
Agent-driven browser on your machine◆◐——
Watch & control bot desktops live◆◐——
Laptop closes, work routes to cloud◆———
Proactive lead bot, 24/7◆◐◐—
Least-privilege local tools◆——◐
Skills · hooks · MCP extensibility◆◐—◆
◆ YES  ·  ◐ PARTIAL / MANUAL  ·  — NO

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