nickvasilescu/hermes-desktop-os1
nickvasilescu/hermes-desktop-os1Hermes Desktop - OS1 Edition: native macOS workspace for Hermes Agent on Orgo cloud computers and SSH hosts
From the README
Hermes Desktop - OS1 Edition
OS1 by Element Software · powered by Orgo · forked from Hermes Desktop
A native macOS interface for an AI agent that lives in a cloud computer. Inspired by Her (2013): warm coral on cream, thin type, calm motion.
Provision a cloud computer, hand it to the agent, and stay in one focused workspace: sessions, kanban, files, skills, cron jobs, and a real terminal. The infrastructure is Orgo; the agent on it is Hermes. The product you touch is OS1.
What you get
- Cloud computers, end to end: paste your API key once, pick a workspace, pick a computer (or create one), save. The app talks directly to the platform's HTTP API and the per-VM websocket terminal — no SSH, no gateway, no helper service on the VM.
- One-click agent install on a fresh computer. The first time you open the workspace and the agent isn't there, the Overview screen surfaces an "Install Hermes Agent" button. ~60–90 seconds later Sessions, Kanban, Files, Skills, and Cron all populate.
- Real interactive shell over the per-VM terminal websocket. Bytes stream in real time; resize works; output and history reflow cleanly.
- SSH connections still supported for hosts you reach over SSH today. Same flow as the upstream Hermes Desktop fork OS1 was built on.
- Everything else from the foundation: native Sessions browser with full-text search, Kanban board, file editor with conflict checks, skills viewer, cron job manager, profile-aware paths, English / Simplified Chinese / Russian localization scaffolding.
Requirements
- macOS 14 or newer (Apple Silicon or Intel — universal build)
- One of:
- An Orgo account with an API key (the cloud-computer infra powering OS1 — get a key at orgo.ai/settings/api-keys), OR
- A host you already reach with
sshfrom this Mac without interactive prompts (same flow as upstream Hermes Desktop)
For cloud computers, the app handles VM provisioning, agent
installation, and the websocket terminal automatically. For SSH
connections, the host needs python3 on the non-interactive SSH PATH
and Hermes already installed.
Install
Download the latest OS1.app.zip from the GitHub Releases page,
unzip it, drag OS1.app into /Applications, and launch.
The build is universal (Apple Silicon + Intel) and ad-hoc signed. On first launch macOS may say it can't verify the developer — right-click the app, choose Open, and confirm.
Setup
Cloud computer (recommended)
- Open the Connections tab → click Add Host
- Switch the transport picker to Orgo VM
- Paste your API key → click Verify & Save. The key persists in the macOS Keychain; subsequent connections reuse it.
- Pick a workspace from the dropdown.
- Pick a computer, or click Create new computer… to spin one up inline (defaults: Linux, 8 GB RAM, 4 CPU, 50 GB disk).
- Save → the connection is selectable from the host list.
- If the agent isn't installed o