OpenHuman Installationsanleitung (2026): In 5 Minuten zum KI-Digitaltwin

Wenn Sie OpenHuman auf GitHub schon gesehen haben, aber noch nicht installiert: Dieser Artikel ist der kürzeste Weg zur produktiven Nutzung im Jahr 2026 — vom Download bis zum Moment, in dem der Agent sagt: „Sie haben heute Nachmittag ein Meeting.“ Schritt für Schritt, für erfahrene Nutzer in etwa 5 Minuten (inklusive OAuth-Dialog und erster Sync-Wartezeit). OpenHuman ist kein weiteres Chat-Fenster im Browser, sondern ein Desktop-Agent als persönlicher KI-Digitaltwin: lokaler Memory Tree, 118+ OAuth-Dienste, Hintergrund-Sync etwa alle 20 Minuten. Nach der Installation lohnt sich unser Tiefgang zu Architektur und Memory Tree sowie zu Agent Skills; hier geht es nur darum, wie Sie installieren, konfigurieren und Erfolg prüfen.

Der Reiz von OpenHuman liegt nicht in einer einzelnen Funktion, sondern in der Kombination: Daten bleiben auf Ihrem Rechner, der Agent kann aber trotzdem Gmail, Kalender und GitHub lesen — vorausgesetzt, Sie schließen die Ersteinrichtung sauber ab. Wer nur die App startet, ohne OAuth und Modell zu konfigurieren, sieht eine leere Oberfläche und wundert sich, warum „nichts passiert“. Diese Anleitung vermeidet genau dieses Szenario: Jeder Schritt endet mit einer klaren Erfolgskontrolle, damit Sie nicht raten müssen, ob die Installation geklappt hat.

Was vor der Installation vorbereiten

OpenHuman ist eine Tauri-Desktop-App (Rust-Kern + Web-UI) mit offizieller Unterstützung für macOS, Windows und Linux. Im Jahr 2026 ist die beste Erfahrung weiterhin auf dem Apple-Silicon-Mac — besonders wenn Sie Ollama oder MLX für lokale Inferenz auf demselben Gerät betreiben. Vor dem Start sollten folgende Punkte erfüllt sein:

• Systemberechtigungen — Unter macOS müssen Sie heruntergeladene Apps in „Datenschutz & Sicherheit“ erlauben (oder bei Installation außerhalb des App Store per Rechtsklick → Öffnen).
• Mindestens ein LLM-Zugang — Anthropic- oder OpenAI-API-Key, oder lokal laufendes Ollama (optional). Ohne Key startet die Oberfläche, aber der Agent kann nicht inferieren.
• 2–3 Konten zum Anbinden — Empfohlen für den ersten Durchlauf: Gmail + Google Calendar + GitHub (Entwickler) oder Notion + Slack (Wissensarbeit). Ohne Datenquellen bleibt der Memory Tree leer und die 5-Minuten-Abnahme scheitert.
• Speicher und Netzwerk — Der Memory Tree schreibt in lokale SQLite- und Markdown-Dateien; planen Sie einige hundert MB ein. OAuth und der erste Abruf brauchen stabiles Internet.

Vollständige Abhängigkeiten und Build aus Quellcode finden Sie im offiziellen Repository unter docs/; für den Alltagsgebrauch ist kein Git-Clone nötig. Führen Sie vorab eine Umgebungsprüfung im Terminal aus, damit Sie nicht mitten in der Installation feststellen, dass Homebrew oder die Architektur nicht passt:

# 1. System und Chip (Apple Silicon = arm64)
sw_vers
uname -m

# 2. Homebrew verfügbar? (für brew-Installation)
brew --version
brew doctor

# 3. Bei lokalem Ollama: Port 11434 frei?
lsof -i :11434 || echo "Port 11434 frei, Ollama kann starten"

# 4. Speicherplatz (Memory Tree + Modell-Cache, ≥5 GB empfohlen)
df -h ~

Wenn uname -m arm64 ausgibt, laden Sie das passende Apple-Silicon-Binary. Auf Intel-Macs prüfen Sie in den GitHub Releases explizit die x64-Variante — nicht jede Distribution liefert für beide Architekturen gleichzeitig aktuelle Builds.

