Hermes auf iPhone und Android

Einführung

Du musst Hermes nicht auf deinem Smartphone ausführen, um es dort zu nutzen. Beim einfachsten Aufbau läuft Hermes weiter auf seinem ständig erreichbaren Server und das Smartphone dient als Fernsteuerung.

Für die meisten Menschen ist Telegram die schnellste und zuverlässigste mobile Option. Es funktioniert auf iPhone und Android, benötigt keinen offenen eingehenden Port, unterstützt Dateien und Sprachnachrichten und kann dich über abgeschlossene Zeitpläne oder Hintergrundaufgaben informieren. Ein verwaltetes Parlant-Agents-Dashboard kann einen Telegram-Bot inzwischen mit einem kurzen QR-Ablauf erstellen und verbinden.

Nutze eine native App nur, wenn du umfangreichere Bedienelemente für Sitzungen, Modelle, Aufgaben, Skills, Gedächtnis oder Dateien brauchst. Native Apps und Installationen auf dem Smartphone verwenden unterschiedliche Backends und sind daher nicht austauschbar.

Beispiele

Wenn du nur Aufträge senden und Ergebnisse empfangen möchtest, beginne mit Telegram. So vermeidest du fast die gesamte mobile Netzwerk- und Kompatibilitätsarbeit.

Ausführliche Anleitung

Schnellster Weg für einen verwalteten Agenten: Browser verwenden

1. Öffne dein Parlant-Agents-Konto auf dem Smartphone.
2. Wähle deinen Agenten und tippe auf Hermes WebUI.
3. Melde dich mit dem Hermex-Passwort unter Zugangsdaten → Hermes WebUI und Hermex an.
4. Öffne Chat und sende eine kurze Testnachricht.
5. Optional: Wähle in Safari Teilen → Zum Home-Bildschirm; in Chrome Menü → Zum Startbildschirm hinzufügen.

Damit greifst du auf denselben Agenten, dieselben Dateien, dasselbe Gedächtnis und dieselbe Modellkonfiguration wie am Computer zu. Auf dem Smartphone läuft nur der Browser.

Empfehlung für iPhone und Android: Telegram

1. Bot per QR-Einrichtung erstellen und verbinden

1. Installiere Telegram und melde dich an.
2. Öffne dein Hermes-Dashboard und dort Channels.
3. Suche Telegram und wähle Set up with QR.
4. Scanne den QR-Code oder wähle Open Telegram. Telegram öffnet @HermesSetupBot.
5. Tippe auf Create Bot. Vor der Bestätigung kannst du den Anzeigenamen ändern.
6. Kehre zum Hermes-Dashboard zurück. Dort sollten der neue Bot-Benutzername und deine numerische Telegram-Benutzer-ID erscheinen.
7. Prüfe, ob deine ID unter Allowed users steht, und wähle Save and restart.
8. Warte, bis Telegram als Connected angezeigt wird. Öffne dann den neuen Bot und sende Hallo.

Der Einrichtungsdienst übergibt das neue Bot-Token einmalig an deine Hermes-Instanz. Danach speichert und verwendet Hermes es auf deinem eigenen Server.

2. Fünf nützliche Befehle

• /help — verfügbare Befehle anzeigen;
• /new — ein neues, leeres Gespräch beginnen;
• /stop — laufende Arbeit stoppen;
• /status — Sitzungsstatus anzeigen;
• /sethome — künftige geplante Ergebnisse an diesen Chat senden.

Telegram unterstützt Text, Fotos, Dokumente, Sprachnachrichten, gestreamte Antworten und getrennte Gesprächsthemen. Beginne mit einer Direktnachricht und ergänze Gruppen oder Themen später.

3. Zugriff privat halten

Lass die Zulassungsliste aktiviert. Aktiviere niemals „alle Benutzer erlauben“ für einen Agenten mit Terminal- und Dateizugriff. Behandle das Bot-Token wie ein Passwort. Falls es offengelegt wird, widerrufe es über BotFather und verbinde den Bot neu.

Falls die QR-Einrichtung nicht verfügbar ist, nutze den manuellen Weg: Erstelle mit @BotFather einen Bot, ermittle deine numerische ID mit @userinfobot und trage beides unter Channels → Telegram → Configure ein. Den vollständigen Ersatzweg beschreibt die offizielle Telegram-Anleitung.

Nativer iOS-Weg: Hermex

Hermex ist ein kostenloser, unabhängiger iOS-Client. Der Agent läuft weiterhin auf einem Computer oder Server. Hermex spricht über HTTP oder HTTPS mit der API des Open-Source-Projekts hermes-webui und ergänzt native Sitzungen, Streaming, Anhänge, Modellsteuerung, Aufgaben, Skills, Gedächtnis und Dateiansicht.

