Skip to content

README.md

Latest commit

 

History

History
122 lines (86 loc) · 4.54 KB

README.md

File metadata and controls

122 lines (86 loc) · 4.54 KB

Superhuman - Personal AI Assistant

CI status GitHub release MIT License

Superhuman is a personal AI assistant you run on your own devices. One Gateway gives you the same assistant across chat apps, the web dashboard, and paired devices.

It is built for people who want an assistant they control: self-hosted, multi-device, and available from the tools they already use.

Website · Docs · Getting Started

Highlights

  • One Gateway for chat, sessions, tools, automation, and the web dashboard
  • Multi-channel messaging across WhatsApp, Telegram, Slack, Discord, Signal, iMessage/BlueBubbles, Matrix, WebChat, and more
  • Paired devices for macOS, iOS, and Android, plus Canvas and browser automation
  • Multi-agent routing with workspace-backed skills and per-session isolation controls

Install

Runtime: Node 24 (recommended) or Node 22.14+.

npm install -g @lpfchan/superhuman@latest
# or: pnpm add -g @lpfchan/superhuman@latest

superhuman onboard --install-daemon

The onboarding flow is the recommended setup path on macOS, Linux, and Windows via WSL2.

Quick start

superhuman onboard --install-daemon

superhuman gateway --port 18789 --verbose

superhuman message send --to +1234567890 --message "Hello from Superhuman"
superhuman agent --message "Ship checklist" --thinking high

Already using OpenClaw? See Updating and OpenClaw to Superhuman migration.

How it works

Channels / WebChat / Apps
           |
           v
+-------------------------------+
|            Gateway            |
|       ws://127.0.0.1:18789    |
+---------------+---------------+
                |
                +-- agent runtime
                +-- CLI
                +-- Control UI
                +-- macOS / iOS / Android nodes

Configuration

Canonical config: ~/.superhuman/superhuman.json.

{
  agent: {
    model: "anthropic/claude-opus-4-6",
  },
}

More: Configuration · Config/state migration

From source

Prefer pnpm for builds from source. Bun is optional for running TypeScript directly.

git clone https://github.com/LPFchan/Superhuman.git
cd Superhuman

pnpm install
pnpm ui:build
pnpm build

pnpm superhuman onboard --install-daemon
pnpm gateway:watch

pnpm superhuman ... runs TypeScript directly via tsx. pnpm build produces dist/ for Node and the packaged superhuman binary.

Security notes

Superhuman can connect to real messaging surfaces and run tools on your machine. Treat inbound DMs as untrusted input.

  • DM pairing is the default for supported messaging channels.
  • Approve new senders with superhuman pairing approve <channel> <code>.
  • For safer multi-user setups, set agents.defaults.sandbox.mode: "non-main" so non-main sessions run inside per-session sandboxes.
  • Run superhuman doctor after upgrades or config changes.

More: Security · Gateway runbook · Doctor

Docs

Contributing

See CONTRIBUTING.md for contribution guidelines.