Drei Installationswege: Offizielles Paket, Homebrew, Skript

Das offizielle README empfiehlt: Signierte native Installer oder System-Paketmanager bevorzugen. Skript-Installation eignet sich zum schnellen Ausprobieren, birgt aber höheres Supply-Chain-Risiko. Die folgende Tabelle ist nach Empfehlung sortiert.

# Im Browser das neueste Release öffnen (arm64 / x64 passend zum Chip)
open "https://github.com/tinyhumansai/openhuman/releases/latest"
# oder die Download-Seite
open "https://tinyhumans.ai/openhuman"

# Nach dem Download: DMG mounten und in Programme kopieren (Dateiname variiert)
hdiutil attach ~/Downloads/OpenHuman*.dmg
cp -R "/Volumes/OpenHuman/OpenHuman.app" /Applications/
hdiutil detach "/Volumes/OpenHuman"

# Bei „Entwickler kann nicht verifiziert werden“: Quarantäne entfernen
xattr -dr com.apple.quarantine /Applications/OpenHuman.app
open -a OpenHuman

# 1. Offiziellen tap hinzufügen (einmalig)
brew tap tinyhumansai/core

# 2. Installieren (lädt aktuelles stable Binary)
brew install openhuman

# 3. Prüfen ob im PATH
which openhuman
openhuman --version

# 4. Desktop starten (CLI oder Launchpad)
openhuman

# 5. Später upgraden
brew update
brew upgrade openhuman

# Alternative ohne core tap (in manchen Docs)
# brew install tinyhumansai/openhuman/openhuman

# Node-Version prüfen
node -v

# npm-Paket installieren (lädt natives Binary, SHA-256-Prüfung)
npm install -g openhuman

openhuman --version
openhuman

# 1. GPG importieren und apt-Quelle hinzufügen
sudo apt-get install -y 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

# 2. Installieren und starten
sudo apt-get update
sudo apt-get install -y openhuman
openhuman --version

# 1. Skript nur herunterladen, nicht ausführen
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  -o /tmp/openhuman-install.sh
less /tmp/openhuman-install.sh

# 2. dry-run zur Vorschau (falls vom Skript unterstützt)
bash /tmp/openhuman-install.sh --dry-run --verbose

# 3. Nach Prüfung installieren
bash /tmp/openhuman-install.sh

# macOS / Linux Einzeiler (entspricht Schritt 3)
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  | bash

# Windows PowerShell:
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

macOS Schritt-für-Schritt: Von der Installation zur Abnahme

Im Folgenden ein kopierbarer Mix aus Terminal und GUI: Standard ist Homebrew plus Anthropic-API; bei DMG-Installation ab Schritt 3 einsteigen. Nach jedem Schritt steht, wie Sie Erfolg erkennen.

brew tap tinyhumansai/core
brew install openhuman
openhuman --version
open -a OpenHuman

# App läuft? (OpenHuman-Prozess sollte sichtbar sein)
pgrep -lf -i openhuman || ps aux | grep -i openhuman | grep -v grep

# Ollama installieren und im Hintergrund starten
brew install ollama
brew services start ollama

# Kleines Modell zum Verbindungstest ziehen
ollama pull llama3.2

# API-Check: JSON mit models-Liste
curl -s http://127.0.0.1:11434/api/tags | head -c 400
echo

# GUI: Settings → Models / Providers
#   - Cloud: Anthropic API Key (sk-ant-...) oder OpenAI Key
#   - Lokal: Base URL http://127.0.0.1:11434, Modell z. B. llama3.2

# Key nicht in Shell-History; für CLI-Test temporär exportieren:
read -s ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
# (Eingabe ohne Echo; danach unset ANTHROPIC_API_KEY)

# Anthropic-Key unabhängig von OpenHuman testen
curl -s https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}' \
  | head -c 300
echo

# GUI: Connections / Integrations → Connect klicken
#   Empfohlene Reihenfolge: Gmail → Google Calendar → GitHub
# Nach OAuth im Browser: Connected / Active in der App

# Bei Proxy-Problemen HTTPS-Ausgang testen:
curl -sI https://github.com | head -5
curl -sI https://accounts.google.com | head -5