Wichtige Kompatibilitätsprüfung: Hermex verbindet sich nicht mit dem normalen Hermes-Dashboard. Aktuelle verwaltete Parlant-Agents-Images führen hermes-webui separat aus: https://<dein-slug>.parlant.xyz ist die Adresse für WebUI und Hermex, während https://<dein-slug>-admin.parlant.xyz zum normalen Verwaltungs-Dashboard führt. Ältere verwaltete Instanzen behalten bis zum Upgrade die bisherige Aufteilung.

1. Verwaltete Parlant-Agents-Instanz verbinden

1. Öffne dein Parlant-Agents-Konto und wähle Zugangsdaten.
2. Kopiere Hermes-WebUI-URL und Hermex-Passwort aus der Karte Hermes WebUI und Hermex.
3. Installiere Hermex aus dem App Store.
4. Füge die URL ein, tippe auf Test Connection, gib das Passwort ein und melde dich an.

Keine Serverinstallation, Portweiterleitung, Tailscale-Einrichtung und kein zusätzliches Cloudflare-Konto nötig. Der Dienst bleibt auf deinem Server an die Loopback-Adresse gebunden; der vorhandene, nur ausgehend verbundene Cloudflare Tunnel liefert HTTPS. Parlant Agents pinnt und prüft hermes-webui zusammen mit der Hermes-Version jedes Images und wendet das verwaltete Theme automatisch an.

2. Benötigten Server auf einem selbst betriebenen Host installieren

Auf einem macOS-, Linux- oder Windows/WSL2-Rechner, auf dem Hermes bereits läuft:

git clone https://github.com/nesquena/hermes-webui.git
cd hermes-webui
python3 bootstrap.py

Das Bootstrap-Skript prüft Hermes, erstellt die Umgebung und startet die Weboberfläche unter 127.0.0.1:8787. Aktiviere vor dem Zugriff von einem anderen Gerät die Authentifizierung in den Einstellungen und setze ein starkes, einmaliges Passwort. Prüfe den lokalen Betrieb:

curl http://127.0.0.1:8787/health

3. Selbst betriebene Installation sicher erreichbar machen

Tailscale ist die sicherere Voreinstellung. Installiere Tailscale auf Server und iPhone, melde beide im selben Tailnet an und starte hermes-webui mit Passwort und netzwerkweit sichtbarer Bindung:

HERMES_WEBUI_HOST=0.0.0.0 HERMES_WEBUI_PASSWORD='langes-einmaliges-passwort-verwenden' ./start.sh
tailscale ip -4

Verwende in Hermex http://100.x.y.z:8787. Tailscale verschlüsselt die Verbindung. Die Bindung an 0.0.0.0 macht den Dienst auch im lokalen Netzwerk erreichbar; das Passwort muss daher aktiv bleiben.

Ein stabiler HTTPS-Reverse-Proxy oder benannter Cloudflare Tunnel funktioniert ebenfalls. Ein Quick Tunnel eignet sich zum Testen:

cloudflared tunnel --url http://localhost:8787

Die Adresse eines Quick Tunnels ändert sich nach einem Neustart. Jeder öffentliche Hostname benötigt ein starkes Serverpasswort. Hermex kann derzeit keine zusätzliche Cloudflare-Access-Anmeldung verarbeiten.

4. App verbinden

1. Folge der Hermex-Einrichtungsanleitung und installiere Hermex aus dem App Store.
2. Trage nur den Server-Ursprung ein, zum Beispiel https://hermes.example.com oder http://100.x.y.z:8787.
3. Tippe auf Test Connection.
4. Gib das Passwort von hermes-webui ein und melde dich an.
5. Öffne eine vorhandene Sitzung oder erstelle ein kurzes Testgespräch.

Wenn der Verbindungstest scheitert, prüfe nacheinander Serverprozess, /health, Tailscale oder Tunnel sowie URL und Passwort. Hermex benötigt iOS 18 oder neuer. Da sich die Server-API noch verändert, aktualisiere Hermex und hermes-webui gemeinsam, wenn Funktionen nicht mehr arbeiten.

Android-Option 1: Play-Store-App für ein separates Hermes auf dem Smartphone

Hermes Agent - Android von Hen Works verpackt Agent, Terminal, Python, git, Sitzungen, Gedächtnis und Anbieter-Einrichtung in einer Android-App. Wähle sie, wenn ein neues Hermes direkt auf dem Smartphone laufen soll.

1. Installiere die App aus Google Play.
2. Erstelle einen separaten Anbieter-API-Schlüssel mit niedrigem Ausgabenlimit.
3. Folge der Einrichtung in der App, wähle Anbieter und Modell und führe die Selbstprüfung aus.
4. Beginne mit einem ungefährlichen Auftrag, bevor du breiteren Datei- oder Terminalzugriff gewährst.

