- OpenHuman is your Personal AI super intelligence: local memory, managed services where needed, simple and powerful.
+ OpenHuman is your personal AI super intelligence: a brain that remembers everything, a fantastic orchestrator, a deep researcher. Local-first, simple, powerful.
@@ -58,7 +54,7 @@
> **Early Beta**: Under active development. Expect rough edges.
-> **Local + managed services, upfront:** OpenHuman stores its Memory Tree, Obsidian-style Markdown vault, workspace config, and local runtime state on your machine. The default managed experience still uses OpenHuman-hosted services for account sign-in, model routing, web search proxying, and managed integration/OAuth flows through the Composio connector layer. Choose custom/local settings if you want to bring your own model, search, or Composio credentials; some real-time triggers and hosted features still require the managed backend.
+> 🎉 Within one week of launch, OpenHuman became the number one trending repository on GitHub for nine days in a row.
# Install
@@ -112,27 +108,36 @@ A separately signed script-install path is not currently available. Issue [#2620
# 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](https://tinyhumans.gitbook.io/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](https://tinyhumans.gitbook.io/openhuman/).
-- **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](https://tinyhumans.gitbook.io/openhuman/features/mascot): a desktop mascot that speaks, reacts to its surroundings, [joins your Google Meets](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents) as a real participant, remembers you across weeks, and keeps thinking in the background even when you've stopped typing.
+### 🧠 The brain
-- **100+ one-click OAuth integrations, 5,000+ MCP servers, 90,000+ Skills**: plug into Gmail, Notion, GitHub, Slack, Stripe, Calendar, Drive, Linear, Jira and the rest of your stack with [**one-click OAuth**](https://tinyhumans.gitbook.io/openhuman/features/integrations) — 100+ curated connectors brokered through the Composio layer. Beyond that, OpenHuman browses the open **Model Context Protocol** ecosystem (Smithery + the official MCP registry — thousands of servers) and a **90,000-entry Skills catalog**, so the agent can install new typed tools and skills on demand. Every connection becomes a typed tool, and every twenty minutes [auto-fetch](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch) walks each active connection and pulls fresh data into the [memory tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree). No prompts, no polling loops you have to write, so the agent already has tomorrow's context this morning.
+- **[Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: your data compressed into scored Markdown trees in SQLite on your machine, mirrored as an [Obsidian vault](https://x.com/karpathy/status/2039805659525644595) you can open and edit. No vector-soup black box.
+- **[100+ OAuth integrations, 5,000+ MCP servers, 90,000+ Skills](https://tinyhumans.gitbook.io/openhuman/features/integrations)**: one click into Gmail, Notion, GitHub, Slack and the rest of your stack. [Auto-fetch](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch) feeds the brain every 20 minutes — it has tomorrow's context this morning.
+- **[A subconscious](https://tinyhumans.gitbook.io/openhuman/features/subconscious)**: a background loop that diffs your world, advances your goals, and writes your morning briefing — thinking continues after you stop typing.
+- **[Goals & Todos](https://tinyhumans.gitbook.io/openhuman/features/goals-and-todos)**: long-term goals, durable per-thread goals, and a shared kanban board per conversation.
+- **[TokenJuice](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: tool output compressed before it hits the model — same information, up to 80% fewer tokens. A brain this big would be unaffordable without it.
- Managed integrations use OpenHuman's Composio connector layer. OAuth handshakes and integration tool calls are proxied through the managed backend by default. If you want to run Composio directly instead, configure direct mode with your own Composio API key; real-time trigger webhooks then need to be hosted and wired by you.
+### 🕸️ The orchestrator
-- **[Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian Wiki](https://tinyhumans.gitbook.io/openhuman/features/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](https://x.com/karpathy/status/2039805659525644595).
+- **[Workflows](https://tinyhumans.gitbook.io/openhuman/features/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](https://github.com/tinyhumansai/tinyflows).
+- **[A harness that finishes the job](https://tinyhumans.gitbook.io/openhuman/developing/architecture/agent-harness)** _(new)_: checkpointed graph runs on open-source [tinyagents](https://github.com/tinyhumansai/tinyagents) — stuck agents get steered, halted ones return a root cause, every run replays with real per-call costs.
+- **[A split brain, always on](https://tinyhumans.gitbook.io/openhuman/features/orchestration)** _(new)_: a fast reflex agent triages inbound traffic while a deep reasoning core delegates to worker fleets, steered by the subconscious.
+- **[An agent economy](https://tinyhumans.gitbook.io/openhuman/features/tinyplace)**: a `@handle` on [tiny.place](https://tiny.place), Signal-encrypted agent-to-agent orchestration, x402 USDC bounties and trading — keys never touch disk.
-- **[SuperContext](https://tinyhumans.gitbook.io/openhuman/features/super-context)**: a fresh chat shouldn't start cold. With SuperContext enabled, the harness deterministically spawns a read-only `context_scout` on the **first turn of every new thread** — it sweeps your memory tree, files, and connected data, assembles a bounded context bundle, and prepends it to your message before the model ever reads it. No tool call to wait on, no "let me look that up" round-trip: the agent answers your first message already knowing the relevant background. Toggle it from the composer or `context.super_context_enabled`.
+### 🔬 The deep researcher & doer
-- **[Goals & Todos](https://tinyhumans.gitbook.io/openhuman/features/goals-and-todos)**: OpenHuman keeps the agent pointed at what matters. A short, human-editable list of **long-term goals** (`MEMORY_GOALS.md`) rides along in memory and can self-reflect against your recent activity; each **thread** can carry a single durable **goal** with an optional token budget that the agent works across turns, interrupts and idle periods (autonomous idle continuation); and every conversation hosts a **kanban task board** of todos that you and the agent build together — plans, acceptance criteria, approval gates and all. There's also a personal task list you own outright.
+- **[SuperContext](https://tinyhumans.gitbook.io/openhuman/features/super-context)**: 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](https://tinyhumans.gitbook.io/openhuman/features/native-tools/browser-and-computer), [native voice](gitbooks/features/native-tools/voice.md) with in-process Whisper — and [model routing](https://tinyhumans.gitbook.io/openhuman/features/model-routing) that picks the right LLM per workload, one subscription, [local AI optional](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai).
+- **[Meeting agents](https://tinyhumans.gitbook.io/openhuman/features/mascot/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](https://tinyhumans.gitbook.io/openhuman/features/native-tools)** _(new)_: Seedream/SeedEdit images and Seedance/Veo video, straight into your workspace on the same subscription.
+- **[17 messaging channels](https://tinyhumans.gitbook.io/openhuman/features/channels)**: Telegram, Discord, Slack, WhatsApp, Signal, iMessage… plus **native email** (IMAP IDLE + SMTP). Your agent reaches you where you already are.
-- **[Themes & Theme Studio](https://tinyhumans.gitbook.io/openhuman/features/theming)**: make it yours. Five built-in theme families (Classic, Ocean, Sepia, Matrix, HAL 9000) ship in light/dark/auto variants, and the **Theme Studio** in Settings is a full visual editor — adjust every colour token with live contrast warnings, swap fonts per role, pick an animated WebGL-mesh / flat / custom-image backdrop, and export or import themes as JSON to share. Editing a preset auto-forks a custom theme so the originals stay pristine; everything applies instantly and persists locally.
+### 🧍 Human, private, yours
-- **Batteries included**: web search, a web-fetch [scraper](https://tinyhumans.gitbook.io/openhuman/features/native-tools), a full coder toolset (filesystem, git, lint, test, grep), and [native voice](gitbooks/features/native-tools/voice.md) (STT in, ElevenLabs TTS out, mascot lip-sync, live Google Meet agent) are wired in by default. By default, [model routing](https://tinyhumans.gitbook.io/openhuman/features/model-routing) uses the OpenHuman backend to select and proxy the right LLM for each workload (reasoning, fast, or vision). One subscription includes all models. No "install a plugin to read files" friction. Use [optional local AI via Ollama](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai) for supported on-device workloads.
-
-- **[Smart token compression (TokenJuice)](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: 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, and verbose tool output is deduped and summarized via a configurable rule overlay etc... CJK, emoji, and other multi-byte text are preserved grapheme-by-grapheme — never stripped. You get the same information but at a fraction of the tokens. Reducing cost & latency by up to 80%.
-
-- **[Messaging channels](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** and **[privacy & security](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: inbound/outbound across the channels you already use, with workflow data that stays on device, encrypted locally, treated as yours.
+- **Simple, UI-first & Human**: install to working agent in a few clicks — no config files, no terminal. And it has [a face](https://tinyhumans.gitbook.io/openhuman/features/mascot): a mascot that speaks, reacts, and remembers you.
+- **[Privacy & security](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: on-device encrypted data, approval gate, OS-keyring secrets, opt-in sandboxing — and _(new)_ **[Privacy Mode](https://tinyhumans.gitbook.io/openhuman/features/privacy-mode)**: one switch and no inference leaves your machine, enforced in the Rust core.
+- **[Themes & Theme Studio](https://tinyhumans.gitbook.io/openhuman/features/theming)**: five theme families plus a full visual editor, exportable as JSON.
## Contributing from source
@@ -160,21 +165,38 @@ In just one sync pass, the agent has full (compressed) context of your inbox, yo
Already self-host [agentmemory](https://github.com/rohitg00/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](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/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](https://tinyhumans.gitbook.io/openhuman/features/orchestration)**:
+
+- **Graphs, not loops** — turns compile to checkpointed state-machine graphs on [tinyagents](https://github.com/tinyhumansai/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](https://github.com/tinyhumansai/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](https://github.com/rohitg00/agentmemory) backend |
-| **Integrations** | ⚠️ Few connectors | ⚠️ BYO | ⚠️ BYO | 🚀 100+ OAuth · 5k+ MCP · 90k+ Skills |
-| **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 |
+| | 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](https://github.com/rohitg00/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
diff --git a/docs/README.de.md b/docs/README.de.md
index 9ab3b9644..2452aa94e 100644
--- a/docs/README.de.md
+++ b/docs/README.de.md
@@ -1,8 +1,3 @@
-
+ OpenHuman ist deine persönliche KI-Superintelligenz: ein Gehirn, das sich alles merkt, ein fantastischer Orchestrator, ein Deep Researcher. Local-first, schlicht, mächtig.
+
@@ -48,47 +55,94 @@
> **Frühe Beta**: Wird aktiv weiterentwickelt. Mit Ecken und Kanten ist zu rechnen.
-> **Lokal + verwaltete Dienste, upfront:** OpenHuman speichert seinen Memory Tree, Obsidian-Style-Markdown-Vault, Workspace-Konfiguration und lokalen Laufzeitstatus auf deiner Maschine. Die standardmäßige verwaltete Erfahrung nutzt weiterhin OpenHuman-gehostete Dienste für Account-Anmeldung, Model-Routing, Web-Search-Proxying und verwaltete Integration/OAuth-Flows über die Composio-Connector-Schicht. Wähle benutzerdefinierte/lokale Einstellungen, wenn du dein eigenes Modell, deine eigene Suche oder Composio-Credentials mitbringen möchtest; einige Echtzeit-Trigger und gehostete Funktionen erfordern weiterhin das verwaltete Backend.
+> 🎉 Innerhalb einer Woche nach dem Launch wurde OpenHuman neun Tage in Folge das Nummer-eins-Trending-Repository auf GitHub.
-Für Installation und Einstieg lade die App von [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme) herunter oder führe im Terminal aus:
+# Installation
+
+Lade die Installer von [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme) oder von der [GitHub-Releases](https://github.com/tinyhumansai/openhuman/releases/latest)-Seite herunter. Für Terminal-Installationen sind die nativen Paketpfade unten zu bevorzugen, da sie — wo verfügbar — den Paketmanager bzw. nativen Installer deines Betriebssystems nutzen.
+
+## Empfohlene Installation (native Pakete)
+
+Diese Pfade nutzen native Installer-Oberflächen. Homebrew und MSI bringen ihre üblichen Signatur-/Integritätsprüfungen mit; unter Debian/Ubuntu installiert `apt-get` das Release-`.deb` und löst die Systemabhängigkeiten auf.
+
+**macOS (Homebrew-Tap):**
```bash
-# DMG/EXE über https://tinyhumans.ai/openhuman herunterladen oder direkt im Terminal:
+brew tap tinyhumansai/core
+brew install openhuman
+```
-# macOS oder Linux x64
+**Linux (Debian/Ubuntu — Release-`.deb`):**
+
+```bash
+# Download OpenHuman__amd64.deb or OpenHuman__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):** das [`openhuman-bin`-AUR-Rezept](../packages/arch/openhuman-bin/) liegt im Repo. Sobald es veröffentlicht ist, können Arch-Nutzer es mit `yay -S openhuman-bin` installieren.
+
+**Windows:** lade die signierte `.msi` vom [neuesten Release](https://github.com/tinyhumansai/openhuman/releases/latest) herunter und führe sie aus.
+
+**Manuell `.dmg` / `.deb` / `.AppImage` / `.msi`:** hole dir den Installer für deine Plattform direkt von der [Seite des neuesten Releases](https://github.com/tinyhumansai/openhuman/releases/latest).
+
+> **Linux:** das AppImage kann unter Wayland beim Start abstürzen, Host-Systembibliotheken wie `libgbm.so.1` vermissen oder auf Arch-basierten Distros mit `sharun: Interpreter not found!` fehlschlagen — siehe [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) für die Ursache und Env-Var-Workarounds. Das `.deb`-Paket oben vermeidet diese Fehlerbilder auf Debian/Ubuntu, indem apt die Laufzeitabhängigkeiten auflöst.
+
+## Alternative: Skript-Installation (ohne Integritätsprüfung)
+
+> **Warnung — unverifizierte Installation.** Diese Skripte werden live von `raw.githubusercontent.com` ausgeliefert und bringen **keine** separate Signatur mit — `curl … | bash` und `irm … | iex` haben also keine Möglichkeit, Manipulationen an den Skript-Bytes zu erkennen. Bevorzuge wann immer möglich die **nativen Paketpfade** oben. Wenn du das Skript dennoch nutzen musst, siehe „Verifizierte Skript-Installation" unten.
+
+```bash
+# macOS or Linux x64
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
-# Windows
+# Windows (PowerShell)
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
```
-
-> **Linux:** the AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds.
-Arch Linux package maintainers can use the [`openhuman-bin` AUR recipe](../packages/arch/openhuman-bin/);
-once published, Arch users can install it with `yay -S openhuman-bin`.
-
+Unter Debian/Ubuntu löst `install.sh` zuerst das neueste Release-`.deb` auf und installiert es mit `apt-get`, sodass apt die Laufzeitabhängigkeiten übernimmt. Setze `OPENHUMAN_INSTALLER_LINUX_PACKAGE=appimage`, um den AppImage-Pfad zu erzwingen.
+
+## Status der verifizierten Skript-Installation
+
+Ein separat signierter Skript-Installationspfad ist derzeit nicht verfügbar. Issue [#2620](https://github.com/tinyhumansai/openhuman/issues/2620) wurde geschlossen, nachdem die nativen Paketpfade in den Vordergrund gerückt wurden, aber die aktuellen Release-Assets enthalten kein `install.sh.asc` / `install.ps1.asc` zur Skriptverifikation vor der Ausführung. Behandle die Skript-Installation als unverifiziert und bevorzuge nach Möglichkeit die nativen Paketoptionen oben.
# Was ist OpenHuman?
-OpenHuman ist ein quelloffener, agentenbasierter Assistent, der sich in deinen Alltag einfügt. Jeder Punkt verlinkt auf die ausführliche Beschreibung in der [Doku](https://tinyhumans.gitbook.io/openhuman/).
+OpenHuman ist drei Dinge, die die meisten Assistenten nicht sind: **ein Gehirn**, das ein persistentes, lokales Gedächtnis deiner Welt aufbaut; **ein fantastischer Orchestrator**, der Flotten von Agenten auf dauerhaften Graphen betreibt; und **ein Deep Researcher**, der deine Daten und das Web durchkämmt, bevor du deine Frage zu Ende gestellt hast. Jeder Punkt verlinkt auf die ausführliche Beschreibung in der [Doku](https://tinyhumans.gitbook.io/openhuman/).
-- **Schlicht, UI-zuerst & menschlich** — Eine aufgeräumte Desktop-Erfahrung und kurze Onboarding-Pfade bringen dich in wenigen Klicks von der Installation zum laufenden Agenten — keine Config-First-Einrichtung, kein Terminal nötig. Der Agent hat [ein Gesicht](https://tinyhumans.gitbook.io/openhuman/features/mascot): ein Desktop-Maskottchen, das spricht, auf seine Umgebung reagiert, als echter Teilnehmer [in deinen Google-Meets sitzt](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents), sich über Wochen an dich erinnert und im Hintergrund weiterdenkt, auch wenn du längst nicht mehr tippst.
+### 🧠 Das Gehirn
-- **[118+ Drittanbieter-Integrationen](https://tinyhumans.gitbook.io/openhuman/features/integrations) mit [Auto-Fetch](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch)**: Gmail, Notion, GitHub, Slack, Stripe, Calendar, Drive, Linear, Jira und der Rest deines Stacks per **Ein-Klick-OAuth** anbinden. Jede Verbindung wird dem Agenten als typisiertes Tool freigegeben, und alle zwanzig Minuten geht der Core durch jede aktive Verbindung und zieht frische Daten in den [Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch). Keine Prompts, keine Polling-Schleifen, die du selbst schreiben musst — der Agent hat morgens schon den Kontext für den Tag.
+- **[Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian-Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: deine Daten, komprimiert in bewertete Markdown-Bäume in SQLite auf deiner Maschine, gespiegelt als [Obsidian-Vault](https://x.com/karpathy/status/2039805659525644595), das du öffnen und editieren kannst. Keine Vektor-Suppen-Blackbox.
+- **[100+ OAuth-Integrationen, 5.000+ MCP-Server, 90.000+ Skills](https://tinyhumans.gitbook.io/openhuman/features/integrations)**: mit einem Klick in Gmail, Notion, GitHub, Slack und den Rest deines Stacks. [Auto-Fetch](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch) füttert das Gehirn alle 20 Minuten — es hat den Kontext von morgen schon heute Früh.
+- **[Ein Unterbewusstsein](https://tinyhumans.gitbook.io/openhuman/features/subconscious)**: eine Hintergrundschleife, die Veränderungen in deiner Welt erkennt, deine Ziele vorantreibt und dein Morgen-Briefing schreibt — das Denken geht weiter, auch wenn du längst nicht mehr tippst.
+- **[Goals & Todos](https://tinyhumans.gitbook.io/openhuman/features/goals-and-todos)**: Langzeitziele, dauerhafte Ziele pro Thread und ein geteiltes Kanban-Board pro Unterhaltung.
+- **[TokenJuice](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: Tool-Ausgaben werden komprimiert, bevor sie das Modell erreichen — dieselbe Information, bis zu 80% weniger Tokens. Ein so großes Gehirn wäre ohne es unbezahlbar.
- Verwaltete Integrationen nutzen OpenHumans Composio-Connector-Schicht. OAuth-Handshakes und Integration-Tool-Calls werden standardmäßig über das verwaltete Backend geproxied. Wenn du stattdessen Composio direkt betreiben möchtest, konfiguriere den Direktmodus mit deinem eigenen Composio-API-Key; Echtzeit-Trigger-Webhooks müssen dann von dir selbst gehostet und verkabelt werden.
+### 🕸️ Der Orchestrator
-- **[Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian-Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: eine lokal-zentrierte Wissensbasis, aufgebaut aus deinen Daten und deinen Aktivitäten. Alles, was du verbindest, wird in Markdown-Chunks von ≤3k Tokens kanonisiert, bewertet und in hierarchische Zusammenfassungs-Bäume gefaltet, gespeichert in **SQLite auf deiner Maschine**. Dieselben Chunks landen als `.md`-Dateien in einem Obsidian-kompatiblen Vault, das du öffnen, durchstöbern und editieren kannst — inspiriert von Karpathys [obsidian-wiki-Workflow](https://x.com/karpathy/status/2039805659525644595).
+- **[Workflows](https://tinyhumans.gitbook.io/openhuman/features/workflows)** _(neu)_: der Agent schlägt die Automatisierung vor; du prüfst sie auf einer Canvas und speicherst. Dauerhafte, trigger-gesteuerte, freigabe-gesicherte Läufe auf dem quelloffenen [tinyflows](https://github.com/tinyhumansai/tinyflows).
+- **[Ein Harness, das die Arbeit zu Ende bringt](https://tinyhumans.gitbook.io/openhuman/developing/architecture/agent-harness)** _(neu)_: checkpointed Graph-Läufe auf dem quelloffenen [tinyagents](https://github.com/tinyhumansai/tinyagents) — festgefahrene Agenten werden nachgesteuert, gestoppte liefern eine Root Cause zurück, jeder Lauf lässt sich mit echten Kosten pro Aufruf wieder abspielen.
+- **[Ein Split Brain, immer an](https://tinyhumans.gitbook.io/openhuman/features/orchestration)** _(neu)_: ein schneller Reflex-Agent triagiert eingehenden Traffic, während ein tiefer Reasoning-Kern an Worker-Flotten delegiert, gesteuert vom Unterbewusstsein.
+- **[Eine Agenten-Ökonomie](https://tinyhumans.gitbook.io/openhuman/features/tinyplace)**: ein `@handle` auf [tiny.place](https://tiny.place), Signal-verschlüsselte Agent-zu-Agent-Orchestrierung, x402-USDC-Bounties und Handel — Keys berühren nie die Festplatte.
-- **Alles eingebaut**: Web-Suche, ein Web-Fetch-[Scraper](https://tinyhumans.gitbook.io/openhuman/features/native-tools), ein vollständiges Coder-Toolset (Dateisystem, Git, Lint, Test, Grep) und [native Sprache](https://tinyhumans.gitbook.io/openhuman/features/native-tools/voice) (STT als Eingabe, ElevenLabs TTS als Ausgabe, Lippensynchronisation für das Maskottchen, Live-Google-Meet-Agent) sind ab Werk verdrahtet. Standardmäßig nutzt [Model-Routing](https://tinyhumans.gitbook.io/openhuman/features/model-routing) das OpenHuman-Backend, um das passende LLM für jede Workload auszuwählen und zu proxien (Reasoning, Fast oder Vision). Ein Abo umfasst alle Modelle. Keine "erst-ein-Plugin-installieren-um-Dateien-zu-lesen"-Hürde. [Optional lokale KI über Ollama](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai) für On-Device-Workloads.
+### 🔬 Der Deep Researcher & Macher
-- **[Smarte Token-Kompression (TokenJuice)](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: Jeder Tool-Aufruf, jedes Scrape-Ergebnis, jeder E-Mail-Text und jeder Such-Payload läuft durch eine Token-Kompressionsschicht, bevor er ein LLM-Modell erreicht. HTML wird zu Markdown konvertiert, lange URLs werden gekürzt, und ausschweifende Tool-Ausgaben werden über eine konfigurierbare Regel-Ebene dedupliziert und zusammengefasst usw. CJK, Emojis und andere Multi-Byte-Texte bleiben Graphem für Graphem erhalten — niemals abgeschnitten. Du erhältst dieselbe Information bei einem Bruchteil der Tokens. Kosten und Latenz sinken um bis zu 80%.
+- **[SuperContext](https://tinyhumans.gitbook.io/openhuman/features/super-context)**: ein Research-Scout durchkämmt dein Gedächtnis und deine Dateien, bevor das Modell deine erste Nachricht liest. Keine Kaltstarts.
+- **Alles eingebaut**: Web-Suche, Scraper, Coder-Toolset, ein echter [Browser](https://tinyhumans.gitbook.io/openhuman/features/native-tools/browser-and-computer), [native Sprache](../gitbooks/features/native-tools/voice.md) mit In-Process-Whisper — und [Model-Routing](https://tinyhumans.gitbook.io/openhuman/features/model-routing), das das passende LLM pro Workload auswählt, ein Abo, [lokale KI optional](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai).
+- **[Meeting-Agenten](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents)** _(neu)_: nimmt an **Meet, Zoom, Teams und Webex** teil — mit Gesicht und Stimme. Tritt automatisch aus deinem Kalender bei, streamt ein Live-Transkript, antwortet auf seinen Namen und legt Zusammenfassung + Action Items ab.
+- **[Bild- & Videogenerierung](https://tinyhumans.gitbook.io/openhuman/features/native-tools)** _(neu)_: Seedream/SeedEdit-Bilder und Seedance/Veo-Video, direkt in deinen Workspace im selben Abo.
+- **[17 Messaging-Kanäle](https://tinyhumans.gitbook.io/openhuman/features/channels)**: Telegram, Discord, Slack, WhatsApp, Signal, iMessage… plus **native E-Mail** (IMAP IDLE + SMTP). Dein Agent erreicht dich dort, wo du ohnehin schon bist.
-- **[Messaging-Kanäle](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** und **[Privatsphäre & Sicherheit](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: ein- und ausgehend über die Kanäle, die du ohnehin nutzt — Workflow-Daten bleiben auf dem Gerät, lokal verschlüsselt, und gehören dir.
+### 🧍 Menschlich, privat, deins
+
+- **Schlicht, UI-zuerst & menschlich**: von der Installation zum laufenden Agenten in wenigen Klicks — keine Config-Dateien, kein Terminal. Und es hat [ein Gesicht](https://tinyhumans.gitbook.io/openhuman/features/mascot): ein Maskottchen, das spricht, reagiert und sich an dich erinnert.
+- **[Privatsphäre & Sicherheit](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: verschlüsselte Daten auf dem Gerät, Freigabe-Gate, Secrets im OS-Schlüsselbund, Opt-in-Sandboxing — und _(neu)_ **[Privacy Mode](https://tinyhumans.gitbook.io/openhuman/features/privacy-mode)**: ein Schalter, und keine Inferenz verlässt deine Maschine — erzwungen im Rust-Core.
+- **[Themes & Theme Studio](https://tinyhumans.gitbook.io/openhuman/features/theming)**: fünf Theme-Familien plus ein vollständiger visueller Editor, exportierbar als JSON.
## Beitragen aus dem Quellcode
-Neu hier? Beginne mit [`CONTRIBUTING.md`](../CONTRIBUTING.md) für den Fork-/PR-Workflow und die lokalen Prüfbefehle. Der kurze Weg:
+Neu hier? Beginne mit [`CONTRIBUTING.md`](../CONTRIBUTING.md) für den Fork-/PR-Workflow und die lokalen Prüfbefehle, oder nutze den Copy-Paste-Prompt für KI-Coding-Agenten in [`CONTRIBUTING-BEGINNERS.md`](../CONTRIBUTING-BEGINNERS.md#optional-let-an-ai-coding-agent-guide-you). Der kurze Weg:
1. Installiere Git, Node.js 24+, pnpm 10.10.0, Rust 1.93.0 (`rustfmt` + `clippy`), CMake, Ninja, ripgrep sowie die plattformspezifischen Desktop-Build-Voraussetzungen.
2. Forke und klone das Repo, führe dann `git submodule update --init --recursive` aus, bevor du `pnpm install` startest, damit die mitgelieferten Tauri/CEF-Quellen vorhanden sind.
@@ -101,39 +155,56 @@ Tiefer einsteigen: [Architektur](https://tinyhumans.gitbook.io/openhuman/develop
OpenHuman ist das erste Agent-Harness, das dich in Minuten kennenlernt. Inspiriert von [Karpathys LLM-Knowledgebase](https://x.com/karpathy/status/2039805659525644595). Die meisten Agenten starten aus dem Kalten. Hermes lernt, indem er dir bei der Arbeit zusieht; OpenClaw wartet darauf, dass Plugins Kontext einspielen. So oder so vergehen Tage oder Wochen, bevor der Agent genug über deinen Stack weiß, um wirklich nützlich zu sein.
-
+
> OpenHuman fasst all deine Dokumente, E-Mails und Chats zusammen, komprimiert sie und legt einen Memory Graph an, mit dem dein Agent sich alles über dich merken kann.
OpenHuman überspringt die Wartezeit. Verbinde deine Accounts, lass [Auto-Fetch](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch) die Daten lokal in einer 20-Minuten-Schleife abholen, und [Memory Trees](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) komprimieren alles in Markdown-Dateien, intelligent abgelegt in einem [Obsidian-Wiki im Karpathy-Stil](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki).
-Nach nur einem Sync-Durchlauf hat der Agent den vollständigen (komprimierten) Kontext deines Postfachs, deines Kalenders, deiner Repos, deiner Dokumente und deiner Nachrichten. Keine Trainingsphase. Kein "gib ihm ein paar Wochen". Er wird zu dir — gesteuert von dir.
+Nach nur einem Sync-Durchlauf hat der Agent den vollständigen (komprimierten) Kontext deines Postfachs, deines Kalenders, deiner Repos, deiner Dokumente und deiner Nachrichten. Keine Trainingsphase. Kein „gib ihm ein paar Wochen". Er wird zu dir — gesteuert von dir.
Du hostest [agentmemory](https://github.com/rohitg00/agentmemory) bereits selbst für andere Coding-Agenten? OpenHuman bringt ein optionales `Memory`-Backend mit, das dorthin proxyt — setze `memory.backend = "agentmemory"` in `config.toml`, und derselbe persistente Store treibt OpenHuman zusammen mit Claude Code, Cursor, Codex und OpenCode an. Setup-Details auf der Seite zum [agentmemory-Backend](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/agentmemory-backend).
+## Ein Orchestrator, kein Chatbot
+
+Der tiefste Unterschied ist kein einzelnes Feature — es ist das Ausführungsmodell. Claude Code, OpenClaw und Hermes betreiben **einen Agenten in einer Schleife**. OpenHuman ist ein **[Orchestrator](https://tinyhumans.gitbook.io/openhuman/features/orchestration)**:
+
+- **Graphen statt Schleifen** — Turns kompilieren zu checkpointed State-Machine-Graphen auf [tinyagents](https://github.com/tinyhumansai/tinyagents): für einen Menschen pausieren, einen Neustart überleben, mitten im Lauf weitermachen.
+- **Sub-Agenten-Flotten** — Spezialisten spawnen drei Ebenen tief, untätige Worker werden wiederverwendet, und Circuit Breaker verwandeln festgefahrene Agenten in Root-Cause-Berichte.
+- **Workflows, die du sehen kannst** — vom Agenten vorgeschlagene [tinyflows](https://github.com/tinyhumansai/tinyflows)-Graphen, geprüft auf einer Canvas: dauerhaft, trigger-gesteuert, freigabe-gesichert.
+- **Ein Split Brain, immer an** — ein schneller Reflex-Agent triagiert, während ein tiefer Kern nachdenkt, gesteuert von der Unterbewusstseins-Schleife.
+- **Agent-zu-Agent, verschlüsselt** — Instanzen orchestrieren sich gegenseitig über **Signal-Protokoll-E2E**-Sitzungen mit einwilligungsbasiertem Pairing und x402-Zahlungen. Kein Server sieht Klartext.
+- **Als Nächstes: RLMs** — das Modell schreibt seinen eigenen Orchestrierungscode in einer gesandboxten REPL, auf derselben Graph-Engine und demselben Vertrauensmodell.
+
## OpenHuman vs. andere Agent-Harnesses
Übersichtsvergleich (Produkte entwickeln sich weiter — bitte beim jeweiligen Anbieter verifizieren). OpenHuman ist darauf ausgelegt, **Vendor-Wildwuchs zu reduzieren**, **Workflow-Wissen auf dem Gerät zu halten** und dem Agenten eine **persistente Erinnerung** an deine Daten zu geben — nicht nur an den Chat.
-| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
-| ------------------- | ----------------- | ----------------- | ----------------- | ---------------------------------- |
-| **Quelloffen** | 🚫 Proprietär | ✅ MIT | ✅ MIT | ✅ GNU |
-| **Einfacher Einstieg** | ✅ Desktop + CLI | ⚠️ Terminal zuerst | ⚠️ Terminal zuerst | ✅ Aufgeräumte UI, in Minuten |
-| **Kosten** | ⚠️ Abo + Zusatzkosten | ⚠️ BYO-Modelle | ⚠️ BYO-Modelle | ✅ Ein Abo + TokenJuice |
-| **Memory** | ✅ chat-gebunden | ⚠️ plugin-abhängig | ✅ selbstlernend | 🚀 Memory Tree + Obsidian-Vault, optional [agentmemory](https://github.com/rohitg00/agentmemory)-Backend |
-| **Integrationen** | ⚠️ wenige Konnektoren | ⚠️ BYO | ⚠️ BYO | 🚀 118+ über OAuth |
-| **Auto-Fetch** | 🚫 keiner | 🚫 keiner | 🚫 keiner | ✅ 20-Min.-Sync ins Memory |
-| **API-Wildwuchs** | 🚫 zusätzliche Keys | 🚫 BYOK | 🚫 Multi-Vendor | ✅ ein Account |
-| **Model-Routing** | 🚫 nur ein Modell | ⚠️ manuell | ⚠️ manuell | ✅ eingebaut |
-| **Native Tools** | ✅ nur Code | ✅ nur Code | ✅ nur Code | ✅ Code + Suche + Scraper + Sprache |
+| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
+| ---------------------- | ---------------------- | ------------------ | ------------------ | --------------------------------------------------------------------------------------------------------- |
+| **Quelloffen** | 🚫 Proprietär | ✅ MIT | ✅ MIT | ✅ GNU |
+| **Einfacher Einstieg** | ✅ Desktop + CLI | ⚠️ Terminal zuerst | ⚠️ Terminal zuerst | ✅ Aufgeräumte UI, in Minuten |
+| **Kosten** | ⚠️ Abo + Zusatzkosten | ⚠️ BYO-Modelle | ⚠️ BYO-Modelle | ✅ Ein Abo + TokenJuice |
+| **Memory** | ✅ chat-gebunden | ⚠️ plugin-abhängig | ✅ selbstlernend | 🚀 Memory Tree + Obsidian-Vault, optional [agentmemory](https://github.com/rohitg00/agentmemory)-Backend |
+| **Integrationen** | ⚠️ wenige Konnektoren | ⚠️ BYO | ⚠️ BYO | 🚀 100+ OAuth · 5k+ MCP · 90k+ Skills |
+| **Auto-Fetch** | 🚫 keiner | 🚫 keiner | 🚫 keiner | ✅ 20-Min.-Sync ins Memory |
+| **Orchestrierung** | ⚠️ Sub-Tasks | ⚠️ eine Schleife | ⚠️ eine Schleife | 🚀 Agent-Graphen + Checkpoints + E2E-verschlüsseltes A2A |
+| **Workflows** | 🚫 keine | ⚠️ Skripte | ⚠️ Skripte | 🚀 visuell, dauerhaft, agent-vorgeschlagen, freigabe-gesichert |
+| **Meetings** | 🚫 keine | 🚫 keine | 🚫 keine | 🚀 nimmt an Meet/Zoom/Teams/Webex teil, spricht, Live-Transkript |
+| **Messaging-Kanäle** | 🚫 keine | ⚠️ einige wenige | ⚠️ einige wenige | ✅ 17 inkl. nativer E-Mail (IMAP/SMTP) |
+| **Nur-lokal-Modus** | 🚫 nur Cloud | ⚠️ BYO lokal | ⚠️ BYO lokal | ✅ per Schalter erzwungener Privacy Mode |
+| **Observability** | 🚫 undurchsichtig | ⚠️ Logs | ⚠️ Logs | ✅ wiederabspielbare Lauf-Journale + Kostenabrechnung pro Aufruf |
+| **API-Wildwuchs** | 🚫 zusätzliche Keys | 🚫 BYOK | 🚫 Multi-Vendor | ✅ ein Account |
+| **Model-Routing** | 🚫 nur ein Modell | ⚠️ manuell | ⚠️ manuell | ✅ eingebaut |
+| **Native Tools** | ✅ nur Code | ✅ nur Code | ✅ nur Code | ✅ Code + Suche + Scraper + Browser + Sprache + Mediengenerierung |
# Gib uns einen Stern auf GitHub
_Baust du auch in Richtung AGI und künstlichem Bewusstsein? Setze einen Stern und hilf anderen, den Weg zu finden._
@@ -49,45 +55,94 @@
> **얼리 베타**: 활발히 개발 중입니다. 다소 미흡한 부분이 있을 수 있습니다.
-> **로컬 + 관리형 서비스, upfront:** OpenHuman은 Memory Tree, Obsidian 스타일 Markdown 볼트, 워크스페이스 설정 및 로컬 런타임 상태를 사용자의 머신에 저장합니다. 기본 관리형 경험은 여전히 계정 로그인, 모델 라우팅, 웹 검색 프록시 및 Composio 커넥터 레이어를 통한 관리형 통합/OAuth 플로우에 OpenHuman 호스팅 서비스를 사용합니다. 자체 모델, 검색 또는 Composio 인증 정보를 가져오려면 사용자 지정/로컬 설정을 선택하세요. 일부 실시간 트리거 및 호스팅 기능은 여전히 관리형 백엔드를 필요로 합니다.
+> 🎉 출시 후 일주일 만에 OpenHuman은 9일 연속 GitHub 트렌딩 저장소 1위에 올랐습니다.
-설치하거나 시작하려면 [tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme) 웹사이트에서 다운로드하거나 터미널에서 다음을 실행하세요.
+# 설치
+
+[tinyhumans.ai/openhuman](https://tinyhumans.ai/openhuman?utm_source=github&utm_medium=readme) 또는 [GitHub Releases](https://github.com/tinyhumansai/openhuman/releases/latest) 페이지에서 설치 프로그램을 다운로드하세요. 터미널 설치의 경우, 가능한 한 OS 패키지 관리자나 네이티브 설치 프로그램을 사용하는 아래의 네이티브 패키지 경로를 권장합니다.
+
+## 권장 설치 방법 (네이티브 패키지)
+
+이 경로들은 네이티브 설치 프로그램을 사용합니다. Homebrew와 MSI는 일반적인 서명/무결성 검사를 제공하며, Debian/Ubuntu는 `apt-get`으로 릴리스 `.deb`를 설치하고 시스템 의존성을 해결합니다.
+
+**macOS (Homebrew tap):**
```bash
-# https://tinyhumans.ai/openhuman 에서 DMG, EXE를 다운로드하거나 터미널에서 실행하세요.
+brew tap tinyhumansai/core
+brew install openhuman
+```
-# macOS 또는 Linux x64용
+**Linux (Debian/Ubuntu — 릴리스 `.deb`):**
+
+```bash
+# Download OpenHuman__amd64.deb or OpenHuman__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):** [`openhuman-bin` AUR 레시피](../packages/arch/openhuman-bin/)가 저장소에 포함되어 있습니다. 게시된 후에는 Arch 사용자가 `yay -S openhuman-bin`으로 설치할 수 있습니다.
+
+**Windows:** [최신 릴리스](https://github.com/tinyhumansai/openhuman/releases/latest)에서 서명된 `.msi`를 다운로드하여 실행하세요.
+
+**수동 `.dmg` / `.deb` / `.AppImage` / `.msi` 설치:** [최신 릴리스 페이지](https://github.com/tinyhumansai/openhuman/releases/latest)에서 플랫폼에 맞는 설치 프로그램을 직접 받으세요.
+
+> **Linux:** AppImage는 Wayland 환경에서 실행 시 크래시가 발생하거나, `libgbm.so.1` 같은 호스트 시스템 라이브러리가 없거나, Arch 계열 배포판에서 `sharun: Interpreter not found!` 오류로 실패할 수 있습니다. 원인과 환경 변수 우회 방법은 [#2463](https://github.com/tinyhumansai/openhuman/issues/2463)을 참조하세요. 위의 `.deb` 패키지는 apt가 런타임 의존성을 해결하도록 하여 Debian/Ubuntu에서 이러한 문제를 피합니다.
+
+## 대안: 스크립트 설치 (무결성 검사 없음)
+
+> **경고 — 검증되지 않은 설치입니다.** 이 스크립트들은 `raw.githubusercontent.com`에서 실시간으로 제공되며 별도의 서명을 포함하지 **않으므로**, `curl … | bash`와 `irm … | iex`는 스크립트 바이트가 변조되었는지 감지할 방법이 없습니다. 가능하면 위의 **네이티브 패키지** 경로를 우선 사용하세요. 스크립트를 반드시 사용해야 한다면 아래의 "검증된 스크립트 설치 상태"를 참조하세요.
+
+```bash
+# macOS or Linux x64
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
-# Windows용
+# Windows (PowerShell)
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex
```
-
-> **Linux:** the AppImage can crash on launch under Wayland (and on Arch-based distros with `sharun: Interpreter not found!`) — see [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) for the cause and env-var workarounds.
-Arch Linux package maintainers can use the [`openhuman-bin` AUR recipe](../packages/arch/openhuman-bin/);
-once published, Arch users can install it with `yay -S openhuman-bin`.
-
+Debian/Ubuntu에서 `install.sh`는 먼저 최신 릴리스 `.deb`를 찾아 `apt-get`으로 설치하므로 런타임 의존성이 apt에 의해 처리됩니다. AppImage 경로를 강제하려면 `OPENHUMAN_INSTALLER_LINUX_PACKAGE=appimage`를 설정하세요.
+
+## 검증된 스크립트 설치 상태
+
+별도로 서명된 스크립트 설치 경로는 현재 제공되지 않습니다. 이슈 [#2620](https://github.com/tinyhumansai/openhuman/issues/2620)은 네이티브 패키지 경로가 우선 방식으로 승격된 후 닫혔지만, 현재 릴리스 자산에는 실행 전 스크립트 검증을 위한 `install.sh.asc` / `install.ps1.asc`가 포함되어 있지 않습니다. 스크립트 설치 경로는 검증되지 않은 것으로 간주하고, 가능하면 위의 네이티브 패키지 옵션을 우선 사용하세요.
# OpenHuman이란 무엇인가요?
-OpenHuman은 일상 생활에 통합되도록 설계된 오픈 소스 에이전트 어시스턴트입니다. 각 글머리 기호는 [문서](https://tinyhumans.gitbook.io/openhuman/)의 더 깊은 설명으로 연결됩니다.
+OpenHuman은 대부분의 어시스턴트가 갖지 못한 세 가지입니다: 당신의 세계에 대한 지속적인 로컬 메모리를 구축하는 **두뇌**, 내구성 있는 그래프 위에서 에이전트 함대를 운영하는 **탁월한 오케스트레이터**, 그리고 질문을 끝내기도 전에 당신의 데이터와 웹을 훑는 **깊이 있는 리서처**. 각 글머리 기호는 [문서](https://tinyhumans.gitbook.io/openhuman/)의 더 깊은 설명으로 연결됩니다.
-- **단순함, UI 우선 및 인간 중심**: 깔끔한 데스크톱 경험과 짧은 온보딩 경로를 통해 설치 후 몇 번의 클릭만으로 작동하는 에이전트를 만날 수 있습니다. 설정 우선 방식이나 터미널이 필요하지 않습니다. 에이전트는 [얼굴](https://tinyhumans.gitbook.io/openhuman/features/mascot)을 가지고 있습니다. 말을 하고, 주변 환경에 반응하며, 실제 참가자로 [Google Meet에 참여](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents)하고, 몇 주 동안 당신을 기억하며, 타이핑을 멈춘 후에도 백그라운드에서 계속 생각하는 데스크톱 마스코트입니다.
+### 🧠 두뇌
-- **[118개 이상의 서드파티 통합](https://tinyhumans.gitbook.io/openhuman/features/integrations) 및 [자동 가져오기(auto-fetch)](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch)**: Gmail, Notion, GitHub, Slack, Stripe, Calendar, Drive, Linear, Jira 등 당신의 스택을 **원클릭 OAuth**로 연결하세요. 모든 연결은 유형이 지정된 도구로 에이전트에게 노출되며, 코어는 20분마다 각 활성 연결을 탐색하여 신선한 데이터를 [메모리 트리](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch)로 가져옵니다. 프롬프트나 직접 작성해야 하는 폴링 루프가 필요 없으므로, 에이전트는 오늘 아침에 이미 내일의 컨텍스트를 가지고 있습니다.
+- **[메모리 트리(Memory Tree)](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian 위키](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: 당신의 데이터는 점수가 매겨진 Markdown 트리로 압축되어 당신의 머신에 있는 SQLite에 저장되고, 열어서 직접 편집할 수 있는 [Obsidian 볼트](https://x.com/karpathy/status/2039805659525644595)로 미러링됩니다. 벡터 수프 같은 블랙박스가 아닙니다.
+- **[100개 이상의 OAuth 통합, 5,000개 이상의 MCP 서버, 90,000개 이상의 Skills](https://tinyhumans.gitbook.io/openhuman/features/integrations)**: Gmail, Notion, GitHub, Slack 등 당신의 스택을 원클릭으로 연결하세요. [자동 가져오기(auto-fetch)](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch)가 20분마다 두뇌에 데이터를 공급합니다 — 오늘 아침에 이미 내일의 컨텍스트를 가지고 있습니다.
+- **[잠재의식(subconscious)](https://tinyhumans.gitbook.io/openhuman/features/subconscious)**: 당신의 세계의 변화를 비교 분석하고, 목표를 진전시키고, 아침 브리핑을 작성하는 백그라운드 루프 — 타이핑을 멈춘 후에도 생각은 계속됩니다.
+- **[목표 및 할 일(Goals & Todos)](https://tinyhumans.gitbook.io/openhuman/features/goals-and-todos)**: 장기 목표, 스레드별 지속 목표, 그리고 대화별 공유 칸반 보드를 제공합니다.
+- **[TokenJuice](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: 도구 출력은 모델에 닿기 전에 압축됩니다 — 동일한 정보를 최대 80% 적은 토큰으로. 이것 없이는 이만큼 큰 두뇌를 감당할 수 없을 것입니다.
-- **[메모리 트리(Memory Tree)](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian 위키](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: 당신의 데이터와 활동을 바탕으로 구축된 로컬 우선 지식 베이스입니다. 연결된 모든 것은 3k 토큰 이하의 Markdown 청크로 규격화되고 점수가 매겨지며, **당신의 머신에 있는 SQLite**에 저장되는 계층적 요약 트리로 접힙니다. 동일한 청크는 당신이 열고, 탐색하고, 편집할 수 있는 Obsidian 호환 볼트에 `.md` 파일로 저장됩니다. 이는 Karpathy의 [obsidian-wiki 워크플로우](https://x.com/karpathy/status/2039805659525644595)에서 영감을 받았습니다.
+### 🕸️ 오케스트레이터
-- **모든 것이 포함됨(Batteries included)**: 웹 검색, 웹 가져오기 [스크레이퍼](https://tinyhumans.gitbook.io/openhuman/features/native-tools), 전체 코더 툴셋(파일 시스템, git, lint, test, grep), 그리고 [네이티브 음성](https://tinyhumans.gitbook.io/openhuman/features/native-tools/voice)(STT 입력, ElevenLabs TTS 출력, 마스코트 립싱크, 라이브 Google Meet 에이전트)이 기본적으로 연결되어 있습니다. 기본적으로 [모델 라우팅](https://tinyhumans.gitbook.io/openhuman/features/model-routing)은 OpenHuman 백엔드를 사용하여 각 워크로드에 적합한 LLM(추론, 고속 또는 비전)을 선택하고 프록시합니다. 하나의 구독에 모든 모델이 포함됩니다. "파일을 읽기 위해 플러그인 설치"와 같은 번거로움이 없습니다. 온디바이스 워크로드를 위해 [Ollama를 통한 선택적 로컬 AI](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai)를 지원합니다.
+- **[Workflows](https://tinyhumans.gitbook.io/openhuman/features/workflows)** _(신규)_: 에이전트가 자동화를 제안하면 캔버스에서 검토하고 저장하면 됩니다. 내구성 있고, 트리거 기반이며, 승인 게이트를 거치는 실행이 오픈 소스 [tinyflows](https://github.com/tinyhumansai/tinyflows) 위에서 동작합니다.
+- **[일을 끝까지 마무리하는 하네스](https://tinyhumans.gitbook.io/openhuman/developing/architecture/agent-harness)** _(신규)_: 오픈 소스 [tinyagents](https://github.com/tinyhumansai/tinyagents) 기반의 체크포인트 그래프 실행 — 막힌 에이전트는 방향을 조정받고, 중단된 에이전트는 근본 원인을 돌려주며, 모든 실행은 호출별 실제 비용과 함께 재생됩니다.
+- **[상시 가동되는 분할 두뇌(split brain)](https://tinyhumans.gitbook.io/openhuman/features/orchestration)** _(신규)_: 빠른 반사 에이전트가 들어오는 트래픽을 분류하는 동안 깊은 추론 코어가 워커 함대에 작업을 위임하며, 잠재의식이 이를 조종합니다.
+- **[에이전트 경제](https://tinyhumans.gitbook.io/openhuman/features/tinyplace)**: [tiny.place](https://tiny.place)의 `@handle`, Signal로 암호화된 에이전트 간 오케스트레이션, x402 USDC 바운티와 거래 — 키는 디스크에 절대 닿지 않습니다.
-- **[스마트 토큰 압축(TokenJuice)](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: 모든 도구 호출, 스크레이핑 결과, 이메일 본문 및 검색 페이로드는 LLM 모델에 전달되기 전에 토큰 압축 레이어를 거칩니다. HTML은 Markdown으로 변환되고, 긴 URL은 단축되며, 장황한 도구 출력은 구성 가능한 규칙 오버레이 등을 통해 중복 제거 및 요약됩니다. CJK, 이모지 및 기타 멀티바이트 텍스트는 자소(grapheme) 단위로 보존되며 절대 삭제되지 않습니다. 동일한 정보를 훨씬 적은 토큰으로 얻을 수 있어 비용과 지연 시간을 최대 80%까지 줄일 수 있습니다.
+### 🔬 깊이 있는 리서처이자 실행가
-- **[메시징 채널](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** 및 **[개인 정보 보호 및 보안](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: 이미 사용 중인 채널을 통해 메시지를 주고받을 수 있으며, 워크플로우 데이터는 기기에 남아 로컬에서 암호화되어 당신의 것으로 관리됩니다.
+- **[SuperContext](https://tinyhumans.gitbook.io/openhuman/features/super-context)**: 모델이 첫 메시지를 읽기 전에 리서치 스카우트가 당신의 메모리와 파일을 훑습니다. 콜드 스타트가 없습니다.
+- **모든 것이 포함됨(Batteries included)**: 웹 검색, 스크레이퍼, 코더 툴셋, 실제 [브라우저](https://tinyhumans.gitbook.io/openhuman/features/native-tools/browser-and-computer), 인프로세스 Whisper를 갖춘 [네이티브 음성](../gitbooks/features/native-tools/voice.md) — 그리고 워크로드별로 적합한 LLM을 선택하는 [모델 라우팅](https://tinyhumans.gitbook.io/openhuman/features/model-routing)까지. 하나의 구독으로, [로컬 AI는 선택 사항](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai)입니다.
+- **[미팅 에이전트](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents)** _(신규)_: 얼굴과 목소리를 가지고 **Meet, Zoom, Teams, Webex**에 참여합니다 — 캘린더에서 자동으로 참여하고, 실시간 자막을 스트리밍하며, 이름이 불리면 대답하고, 요약과 액션 아이템을 정리합니다.
+- **[이미지 및 비디오 생성](https://tinyhumans.gitbook.io/openhuman/features/native-tools)** _(신규)_: Seedream/SeedEdit 이미지와 Seedance/Veo 비디오가 동일한 구독으로 워크스페이스에 바로 생성됩니다.
+- **[17개의 메시징 채널](https://tinyhumans.gitbook.io/openhuman/features/channels)**: Telegram, Discord, Slack, WhatsApp, Signal, iMessage… 그리고 **네이티브 이메일**(IMAP IDLE + SMTP)까지. 에이전트는 당신이 이미 있는 곳에서 당신에게 닿습니다.
+
+### 🧍 인간적이고, 프라이빗하며, 당신의 것
+
+- **단순함, UI 우선 및 인간 중심**: 설치 후 몇 번의 클릭만으로 작동하는 에이전트를 만날 수 있습니다 — 설정 파일도, 터미널도 필요 없습니다. 그리고 [얼굴](https://tinyhumans.gitbook.io/openhuman/features/mascot)이 있습니다: 말하고, 반응하고, 당신을 기억하는 마스코트입니다.
+- **[개인 정보 보호 및 보안](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: 기기 내 암호화된 데이터, 승인 게이트, OS 키링 시크릿, 선택적 샌드박싱 — 그리고 _(신규)_ **[Privacy Mode](https://tinyhumans.gitbook.io/openhuman/features/privacy-mode)**: 스위치 하나로 어떤 추론도 당신의 머신을 떠나지 않으며, Rust 코어에서 강제됩니다.
+- **[테마 및 Theme Studio](https://tinyhumans.gitbook.io/openhuman/features/theming)**: 5가지 테마 패밀리와 완전한 시각적 에디터, JSON으로 내보낼 수 있습니다.
## 소스에서 기여하기
-새로운 기여자인가요? 포크/PR 워크플로우 및 로컬 검증 명령에 대해서는 [`CONTRIBUTING.md`](../CONTRIBUTING.md)에서 시작하세요. 빠른 경로는 다음과 같습니다.
+새로운 기여자인가요? 포크/PR 워크플로우 및 로컬 검증 명령에 대해서는 [`CONTRIBUTING.md`](../CONTRIBUTING.md)에서 시작하거나, [`CONTRIBUTING-BEGINNERS.md`](../CONTRIBUTING-BEGINNERS.md#optional-let-an-ai-coding-agent-guide-you)의 복사-붙여넣기 AI 에이전트 프롬프트를 사용하세요. 빠른 경로는 다음과 같습니다.
1. Git, Node.js 24+, pnpm 10.10.0, Rust 1.93.0(`rustfmt` + `clippy`), CMake, Ninja, ripgrep 및 플랫폼 데스크톱 빌드 필수 구성 요소를 설치합니다.
2. 저장소를 포크하고 클론한 다음, `pnpm install` 전에 `git submodule update --init --recursive`를 실행하여 벤더링된 Tauri/CEF 소스가 존재하는지 확인합니다.
@@ -111,28 +166,45 @@ OpenHuman은 기다림을 생략합니다. 계정을 연결하고, [자동 가
이미 다른 코딩 에이전트에서 [agentmemory](https://github.com/rohitg00/agentmemory)를 자체 호스팅하고 있나요? OpenHuman은 이를 프록시하는 선택적 `Memory` 백엔드를 제공합니다. `config.toml`에서 `memory.backend = "agentmemory"`를 설정하면 동일한 내구성 있는 저장소가 Claude Code, Cursor, Codex, OpenCode와 함께 OpenHuman을 구동합니다. 설정 방법은 [agentmemory 백엔드](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/agentmemory-backend) 페이지를 참조하세요.
+## 챗봇이 아닌 오케스트레이터
+
+가장 깊은 차이는 어느 하나의 기능이 아니라 실행 모델입니다. Claude Code, OpenClaw, Hermes는 **하나의 루프에서 하나의 에이전트**를 실행합니다. OpenHuman은 **[오케스트레이터](https://tinyhumans.gitbook.io/openhuman/features/orchestration)**입니다:
+
+- **루프가 아닌 그래프** — 턴은 [tinyagents](https://github.com/tinyhumansai/tinyagents) 기반의 체크포인트가 있는 상태 머신 그래프로 컴파일됩니다: 사람을 위해 일시 정지하고, 재시작에도 살아남고, 실행 중간에 재개합니다.
+- **서브 에이전트 함대** — 전문 에이전트가 3단계 깊이까지 생성되고, 유휴 워커는 재사용되며, 서킷 브레이커가 막힌 에이전트를 근본 원인 보고서로 바꿔 줍니다.
+- **눈으로 볼 수 있는 워크플로우** — 에이전트가 제안하고 캔버스에서 검토하는 [tinyflows](https://github.com/tinyhumansai/tinyflows) 그래프: 내구성 있고, 트리거 기반이며, 승인 게이트를 거칩니다.
+- **상시 가동되는 분할 두뇌(split brain)** — 빠른 반사 에이전트가 분류하는 동안 깊은 코어가 추론하며, 잠재의식 루프가 이를 조종합니다.
+- **암호화된 에이전트 간 통신** — 인스턴스들은 동의 기반 페어링과 x402 결제를 갖춘 **Signal 프로토콜 E2E** 세션을 통해 서로를 오케스트레이션합니다. 어떤 서버도 평문을 보지 못합니다.
+- **다음 단계: RLM** — 모델이 샌드박스 REPL에서 자신의 오케스트레이션 코드를 직접 작성합니다. 동일한 그래프 엔진과 신뢰 모델 위에서요.
+
## OpenHuman vs 다른 에이전트 하네스
상위 수준 비교(제품은 진화하므로 각 벤더에 확인하세요). OpenHuman은 **벤더 분산화(sprawl)를 최소화**하고, **워크플로우 지식을 기기에 유지**하며, 채팅뿐만 아니라 당신의 데이터에 대한 **지속적인 기억**을 에이전트에게 제공하도록 구축되었습니다.
-| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
-| ------------------- | ----------------- | ----------------- | ----------------- | ---------------------------------- |
-| **오픈 소스** | 🚫 독점 소스 | ✅ MIT | ✅ MIT | ✅ GNU |
-| **시작하기 쉬움** | ✅ 데스크톱 + CLI | ⚠️ 터미널 우선 | ⚠️ 터미널 우선 | ✅ 깔끔한 UI, 단 몇 분 |
-| **비용** | ⚠️ 구독 + 애드온 | ⚠️ 모델 직접 제공 | ⚠️ 모델 직접 제공 | ✅ 단일 구독 + TokenJuice |
-| **메모리** | ✅ 채팅 범위 한정 | ⚠️ 플러그인 의존 | ✅ 자기 학습 | 🚀 메모리 트리 + Obsidian 볼트, 선택적 [agentmemory](https://github.com/rohitg00/agentmemory) 백엔드 |
-| **통합** | ⚠️ 적은 커넥터 | ⚠️ 직접 구축 | ⚠️ 직접 구축 | 🚀 OAuth를 통한 118개 이상 |
-| **자동 가져오기** | 🚫 없음 | 🚫 없음 | 🚫 없음 | ✅ 20분마다 메모리로 동기화 |
-| **API 분산화** | 🚫 추가 키 필요 | 🚫 BYOK | 🚫 멀티 벤더 | ✅ 단일 계정 |
-| **모델 라우팅** | 🚫 단일 모델 | ⚠️ 수동 | ⚠️ 수동 | ✅ 내장됨 |
-| **네이티브 도구** | ✅ 코드 전용 | ✅ 코드 전용 | ✅ 코드 전용 | ✅ 코드 + 검색 + 스크레이퍼 + 음성 |
+| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
+| ------------------- | ----------------- | ----------------- | ----------------- | -------------------------------------------------------------------------------------------------------- |
+| **오픈 소스** | 🚫 독점 소스 | ✅ MIT | ✅ MIT | ✅ GNU |
+| **시작하기 쉬움** | ✅ 데스크톱 + CLI | ⚠️ 터미널 우선 | ⚠️ 터미널 우선 | ✅ 깔끔한 UI, 단 몇 분 |
+| **비용** | ⚠️ 구독 + 애드온 | ⚠️ 모델 직접 제공 | ⚠️ 모델 직접 제공 | ✅ 단일 구독 + TokenJuice |
+| **메모리** | ✅ 채팅 범위 한정 | ⚠️ 플러그인 의존 | ✅ 자기 학습 | 🚀 메모리 트리 + Obsidian 볼트, 선택적 [agentmemory](https://github.com/rohitg00/agentmemory) 백엔드 |
+| **통합** | ⚠️ 적은 커넥터 | ⚠️ 직접 구축 | ⚠️ 직접 구축 | 🚀 100개 이상 OAuth · 5천 개 이상 MCP · 9만 개 이상 Skills |
+| **자동 가져오기** | 🚫 없음 | 🚫 없음 | 🚫 없음 | ✅ 20분마다 메모리로 동기화 |
+| **오케스트레이션** | ⚠️ 서브 태스크 | ⚠️ 단일 루프 | ⚠️ 단일 루프 | 🚀 에이전트 그래프 + 체크포인트 + E2E 암호화 A2A |
+| **워크플로우** | 🚫 없음 | ⚠️ 스크립트 | ⚠️ 스크립트 | 🚀 시각적, 내구성, 에이전트 제안, 승인 게이트 |
+| **회의** | 🚫 없음 | 🚫 없음 | 🚫 없음 | 🚀 Meet/Zoom/Teams/Webex 참여, 발화, 실시간 자막 |
+| **메시징 채널** | 🚫 없음 | ⚠️ 소수 | ⚠️ 소수 | ✅ 네이티브 이메일(IMAP/SMTP) 포함 17개 |
+| **로컬 전용 모드** | 🚫 클라우드 전용 | ⚠️ 로컬 직접 구축 | ⚠️ 로컬 직접 구축 | ✅ 스위치 하나로 강제되는 Privacy Mode |
+| **관측 가능성** | 🚫 불투명 | ⚠️ 로그 | ⚠️ 로그 | ✅ 재생 가능한 실행 저널 + 호출별 비용 집계 |
+| **API 분산화** | 🚫 추가 키 필요 | 🚫 BYOK | 🚫 멀티 벤더 | ✅ 단일 계정 |
+| **모델 라우팅** | 🚫 단일 모델 | ⚠️ 수동 | ⚠️ 수동 | ✅ 내장됨 |
+| **네이티브 도구** | ✅ 코드 전용 | ✅ 코드 전용 | ✅ 코드 전용 | ✅ 코드 + 검색 + 스크레이퍼 + 브라우저 + 음성 + 미디어 생성 |
# GitHub에서 스타를 눌러주세요
_AGI와 인공 의식을 향해 나아가고 계신가요? 저장소에 스타를 눌러 다른 사람들도 이 길을 찾을 수 있도록 도와주세요._
- اوپن ہیومن آپ کی ذاتی مصنوعی ذہانت کی سپر انٹیلی جنس ہے: مقامی یادداشت، ضرورت کے مطابق میزبانی خدمات، سادہ مگر طاقتور۔
+ OpenHuman آپ کی ذاتی AI سپر انٹیلی جنس ہے: ایک دماغ جو سب کچھ یاد رکھتا ہے، ایک شاندار آرکسٹریٹر، ایک گہرا محقق۔ مقامی اول، سادہ، طاقتور۔
-
+
@@ -62,7 +68,7 @@
> **ابتدائی آزمائشی نسخہ**: فعال ترقی جاری ہے، بے ضابطگیوں کی توقع کریں۔
-> **مقامی + منظم خدمات:** OpenHuman اپنا Memory Tree، Obsidian-style Markdown والٹ، ورک اسپیس کنفیگریشن، اور مقامی رن ٹائم اسٹیٹ آپ کی مشین پر محفوظ کرتا ہے۔ طے شدہ منظم تجربہ اب بھی OpenHuman کی میزبان خدمات استعمال کرتا ہے اکاؤنٹ سائن ان، ماڈل روٹنگ، ویب سرچ پروکسی، اور Composio کنیکٹر پرت کے ذریعے منظم انضمام/OAuth فلو کے لیے۔ اگر آپ اپنا ماڈل، سرچ، یا Composio اسناد لانا چاہتے ہیں تو اپنی مرضی کے مطابق/مقامی سیٹنگز منتخب کریں؛ کچھ ریئل ٹائم ٹرگرز اور میزبان فیچرز اب بھی منظم بیک اینڈ کی ضرورت رکھتے ہیں۔
+> 🎉 لانچ کے ایک ہفتے کے اندر، OpenHuman مسلسل نو دن تک GitHub پر نمبر ایک ٹرینڈنگ ریپوزٹری رہا۔
# انسٹال کریں
@@ -110,7 +116,7 @@ sudo apt-get install -y --no-install-recommends ./OpenHuman_*_amd64.deb
**دستی `.dmg` / `.deb` / `.AppImage` / `.msi`:** اپنے پلیٹ فارم کے لیے انسٹالر براہ راست [تازہ ترین ریلیز صفحے](https://github.com/tinyhumansai/openhuman/releases/latest) سے حاصل کریں۔
-> **لینکس:** ایپ امیج وے لینڈ کے تحت لانچ ہوتے وقت کریش کر سکتا ہے، `libgbm.so.1` جیسی میزبان سسٹم لائبریری کھو سکتا ہے، یا آرچ پر مبنی ڈسٹرو پر `sharun: Interpreter not found!` کے ساتھ ناکام ہو سکتا ہے — وجہ اور env-var ورکاراؤنڈ کے لیے [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) دیکھیں۔ اوپر والا `.deb` پیکیج ڈیبین/ابونٹو پر apt کے ذریعے runtime dependencies حل کرتا ہے۔
+> **لینکس:** ایپ امیج وے لینڈ کے تحت لانچ ہوتے وقت کریش کر سکتا ہے، `libgbm.so.1` جیسی میزبان سسٹم لائبریری کھو سکتا ہے، یا آرچ پر مبنی ڈسٹرو پر `sharun: Interpreter not found!` کے ساتھ ناکام ہو سکتا ہے — وجہ اور env-var ورکاراؤنڈ کے لیے [#2463](https://github.com/tinyhumansai/openhuman/issues/2463) دیکھیں۔ اوپر والا `.deb` پیکیج ڈیبین/ابونٹو پر apt کے ذریعے runtime dependencies حل کر کے ان ناکامیوں سے بچاتا ہے۔
## متبادل: اسکرپٹ انسٹال (مربوطیت کی تصدیق نہیں)
@@ -121,7 +127,7 @@ sudo apt-get install -y --no-install-recommends ./OpenHuman_*_amd64.deb
```bash
-# macOS یا Linux x64
+# macOS or Linux x64
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
# Windows (PowerShell)
@@ -140,25 +146,40 @@ irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/instal
# OpenHuman کیا ہے؟
-OpenHuman ایک اوپن سورس ایجنٹک اسسٹنٹ ہے جو آپ کی روزمرہ زندگی میں آپ کے ساتھ ضم ہونے کے لیے ڈیزائن کیا گیا ہے۔ ہر بلیٹ [دستاویزات](https://tinyhumans.gitbook.io/openhuman/) میں گہرائی سے تحریر کی طرف جاتا ہے۔
+OpenHuman تین چیزیں ہے جو زیادہ تر اسسٹنٹس نہیں ہیں: **ایک دماغ** جو آپ کی دنیا کی ایک مستقل، مقامی یادداشت بناتا ہے؛ **ایک شاندار آرکسٹریٹر** جو پائیدار گرافس پر ایجنٹس کے فلیٹس چلاتا ہے؛ اور **ایک گہرا محقق** جو آپ کے سوال مکمل کرنے سے پہلے آپ کے ڈیٹا اور ویب کا جائزہ لے لیتا ہے۔ ہر بلیٹ [دستاویزات](https://tinyhumans.gitbook.io/openhuman/) میں گہرائی سے تحریر کی طرف جاتا ہے۔
-- **سادہ، یوزر انٹرفیس اول اور انسانی** — ایک صاف ڈیسک ٹاپ تجربہ اور مختصر آن بورڈنگ راستے آپ کو انسٹال سے ایک کام کرنے والے ایجنٹ تک چند کلکس میں لے جاتے ہیں — کوئی پہلے کنفیگر نہیں، کوئی ٹرمینل ضروری نہیں۔ ایجنٹ کا [ایک چہرہ](https://tinyhumans.gitbook.io/openhuman/features/mascot) ہے: ایک ڈیسک ٹاپ مسکاٹ جو بولتا ہے، اپنے ماحول پر ردعمل دیتا ہے، [Google Meet میں](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents) ایک حقیقی شریک کے طور پر شامل ہوتا ہے، ہفتوں تک آپ کو یاد رکھتا ہے، اور پس منظر میں سوچتا رہتا ہے چاہے آپ نے ٹائپ کرنا چھوڑ دیا ہو۔
+### 🧠 دماغ
-- **[118+ تیسرے فریق کے انضمام](https://tinyhumans.gitbook.io/openhuman/features/integrations) + [خودکار لانا](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch)**: **ایک کلک OAuth** کے ساتھ Gmail، Notion، GitHub، Slack، Stripe، Calendar، Drive، Linear، Jira اور اپنے باقی اسٹیک میں پلگ ان کریں۔ ہر کنیکشن ایجنٹ کو ایک ٹائپڈ ٹول کے طور پر ظاہر ہوتا ہے، اور ہر بیس منٹ میں کور ہر فعال کنیکشن پر چلتا ہے اور تازہ ڈیٹا کو [میموری ٹری](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch) میں کھینچتا ہے۔ کوئی پرامپٹ نہیں، کوئی پولنگ لوپ نہیں جو آپ کو لکھنا پڑے، اس لیے ایجنٹ کے پاس آج صبح ہی کل کا سیاق و سباق ہوتا ہے۔
+- **[میموری ٹری](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: آپ کا ڈیٹا اسکور شدہ Markdown درختوں میں کمپریس ہو کر آپ کی مشین پر SQLite میں محفوظ ہوتا ہے، اور ایک [Obsidian والٹ](https://x.com/karpathy/status/2039805659525644595) کے طور پر عکس بند ہوتا ہے جسے آپ کھول اور ایڈٹ کر سکتے ہیں۔ کوئی ویکٹر سوپ بلیک باکس نہیں۔
+- **[100+ OAuth انضمام، 5,000+ MCP سرورز، 90,000+ سکلز](https://tinyhumans.gitbook.io/openhuman/features/integrations)**: ایک کلک سے Gmail، Notion، GitHub، Slack اور اپنے باقی اسٹیک میں پلگ ان کریں۔ [خودکار لانا](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch) ہر 20 منٹ میں دماغ کو خوراک دیتا ہے — اس کے پاس آج صبح ہی کل کا سیاق و سباق ہوتا ہے۔
+- **[ایک لاشعور](https://tinyhumans.gitbook.io/openhuman/features/subconscious)**: ایک پس منظر لوپ جو آپ کی دنیا کا موازنہ کرتا ہے، آپ کے اہداف کو آگے بڑھاتا ہے، اور آپ کی صبح کی بریفنگ لکھتا ہے — آپ کے ٹائپ کرنا چھوڑنے کے بعد بھی سوچ جاری رہتی ہے۔
+- **[اہداف اور ٹوڈوز](https://tinyhumans.gitbook.io/openhuman/features/goals-and-todos)**: طویل مدتی اہداف، فی تھریڈ پائیدار اہداف، اور ہر گفتگو کے لیے ایک مشترکہ کنبان بورڈ۔
+- **[TokenJuice](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: ٹول آؤٹ پٹ ماڈل تک پہنچنے سے پہلے کمپریس ہوتا ہے — وہی معلومات، 80% تک کم ٹوکنز۔ اتنا بڑا دماغ اس کے بغیر ناقابلِ برداشت مہنگا ہوتا۔
- منظم انضمام OpenHuman کے Composio کنیکٹر پرت کا استعمال کرتے ہیں۔ OAuth مصافحہ اور انضمام ٹول کالز ڈیفالٹ طور پر منظم بیک اینڈ کے ذریعے پروکسی ہوتی ہیں۔ اگر آپ براہ راست Composio چلانا چاہتے ہیں تو اپنی Composio API کلید کے ساتھ ڈائریکٹ موڈ کنفیگر کریں؛ ریئل ٹائم ٹرگر ویب ہکس کو پھر آپ کو خود میزبانی اور وائر کرنا ہوگا۔
+### 🕸️ آرکسٹریٹر
-- **[میموری ٹری](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: ایک مقامی اول علم کا ذخیرہ جو آپ کے ڈیٹا اور سرگرمی سے بنایا گیا ہے۔ آپ جو کچھ بھی جوڑتے ہیں وہ ≤3k-token کے Markdown ٹکڑوں میں معیاری ہو جاتا ہے، اسکور کیا جاتا ہے، اور درجہ بندی کے خلاصے کے درختوں میں جوڑ دیا جاتا ہے جو **آپ کی مشین پر SQLite** میں محفوظ ہوتے ہیں۔ وہی ٹکڑے Obsidian-مطابق والٹ میں `.md` فائلوں کے طور پر اترتے ہیں جسے آپ کھول سکتے ہیں، براؤز اور ایڈٹ کر سکتے ہیں، کارپیتھی کے [obsidian-wiki ورک فلو](https://x.com/karpathy/status/2039805659525644595) سے متاثر۔
+- **[ورک فلوز](https://tinyhumans.gitbook.io/openhuman/features/workflows)** _(نیا)_: ایجنٹ آٹومیشن تجویز کرتا ہے؛ آپ اسے کینوس پر جائزہ لے کر محفوظ کرتے ہیں۔ اوپن سورس [tinyflows](https://github.com/tinyhumansai/tinyflows) پر پائیدار، ٹرگر سے چلنے والے، منظوری سے محفوظ رنز۔
+- **[ایک ہارنس جو کام مکمل کرتا ہے](https://tinyhumans.gitbook.io/openhuman/developing/architecture/agent-harness)** _(نیا)_: اوپن سورس [tinyagents](https://github.com/tinyhumansai/tinyagents) پر چیک پوائنٹ شدہ گراف رنز — اٹکے ہوئے ایجنٹس کو راہ دکھائی جاتی ہے، رکے ہوئے بنیادی وجہ واپس دیتے ہیں، ہر رن حقیقی فی کال لاگت کے ساتھ دوبارہ چلایا جا سکتا ہے۔
+- **[ایک split brain، ہمیشہ فعال](https://tinyhumans.gitbook.io/openhuman/features/orchestration)** _(نیا)_: ایک تیز reflex ایجنٹ آنے والی ٹریفک کو چھانٹتا ہے جبکہ ایک گہرا reasoning کور ورکر فلیٹس کو کام سونپتا ہے، لاشعور کی رہنمائی میں۔
+- **[ایک ایجنٹ معیشت](https://tinyhumans.gitbook.io/openhuman/features/tinyplace)**: [tiny.place](https://tiny.place) پر ایک `@handle`، Signal-انکرپٹڈ ایجنٹ سے ایجنٹ آرکسٹریشن، x402 USDC انعامی کام اور تجارت — چابیاں کبھی ڈسک کو نہیں چھوتیں۔
-- **سب کچھ شامل ہے**: ویب سرچ، ایک ویب فیچ [سکریپر](https://tinyhumans.gitbook.io/openhuman/features/native-tools)، ایک مکمل کوڈر ٹول سیٹ (فائل سسٹم، گٹ، لنٹ، ٹیسٹ، گریپ)، اور [مقامی آواز](https://tinyhumans.gitbook.io/openhuman/features/native-tools/voice) (STT ان پٹ، ElevenLabs TTS آؤٹ پٹ، مسکاٹ لپ سنک، لائیو Google Meet ایجنٹ) ڈیفالٹ طور پر وائرڈ ہیں۔ ڈیفالٹ طور پر، [ماڈل روٹنگ](https://tinyhumans.gitbook.io/openhuman/features/model-routing) ہر ورک لوڈ (reasoning، fast، یا vision) کے لیے صحیح LLM کو منتخب اور پروکسی کرنے کے لیے OpenHuman بیک اینڈ استعمال کرتی ہے۔ ایک سبسکرپشن میں تمام ماڈلز شامل ہیں۔ کوئی "فائل پڑھنے کے لیے پلگ ان انسٹال کریں" رگڑ نہیں۔ تعاون یافتہ ڈیوائس پر ورک لوڈز کے لیے [Ollama کے ذریعے اختیاری مقامی AI](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai) استعمال کریں۔
+### 🔬 گہرا محقق اور کام کرنے والا
-- **[اسمارٹ ٹوکن کمپریشن (TokenJuice)](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: ہر ٹول کال، سکریپ نتیجہ، ای میل باڈی، اور سرچ پے لوڈ کسی بھی LLM ماڈل کو چھونے سے پہلے ٹوکن کمپریشن پرت سے گزرتا ہے۔ HTML کو Markdown میں تبدیل کیا جاتا ہے، لمبے URLs کو چھوٹا کیا جاتا ہے، اور لمبے ٹول آؤٹ پٹ کو ایک قابل ترتیب اصول اوورلے وغیرہ کے ذریعے ڈیڈپ اور خلاصہ کیا جاتا ہے... CJK، ایموجی، اور دیگر ملٹی بائٹ ٹیکسٹ گرافیم بہ گرافیم محفوظ رہتے ہیں — کبھی نہیں ہٹائے جاتے۔ آپ کو وہی معلومات ملتی ہیں لیکن ٹوکنز کے ایک حصے میں۔ لاگت اور تاخیر کو 80% تک کم کرنا۔
+- **[SuperContext](https://tinyhumans.gitbook.io/openhuman/features/super-context)**: ایک ریسرچ اسکاؤٹ ماڈل کے آپ کا پہلا پیغام پڑھنے سے پہلے آپ کی یادداشت اور فائلوں کا جائزہ لے لیتا ہے۔ کوئی سرد آغاز نہیں۔
+- **سب کچھ شامل ہے**: ویب سرچ، سکریپر، کوڈر ٹول سیٹ، ایک حقیقی [براؤزر](https://tinyhumans.gitbook.io/openhuman/features/native-tools/browser-and-computer)، ان پروسیس Whisper کے ساتھ [مقامی آواز](../gitbooks/features/native-tools/voice.md) — اور [ماڈل روٹنگ](https://tinyhumans.gitbook.io/openhuman/features/model-routing) جو ہر ورک لوڈ کے لیے صحیح LLM چنتی ہے، ایک سبسکرپشن، [مقامی AI اختیاری](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai)۔
+- **[میٹنگ ایجنٹس](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents)** _(نیا)_: چہرے اور آواز کے ساتھ **Meet، Zoom، Teams، اور Webex** میں شامل ہوتا ہے — کیلنڈر سے خود بخود شامل ہوتا ہے، لائیو ٹرانسکرپٹ اسٹریم کرتا ہے، نام سے جواب دیتا ہے، خلاصہ + ایکشن آئٹمز محفوظ کرتا ہے۔
+- **[تصویر اور ویڈیو جنریشن](https://tinyhumans.gitbook.io/openhuman/features/native-tools)** _(نیا)_: Seedream/SeedEdit تصاویر اور Seedance/Veo ویڈیو، براہ راست آپ کے ورک اسپیس میں، اسی سبسکرپشن پر۔
+- **[17 میسجنگ چینلز](https://tinyhumans.gitbook.io/openhuman/features/channels)**: Telegram، Discord، Slack، WhatsApp، Signal، iMessage… اور ساتھ **مقامی ای میل** (IMAP IDLE + SMTP)۔ آپ کا ایجنٹ آپ تک وہیں پہنچتا ہے جہاں آپ پہلے سے موجود ہیں۔
-- **[میسجنگ چینلز](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** اور **[پرائیویسی اور سیکیورٹی](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: ان چینلز پر اندر/باہر جنہیں آپ پہلے سے استعمال کرتے ہیں، ورک فلو ڈیٹا کے ساتھ جو ڈیوائس پر رہتا ہے، مقامی طور پر انکرپٹڈ، آپ کا سمجھا جاتا ہے۔
+### 🧍 انسانی، نجی، آپ کا اپنا
+
+- **سادہ، یوزر انٹرفیس اول اور انسانی**: انسٹال سے کام کرنے والے ایجنٹ تک چند کلکس میں — کوئی کنفیگ فائلیں نہیں، کوئی ٹرمینل نہیں۔ اور اس کا [ایک چہرہ](https://tinyhumans.gitbook.io/openhuman/features/mascot) ہے: ایک مسکاٹ جو بولتا ہے، ردعمل دیتا ہے، اور آپ کو یاد رکھتا ہے۔
+- **[پرائیویسی اور سیکیورٹی](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: ڈیوائس پر انکرپٹڈ ڈیٹا، منظوری کا دروازہ، OS-keyring رازداری، اختیاری سینڈ باکسنگ — اور _(نیا)_ **[پرائیویسی موڈ](https://tinyhumans.gitbook.io/openhuman/features/privacy-mode)**: ایک سوئچ اور کوئی inference آپ کی مشین سے باہر نہیں جاتی، Rust کور میں نافذ۔
+- **[تھیمز اور تھیم اسٹوڈیو](https://tinyhumans.gitbook.io/openhuman/features/theming)**: پانچ تھیم خاندان اور ایک مکمل بصری ایڈیٹر، JSON کے طور پر قابلِ ایکسپورٹ۔
## سورس سے تعاون
-نیا تعاون کنندہ؟ fork/PR ورک فلو اور مقامی تصدیقی کمانڈز کے لیے [`CONTRIBUTING.md`](../CONTRIBUTING.md) سے شروع کریں۔ مختصر راستہ:
+نیا تعاون کنندہ؟ fork/PR ورک فلو اور مقامی تصدیقی کمانڈز کے لیے [`CONTRIBUTING.md`](../CONTRIBUTING.md) سے شروع کریں، یا [`CONTRIBUTING-BEGINNERS.md`](../CONTRIBUTING-BEGINNERS.md#optional-let-an-ai-coding-agent-guide-you) میں موجود کاپی پیسٹ AI-ایجنٹ پرامپٹ استعمال کریں۔ مختصر راستہ:
1. Git، Node.js 24+، pnpm 10.10.0، Rust 1.93.0 (`rustfmt` + `clippy`)، CMake، Ninja، ripgrep، اور پلیٹ فارم ڈیسک ٹاپ بلڈ کی ضروریات انسٹال کریں۔
2. ریپو کو fork اور کلون کریں، پھر `pnpm install` سے پہلے `git submodule update --init --recursive` چلائیں تاکہ وینڈرڈ Tauri/CEF سورس موجود ہوں۔
@@ -175,7 +196,7 @@ OpenHuman پہلا ایجنٹ ہارنس ہے جو منٹوں میں آپ کو
-
+
@@ -184,12 +205,23 @@ OpenHuman پہلا ایجنٹ ہارنس ہے جو منٹوں میں آپ کو
> OpenHuman آپ کی تمام دستاویزات، ای میلز اور چیٹس کا خلاصہ اور کمپریس کرتا ہے؛ اور ایک میموری گراف بناتا ہے جو آپ کے ایجنٹ کو آپ کے بارے میں سب کچھ یاد رکھنے دیتا ہے۔
-OpenHuman انتظار چھوڑ دیتا ہے۔ اپنے اکاؤنٹس جوڑیں، [خودکار لانے](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch) کو 20 منٹ کے لوپ پر مقامی طور پر ڈیٹا کھینچنے دیں، اور پھر [میموری ٹریز](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) کو ہر چیز کو Markdown فائلوں میں کمپریس کرنے دیں جو [Karpathy-style Obsidian wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki) میں ذخیرہ ہوتی ہیں۔
+OpenHuman انتظار چھوڑ دیتا ہے۔ اپنے اکاؤنٹس جوڑیں، [خودکار لانے](https://tinyhumans.gitbook.io/openhuman/features/integrations/auto-fetch) کو 20 منٹ کے لوپ پر مقامی طور پر ڈیٹا کھینچنے دیں، اور پھر [میموری ٹریز](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) کو ہر چیز کو Markdown فائلوں میں کمپریس کرنے دیں جو [Karpathy-style Obsidian wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki) میں ذہانت سے ذخیرہ ہوتی ہیں۔
صرف ایک سنک پاس میں، ایجنٹ کے پاس آپ کے ان باکس، کیلنڈر، ریپوز، دستاویزات، پیغامات کا مکمل (کمپریسڈ) سیاق و سباق ہوتا ہے۔ کوئی تربیتی مدت نہیں۔ کوئی "اسے کچھ ہفتے دو" نہیں۔ یہ آپ بن جاتا ہے، آپ کے کنٹرول میں۔
پہلے سے دوسرے کوڈنگ ایجنٹس میں [agentmemory](https://github.com/rohitg00/agentmemory) سیلف ہوسٹ کر رہے ہیں؟ OpenHuman ایک اختیاری `Memory` بیک اینڈ بھیجتا ہے جو اسے پروکسی کرتا ہے — `config.toml` میں `memory.backend = "agentmemory"` سیٹ کریں اور وہی پائیدار اسٹور OpenHuman کے ساتھ Claude Code، Cursor، Codex، اور OpenCode کو طاقت دیتا ہے۔ سیٹ اپ کے لیے [agentmemory بیک اینڈ](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/agentmemory-backend) صفحہ دیکھیں۔
+## ایک آرکسٹریٹر، چیٹ بوٹ نہیں
+
+سب سے گہرا فرق کوئی ایک فیچر نہیں — بلکہ execution model ہے۔ Claude Code، OpenClaw، اور Hermes **ایک لوپ میں ایک ایجنٹ** چلاتے ہیں۔ OpenHuman ایک **[آرکسٹریٹر](https://tinyhumans.gitbook.io/openhuman/features/orchestration)** ہے:
+
+- **گرافس، لوپس نہیں** — باریاں [tinyagents](https://github.com/tinyhumansai/tinyagents) پر چیک پوائنٹ شدہ state-machine گرافس میں کمپائل ہوتی ہیں: انسان کے لیے رکیں، ری اسٹارٹ سے بچ نکلیں، رن کے بیچ سے دوبارہ شروع ہوں۔
+- **ذیلی ایجنٹ فلیٹس** — ماہرین تین سطح گہرائی تک بنتے ہیں، فارغ ورکرز دوبارہ استعمال ہوتے ہیں، اور سرکٹ بریکرز اٹکے ہوئے ایجنٹس کو بنیادی وجہ کی رپورٹوں میں بدل دیتے ہیں۔
+- **ورک فلوز جو آپ دیکھ سکتے ہیں** — ایجنٹ کے تجویز کردہ [tinyflows](https://github.com/tinyhumansai/tinyflows) گرافس، کینوس پر جائزہ شدہ: پائیدار، ٹرگر سے چلنے والے، منظوری سے محفوظ۔
+- **ایک split brain، ہمیشہ فعال** — ایک تیز reflex ایجنٹ چھانٹتا ہے جبکہ ایک گہرا کور سوچتا ہے، لاشعوری لوپ کی رہنمائی میں۔
+- **ایجنٹ سے ایجنٹ، انکرپٹڈ** — انسٹینسز ایک دوسرے کو **Signal-پروٹوکول E2E** سیشنز پر آرکسٹریٹ کرتے ہیں، رضامندی پر مبنی جوڑی اور x402 ادائیگیوں کے ساتھ۔ کوئی سرور plaintext نہیں دیکھتا۔
+- **آگے: RLMs** — ماڈل ایک سینڈ باکسڈ REPL میں اپنا آرکسٹریشن کوڈ خود لکھتا ہے، اسی گراف انجن اور ٹرسٹ ماڈل پر۔
+
## OpenHuman بمقابلہ دوسرے ایجنٹ ہارنسز
اعلیٰ سطحی موازنہ (مصنوعات تیار ہوتی ہیں، اس لیے ہر وینڈر کے خلاف تصدیق کریں)۔ OpenHuman کو **وینڈر پھیلاؤ کو کم سے کم کرنے**، **ورک فلو کے علم کو ڈیوائس پر رکھنے**، اور ایجنٹ کو آپ کے ڈیٹا کی **مستقل یادداشت** دینے کے لیے بنایا گیا ہے، نہ کہ صرف چیٹ۔
@@ -198,17 +230,23 @@ OpenHuman انتظار چھوڑ دیتا ہے۔ اپنے اکاؤنٹس جوڑی
-| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
-| ------------------- | ----------------- | ----------------- | ----------------- | ---------------------------------- |
-| **اوپن سورس** | 🚫 ملکیتی | ✅ MIT | ✅ MIT | ✅ GNU |
-| **شروع کرنا آسان** | ✅ ڈیسک ٹاپ + کمانڈ لائن | ⚠️ پہلے ٹرمینل | ⚠️ پہلے ٹرمینل | ✅ صاف یوزر انٹرفیس، منٹوں میں |
-| **لاگت** | ⚠️ سبسکرپشن + ایڈ آنز | ⚠️ اپنے ماڈل | ⚠️ اپنے ماڈل | ✅ ایک سبسکرپشن + TokenJuice |
-| **یادداشت** | ✅ چیٹ تک محدود | ⚠️ پلگ ان پر انحصار | ✅ خود سیکھنا | 🚀 میموری ٹری + Obsidian والٹ، اختیاری [agentmemory](https://github.com/rohitg00/agentmemory) بیک اینڈ |
-| **انضمام** | ⚠️ چند کنیکٹر | ⚠️ خود لائیں | ⚠️ خود لائیں | 🚀 118+ OAuth کے ذریعے |
-| **خودکار لانا** | 🚫 کوئی نہیں | 🚫 کوئی نہیں | 🚫 کوئی نہیں | ✅ 20 منٹ سنک میموری میں |
-| **API پھیلاؤ** | 🚫 اضافی چابیاں | 🚫 اپنی چابیاں | 🚫 کئی وینڈر | ✅ ایک اکاؤنٹ |
-| **ماڈل روٹنگ** | 🚫 ایک ماڈل | ⚠️ دستی | ⚠️ دستی | ✅ بلٹ ان |
-| **مقامی ٹولز** | ✅ صرف کوڈ | ✅ صرف کوڈ | ✅ صرف کوڈ | ✅ کوڈ + سرچ + سکریپر + آواز |
+| | Claude Cowork | OpenClaw | Hermes Agent | OpenHuman |
+| ------------------- | ------------------------ | ------------------- | ---------------- | -------------------------------------------------------------------------------------------------------- |
+| **اوپن سورس** | 🚫 ملکیتی | ✅ MIT | ✅ MIT | ✅ GNU |
+| **شروع کرنا آسان** | ✅ ڈیسک ٹاپ + کمانڈ لائن | ⚠️ پہلے ٹرمینل | ⚠️ پہلے ٹرمینل | ✅ صاف یوزر انٹرفیس، منٹوں میں |
+| **لاگت** | ⚠️ سبسکرپشن + ایڈ آنز | ⚠️ اپنے ماڈل | ⚠️ اپنے ماڈل | ✅ ایک سبسکرپشن + TokenJuice |
+| **یادداشت** | ✅ چیٹ تک محدود | ⚠️ پلگ ان پر انحصار | ✅ خود سیکھنا | 🚀 میموری ٹری + Obsidian والٹ، اختیاری [agentmemory](https://github.com/rohitg00/agentmemory) بیک اینڈ |
+| **انضمام** | ⚠️ چند کنیکٹر | ⚠️ خود لائیں | ⚠️ خود لائیں | 🚀 100+ OAuth · 5k+ MCP · 90k+ سکلز |
+| **خودکار لانا** | 🚫 کوئی نہیں | 🚫 کوئی نہیں | 🚫 کوئی نہیں | ✅ 20 منٹ سنک میموری میں |
+| **آرکسٹریشن** | ⚠️ ذیلی ٹاسکس | ⚠️ ایک لوپ | ⚠️ ایک لوپ | 🚀 ایجنٹ گرافس + چیک پوائنٹس + E2E-انکرپٹڈ A2A |
+| **ورک فلوز** | 🚫 کوئی نہیں | ⚠️ اسکرپٹس | ⚠️ اسکرپٹس | 🚀 بصری، پائیدار، ایجنٹ کی تجویز کردہ، منظوری سے محفوظ |
+| **میٹنگز** | 🚫 کوئی نہیں | 🚫 کوئی نہیں | 🚫 کوئی نہیں | 🚀 Meet/Zoom/Teams/Webex میں شامل، بولتا ہے، لائیو ٹرانسکرپٹ |
+| **میسجنگ چینلز** | 🚫 کوئی نہیں | ⚠️ چند ایک | ⚠️ چند ایک | ✅ 17 بشمول مقامی ای میل (IMAP/SMTP) |
+| **صرف مقامی موڈ** | 🚫 صرف کلاؤڈ | ⚠️ اپنا مقامی لائیں | ⚠️ اپنا مقامی لائیں | ✅ ایک سوئچ سے نافذ پرائیویسی موڈ |
+| **مشاہدہ پذیری** | 🚫 غیر شفاف | ⚠️ لاگز | ⚠️ لاگز | ✅ قابلِ اعادہ رن جرنلز + فی کال لاگت کا حساب |
+| **API پھیلاؤ** | 🚫 اضافی چابیاں | 🚫 اپنی چابیاں | 🚫 کئی وینڈر | ✅ ایک اکاؤنٹ |
+| **ماڈل روٹنگ** | 🚫 ایک ماڈل | ⚠️ دستی | ⚠️ دستی | ✅ بلٹ ان |
+| **مقامی ٹولز** | ✅ صرف کوڈ | ✅ صرف کوڈ | ✅ صرف کوڈ | ✅ کوڈ + سرچ + سکریپر + براؤزر + آواز + میڈیا جنریشن |
@@ -58,7 +54,7 @@
> **Early Beta**: Under active development. Expect rough edges.
-> **Local + managed services, upfront:** OpenHuman stores its Memory Tree, Obsidian-style Markdown vault, workspace config, and local runtime state on your machine. The default managed experience still uses OpenHuman-hosted services for account sign-in, model routing, web search proxying, and managed integration/OAuth flows through the Composio connector layer. Choose custom/local settings if you want to bring your own model, search, or Composio credentials; some real-time triggers and hosted features still require the managed backend.
+> 🎉 Within one week of launch, OpenHuman became the number one trending repository on GitHub for nine days in a row.
# Install
@@ -112,27 +108,36 @@ A separately signed script-install path is not currently available. Issue [#2620
# 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](https://tinyhumans.gitbook.io/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](https://tinyhumans.gitbook.io/openhuman/).
-- **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](https://tinyhumans.gitbook.io/openhuman/features/mascot): a desktop mascot that speaks, reacts to its surroundings, [joins your Google Meets](https://tinyhumans.gitbook.io/openhuman/features/mascot/meeting-agents) as a real participant, remembers you across weeks, and keeps thinking in the background even when you've stopped typing.
+### 🧠 The brain
-- **100+ one-click OAuth integrations, 5,000+ MCP servers, 90,000+ Skills**: plug into Gmail, Notion, GitHub, Slack, Stripe, Calendar, Drive, Linear, Jira and the rest of your stack with [**one-click OAuth**](https://tinyhumans.gitbook.io/openhuman/features/integrations) — 100+ curated connectors brokered through the Composio layer. Beyond that, OpenHuman browses the open **Model Context Protocol** ecosystem (Smithery + the official MCP registry — thousands of servers) and a **90,000-entry Skills catalog**, so the agent can install new typed tools and skills on demand. Every connection becomes a typed tool, and every twenty minutes [auto-fetch](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch) walks each active connection and pulls fresh data into the [memory tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree). No prompts, no polling loops you have to write, so the agent already has tomorrow's context this morning.
+- **[Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian Wiki](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki)**: your data compressed into scored Markdown trees in SQLite on your machine, mirrored as an [Obsidian vault](https://x.com/karpathy/status/2039805659525644595) you can open and edit. No vector-soup black box.
+- **[100+ OAuth integrations, 5,000+ MCP servers, 90,000+ Skills](https://tinyhumans.gitbook.io/openhuman/features/integrations)**: one click into Gmail, Notion, GitHub, Slack and the rest of your stack. [Auto-fetch](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/auto-fetch) feeds the brain every 20 minutes — it has tomorrow's context this morning.
+- **[A subconscious](https://tinyhumans.gitbook.io/openhuman/features/subconscious)**: a background loop that diffs your world, advances your goals, and writes your morning briefing — thinking continues after you stop typing.
+- **[Goals & Todos](https://tinyhumans.gitbook.io/openhuman/features/goals-and-todos)**: long-term goals, durable per-thread goals, and a shared kanban board per conversation.
+- **[TokenJuice](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: tool output compressed before it hits the model — same information, up to 80% fewer tokens. A brain this big would be unaffordable without it.
- Managed integrations use OpenHuman's Composio connector layer. OAuth handshakes and integration tool calls are proxied through the managed backend by default. If you want to run Composio directly instead, configure direct mode with your own Composio API key; real-time trigger webhooks then need to be hosted and wired by you.
+### 🕸️ The orchestrator
-- **[Memory Tree](https://tinyhumans.gitbook.io/openhuman/features/memory-tree) + [Obsidian Wiki](https://tinyhumans.gitbook.io/openhuman/features/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](https://x.com/karpathy/status/2039805659525644595).
+- **[Workflows](https://tinyhumans.gitbook.io/openhuman/features/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](https://github.com/tinyhumansai/tinyflows).
+- **[A harness that finishes the job](https://tinyhumans.gitbook.io/openhuman/developing/architecture/agent-harness)** _(new)_: checkpointed graph runs on open-source [tinyagents](https://github.com/tinyhumansai/tinyagents) — stuck agents get steered, halted ones return a root cause, every run replays with real per-call costs.
+- **[A split brain, always on](https://tinyhumans.gitbook.io/openhuman/features/orchestration)** _(new)_: a fast reflex agent triages inbound traffic while a deep reasoning core delegates to worker fleets, steered by the subconscious.
+- **[An agent economy](https://tinyhumans.gitbook.io/openhuman/features/tinyplace)**: a `@handle` on [tiny.place](https://tiny.place), Signal-encrypted agent-to-agent orchestration, x402 USDC bounties and trading — keys never touch disk.
-- **[SuperContext](https://tinyhumans.gitbook.io/openhuman/features/super-context)**: a fresh chat shouldn't start cold. With SuperContext enabled, the harness deterministically spawns a read-only `context_scout` on the **first turn of every new thread** — it sweeps your memory tree, files, and connected data, assembles a bounded context bundle, and prepends it to your message before the model ever reads it. No tool call to wait on, no "let me look that up" round-trip: the agent answers your first message already knowing the relevant background. Toggle it from the composer or `context.super_context_enabled`.
+### 🔬 The deep researcher & doer
-- **[Goals & Todos](https://tinyhumans.gitbook.io/openhuman/features/goals-and-todos)**: OpenHuman keeps the agent pointed at what matters. A short, human-editable list of **long-term goals** (`MEMORY_GOALS.md`) rides along in memory and can self-reflect against your recent activity; each **thread** can carry a single durable **goal** with an optional token budget that the agent works across turns, interrupts and idle periods (autonomous idle continuation); and every conversation hosts a **kanban task board** of todos that you and the agent build together — plans, acceptance criteria, approval gates and all. There's also a personal task list you own outright.
+- **[SuperContext](https://tinyhumans.gitbook.io/openhuman/features/super-context)**: 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](https://tinyhumans.gitbook.io/openhuman/features/native-tools/browser-and-computer), [native voice](gitbooks/features/native-tools/voice.md) with in-process Whisper — and [model routing](https://tinyhumans.gitbook.io/openhuman/features/model-routing) that picks the right LLM per workload, one subscription, [local AI optional](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai).
+- **[Meeting agents](https://tinyhumans.gitbook.io/openhuman/features/mascot/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](https://tinyhumans.gitbook.io/openhuman/features/native-tools)** _(new)_: Seedream/SeedEdit images and Seedance/Veo video, straight into your workspace on the same subscription.
+- **[17 messaging channels](https://tinyhumans.gitbook.io/openhuman/features/channels)**: Telegram, Discord, Slack, WhatsApp, Signal, iMessage… plus **native email** (IMAP IDLE + SMTP). Your agent reaches you where you already are.
-- **[Themes & Theme Studio](https://tinyhumans.gitbook.io/openhuman/features/theming)**: make it yours. Five built-in theme families (Classic, Ocean, Sepia, Matrix, HAL 9000) ship in light/dark/auto variants, and the **Theme Studio** in Settings is a full visual editor — adjust every colour token with live contrast warnings, swap fonts per role, pick an animated WebGL-mesh / flat / custom-image backdrop, and export or import themes as JSON to share. Editing a preset auto-forks a custom theme so the originals stay pristine; everything applies instantly and persists locally.
+### 🧍 Human, private, yours
-- **Batteries included**: web search, a web-fetch [scraper](https://tinyhumans.gitbook.io/openhuman/features/native-tools), a full coder toolset (filesystem, git, lint, test, grep), and [native voice](gitbooks/features/native-tools/voice.md) (STT in, ElevenLabs TTS out, mascot lip-sync, live Google Meet agent) are wired in by default. By default, [model routing](https://tinyhumans.gitbook.io/openhuman/features/model-routing) uses the OpenHuman backend to select and proxy the right LLM for each workload (reasoning, fast, or vision). One subscription includes all models. No "install a plugin to read files" friction. Use [optional local AI via Ollama](https://tinyhumans.gitbook.io/openhuman/features/model-routing/local-ai) for supported on-device workloads.
-
-- **[Smart token compression (TokenJuice)](https://tinyhumans.gitbook.io/openhuman/features/token-compression)**: 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, and verbose tool output is deduped and summarized via a configurable rule overlay etc... CJK, emoji, and other multi-byte text are preserved grapheme-by-grapheme — never stripped. You get the same information but at a fraction of the tokens. Reducing cost & latency by up to 80%.
-
-- **[Messaging channels](https://tinyhumans.gitbook.io/openhuman/features/integrations#messaging-channels)** and **[privacy & security](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: inbound/outbound across the channels you already use, with workflow data that stays on device, encrypted locally, treated as yours.
+- **Simple, UI-first & Human**: install to working agent in a few clicks — no config files, no terminal. And it has [a face](https://tinyhumans.gitbook.io/openhuman/features/mascot): a mascot that speaks, reacts, and remembers you.
+- **[Privacy & security](https://tinyhumans.gitbook.io/openhuman/features/privacy-and-security)**: on-device encrypted data, approval gate, OS-keyring secrets, opt-in sandboxing — and _(new)_ **[Privacy Mode](https://tinyhumans.gitbook.io/openhuman/features/privacy-mode)**: one switch and no inference leaves your machine, enforced in the Rust core.
+- **[Themes & Theme Studio](https://tinyhumans.gitbook.io/openhuman/features/theming)**: five theme families plus a full visual editor, exportable as JSON.
## Contributing from source
@@ -160,21 +165,38 @@ In just one sync pass, the agent has full (compressed) context of your inbox, yo
Already self-host [agentmemory](https://github.com/rohitg00/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](https://tinyhumans.gitbook.io/openhuman/features/obsidian-wiki/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](https://tinyhumans.gitbook.io/openhuman/features/orchestration)**:
+
+- **Graphs, not loops** — turns compile to checkpointed state-machine graphs on [tinyagents](https://github.com/tinyhumansai/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](https://github.com/tinyhumansai/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](https://github.com/rohitg00/agentmemory) backend |
-| **Integrations** | ⚠️ Few connectors | ⚠️ BYO | ⚠️ BYO | 🚀 100+ OAuth · 5k+ MCP · 90k+ Skills |
-| **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 |
+| | 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](https://github.com/rohitg00/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
diff --git a/docs/README.de.md b/docs/README.de.md
index 9ab3b9644..2452aa94e 100644
--- a/docs/README.de.md
+++ b/docs/README.de.md
@@ -1,8 +1,3 @@
-
- 
+ 
+ 
+ .png)
+ 
