mirror of
https://github.com/tinyhumansai/openhuman.git
synced 2026-07-27 21:08:00 +00:00
188 lines
20 KiB
Markdown
188 lines
20 KiB
Markdown
<h1 align="center">OpenHuman</h1>
|
|
|
|
<p align="center">
|
|
<img src="../gitbooks/.gitbook/assets/demo.png" alt="The Tet" />
|
|
</p>
|
|
|
|
<p align="center" style="display: inline-block">
|
|
<a href="https://trendshift.io/repositories/23680" target="_blank" style="display: inline-block">
|
|
<img src="https://trendshift.io/api/badge/repositories/23680" alt="tinyhumansai%2Fopenhuman | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
|
|
</a>
|
|
<a href="https://www.producthunt.com/products/openhuman?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer">
|
|
<img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1136902&theme=light&period=daily&t=1778916022823">
|
|
</a>
|
|
<a href="https://www.producthunt.com/products/openhuman?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer">
|
|
<img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1136902&theme=light&period=weekly&t=1779351403565">
|
|
</a>
|
|
</p>
|
|
<p align="center" style="display: inline-block">
|
|
<a href="https://www.producthunt.com/products/openhuman?embed=true&utm_source=badge-top-post-topic-badge&utm_medium=badge&utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer">
|
|
<img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-topic-badge.svg?post_id=1136902&theme=light&period=weekly&topic_id=268&t=1779351808756">
|
|
</a>
|
|
<a href="https://www.producthunt.com/products/openhuman?embed=true&utm_source=badge-top-post-topic-badge&utm_medium=badge&utm_campaign=badge-openhuman" target="_blank" rel="noopener noreferrer">
|
|
<img alt="OpenHuman - An open source AI harness built with the human in mind | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/top-post-topic-badge.svg?post_id=1136902&theme=light&period=weekly&topic_id=46&t=1779351808756">
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<strong>OpenHuman ist deine persönliche KI-Superintelligenz: ein Gehirn, das sich alles merkt, ein fantastischer Orchestrator, ein Deep Researcher. Local-first, schlicht, mächtig.</strong>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://discord.tinyhumans.ai/">Discord</a> •
|
|
<a href="https://www.reddit.com/r/tinyhumansai/">Reddit</a> •
|
|
<a href="https://x.com/intent/follow?screen_name=tinyhumansai">X/Twitter</a> •
|
|
<a href="https://tinyhumans.gitbook.io/openhuman/">Doku</a> •
|
|
<a href="https://x.com/intent/follow?screen_name=senamakel">@senamakel folgen (Creator)</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
🇺🇸 <a href="../README.md">English</a> | 🇨🇳 <a href="./README.zh-CN.md">简体中文</a> | 🇯🇵 <a href="./README.ja-JP.md">日本語</a> | 🇰🇷 <a href="./README.ko.md">한국어</a> | 🇩🇪 <a href="./README.de.md">Deutsch</a> | 🇵🇰 <a href="./README.ur-pk.md">اردو</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="https://img.shields.io/badge/status-early%20beta-orange" alt="Frühe Beta" />
|
|
<a href="https://github.com/tinyhumansai/openhuman/releases/latest"><img src="https://img.shields.io/github/v/release/tinyhumansai/openhuman?label=latest" alt="Aktuellste Version" /></a>
|
|
<a href="https://github.com/tinyhumansai/openhuman"><img src="https://img.shields.io/github/stars/tinyhumansai/openhuman?style=flat" alt="GitHub Stars" /></a>
|
|
<a href="../LICENSE"><img src="https://img.shields.io/github/license/tinyhumansai/openhuman" alt="Lizenz" /></a>
|
|
</p>
|
|
|
|
> **Frühe Beta**: Wird aktiv weiterentwickelt. Mit Ecken und Kanten ist zu rechnen.
|
|
|
|
> 🎉 Innerhalb einer Woche nach dem Launch wurde OpenHuman neun Tage in Folge das Nummer-eins-Trending-Repository auf GitHub.
|
|
|
|
# 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 (Homebrew, Debian/Ubuntu-`.deb`, AUR, Install-Skripte und Plattformhinweise) siehe **[INSTALL.md](../INSTALL.md)**.
|
|
|
|
# Was ist 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/).
|
|
|
|
### 🧠 Das Gehirn
|
|
|
|
- **[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. So hat es 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.
|
|
|
|
### 🕸️ Der Orchestrator
|
|
|
|
- **[Workflows](https://tinyhumans.gitbook.io/openhuman/features/workflows)**: 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)**: 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)**: 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.
|
|
|
|
### 🔬 Der Deep Researcher & Macher
|
|
|
|
- **[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. Dazu [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)**: 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)**: 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.
|
|
|
|
### 🧍 Menschlich, privat, deins
|
|
|
|
- **Schlicht, UI-zuerst & menschlich**: von der Installation zum laufenden Agenten in wenigen Klicks, ohne Config-Dateien und ohne 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. Dazu **[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.
|
|
|
|
## Kontext in Minuten, nicht in Wochen
|
|
|
|
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.
|
|
|
|
<p align="center">
|
|
<img src="../gitbooks/.gitbook/assets/memory.png" alt="Diagramm zum OpenHuman-Kontextaufbau">
|
|
</p>
|
|
|
|
> 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.
|
|
|
|
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
|
|
|
|
Die meisten Agent-Harnesses betreiben einen Agenten in einer Schleife. OpenHuman ist ein **[Orchestrator](https://tinyhumans.gitbook.io/openhuman/features/orchestration)**:
|
|
|
|
<p align="center">
|
|
<img src="../gitbooks/.gitbook/assets/orchestration.png" alt="OpenHuman-Orchestrierungsdiagramm">
|
|
</p>
|
|
|
|
> Agent-zu-Agent-Messaging läuft über Signal-Protokoll-Ende-zu-Ende-Verschlüsselung. Du kannst also alles anbinden (Claude Code, Codex, OpenClaw, Hermes) und mit OpenHuman all deine Agenten und Tools orchestrieren.
|
|
|
|
- **Graphen statt Schleifen**: Turns laufen als checkpointed 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; festgefahrene Agenten werden zu Root-Cause-Berichten.
|
|
- **Agent-zu-Agent, verschlüsselt**: Instanzen orchestrieren sich gegenseitig über Signal-Protokoll-E2E-Sitzungen mit x402-Zahlungen. Kein Server sieht jemals Klartext.
|
|
|
|
## Workflows, die du sehen kannst
|
|
|
|
Stark inspiriert von n8n und Zapier bringen [Workflows](https://tinyhumans.gitbook.io/openhuman/features/workflows) dieselbe visuelle, trigger-gesteuerte Automatisierung zu deinem Agenten, nur dass der Agent sie für dich baut. Bitte um eine Automatisierung, und er schlägt eine vor: einen [tinyflows](https://github.com/tinyhumansai/tinyflows)-Graphen, den du vor dem Speichern auf einer visuellen Canvas prüfst.
|
|
|
|
<p align="center">
|
|
<img src="../gitbooks/.gitbook/assets/workflows.png" alt="OpenHuman-Workflow-Canvas">
|
|
</p>
|
|
|
|
> Der Agent schlägt den Workflow vor; du prüfst ihn auf einer Canvas und speicherst ihn.
|
|
|
|
Gespeicherte Workflows sind dauerhaft und trigger-gesteuert: sie feuern auf Zeitpläne, Webhooks oder Kanal-Events, überleben Neustarts und sichern Seiteneffekte hinter Freigaben ab.
|
|
|
|
## 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 | 🚀 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 |
|
|
|
|
## Beitragen aus dem Quellcode
|
|
|
|
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.
|
|
3. Nutze `pnpm dev` für reine Web-UI-Arbeit, `pnpm --filter openhuman-app dev:app` für die Desktop-Shell sowie gezielte Checks wie `pnpm typecheck`, `pnpm format:check` und `cargo check -p openhuman --lib`, bevor du einen PR öffnest.
|
|
|
|
Tiefer einsteigen: [Architektur](https://tinyhumans.gitbook.io/openhuman/developing/architecture) · [Einrichtung](https://tinyhumans.gitbook.io/openhuman/developing/getting-set-up) · [Cloud-Deployment](../gitbooks/features/cloud-deploy.md).
|
|
|
|
# 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._
|
|
|
|
<p align="center">
|
|
<a href="https://www.star-history.com/#tinyhumansai/openhuman&type=date&legend=top-left">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&theme=dark&legend=top-left" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
|
|
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=tinyhumansai/openhuman&type=date&legend=top-left" />
|
|
</picture>
|
|
</a>
|
|
</p>
|
|
|
|
# Contributors Hall of Fame
|
|
|
|
Zeig etwas Liebe und lande in der Hall of Fame. Mitwirkende erhalten kostenloses Merch und besonderen Zugang zu unserem [Discord](https://discord.tinyhumans.ai/).
|
|
|
|
<a href="https://github.com/tinyhumansai/openhuman/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=tinyhumansai/openhuman" alt="OpenHuman contributors" />
|
|
</a>
|