Diese App verbindet sich nicht mit deinem vorhandenen verwalteten Hermes. Sie erstellt eine weitere Installation mit eigenen Sitzungen, eigenem Gedächtnis und eigenen Dateien. Sie ist eine Drittanbieter-App mit Werbung und optionalem Kauf, keine offizielle Veröffentlichung von Nous Research. Prüfe die Datenschutzangaben im Play Store und verwende keinen uneingeschränkten produktiven API-Schlüssel erneut.

Android-Option 2: Community-Client für einen vorhandenen selbst betriebenen Server

Der Hermes-Android-Community-Client kann Sitzungen eines vorhandenen Hermes-API-Servers anzeigen und Chats streamen. Optionaler Dashboard-Zugriff ergänzt Gedächtnis, Zeitpläne, Skills und Einstellungen. Das ist nützlich, erfordert aber mehr Arbeit als Telegram.

1. Aktiviere auf dem Hermes-Host den authentifizierten API-Server mit einem starken API_SERVER_KEY. Halte den Standardport 8642 privat.
2. Verbinde Server und Android-Smartphone mit demselben Tailscale-Netzwerk. Leite die Ports 8642 und 9119 nicht direkt ins öffentliche Internet weiter.
3. Lade die aktuelle Datei app-arm64-v8a-release.apk von GitHub Releases. Android 8 oder neuer ist erforderlich.
4. Erlaube dem Browser oder Dateimanager die APK-Installation nur für die Installation und schalte diese Berechtigung danach wieder aus.
5. Füge in der App die Tailscale-IP oder den MagicDNS-Namen des Servers, Port 8642 und den API-Schlüssel hinzu.
6. Wenn du Dashboard-Bereiche brauchst, ergänze die separat geschützte Dashboard-Adresse und deren Zugangsdaten.

Dieser Client ist unabhängig und wird seitlich installiert. Prüfe vor jedem Update die Release-Seite, Repository-Aktivität und angeforderten Berechtigungen. Verwaltete Parlant-Agents-Instanzen veröffentlichen den API-Port standardmäßig nicht. Dieser Weg benötigt daher Serveradministration und ist nicht der schnelle Weg für den verwalteten Dienst.

Android-Option 3: Offizielles Hermes in Termux

Termux führt die echte Hermes-CLI innerhalb von Android aus. Nutze diesen Weg, wenn Open-Source-Code und lokale Terminalsteuerung wichtiger sind als Komfort.

1. Installiere einen aktuellen Termux-Build von termux.dev statt eines alten, nicht unterstützten Store-Builds.
2. Führe in Termux das offizielle Installationsskript aus:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

3. Prüfe und konfiguriere die Installation:

hermes version
hermes doctor
hermes model
hermes

Das Installationsskript wählt automatisch Android-kompatible Abhängigkeitsgruppen. Der geprüfte Weg umfasst CLI, Zeitpläne, Hintergrundterminals, Telegram-Gateway, MCP, Gedächtnis und ACP. Docker-Isolation, lokale Whisper-Spracherkennung und automatische Browser-Einrichtung gehören nicht zum geprüften Weg. Android kann Termux im Hintergrund anhalten; verlasse dich daher nicht darauf als ständig erreichbares Gateway.

Termux ist eine offizielle Tier-2-Plattform: Echte Nutzer verwenden sie, aber neue Versionen können Android-spezifische Abhängigkeiten beschädigen. Folge bei Installations- oder Aktualisierungsfehlern der vollständigen Termux-Anleitung.

Welchen Weg solltest du wählen?

• Kunde von Parlant Agents: zuerst Browser, danach Telegram.
• Zuverlässiger mobiler Chat und Benachrichtigungen auf beliebigem Smartphone: Telegram.
• iPhone mit vollständiger nativer Steueroberfläche und Möglichkeit, einen Zusatzserver zu betreiben: Hermex.
• Android mit separatem lokalen Agenten und einfacher Installation: Play-Store-App mit begrenztem Anbieter-Schlüssel.
• Android als nativer Client für einen vorhandenen selbst betriebenen Server: Community-Client über Tailscale.
• Android-Power-User mit offiziellem Hermes direkt auf dem Gerät: Termux.

Wie diese Optionen geprüft wurden

Die Recherche prüfte am 15. Juli 2026 aktuelle Primärdokumentation, Release-Aktivität und echte Nutzerberichte. Hermex hatte im US App Store 42 Bewertungen; Rezensionen bestätigten tägliche Nutzung und einfache Einrichtung, berichteten aber auch über langsame lange Gespräche und Verwirrung wegen des benötigten hermes-webui-Zusatzservers. Die Android-App im Play Store zeigte mehr als 10.000 Installationen, 4,4 Sterne aus 2.016 Bewertungen und Rezensionen mit erfolgreicher Einrichtung. Der Android-Community-Client veröffentlicht aktiv neue Versionen und hat einen Nutzerbericht über einen funktionierenden Reverse-Proxy-Aufbau. Termux wird vom Hermes-Projekt dokumentiert und getestet; aktive Android-Nutzerberichte bestätigen zugleich die Tier-2-Einschränkungen.