# OpenHuman 5–20 Min. laufen lassen; Sync-Status in der Menüleiste
# Pfad in Settings → Data / Memory nachschlagen
# Oft unter Application Support; grob suchen:
find ~/Library/Application\ Support -maxdepth 3 -iname '*openhuman*' 2>/dev/null

# Bekanntes Memory-Root $MEMORY_DIR — neueste Markdown-Dateien:
# MEMORY_DIR="…/memory"   # Pfad aus den Einstellungen
# ls -lt "$MEMORY_DIR" | head
# find "$MEMORY_DIR" -name '*.md' -mtime -1 | head

# Stichprobe: echte Betreffzeilen (Mail/Meeting/PR)?
# head -40 "$(find "$MEMORY_DIR" -name '*.md' | head -1)"

# Test 1 — Kalender (Google Calendar verbunden)
„Liste meine heutigen Meetings mit Titel und Startzeit, mit Quelle aus dem Memory Tree.“

# Test 2 — GitHub (GitHub verbunden)
„In welchem Repo hatte ich zuletzt gemergte PRs? Repo-Name und PR-Titel.“

# Bei generischen Antworten: Schritt 6 — .md-Dateien vorhanden?

5-Minuten-Checkliste für die Erstkonfiguration

Wer lieber abhakt statt lange Befehlsblöcke liest: Diese Liste entspricht eins zu eins dem vorherigen Abschnitt. Die Uhr startet, sobald die App geöffnet ist.

1. Minute 1: Modellanbieter — In Settings Anthropic- oder OpenAI-Key eintragen, oder Ollama Base URL http://127.0.0.1:11434; mit curl …/api/tags oder Anthropic-Probe Key validieren.
2. Minute 2–3: OAuth — Gmail, Calendar, GitHub verbinden; nach Browser-Auth Status Connected.
3. Minute 4: Erster Sync — App laufen lassen; mit find ~/Library/Application Support -iname '*openhuman*' Datenordner finden und heutige .md bestätigen.
4. Minute 5: Dialog-Test — Tests 1 und 2 aus dem vorherigen Block; konkrete Fakten = Erfolg.

In der Praxis dauert OAuth oft länger als eine Minute — rechnerisch sind es trotzdem fünf Minuten aktive Arbeit plus Wartezeit im Hintergrund. Planen Sie für den ersten Tag lieber eine halbe Stunde ein, damit der Memory Tree sinnvoll gefüllt wird.

Dienste verbinden und Memory Tree validieren

Das Gefühl eines „Digitaltwins“ kommt vom Memory Tree: Drittanbieterdaten werden in Markdown-Blöcke ≤3k Token normalisiert, in lokaler SQLite gespeichert und als .md exportiert — lesbar auch in Obsidian. Prüfen Sie nicht nur grüne Status-LEDs, sondern ob Dateien physisch ankommen:

• In der App Memory Tree / Speicherordner öffnen: neue Dateien mit heutigem Zeitstempel.
• Eine .md im Editor öffnen: E-Mail-Betreff, Meeting-Titel, PR-Namen — prüfbare Fakten, keine leeren Vorlagen.
• Optional: Backend mit agentmemory teilen, damit OpenHuman und Claude Code persistenten Kontext nutzen (Fortgeschritten).

# Anzahl Markdown-Dateien von heute
find "$MEMORY_DIR" -name '*.md' -mtime -1 2>/dev/null | wc -l

# Neueste 3 Fragmente nach Änderungszeit
find "$MEMORY_DIR" -name '*.md' -print0 2>/dev/null \
  | xargs -0 ls -lt 2>/dev/null | head -3

# SQLite-Datei in der Nähe (Name je nach Version)
find "$MEMORY_DIR/.." -maxdepth 2 -name '*.sqlite' -o -name '*.db' 2>/dev/null
# DB="/path/to/openhuman.db"
# sqlite3 "$DB" ".tables"

Der Unterschied zu ChatGPT: Dort lebt Kontext in der Konversation; bei OpenHuman liegt er in auditierbaren Dateien auf Ihrer Festplatte — ein Grund für den Hype auf GitHub. Produkt-Hintergrund in unserem Fünf-Tage-Erfahrungsbericht.

Mac-Fortgeschritten: lokal vs. Cloud-Mac im Dauerbetrieb

