Wer 2026 nach einem OpenHuman Installations-Tutorial sucht, stößt weiterhin auf veraltete git clone + pip install -r requirements.txt-Anleitungen. Diese beschreiben generische Digital-Human-Repositories, nicht den tinyhumans-Desktop-Agenten mit signierten Installern. Dieser Leitfaden richtet sich an Einsteiger und Entwickler, die OpenHuman von der Installation über Login und Gmail- oder Slack-Anbindung bis zum ersten Ingest-Zyklus von etwa zwanzig Minuten, einem nutzbaren Memory Tree und optionaler Ollama-Lokalinferenz auf macOS, Windows oder Linux durchlaufen wollen. Wir beginnen mit sechs typischen Fehlurteilen, liefern Umgebungstabellen, signierte Installationspfade, ein Acht-Schritte-Runbook und eine Fehler-Matrix. Für die Kombination mit OpenClaw auf dedizierter Hardware verweisen wir auf den Schwesterartikel OpenClaw und OpenHuman auf gemietetem Mac. Monatspreise stehen auf der NOVAKVM-Mietpreisseite, Bestellung auf der Bestellseite. Befehle und Versionen folgen der offiziellen tinyhumans-Dokumentation und GitHub Releases; Links nach jedem Release erneut öffnen. Der Fokus liegt auf dem offiziellen Desktop-Produkt — nicht auf inoffiziellen Python-Forks aus Forenbeiträgen.
[ SECTION_01 ] // PAIN_MAP Sechs Irrtümer bei der OpenHuman-Installation (2026)
- „Zuerst git clone und pip install“: Der Hauptpfad ist ein Desktop-Installer oder Systempaketmanager (Homebrew, signiertes APT, signiertes MSI), kein manuell zusammengebautes Python-Environment aus einem Fork.
- „Ohne NVIDIA-GPU läuft nichts“: OpenHuman nutzt standardmäßig eine gehostete Modell-Route; sensible Schritte können optional über Ollama auf CPU oder Apple Silicon laufen. CUDA-Trainingsrigs sind nicht Voraussetzung.
- „Briefing muss direkt nach Install voll sein“: Getting Started nennt explizit: Nach Anbindung einer Datenquelle startet der erste automatische Abruf in etwa zwanzig Minuten. Wer vorher die Speicherqualität bewertet, hält oft einen Defekt für gegeben.
- „Alles liegt in der Cloud“: Memory Tree, Markdown-Vault und Workspace-Konfiguration bleiben lokal auf der Festplatte. Login, Teile von OAuth und Modell-Routing können dennoch gehostete Dienste nutzen — Grenzen kennen, besonders im Hinblick auf DSGVO und Auftragsverarbeitung.
- „curl | bash ist wie Homebrew“: Das README weist darauf hin, dass Skripte von
raw.githubusercontent.comkommen und keine separate Signaturprüfung haben. Produktionsumgebungen sollten signierte Native-Pakete bevorzugen. - „Schlafender Laptop reicht für Produktions-Ingest“: Große Postfächer und Code-Repos beanspruchen RAM und SSD; Deckel-zu unterbricht Hintergrund-Sync. „App startet“ und „Ingest läuft 7×24“ sind verschiedene Kriterien.
Offizielle OpenHuman-Einstiegspunkte — nach jedem Release erneut prüfen:
OpenHuman Download-Seite (tinyhumans.ai)
OpenHuman Getting Started (GitBook)
tinyhumansai/openhuman (GitHub-Repository und Releases)
[ SECTION_02 ] // ENV_MATRIX OpenHuman-Anforderungen: Mindestspecs und Hosting-Wahl
Die Tabelle fasst praxisnahe Untergrenzen für den Desktop-Client zusammen. Bei Ollama auf derselben Maschine oder großem Gmail-Archiv gegen die Empfehlungsspalte planen. Wer personenbezogene E-Mails oder Kundendaten indexiert, sollte zusätzlich prüfen, ob gehostete Modell-Routen in die eigene DSGVO-Dokumentation passen — lokale Vault-Daten bleiben zwar auf der Platte, OAuth und Inference können dennoch Drittanbieter berühren. Preise und Verfügbarkeit auf der Mietpreisseite prüfen.
| Punkt | Minimum | Empfohlen (großes Postfach + optionales lokales Modell) |
|---|---|---|
| Betriebssystem | macOS / Windows / Linux laut offizieller Download-Seite | macOS 14+ auf Apple Silicon oder Ubuntu 24.04 LTS Desktop |
| Arbeitsspeicher | Offizielle Docs: 4 GB+ | 16 GB+; sehr großes Gmail oder Repo plus Ollama ggf. 24–32 GB |
| Festplatte | Einige GB frei | Schnelle SSD; Vault plus SQLite-Ingest wächst mit Postfachgröße |
| GPU | Nicht erforderlich (gehostete Route) | Apple Silicon Unified Memory für lokale Inferenz; CPU-Ollama möglich |
| Netzwerk | Erreichbarer Login und Integrations-OAuth | Stabile Verbindung; erster Ingest und ~20-Minuten-Zyklen brauchen Dauerbetrieb |
| Träger | Installationsaufwand | Hintergrund-Ingest | Typisches Problem |
|---|---|---|---|
| Privater MacBook | Niedrig (Homebrew / DMG) | Stoppt beim Zuklappen; für Tests ok | Private Mail und Agent-Gedächtnis auf einer Platte — DSGVO-Trennung schwierig |
| Headless-Linux-VPS | Hoch (kein offizieller Hauptpfad) | Keine native GUI oder Desktop-Integration | Bildschirmkontext und Sprache eingeschränkt |
| NOVAKVM Mac mini M4 monatlich | Niedrig (macOS-Hauptpfad) | Exklusives Bare Metal 7×24 online | Vault-Backup und Löschung vor Rückgabe planen |
Nur UI und ein Prompt testen? Laptop reicht. Soll Memory Tree-Ingest wochenlang laufen, gehört die App auf einen Produktions-Mac ohne Schlafmodus — idealerweise getrennt vom privaten Gerät, wenn personenbezogene Daten im Spiel sind.
[ SECTION_03 ] // INSTALL OpenHuman installieren: signierte Pakete zuerst, Skripte als Fallback
macOS (Homebrew empfohlen — Systempaket-Signaturkette):
brew tap tinyhumansai/core
brew install openhuman
Linux (Debian/Ubuntu signiertes APT-Repo — Architektur laut offiziellem Repo): GPG-Schlüssel importieren, sources.list.d-Eintrag setzen, dann apt-get install openhuman. Vollständige Befehlsfolge im GitHub-README unter „Linux (Debian/Ubuntu — signed apt repo)“; URLs nach Releases prüfen.
Windows: Signiertes .msi von GitHub Releases oder der Download-Seite installieren.
Universelle Installer: Releases liefern auch .dmg, .deb und .AppImage. Skripte für macOS/Linux und Windows existieren, sind aber laut README Live-Skripte ohne separate Integritäts-Signatur — höheres Risiko als Native-Pakete.
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
Nach der Installation die Desktop-App einmal starten und das OpenHuman-Icon in Dock oder Startmenü bestätigen. Login und Datenquellen-Anbindung in dieser Phase nicht überspringen.
[ SECTION_04 ] // RUNBOOK Acht Schritte zum laufenden OpenHuman: Login, Quellen, erster Prompt, lokale KI
- Herunterladen und installieren: Homebrew, APT oder MSI bevorzugen; App starten und Build mit Releases-Seite abgleichen.
- Anmelden: Erster Bildschirm ist Sign in; die meisten nutzen Social Login. Advanced-Panel akzeptiert custom core RPC URL für Self-Hosting — ignorieren, wenn nicht zutreffend.
- Lokal vs. gehostet verstehen: Memory Tree, Vault und Workspace bleiben lokal; Standard-Sign-in, Modell-Routing, OAuth und Such-Proxy nutzen gehostete Dienste, sofern Custom setup nicht angewendet wird. Für DSGVO-konforme Verarbeitung lokaler Inhalte ist diese Trennung entscheidend.
- Mindestens eine Datenquelle verbinden: Einstellungs-Assistent für Gmail, Slack o. ä. per OAuth. Bei Fehlern Systemzeit und Browser-Callback prüfen.
- Ersten Ingest-Zyklus abwarten: Offizielle Docs: erster automatischer Abruf etwa zwanzig Minuten nach Verbindung. UI funktioniert sofort; Briefing-Antworten können noch leer wirken.
- Smoke-Test-Prompt senden: Nach Ingest z. B. „Fasse Themen meiner Mails der letzten Woche zusammen“ — prüft, ob Memory Tree Kontext hat.
- Optional: Ollama lokale KI aktivieren: Lokalen Runtime-Schalter in den Einstellungen nutzen, falls verfügbar. Co-located Modelle brauchen 16 GB+ RAM; SSD-Belegung beobachten.
- Vault-Verzeichnis sichern: Vor Migration oder Mietende SQLite Memory Tree und Obsidian-kompatible
.md-Vault kopieren — Neuinstallation allein stellt kein Gedächtnis wieder her.
Memory Tree normalisiert angebundene Daten in Markdown-Blöcke von etwa 3k Token, speichert Schichtsummaries in lokaler SQLite und spiegelt einen editierbaren Vault. Das unterscheidet sich von reinen Cloud-Chat-Produkten ohne Persistenz. Wer Ingest über Wochen laufen lässt, sollte Festplattenwachstum und Backup-Rhythmus dokumentieren — besonders relevant, wenn der Agent geschäftliche Kommunikation indiziert und Aufbewahrungsfristen gelten. Für dauerhaften Ingest auf einem Remote-Mac: SSH- und Sitzungs-Baseline im Hilfezentrum.
[ SECTION_05 ] // TROUBLESHOOT OpenHuman-Installation und Erststart: Fehler beheben
| Symptom | Wahrscheinliche Ursache | Maßnahme |
|---|---|---|
| Pip-Tutorial befolgt, kein App-Icon | Falsches Nicht-tinyhumans-Template | Auf tinyhumans-Desktop-Pfad und Releases wechseln |
| Eingeloggt, aber kein Mail-Kontext | Erster Ingest-Zyklus nicht abgeschlossen | ~20 Minuten warten, Prompt erneut testen |
| Speicher wächst schnell | Großes Postfach plus doppelte Vault-Schreibung | Alte Verbindungen löschen, größere SSD oder 512 GB+ Miet-Tier |
| Ruckeln nach Ollama-Aktivierung | Modellgröße vs. verfügbarer RAM | Kleineres quantisiertes Modell oder 24–32 GB RAM |
| brew install openhuman schlägt fehl | Fehlender Tap oder nicht unterstützte Architektur | brew tap und Apple Silicon vs. Intel im README prüfen |
Erweitert: Briefing-Smoke-Test. Nach abgeschlossenem Ingest OpenHuman bitten, aus einem Mail-Thread ein 30-Sekunden-Sprechskript zu entwerfen. Markdown-Blöcke direkt im Vault bearbeiten. Prüfen Sie dabei auch, ob sensible Inhalte im Vault liegen, die vor Export oder Screenshots geschwärzt werden müssen — ein praktischer DSGVO-Check neben der technischen Funktion. Echtzeit-Meet-Teilnahme und Maskottchen-Lipsync hängen vom aktuellen Release ab — Marketing-Clips nicht blind übernehmen.
[ SECTION_06 ] // HARD_FACTS Verifizierbare Fakten und NOVAKVM-Abschluss
- Lizenz und Repository: OpenHuman steht unter GNU GPL-3.0 auf GitHub als
tinyhumansai/openhuman. (Quelle: LICENSE; nach Releases prüfen.) - Systemanforderungen: Getting Started nennt macOS, Windows und Linux Desktop mit 4 GB+ RAM; große Postfächer, Repos oder lokale Modelle empfehlen 16 GB+.
- Speicherarchitektur: Memory Tree+ normalisiert Daten in ≤3k-Token-Markdown-Blöcke, SQLite-Schichtsummaries und Obsidian-kompatiblen Vault. (Quelle: README-Feature-Abschnitt.)
- Integrations-Timing: Nach Gmail-Anbindung startet der erste automatische Abruf in etwa zwanzig Minuten; weiterer Hintergrundrhythmus laut GitBook.
- Versionswahrheit: GitHub Releases und In-App-About als maßgeblich; uncitierte Star-Zahlen oder Benchmark-Rankings ignorieren.
„Installiert“ ist kein Endzustand. Ein privater Laptop eignet sich für Wochenendtests, aber Schlafmodus, OS-Updates und private Mail auf derselben Platte unterbrechen Memory Tree-Ingest ständig — ein DSGVO-relevantes Risiko, wenn Arbeits- und Privatpostfächer vermischt werden. Ein headless Linux-VPS liefert selten die Desktop-Integrationen, die OpenHuman betont. Hat sich lokal bewährt, ist ein produktiver Zwischenschritt: zwei bis vier Wochen dedizierten Mac mini M4 mieten, Vault-Wachstum und Ingest-Stabilität beobachten, dann Kaufentscheidung treffen.
Speicher- und Festplatten-Tier auf der NOVAKVM-Mietpreisseite wählen, Knoten über Bestellseite bereitstellen, Acht-Schritte-Runbook durchlaufen. Für OpenHuman-Produktion mit nativem macOS-Installationspfad, großem Postfach-Ingest 7×24 und planbarer Löschung vor Rückgabe ist NOVAKVM Mac-mini-Bare-Metal-Miete meist günstiger als ein Dauer-Laptop im Wachmodus — und erleichtert die Trennung sensibler Daten vom privaten Gerät.