2026 OpenHuman: Der vollständigste Installations- und Konfigurationsleitfaden — Schritt-für-Schritt-Begleittutorial von null bis zum Lauf

2. Nicht das falsche Projekt installieren: Desktop-Assistent vs. WebGL-SDK

OpenHuman (dieser Leitfaden) ist der Open-Source-Desktop-Personal-AI-Assistent tinyhumansai/openhuman: UI-first, Memory Tree, Obsidian-ähnlicher Markdown-Vault, 118+ OAuth-Integrationen, optionales lokales Ollama. Standardmäßig nutzt er dennoch OpenHuman-Gehostete Dienste für Konto-Login, Modell-Routing, Such-Proxy und Composio-Layer-OAuth (schrittweise Umstellung auf BYOK / direktes Composio in den Einstellungen möglich).

Es gibt außerdem ein OpenHuman WebGL Digital-Human-SDK im Web — für 3D-Avatare, nicht Gegenstand dieses Leitfadens. Wenn Ihr Ziel „persönliche Wissensbasis + E-Mail/Kalender/Repo-Kontext“ ist, nutzen Sie das Desktop-Repo und die Download-Seite tinyhumans.ai/openhuman.

Es ist auch kein generischer Web-Chat-Tab: OpenHuman setzt auf lokale Workflow-Daten + geplante Integrations-Abholungen, nicht auf ein einmaliges Browserfenster. Im Vergleich zu CLI-first-Agenten bietet OpenHuman grafische UI + kurzes Onboarding — Sie brauchen keine Konfigurationsdatei vor der ersten Nachricht.

3. Typische Stolpersteine

1. Einschränkung: „Installiert“ mit „versteht mich schon“ verwechseln. Laut offizieller Dokumentation liegen Memory Tree, Markdown-Vault, Workspace-Konfiguration und lokaler Laufzeitstatus auf Ihrem Rechner; Login, Modell-Routing, Such-Proxy und Standard-OAuth können dennoch gehostete Backends nutzen. Ohne verbundene Integrationen und abgeschlossenen Sync kann der Agent nur allgemein antworten.
2. Versteckte Kosten: zu weitreichende Berechtigungen und Produktionskonten am ersten Tag. Eine OAuth-Freigabe kann Mail-Lesen, Kalender, Repos und mehr abdecken. Solange die App noch Beta ist: mit Test-Postfach oder Test-GitHub-Repo starten, Scopes und Widerruf-Pfade bestätigen, dann echte Arbeitsdaten anbinden.
3. Stabilität & Audit: nicht wissen, wo Speicher und Logs liegen. Deinstallieren und neu installieren ohne Notizen kann die einzige SQLite- und Vault-Sync-Spur löschen. Workspace-Pfad, Integrations-IDs und Modus (gehostet / BYOK / Ollama) für Rollback dokumentieren.

4. Vorbereitungs-Checkliste vor der Installation

Ziel: Netzwerk- oder Festplattenprobleme mitten im Prozess kosten Stunden. Erfolgskriterium: alle Punkte unten vor dem Download abgehakt.