OpenHuman ist für Dauerbetrieb am Desktop gedacht: Zuklappen und Ruhezustand bremsen den Sync. Wenn der Digitaltwin auch abends E-Mail-Zusammenfassungen ziehen soll, während der Laptop aus ist, eignet sich ein immer erreichbarer Mac mini — etwa ein ZavCloud Cloud-Mac mit dediziertem Knoten: echtes macOS, statische IP, stabile OAuth-Callbacks. OAuth-Tokens und Memory-Tree-Dateien sind sensibel: Verschlüsselung, Zugriffskontrolle und Backup separat planen; persönliches Gmail nicht unbedacht in geteilte Multi-Tenant-Umgebungen legen.

Auf lokalem Apple Silicon können Ollama / MLX Offline-Inferenz liefern — passend zur local-first-Story: Modelle und Memories lokal, nur Integrations-Sync über das Internet. Für iOS-Entwicklung bleiben Cursor / Claude Code die Coding-Tools; vor dem Sprint fragt OpenHuman „Wie voll ist der Kalender heute?“ — ähnliche Misch-Workflows beschreiben wir in Anthropic und Claude Code.

# Nach Login auf dem macOS-Cloud-Host
brew tap tinyhumansai/core && brew install openhuman
openhuman --version

# Ohne GUI: manche Versionen nur Sync-Engine — offizielle Docs prüfen
# Empfehlung: Erst-OAuth per VNC/Bildschirmfreigabe, Session eingeloggt halten

# Ruhezustand vermeiden (je nach Rechenzentrum-Richtlinie)
sudo pmset -c sleep 0 displaysleep 0

Fehlerbehebung

• App startet nicht (macOS) — Systemeinstellungen → Datenschutz & Sicherheit → trotzdem öffnen; oder Rechtsklick → Öffnen. MDM kann unsignierte Pakete blockieren — dann signiertes DMG aus Releases.
• OAuth-Callback schlägt fehl — Proxy/VPN, Systemzeit, Popup-Blocker prüfen; Firmennetze blockieren manchmal Composio-Domains — IT-Whitelist nötig.
• Memory Tree bleibt leer — Integrationen auf Connected; einen vollen Sync-Zyklus (~20 Min.) abwarten; Issues auf regionale API-Limits prüfen.
• Agent halluziniert — Memories nicht geschrieben oder Modell nutzt Memory-Tools nicht; enger testen, ggf. @ auf Memory-Datei (falls Version unterstützt).
• brew install findet Paket nicht — Zuerst brew tap tinyhumansai/core; auf Intel-Mac Architektur in Releases prüfen.

# Homebrew-Fehler: Cache leeren und neu installieren
brew update
brew cleanup
brew reinstall openhuman

# Crash-Log nach Absturz
log show --predicate 'process == "OpenHuman"' --last 1h | tail -50

# Ollama läuft, OpenHuman verbindet nicht
curl -s http://127.0.0.1:11434/api/tags
lsof -i :11434

# Komplett deinstallieren und neu (brew)
brew uninstall openhuman
rm -rf ~/Library/Application\ Support/*openhuman* 2>/dev/null
brew install openhuman

# Neueste Issues (gh CLI)
gh issue list -R tinyhumansai/openhuman -L 5

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive
pnpm install
# Nur Web-UI
pnpm dev
# Vollständige Tauri-Desktop-Entwicklung
pnpm dev:app
# Rust-Seite prüfen
cargo check -p openhuman --lib

FAQ

Muss ich online sein? Installation, OAuth und Cloud-Modelle brauchen Netz; Memory-Dateien liegen lokal. Mit lokalem Ollama geht Schwachnetz-Dialog, Mail/Kalender-Sync weiterhin online.

Ist es kostenlos? Client ist Open Source (GPL-3.0); Modell-APIs und manche Connector können Drittkosten verursachen — laut Anbieter-Rechnung.

Konflikt mit Cursor Rules / Claude Code? Nein. OpenHuman editiert kein Repo; Coding-Agenten lesen kein Gmail. Getrennte Schichten.

• Produkt — Was ist der OpenHuman-Digitaltwin
• Skills — Agent Skills und GitHub-Trend
• Vergleich — OpenHuman vs. OpenClaw