<h1 align="center">OpenHuman</h1> <p align="center"> <img src="./gitbooks/.gitbook/assets/demo.png" alt="The Tet" /> </p> <p align="center" style="display: inline-block"> <a href="https://trendshift.io/repositories/23680" target="_blank" style="display: inline-block"> <img src="https://trendshift.io/api/badge/repositories/23680" alt="tinyhumansai%2Fopenhuman | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/> </a> <a href="https://www.producthunt.com/products/openhuman?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer"> <img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1136902&amp;theme=light&amp;period=daily&amp;t=1778916022823"> </a> <a href="https://www.producthunt.com/products/openhuman?embed=true&amp;utm_source=badge-top-post-badge&amp;utm_medium=badge&amp;utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer"> <img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1136902&amp;theme=light&amp;period=weekly&amp;t=1779351403565"> </a> </p> <p align="center" style="display: inline-block"> <a href="https://www.producthunt.com/products/openhuman?embed=true&amp;utm_source=badge-top-post-topic-badge&amp;utm_medium=badge&amp;utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer"> <img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-topic-badge.svg?post_id=1136902&amp;theme=light&amp;period=weekly&amp;topic_id=268&amp;t=1779351808756"> </a> <a href="https://www.producthunt.com/products/openhuman?embed=true&amp;utm_source=badge-top-post-topic-badge&amp;utm_medium=badge&amp;utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer"> <img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-topic-badge.svg?post_id=1136902&amp;theme=light&amp;period=weekly&amp;topic_id=46&amp;t=1779351808756"> </a> </p> <p align="center"> <strong>OpenHuman is your personal AI super intelligence: a brain that remembers everything, a fantastic orchestrator, a deep researcher. Local-first, simple, powerful.</strong> </p> <p align="center"> <a href="https://github.com/tinyhumansai/openhuman/discussions">Discussions</a> • <a href="https://discord.tinyhumans.ai/">Discord</a> • <a href="https://www.reddit.com/r/tinyhumansai/">Reddit</a> • <a href="https://x.com/intent/follow?screen_name=tinyhumansai">X/Twitter</a> • <a href="https://tinyhumans.gitbook.io/openhuman/">Docs</a> • <a href="https://x.com/intent/follow?screen_name=senamakel">Follow @senamakel (Creator)</a> </p> <p align="center"> 🇺🇸 <a href="./README.md">English</a> | 🇨🇳 <a href="./docs/README.zh-CN.md">简体中文</a> | 🇯🇵 <a href="./docs/README.ja-JP.md">日本語</a> | 🇰🇷 <a href="./docs/README.ko.md">한국어</a> | 🇩🇪 <a href="./docs/README.de.md">Deutsch</a> | 🇵🇰 <a href="./docs/README.ur-pk.md">اردو</a> </p> <p align="center"> <img src="https://img.shields.io/badge/status-early%20beta-orange" alt="Early Beta" /> <a href="https://github.com/tinyhumansai/openhuman/releases/latest"><img src="https://img.shields.io/github/v/release/tinyhumansai/openhuman?label=latest" alt="Latest Release" /></a> <a href="https://github.com/tinyhumansai/openhuman/stargazers"><img src="https://img.shields.io/github/stars/tinyhumansai/openhuman?style=flat" alt="GitHub Stars" /></a> <a href="./LICENSE"><img src="https://img.shields.io/github/license/tinyhumansai/openhuman" alt="License" /></a> </p>

Early Beta: Under active development. Expect rough edges.

OpenHuman is not AGI. But it is a meaningful architectural step closer, with better memory, better orchestration, and better tooling.

🎉 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 (Homebrew, Debian/Ubuntu .deb, AUR, install scripts, and platform notes), see INSTALL.md.

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, so it has tomorrow's context this morning.
• 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: 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: checkpointed graph runs on open-source tinyagents. Stuck agents get steered, halted ones return a root cause, and every run replays with real per-call costs.
• A split brain, always on: a fast reflex agent triages inbound traffic while a deep reasoning core delegates to worker fleets, steered by the subconscious.

🔬 The deep researcher & doer

• Batteries included: managed web search, powered by Exa, is included with your OpenHuman subscription and needs no API key; bring your own Exa key to search directly on your own Exa account and billing. Plus scraper, coder toolset, a real browser, and native voice with in-process Whisper. Model routing picks the right LLM per workload on one subscription. That subscription is a default, not a lock-in: point any workload at your own provider key or a fully local Ollama model, and mix the three however you like.
• Image & video generation: 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, with no config files and 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, and opt-in sandboxing. There is also Privacy Mode: flip 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.

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.

<p align="center"> <img src="./gitbooks/.gitbook/assets/memory.png" alt="OpenHuman context-building diagram"> </p>

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

Most agent harnesses run one agent in one loop. OpenHuman is an orchestrator:

<p align="center"> <img src="./gitbooks/.gitbook/assets/orchestration.png" alt="OpenHuman orchestration diagram"> </p>

Agent-to-agent messaging runs over Signal-protocol end-to-end encryption, so you can connect anything (Claude Code, Codex, OpenClaw, Hermes) and use OpenHuman to orchestrate all of your agents and tools.

• Graphs, not loops: turns run as checkpointed graphs on tinyagents. They pause for a human, survive a restart, and resume mid-run.
• Sub-agent fleets: specialists spawn three levels deep; stuck agents become root-cause reports.
• Agent-to-agent, encrypted: instances orchestrate each other over Signal-protocol E2E sessions with x402 payments. No server ever sees plaintext.