Vulpo 1.4Aktualisiert am
Vulpo für Entwickler:innen
Vulpo ist ein Client für Home Assistant, keine Plattform: Es gibt keine öffentliche HTTP-API, keine Webhook-API und keinen MCP-Server. Hier steht alles, woran Entwickler:innen oder ein Agent andocken können, und was Vulpo von einem Home Assistant-Server verlangt.
Es gibt keine öffentliche API
Vulpo bietet keine HTTP-API, keine OpenAPI-Spezifikation, keine Webhooks, kein SDK und keinen MCP-Server, und es gibt weder einen Entwickler-Account noch einen API-Schlüssel oder eine Sandbox, die du beantragen könntest. Nichts in der App lässt sich von einem Server aus steuern, den du betreibst.
Das ist eine bewusste Folge der Architektur: Vulpo hält keine eigenen Daten. Die App liest und schreibt direkt auf deinem Home Assistant-Server und speichert Dashboards in deiner privaten iCloud-Datenbank, es gibt also kein Backend, das ein Dritter aufrufen könnte. Wenn du programmatisch auf ein Zuhause zugreifen willst, nutze die REST- und WebSocket-APIs von Home Assistant auf diesem Server.
Maschinenlesbare Endpunkte auf dieser Website
Jede Seite von vulpo.app ist statisches HTML unter einer eigenen URL und gibt es auch als Markdown. Hänge .md an einen beliebigen Seitenpfad an oder schicke an die HTML-URL den Request-Header Accept: text/markdown, dann kommt dasselbe Dokument als text/markdown; charset=utf-8 zurück.
- https://vulpo.app/llms.txt: Index der Website mit einem Abschnitt, wann sie hilft
- https://vulpo.app/llms-full.txt: FAQ, Vergleich, Funktionsseiten, Preise und Versionshinweise in einem Dokument
- https://vulpo.app/sitemap.xml: jede veröffentlichte Seite mit echtem lastmod
- https://vulpo.app/robots.txt: Crawling-Regeln, jeder KI-Such- und Trainings-Agent ist erlaubt
- https://vulpo.app/faq.md und das .md-Gegenstück jeder anderen Seite
Vulpo auf dem Gerät automatisieren
Der unterstützte Weg, Vulpo aus anderer Software heraus zu steuern, sind App Intents. Vulpo bringt Intents für Siri, die Kurzbefehle-App, die Aktionstaste und Spotlight mit, die Entitätszustände lesen und Aktionen ausführen. So kann ein Kurzbefehl, eine Automation oder eine Anfrage an Apple Intelligence das Zuhause abfragen und steuern, ohne Home Assistant direkt anzusprechen.
HomePass exportiert ein komplettes Vulpo-Setup, also Dashboards, Karten, Umbenennungen, Symbole und Erscheinungsbild, als Datei, die ein anderes Gerät oder eine andere Person importieren kann. Das ist der unterstützte Weg, eine Konfiguration umzuziehen oder zu klonen; das Format ist intern und kein öffentliches Austauschformat.
Anforderungen an Home Assistant
Vulpo funktioniert mit jeder aktuellen Home Assistant-Version, ob als Home Assistant OS, Container, Core oder Supervised. Auf dem Server braucht es keine benutzerdefinierte Integration, kein Add-on und keine HACS-Komponente.
- WebSocket-API für Live-Zustände, REST- und History-API für Diagramme und Logbuch
- Die Integration mobile_app für Push-Benachrichtigungen, Gerätesensoren und Standortmeldungen
- Eine erreichbare URL: eine lokale Adresse, eine externe Adresse oder beide mit automatischem Wechsel
- Funktionen, die auf neueren Fähigkeiten von Home Assistant aufbauen, etwa das Energie-Dashboard oder Bereiche und Etagen, brauchen eine Serverversion, die sie mitbringt
Anmeldevertrag (IndieAuth)
Vulpo meldet sich über den üblichen IndieAuth-Ablauf von Home Assistant an. Die Client-Kennung ist die Website selbst, https://vulpo.app, und die Seite nennt ihr Weiterleitungsziel mit einem link rel=redirect_uri-Tag, das auf vulpo://auth zeigt. Home Assistant ruft die Website während der Anmeldung ab und liest dieses Tag, die Seite ist also Teil des Anmeldevertrags und nicht nur Marketing.
Keine Zugangsdaten erreichen je Joshua Dessol Design. Das Zugriffstoken, das Home Assistant ausstellt, liegt im Schlüsselbund des Geräts und wird nie mit iCloud synchronisiert oder anderswohin gesendet.