• Betriebssystem: macOS (Apple Silicon oder Intel), Windows 10/11 (64-Bit), Debian/Ubuntu oder Arch-Linux-Desktop. Mindestversionen laut aktueller Release Notes; Produkt als Early Beta gekennzeichnet — UI-Pfade können sich ändern.
• Hardware: 16 GB+ RAM empfohlen (lokales Ollama braucht mehr); ≥5 GB Festplatte reservieren (App + Vault + SQLite + Modell-Cache — tatsächlicher Bedarf variiert).
• Netzwerk: GitHub, tinyhumans.ai und OAuth-Redirect-Domains erreichbar; bei Firmen-Proxy System-Proxy konfigurieren oder Browser-Pop-ups erlauben.
• Konten: OpenHuman-Produktkonto; bei Bedarf BYOK-API-Keys von Modellanbietern; bei lokaler Inferenz Ollama installiert und Modell geladen.
• Testdaten: Dediziertes Test-Gmail / Test-GitHub-Repo — nicht am ersten Lauf Firmen-Slack oder Produktions-Postfach verbinden.
• Berechtigungen: macOS kann Benachrichtigungen, Mikrofon (Sprache) und Datei-/Ordnerzugriff abfragen; unter Linux bekannte AppImage- und Wayland-Probleme beachten (offizielles Issue #2463).

5. Download-Quellen & Sicherheitsprüfung

Offizielle Priorität (README): ① Offizielle Website / GitHub-Release-Installer → ② Native Paketmanager (Homebrew, signiertes apt, MSI) → ③ Skript-Installation (keine eigenständige Skript-Signatur — nur bei bewusstem Risiko).

Bei Fehler zuerst prüfen: beschädigte Datei → von Release neu laden; SmartScreen / Gatekeeper-Block → Herausgeber bestätigen, dann erlauben; unbekannte „Spiegel“-Seiten nicht für offizielle Pakete ersetzen.

6. Installation auf drei Plattformen

6.1 macOS (Homebrew empfohlen)

brew tap tinyhumansai/core
brew install openhuman

Alternativ .dmg vom Release laden und nach Programme ziehen. Erfolgskriterium: OpenHuman startet aus Launchpad. Bei Fehler zuerst prüfen: „Entwickler kann nicht verifiziert werden“ → Systemeinstellungen → Datenschutz & Sicherheit → Trotzdem öffnen; beim ersten Start Benachrichtigungen/Mikrofon/Dateizugriff erlauben (minimale Menge für genutzte Funktionen).

6.2 Windows (signiertes MSI)

.msi vom neuesten Release herunterladen und Installer ausführen. Bei SmartScreen Herausgeber bestätigen. Erfolgskriterium: Startmenü-Verknüpfung startet die App. Bei Fehler zuerst prüfen: Unternehmens-Richtlinien-Block, Antivirus-Quarantäne, Firewall blockiert OAuth-Browser-Callback.

6.3 Linux (apt empfohlen; AppImage mit Vorsicht)

sudo apt-get install -y --no-install-recommends gnupg2 curl ca-certificates
curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg
echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \
  https://tinyhumansai.github.io/openhuman/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/openhuman.list
sudo apt-get update
sudo apt-get install -y openhuman

Arch-Nutzer können das AUR-Rezept openhuman-bin des Repos versuchen (yay -S openhuman-bin — AUR-Eintrag prüfen). AppImage kann unter Wayland oder manchen Arch-Setups scheitern (offizielles Issue #2463); Debian/Ubuntu sollten .deb / apt bevorzugen. Erfolgskriterium: Desktop-Menü startet die App. Bei Fehler zuerst prüfen: fehlende Bibliotheken, Wayland-Umgebungsvariablen, Wechsel zur X11-Session.

6.4 Entscheidungsmatrix Plattform-Installation

Deinstallation & Neuinstallation: zuerst alle OAuth-Integrationen trennen und wichtige Vault-Verzeichnisse sichern; nach Deinstallation können Workspace und SQLite im Benutzerprofil verbleiben — offizielle Datenpfade vor dem Löschen der einzigen Speicherkopie prüfen.

7. Erster Start & Konto-Login

1. App starten und ein dediziertes Workspace-Verzeichnis wählen — nicht den gesamten Home-Ordner.
2. Mit OpenHuman-Produktkonto anmelden (Standard gehosteter Login-Flow). Erfolgskriterium: Einstellungen zeigen angemeldeten Status.
3. Update-Kanal und datenschutzbezogene Schalter prüfen (Benachrichtigungen, Sprache, Such-Proxy) — bis zum ersten erfolgreichen Lauf Standardwerte beibehalten, dann anpassen.

Bei Fehler zuerst prüfen: leere Login-Seite → Standardbrowser testen, Werbeblocker deaktivieren; wiederholtes Scheitern → Systemzeit, DNS, Proxy-Bedarf; regionale oder Abo-Richtlinien laut aktueller offizieller Docs — dieser Leitfaden verspricht nicht identische Features in jeder Region.

8. Modell-Konfiguration & BYOK

Gehostete Modelle (Standard): OpenHuman-Backend führt Modell-Routing durch (Auswahl von Reasoning/Schnell/Vision-Modellen je Aufgabe). Offizielle Formulierungen umfassen Multi-Modell-Routing im Abo; Preise und Kontingente auf der Kontoseite können sich ändern.

BYOK (Bring Your Own Key): Anbieter-API-Keys in den Einstellungen hinterlegen — Sie zahlen die Nutzung und verwalten Kontingente; sinnvoll bei bestehenden Enterprise-Verträgen oder feiner Kostenkontrolle.

Lokale Modelle (Ollama): Offizielle Docs unterstützen optionale lokale KI; Apple-Silicon-Mac mit Unified Memory hilft bei kleineren Modellen, große Modelle stoßen dennoch an RAM-Grenzen — Latenz und Qualität selbst prüfen.

Erfolgskriterium: Test-Prompt senden (z. B. „Stell dich in einem Satz vor“) und kohärente Antwort erhalten. Bei Fehler zuerst prüfen: gehostet → Abo/Netzwerk; BYOK → Key-Berechtigungen und Abrechnung; Ollama → Dienst lauscht und Modellname stimmt.

9. Integrationen & Berechtigungskonfiguration

OpenHuman bietet Gmail, Slack, Notion, GitHub, Calendar, Drive und 118+ Connectors über eine Composio-Connector-Schicht. Standard-OAuth-Handshake und Tool-Aufrufe laufen über das gehostete Backend; für direktes Composio eigenen Composio-API-Key in den Einstellungen hinterlegen und Real-Time-Trigger-Webhooks selbst hosten.

OAuth ist der Standard-Flow „im Browser anmelden und der App begrenzten Zugriff in Ihrem Namen gewähren“. Die Berechtigungs-Scopes auf dem Zustimmungsbildschirm lesen — nur das freigeben, was der Praxisfall braucht; unklare Scopes vorerst nicht bestätigen.

Erfolgskriterium: Integration zeigt Connected und OAuth-Callback ohne Fehler. Bei Fehler zuerst prüfen: blockierte Pop-ups, Firmen-SSO, Composio-Status, Netzwerk-Proxy.

10. Speichersystem abnehmen

Für Einsteiger funktioniert OpenHuman-Speicher so:

• Memory Tree: organisiert abgeholte Integrationsdaten in hierarchische Zusammenfassungen, lokal in SQLite für Agent-Abruf.
• Markdown-Vault (Obsidian-kompatibel): dieselbe Wissensbasis landet als .md-Dateien, die Sie in Obsidian durchsuchen und bearbeiten können.
• Auto-Fetch: jede aktive Verbindung holt neue Daten etwa alle 20 Minuten — kein manuelles Polling-Skript nötig.

Abnahme-Schritte: Test-Integration verbinden → mindestens einen 20-Minuten-Zyklus abwarten (oder manuellen Trigger, falls UI vorhanden) → Memory-Ansicht oder Vault auf neue Markdown-Blöcke prüfen → Frage stellen, die nur Testdaten beantworten können (z. B. eindeutiges Stichwort aus Test-Mail).

Erfolgskriterium: Antwort verweist auf korrekte Quellen oder Dateischnipsel. Bei Fehler zuerst prüfen: Integration inaktiv, Sync unvollständig, oder Frage zu Produktionsdaten obwohl nur Testquelle verbunden (Leer-Kontext-Halluzination).

11. Erster Praxisfall: Test-Postfach „Wochenzusammenfassung + To-do“

Ziel: Modell, Integration, Speicher, Output und Widerruf-Schleife in einem Durchlauf verifizieren.

1. Test-Gmail-Konto anlegen; sich selbst 2–3 Mails mit klaren Betreffzeilen senden (z. B. „Q2-Budget-Diskussion“, „Wochenbericht bis Freitag einreichen“).
2. In OpenHuman nur dieses Test-Postfach verbinden; OAuth abschließen.
3. Auf ersten Auto-Fetch warten (≥20 Minuten empfohlen); Vault / Memory auf neuen Inhalt prüfen.
4. Fragen: „Erstelle basierend auf den letzten Mails in meinem Test-Postfach eine Wochenzusammenfassung und To-do-Liste und gib an, aus welcher Mail jedes Element stammt.“
5. Prüfen: Zusammenfassung passt zu Test-Mails; keine erfundenen Themen; exportierten Output speichern, falls die App das unterstützt.
6. Autorisierung sowohl in OpenHuman als auch bei Google widerrufen; bestätigen, dass Disconnect die Referenz auf dieses Postfach stoppt.

Erfolgskriterium: Output passt zu Test-Mails, Quellen prüfbar, Zugriff nach Widerruf gestoppt. Bei Fehler zuerst prüfen: Modell-Schicht (④) und Speicher-Schicht (⑥) getrennt isolieren — Troubleshooting nicht vermischen.

12. Häufige Probleme (schichtweises Troubleshooting)

13. Abschluss-Checkliste: Erweitern, wenn der Kreislauf stabil ist

• Test-OAuth widerrufen, dann echtes Postfach/Repo Integration für Integration hinzufügen.
• Workspace, Vault und wichtige Einstellungs-Screenshots sichern; Modus und ungefähre Monatskosten notieren.
• Offizielle Privacy & Security-Seite lesen; Benachrichtigungs- und Sprach-Schalter prüfen.
• Deinstallationspfad behalten: wissen, wo Daten liegen, damit nicht die einzige Speicherbibliothek gelöscht wird.

Sieben-Schritte-Runbook im Überblick: Vorbereitung → offizielle Installation → Login → Modelltest → eine risikoarme Integration → auf Speicher warten → Praxisfall und Widerruf. Erst danach Slack, Notion und Langzeit-Workflows hinzufügen.