macOS Homebrew · Memory Tree · 118+ OAuth · Fehlermatrix · VNC-Remote-Mac-Checkliste
OpenHuman von tinyhumansai ist ein Open-Source-Desktop-Personal-KI-Agent — kein weiteres Chat-Fenster, sondern eine lokale Intelligenzschicht, die Speicher, Tools, Integrationen und Sprache verbindet. Die stabile Version v0.56.0 (2026-05-27) hat über 30.000 GitHub-Stars. Dieser Leitfaden deckt den empfohlenen macOS-Homebrew-Pfad, Erststart-LLM-Setup, Memory Tree, 118+ OAuth-Connectors, eine 10-Zeilen-Fehlermatrix und eine 20-Minuten-VNC-Abnahme-Checkliste ab. Er ergänzt unseren OpenClaw- & OpenHuman-Deployment-Leitfaden und das Hermes-Agent-Installations-Tutorial.
OpenHuman vermarktet sich als „Personal AI super intelligence“ — privat, einfach und erweiterbar. Anders als OpenClaw oder Hermes Agent (beide terminal-first, BYO-Modell) ist OpenHuman GUI-first: Ein Desktop-Maskottchen reagiert auf Kontext und arbeitet im Hintergrund weiter, auch wenn Sie aufhören zu tippen.
Der Stack ist Rust + Tauri + React, lizenziert unter GNU GPL-3.0. Das Projekt befindet sich noch in Early Beta — Release Notes vor Upgrades lesen. In deutschen Teams sehen wir OpenHuman oft als Ergänzung zu OpenClaw: OpenClaw für IM-Playbooks und Gateway-Automatisierung, OpenHuman für persönliche Wissensarbeit mit GUI und Memory Tree. Die folgende Tabelle fasst die wichtigsten Unterschiede zusammen:
| Dimension | OpenHuman | OpenClaw | Hermes Agent | Claude Cowork |
|---|---|---|---|---|
| Open Source | GPL-3.0 | MIT | MIT | Proprietär |
| Onboarding | Desktop-GUI, Minuten | Terminal-first | Terminal-first | Desktop + CLI |
| Speicher | Memory Tree + Obsidian | Plugin-abhängig | Dreischicht-Self-Learning | Sitzungsbezogen |
| Integrationen | 118+ OAuth | BYO | BYO | Wenige Connectors |
| Auto-Sync | ca. alle 20 Min. in Memory | Keiner | Keiner | Keiner |
| Modell-Routing | Integriert + TokenJuice | Manuell | Manuell | Einzelmodell |
Wer möchte, dass KI den täglichen Workflow wirklich sieht, ohne in der Shell zu leben, profitiert von OpenHumans Connectors und Memory Tree. Weil die App vom grafischen Desktop abhängt, scheitern reine SSH-Sitzungen bei Erstberechtigungen und OAuth — genau hier hilft VNC auf einem gemieteten Mac.
Unter DSGVO-Gesichtspunkten ist der lokale Speicher unter ~/.openhuman/memory/ interessant: Connector-Daten werden vektorisiert und lokal gehalten, nicht zwingend in einer fremden Cloud. Dennoch fließen API-Aufrufe an den gewählten LLM-Anbieter — das muss in der Datenschutz-Folgenabschätzung dokumentiert werden.
Für Binär-Installationen reicht macOS 12 Monterey oder neuer (14+ empfohlen). Für Source-Builds ist die Latte deutlich höher:
| Abhängigkeit | Binär-Nutzer | Entwickler-Build |
|---|---|---|
| macOS | 12+ (14+ empfohlen) | Gleich |
| Node.js | Nicht erforderlich | 24+ |
| pnpm | Nicht erforderlich | 10.10.0 |
| Rust | Nicht erforderlich | 1.93.0 via rustup |
| CMake / Xcode CLT | Homebrew kann auslösen | Erforderlich |
| GPU / CUDA | Nicht erforderlich | Nicht erforderlich |
Inferenz läuft über Ihren LLM-Anbieter (API oder lokales Ollama); die App nutzt WebKit via Tauri, kein lokales GPU-Training. 8 GB RAM reichen für leichte Nutzung; mit aktiviertem Memory Tree empfiehlt sich 16 GB+, um Swap-Druck zu reduzieren. Festplatte: ca. 150–200 MB für die App; Memory Tree kann auf 2–5 GB anwachsen; Ollama-Modelle kommen pro Modell dazu.
Auf Apple Silicon (M1–M4) ist die UI flüssig; Intel-Macs funktionieren, aber der erste Source-Build dauert länger. Für Teams, die OpenHuman neben Ollama auf einem Mac Mini M4 betreiben wollen, gilt: Memory Tree + kleines lokales Modell (7B) passt auf 16 GB, größere Modelle erfordern 24 GB oder reine Cloud-APIs.
Offizielle Optionen: Homebrew-Tap (signierte Paketkette), .dmg von der Website, curl-Skript (nicht empfohlen) oder Source-Compile. Folgen Sie diesen sieben Schritten für Homebrew:
Homebrew installieren, falls fehlend: brew --version. Der Homebrew-Installer kann Xcode Command Line Tools auslösen — im GUI auf Installieren klicken. SSH kann diesen Dialog nicht beantworten.
Tap hinzufügen und installieren:
brew tap tinyhumansai/core brew install openhuman
OpenHuman.app landet in ~/Applications. Der erste Tap zieht Formula-Definitionen von GitHub; brew install lädt das Prebuilt-Binary und prüft die Checksumme.
Erststart & Berechtigungen: Über Spotlight öffnen. Barrierefreiheit und Benachrichtigungen unter Datenschutz & Sicherheit gewähren — nur in einer grafischen Sitzung möglich.
Onboarding / LLM: Claude, OpenAI, Gemini, Grok oder Ollama wählen; API-Keys oder TokenJuice eintragen. Langkontext-Modelle nutzen Memory Tree besser.
OAuth-Integrationen: Einstellungen → Integrations. Jeder Connector öffnet einen Browser-OAuth-Flow — Standardbrowser am Desktop erforderlich.
Memory Tree aktivieren: Einstellungen → Memory → Enable. Erstsync dauert 10–25 Minuten; nicht force-quitten.
Smoke-Test: Etwas fragen, das nur Ihre Connectors wissen, z. B. „Worüber habe ich gestern per E-Mail geschrieben?“ bei verknüpftem Gmail.
Nach erfolgreicher Installation empfiehlt sich brew upgrade openhuman für Updates — während Early Beta sollten Sie Release Notes auf GitHub mitlesen, bevor Sie in Produktion upgraden.
arm64 (Apple Silicon) oder x86_64 von tinyhumans.ai/openhuman oder GitHub Releases laden. Blockiert Gatekeeper die App: Datenschutz & Sicherheit → Trotzdem öffnen.
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
Offizielle Doku warnt: keine unabhängige Skript-Signatur. In Datei speichern, prüfen, dann ausführen.
git clone https://github.com/tinyhumansai/openhuman.git cd openhuman git submodule update --init --recursive pnpm install pnpm --filter openhuman-app dev:app
Erster nativer Build auf M4 Pro dauert oft 3–5 Minuten; auf älteren Intel-Macs langsamer. Für Contributor, die Patches testen wollen, ist Source der einzige Weg — Endnutzer sollten beim Homebrew-Pfad bleiben.
Memory Tree ist OpenHumans Alleinstellungsmerkmal: ein quellenübergreifender persönlicher Wissensgraph, der E-Mail-Zusammenfassungen, PRs, Docs und Kalenderereignisse aufnimmt und etwa alle 20 Minuten aktualisiert.
Unter Einstellungen → Memory können Sie Sync-Intervall (Minimum 5 Minuten) und Scope (z. B. Gmail nur letzte 90 Tage) feinjustieren. Für einen Obsidian Vault den Vault-Root unter Local Sources hinzufügen — Markdown-Änderungen werden read-only indexiert, außer Obsidian Write ist aktiviert.
Sensible Daten über Connector-Filter oder Verzeichnisse wie .private/ ausschließen. Die lokale DB liegt unter ~/.openhuman/memory/ — vor Maschinenwechsel sichern. In gemieteten Mac-Umgebungen: vor Rückgabe des Nodes exportieren oder löschen, je nach Vertrag.
Praxis-Tipp aus Support-Tickets: Der Erstsync bricht oft ab, wenn der Mac in den Schlaf geht. Auf einem Remote-Mac caffeinate -dims während des Syncs oder Energiesparen deaktivieren, bis der grüne Haken erscheint.
| # | Symptom | Wahrscheinliche Ursache | Fix |
|---|---|---|---|
| 1 | brew tap 404 | Veralteter Tap / Netzwerk | brew update; .dmg nutzen |
| 2 | WebKit-Prozess beendet | Altes macOS / Cache korrupt | macOS 12+; ~/Library/WebKit/tinyhumansai leeren |
| 3 | Barrierefreiheit-Dialog blinkt | TCC nicht registriert | OpenHuman manuell unter Datenschutz hinzufügen |
| 4 | OAuth-Callback scheitert | Port 58080–58090 belegt / falscher Browser | Ports freigeben; Safari/Chrome als Standard |
| 5 | Memory Tree bei 0 % hängen | Token abgelaufen / Netzwerk | Connector neu autorisieren |
| 6 | Leere LLM-Antwort | Falscher API-Key / Kontingent | Einstellungen → LLM → Test Connection |
| 7 | Auto-Update scheitert | Non-Homebrew-Rechte | brew upgrade openhuman |
| 8 | Maskottchen fehlt | Display-Skalierung / Barrierefreiheit | Standard-Skalierung; Berechtigung neu |
| 9 | Obsidian-Watch idle | Pfad mit Leerzeichen / Full Disk Access | Pfad quoten; Full Disk Access gewähren |
| 10 | Kein Mikro / Voice | Mikrofon-Berechtigung | Datenschutz → Mikrofon → OpenHuman |
Logs: ~/Library/Logs/tinyhumansai/. GitHub Issues nach Regressionen für Ihre exakte Version durchsuchen. Bei VNC-Sessions: prüfen, ob der Remote-Desktop wirklich im Vordergrund ist — manche TCC-Dialoge erscheinen nur auf dem physischen Display des gemieteten Macs, nicht im VNC-Fenster, wenn Screen Sharing falsch konfiguriert ist.
Diese Schritte erfordern eine grafische Sitzung und scheitern unter SSH-only:
Per VNC verbinden (1440×900+). Desktop sichtbar bestätigen.
brew tap tinyhumansai/core && brew install openhuman ausführen; CLT-Dialog bestätigen falls nötig.
OpenHuman aus ~/Applications starten; alle Datenschutz-Dialoge bestätigen.
LLM-Setup und mindestens eine OAuth-Integration im Remote-Browser abschließen.
Auf Memory-Tree-Erstsync warten (grüner Haken); connector-spezifische Frage stellen zur Recall-Verifikation.
Nach Abnahme kann OpenHuman auf dem Remote-Mac 24/7 online bleiben, während Sie von Windows oder Linux nur bei Bedarf per VNC einsteigen. Das passt zu Teams ohne eigenes Apple-Hardware-Budget, die dennoch DSGVO-konforme EU-Rechenzentren und persistente Desktop-Sessions brauchen.
Ja. UI nutzt WebKit; Inferenz läuft über API oder Ollama. Apple-Silicon-ANE kann lokales Ollama unterstützen, ist aber optional.
Erstvektorisierung autorisierter Connector-Historie in einen lokalen Graphen — typisch 10–25 Minuten. Netzwerk stabil halten und nicht force-quitten.
Homebrew: brew upgrade openhuman. .dmg-Installationen: In-App-Update oder neuestes Release laden. Während Early Beta Release Notes beachten.
OpenHuman senkt die Hürde für eine persönliche KI-Schicht mit GUI-Onboarding, Memory Tree und tiefen Integrationen — dieser Wert hängt aber an persistentem Desktop-Zugang für Berechtigungen und OAuth. Wenn Ihr Alltagsrechner Windows oder Linux ist, oder Sie einen headless Mac 24/7 online wollen, bringt Hardwarekauf Abschreibung und Stromrisiko; ein VNC-fähiger gemieteter Mac erlaubt einmaliges GUI-Setup und dauerhaften Agentenbetrieb ohne lokale Hardware-Ops.
VNCMac-Remote-Mac-Nodes enthalten einen grafischen Desktop genau für diesen Abnahmepfad — nutzen Sie die Schaltfläche unten, wählen Sie einen Plan und folgen Sie unserem Verbindungsleitfaden, um per VNC einzusteigen und die Checkliste aus Abschnitt 07 durchzuführen.