OpenHuman is your personal AI super intelligence: a brain that remembers everything, a fantastic orchestrator, a deep researcher. Local-first, simple, powerful.

Discord • Reddit • X/Twitter • Docs • Follow @senamakel (Creator)

Early Beta: Under active development. Expect rough edges.

🎉 Within one week of launch, OpenHuman became the number one trending repository on GitHub for nine days in a row.

Install

Download installers from tinyhumans.ai/openhuman or from the GitHub Releases page. For terminal installs, the native package paths below are preferred because they use your OS package manager or native installer where available.

Recommended install (native packages)

These paths use native installer surfaces. Homebrew and MSI provide their normal signing/integrity checks; Debian/Ubuntu uses apt-get to install the release .deb and resolve system dependencies.

macOS (Homebrew tap):

brew tap tinyhumansai/core
brew install openhuman

Linux (Debian/Ubuntu — release .deb):

# Download OpenHuman_<version>_amd64.deb or OpenHuman_<version>_arm64.deb
# from https://github.com/tinyhumansai/openhuman/releases/latest, then:
# Replace amd64 with arm64 on arm64 hosts.
sudo apt-get install -y --no-install-recommends ./OpenHuman_*_amd64.deb

Linux (Arch — AUR): the openhuman-bin AUR recipe is in the repo. Once published, Arch users can install it with yay -S openhuman-bin.

Windows: download the signed .msi from the latest release and run it.

Manual .dmg / .deb / .AppImage / .msi: grab the installer for your platform directly from the latest release page.

Linux: the AppImage can crash on launch under Wayland, miss host system libraries such as libgbm.so.1, or fail on Arch-based distros with sharun: Interpreter not found! — see #2463 for the cause and env-var workarounds. The .deb package above avoids those failure modes on Debian/Ubuntu by letting apt resolve runtime dependencies.

Alternative: script install (no integrity check)

Warning — unverified install. These scripts are served live from raw.githubusercontent.com and do not ship a separate signature, so curl … | bash and irm … | iex have no way to detect tampering of the script bytes. Prefer the native package paths above whenever possible. If you must use the script, see "Verified script install" below.

# macOS or Linux x64
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

On Debian/Ubuntu, install.sh resolves the latest release .deb first and installs it with apt-get so runtime dependencies are handled by apt. Set OPENHUMAN_INSTALLER_LINUX_PACKAGE=appimage to force the AppImage path.

Verified script install status

A separately signed script-install path is not currently available. Issue #2620 is closed after the native package paths were promoted, but current release assets do not include install.sh.asc / install.ps1.asc for pre-execution script verification. Treat the script install path as unverified and prefer the native package options above when possible.

What is OpenHuman?

OpenHuman is three things most assistants aren't: a brain that builds a persistent, local memory of your world; a fantastic orchestrator that runs fleets of agents on durable graphs; and a deep researcher that sweeps your data and the web before you finish asking. Every bullet links to the deeper writeup in the docs.

🧠 The brain

Memory Tree + Obsidian Wiki: your data compressed into scored Markdown trees in SQLite on your machine, mirrored as an Obsidian vault you can open and edit. No vector-soup black box.
100+ OAuth integrations, 5,000+ MCP servers, 90,000+ Skills: one click into Gmail, Notion, GitHub, Slack and the rest of your stack. Auto-fetch feeds the brain every 20 minutes — it has tomorrow's context this morning.
A subconscious: a background loop that diffs your world, advances your goals, and writes your morning briefing — thinking continues after you stop typing.
Goals & Todos: long-term goals, durable per-thread goals, and a shared kanban board per conversation.
TokenJuice: tool output compressed before it hits the model — same information, up to 80% fewer tokens. A brain this big would be unaffordable without it.

🕸️ The orchestrator

Workflows (new): the agent proposes the automation; you review it on a canvas and save. Durable, trigger-driven, approval-gated runs on open-source tinyflows.
A harness that finishes the job (new): checkpointed graph runs on open-source tinyagents — stuck agents get steered, halted ones return a root cause, every run replays with real per-call costs.
A split brain, always on (new): a fast reflex agent triages inbound traffic while a deep reasoning core delegates to worker fleets, steered by the subconscious.
An agent economy: a @handle on tiny.place, Signal-encrypted agent-to-agent orchestration, x402 USDC bounties and trading — keys never touch disk.

🔬 The deep researcher & doer

SuperContext: a research scout sweeps your memory and files before the model reads your first message. No cold starts.
Batteries included: web search, scraper, coder toolset, a real browser, native voice with in-process Whisper — and model routing that picks the right LLM per workload, one subscription, local AI optional.
Meeting agents (new): joins Meet, Zoom, Teams, and Webex with a face and a voice — auto-joins from your calendar, streams a live transcript, answers by name, files summary + action items.
Image & video generation (new): Seedream/SeedEdit images and Seedance/Veo video, straight into your workspace on the same subscription.
17 messaging channels: Telegram, Discord, Slack, WhatsApp, Signal, iMessage… plus native email (IMAP IDLE + SMTP). Your agent reaches you where you already are.

🧍 Human, private, yours

Simple, UI-first & Human: install to working agent in a few clicks — no config files, no terminal. And it has a face: a mascot that speaks, reacts, and remembers you.
Privacy & security: on-device encrypted data, approval gate, OS-keyring secrets, opt-in sandboxing — and (new) Privacy Mode: one switch and no inference leaves your machine, enforced in the Rust core.
Themes & Theme Studio: five theme families plus a full visual editor, exportable as JSON.

