Tinyhumansai/openhuman: Your Personal AI super intelligence

Notifications You must be signed in to change notification settings

Fork 405

Star 4.9k

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

1,773 Commits

1,773 Commits

.agents/agents

.agents/agents

.claude

.claude

.codex/commands

.codex/commands

.do

.do

.github

.github

.husky

.husky

.vscode

.vscode

app

app

docs

docs

e2e

e2e

examples

examples

gitbooks

gitbooks

packages

packages

remotion

remotion

scripts

scripts

src

src

tests

tests

.dockerignore

.dockerignore

.env.example

.env.example

.gitignore

.gitignore

.gitmodules

.gitmodules

AGENTS.md

AGENTS.md

CLAUDE.md

CLAUDE.md

CODEX_WORKPAD.md

CODEX_WORKPAD.md

CODE_OF_CONDUCT.md

CODE_OF_CONDUCT.md

CONTRIBUTING.md

CONTRIBUTING.md

Cargo.lock

Cargo.lock

Cargo.toml

Cargo.toml

Dockerfile

Dockerfile

LICENSE

LICENSE

README.md

README.md

SECURITY.md

SECURITY.md

docker-compose.yml

docker-compose.yml

package.json

package.json

pnpm-lock.yaml

pnpm-lock.yaml

pnpm-workspace.yaml

pnpm-workspace.yaml

rust-toolchain.toml

rust-toolchain.toml

Repository files navigation

OpenHuman is your Personal AI super intelligence. Private, Simple and extremely powerful.

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

Early Beta: Under active development. Expect rough edges.

To install or get started, either download from the website over at tinyhumans.ai/openhuman or run

Download DMG, EXEs over at https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme or run in from your terminal

For macOS or Linux x64

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

For Windows

irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

What is OpenHuman?

OpenHuman is an open-source agentic assistant designed to integrate with you in your daily life. Each bullet links to the deeper writeup in the docs.

Simple, UI-first & Human A clean desktop experience and short onboarding paths take you from install to a working agent in a few clicks — no config-first setup, no terminal required. The agent has a face: a desktop mascot that speaks, reacts to its surroundings, joins your Google Meets as a real participant, remembers you across weeks, and keeps thinking in the background even when you've stopped typing.

118+ third-party integrations with auto-fetch: plug into Gmail, Notion, GitHub, Slack, Stripe, Calendar, Drive, Linear, Jira and the rest of your stack with one-click OAuth. Every connection is exposed to the agent as a typed tool, and every twenty minutes the core walks each active connection and pulls fresh data into the memory tree. No prompts, no polling loops you have to write, so the agent already has tomorrow's context this morning.

Memory Tree + Obsidian Wiki: a local-first knowledge base built from your data and your activity. Everything you connect is canonicalized into ≤3k-token Markdown chunks, scored, and folded into hierarchical summary trees stored in SQLite on your machine. The same chunks land as .md files in an Obsidian-compatible vault you can open, browse and edit, inspired by Karpathy's obsidian-wiki workflow.

Batteries included: web search, a web-fetch scraper, a full coder toolset (filesystem, git, lint, test, grep), and native voice (STT in, ElevenLabs TTS out, mascot lip-sync, live Google Meet agent) are wired in by default. Model routing sends each task to the right LLM (reasoning, fast, or vision) under one subscription. No "install a plugin to read files" friction. Optional local AI via Ollama for on-device workloads.

Smart token compression (TokenJuice): every tool call, scrape result, email body, and search payload is run through a token compression layer before it touches any LLM Model. HTML is converted to Markdown, long URLs are shortened, non-ASCII characters are removed etc... You get the same information but at a fraction of the tokens. Reducing cost & latency by up to 80%.

Messaging channels and privacy & security: inbound/outbound across the channels you already use, with workflow data that stays on device, encrypted locally, treated as yours.

Contributing from source

New contributor? Start with CONTRIBUTING.md for the fork/PR workflow and local validation commands. The short path is:

Install Git, Node.js 24+, pnpm 10.10.0, Rust 1.93.0 (rustfmt + clippy), CMake, 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.

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

Integrations ⚠️ Few connectors ⚠️ BYO ⚠️ BYO 🚀 118+ via OAuth

Auto-fetch 🚫 None 🚫 None 🚫 None ✅ 20-min sync into memory

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 + voice

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.

About

Your Personal AI super intelligence. Private, Simple and extremely powerful.

tinyhumans.ai/openhuman

Resources

Readme

License

GPL-3.0 license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy

Uh oh!

There was an error while loading. Please reload this page.

Activity

Custom properties

Stars

4.9k stars

Watchers

28 watching

Forks

405 forks

Report repository

Releases 33

OpenHuman v0.53.40

Latest

May 13, 2026

+ 32 releases

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

Rust 69.6%

TypeScript 26.2%

JavaScript 2.2%

Shell 1.7%

CSS 0.2%

PowerShell 0.1%