Hermes Atlas
Desktop apps, web UIs & dashboards

Korgo Bot

nickvasilescu/korgo-bot

macOS desktop app for persistent Hermes-based bots that share a private Orgo cloud computer

In short

Korgo Bot is a macOS desktop app that packages the Hermes Agent runtime behind a bot-first interface, letting you create persistent bots, connect apps and share one private Orgo cloud computer. In cloud mode, bot state and tool execution live on that computer and are reached over Tailscale.

What Korgo Bot does

Korgo Bot lets you create multiple bots with separate identities and persistent conversations, switch between them without losing each bot's canonical Bot Chat, and mention them with @handles in group chats. Your Mac runs the desktop UI. With cloud mode enabled, bot profiles, conversations, memory, skills and tool execution live on an Orgo computer, which the Mac reaches over a private Tailscale connection.

Every bot can use one shared Orgo cloud computer through direct screen, shell and file tools, or delegate a bounded GUI task to Orgo's hosted computer-use agent, while a built-in desktop viewer lets you watch and control the machine. Shared apps connect through Composio. The README calls it a source-first preview: running from the repository is the supported path, and a local .app or DMG can be built but is not notarized for public download. Setup provisions an Orgo computer with 8 GB RAM and 4 CPU cores.

Key features

  • Multiple bots with separate identities and a persistent Bot Chat each
  • Group chats with @handle mentions
  • Shared Orgo cloud computer with screen, shell and file tools
  • Delegated GUI tasks through Orgo's hosted computer-use agent
  • Connected apps through Composio
  • Built-in desktop viewer to watch and control the cloud computer

When to use it

  • Running several named bots that share one cloud computer
  • Keeping Hermes and bot state in the cloud instead of tying it to your laptop
  • Delegating a GUI task to a hosted computer-use agent from a bot chat

Who it is for: Mac users who want persistent Hermes-powered bots with a shared cloud computer and are comfortable running a source-first preview.

How it fits with Hermes Agent

It packages the Hermes Agent runtime behind its interface and verifies that Hermes is installed on the Orgo computer, pinned to Orgo's system/hermes-agent@1.0.0 template.

How to install Korgo Bot

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/nickvasilescu/hermes-bots.git
cd hermes-bots
./scripts/setup-hermes-bots.sh --verify --run

Requirements: A Mac, Git, Node.js 22.22 or newer, a supported npm release and uv; an Orgo account and API key, a Tailscale account and Mac app, and a ChatGPT/Codex subscription or xAI Grok account; optionally a Composio Connect key

Note: It is a source-first macOS preview that needs an Orgo account (plan credits may be consumed), a Tailscale account and a ChatGPT/Codex subscription or xAI Grok account, and it is not distributed as a notarized download.

FAQ

What is Korgo Bot?

Korgo Bot is a macOS desktop app for creating persistent AI bots, giving them connected apps and letting them share a private cloud computer. It wraps the Hermes Agent runtime in a bot-first interface.

Does Korgo Bot work with Hermes Agent?

Yes. It packages the Hermes Agent runtime, and in cloud mode it verifies Hermes is installed on the Orgo computer. Bot profiles, memory, skills and tool execution then live there.

What do I need to run Korgo Bot?

You need a Mac, Git, Node.js 22.22 or newer, uv, an Orgo account with an API key and a Tailscale account. You also need a ChatGPT/Codex subscription or an xAI Grok account, and optionally a Composio Connect key for shared apps.

Similar interfaces for Hermes Agent

All interfaces

Related guides: Connect Hermes agents on several machines with Hermes Desktop · How to install Hermes Agent