Contributing from source

New contributor? Start with CONTRIBUTING.md for the fork/PR workflow and local validation commands, or use the copy-paste AI-agent prompt in CONTRIBUTING-BEGINNERS.md. The short path is:

Install Git, Node.js 24+, pnpm 10.10.0, Rust 1.93.0 (rustfmt + clippy), CMake, Ninja, ripgrep, and the platform desktop build prerequisites.
Fork and clone the repo, then run git submodule update --init --recursive before pnpm install so the vendored Tauri/CEF sources are present.
Use pnpm dev for web-only UI work, pnpm --filter openhuman-app dev:app for the desktop shell, and focused checks such as pnpm typecheck, pnpm format:check, and cargo check -p openhuman --lib before opening a PR.

Deeper docs: Architecture · Getting Set Up · Cloud Deploy.

Context in minutes, not weeks

OpenHuman is the first agent harness that gets to know you in minutes. Inspired by Karpathy's LLM Knowledgebase. Most agents start cold. Hermes learns by watching you work; OpenClaw waits for plugins to ferry context in. Either way, you spend days or weeks before the agent knows enough about your stack to be genuinely useful.

OpenHuman summarizes and compresses all your documents, emails & chats; and creates a memory graph that lets your agent remember everything about you.

OpenHuman skips the wait. Connect your accounts, let auto-fetch pull data locally on a 20-minute loop, and then have Memory Trees compress everything into Markdown files stored intelligently in a Karpathy-style Obsidian wiki.

In just one sync pass, the agent has full (compressed) context of your inbox, your calendar, your repos, your docs, your messages. No training period. No "give it a few weeks.". It becomes you, controlled by you.

Already self-host agentmemory across other coding agents? OpenHuman ships an optional Memory backend that proxies to it — set memory.backend = "agentmemory" in config.toml and the same durable store powers OpenHuman alongside Claude Code, Cursor, Codex, and OpenCode. See the agentmemory backend page for setup.

An orchestrator, not a chatbot

The deepest difference isn't any single feature — it's the execution model. Claude Code, OpenClaw, and Hermes run one agent in one loop. OpenHuman is an orchestrator:

Graphs, not loops — turns compile to checkpointed state-machine graphs on tinyagents: pause for a human, survive a restart, resume mid-run.
Sub-agent fleets — specialists spawn three levels deep, idle workers get reused, and circuit breakers turn stuck agents into root-cause reports.
Workflows you can see — agent-proposed tinyflows graphs, reviewed on a canvas: durable, trigger-driven, approval-gated.
A split brain, always on — a fast reflex agent triages while a deep core reasons, steered by the subconscious loop.
Agent-to-agent, encrypted — instances orchestrate each other over Signal-protocol E2E sessions with consent-based pairing and x402 payments. No server sees plaintext.
Next: RLMs — the model writing its own orchestration code in a sandboxed REPL, on the same graph engine and trust model.

OpenHuman vs Other Agent Harnesses

High-level comparison (products evolve, so verify against each vendor). OpenHuman is built to minimize vendor sprawl, keep workflow knowledge on-device, and give the agent a persistent memory of your data, not only chat.

	Claude Cowork	OpenClaw	Hermes Agent	OpenHuman
Open-source	🚫 Proprietary	✅ MIT	✅ MIT	✅ GNU
Simple to start	✅ Desktop + CLI	⚠️ Terminal-first	⚠️ Terminal-first	✅ Clean UI, minutes
Cost	⚠️ Sub + add-ons	⚠️ BYO models	⚠️ BYO models	✅ One sub + TokenJuice
Memory	✅ Chat-scoped	⚠️ Plugin-reliant	✅ Self-learning	🚀 Memory Tree + Obsidian vault, optional agentmemory backend
Integrations	⚠️ Few connectors	⚠️ BYO	⚠️ BYO	🚀 100+ OAuth · 5k+ MCP · 90k+ Skills
Auto-fetch	🚫 None	🚫 None	🚫 None	✅ 20-min sync into memory
Orchestration	⚠️ Sub-tasks	⚠️ Single loop	⚠️ Single loop	🚀 Agent graphs + checkpoints + E2E-encrypted A2A
Workflows	🚫 None	⚠️ Scripts	⚠️ Scripts	🚀 Visual, durable, agent-proposed, approval-gated
Meetings	🚫 None	🚫 None	🚫 None	🚀 Joins Meet/Zoom/Teams/Webex, speaks, live transcript
Messaging channels	🚫 None	⚠️ A few	⚠️ A few	✅ 17 incl. native email (IMAP/SMTP)
Local-only mode	🚫 Cloud-only	⚠️ BYO local	⚠️ BYO local	✅ One-switch enforced Privacy Mode
Observability	🚫 Opaque	⚠️ Logs	⚠️ Logs	✅ Replayable run journals + per-call cost accounting
API sprawl	🚫 Extra keys	🚫 BYOK	🚫 Multi-vendor	✅ One account
Model routing	🚫 Single model	⚠️ Manual	⚠️ Manual	✅ Built-in
Native tools	✅ Code-only	✅ Code-only	✅ Code-only	✅ Code + search + scraper + browser + voice + media gen

Star us on GitHub

Building toward AGI and artificial consciousness? Star the repo and help others find the path.

Contributors Hall of Fame

Show some love and end up in the hall of fame. Contributors get free merch and special access to our Discord.