Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Fyos Plugin Haus

FreeNot checked

FYOS plugins for the home: lights, scenes, room presence, weather, cameras, voice / Haus-Plugins für FYOS

GitHubEmbed

About

FYOS plugins for the home: lights, scenes, room presence, weather, cameras, voice / Haus-Plugins für FYOS

README

Das Zuhause als Plugins für den FYOS-Hub (Paket fyos_plugin_haus): Lichter und Szenen über Home Assistant, Raumbelegung, Geräte-Anwesenheit, Wetter, Kameras und Stimme. Räume und Geräte-Zuordnung (daten/*.yaml) sind ein Beispiel; die eigene Datei geben FYOS_HAUS_RAEUME und FYOS_HAUS_ANWESENHEIT an.

Inhalt

Modul Werkzeuge Hinweis
haus haus.favoriten (App), szenen, geraete, favoriten_setzen, schalten, szene_aktivieren Haus-App ui://fyos/haus.html; Weg über smarthome-bruecke, Favoriten in Redis, eine Sperrliste (FYOS_HAUS_SPERRE) hält Geräte wie die Steckdose eines Messrechners heraus
licht licht.befehl „Licht an/aus“ im belegten Raum, „alle Lichter“ überall; Räume: daten/raeume.yaml
anwesenheit anwesenheit.wo, anwesenheit.raeume Omada-AP, os.lage, Handy, HA; Frigate-Zonen per MQTT; Regeln: daten/anwesenheit.yaml
_raeume – Helfer: Raumbelegung (Frigate-Zonen, Haltezeiten, Redis-Zustand)
augen augen.zustand, augen.schalten Frigate-Erkennung je Kamera (Werkzeuge mit Oberflächen-Identität, aber ohne eigene HTML-Datei)
stimme stimme.zustand, stimme.lauscher Lauscher in den Räumen
handy handy.zustand, handy.aktion iPhone über die HA-Companion-App
wetter wetter.jetzt, wetter.vorhersage Home Assistant, Rückfall Open-Meteo
icloud icloud.kalender, icloud.termine CalDAV; Formular-Konto über fyos_plugin_konten._dienst

Das Mail-Plugin (mail.eingang, suchen, lesen) ist seit 0.2.0 nicht mehr hier: es gehört jetzt zu fyos-plugin-mail (IMAP-Konten mit App-Passwort oder ein eigener Mail-Dienst über FYOS_POSTFACH_URL; die Werkzeug-Namen sind gleich). MAIL_INBOX_URL gibt es nicht mehr; die Adresse des Mail-Dienstes steht jetzt in FYOS_POSTFACH_URL.

Apps: Haus (haus.html). Haus, Augen und Stimme werden beim Import ihres Moduls mit _identitaet.registriere_app angemeldet (Kategorie „Zuhause“ bzw. „Assistent“).

Abhängigkeiten

fyos-hub, fyos-plugin-betrieb (lage: PANE_AUTH, _iso, _redis), fyos-plugin-konten (_dienst), dazu pyyaml, redis, paho-mqtt.

Kante zum Leitstand: haus._EINSTELLUNG und haus._ist_einstellung (Kamera- und Melder-Einstellungen wie detect, recording oder motion, die kein Haus-Gerät sind) liegen hier; haus.ist_konfig nutzt sie direkt. fyos-plugin-leitstand hängt von diesem Paket ab und importiert sie, nicht umgekehrt. anwesenheit liest zur Laufzeit über die Registry die Plugins omada (Betrieb-Repo), os (Leitstand-Repo) und handy; fehlt eines, fehlt nur dieser Hinweis.

Konfiguration (Umgebungsvariablen)

Beispiel für die Hub-Konfiguration: hub-config.beispiel.yaml. Geheimnisse nie im Repo, nur ihre Namen.

  • LEITSTAND_HAUS_URL: Smarthome-Dienst (haus, handy, anwesenheit, wetter); er gibt Home Assistant unter /api/smarthome/… weiter
  • FYOS_HAUS_SPERRE: Komma-Liste von Wörtern; Geräte, deren Id oder Name eines enthält, werden nie geschaltet (ohne Einstellung leer)
  • FYOS_HAUS_RAEUME, FYOS_HAUS_ANWESENHEIT: Pfade zu den eigenen Dateien für Räume und Geräte (ohne Einstellung gilt das Beispiel im Paket)
  • REDIS_URL: Favoriten und Raumzustand
  • FRIGATE_URL, FRIGATE_MQTT_HOST, FRIGATE_MQTT_PORT, MQTT_USER, MQTT_PASSWORD (geheim): Augen, Raumbelegung
  • ANWESENHEIT=aus: Hörer auf die Frigate-Zonen abschalten
  • STIMME_URL: Lauscher
  • FYOS_PANE_AUTH: Kopf für die internen Dienste (aus fyos-plugin-betrieb)

Betrieb

pip install -e /pfad/zu/fyos-os/hub -e /pfad/zu/fyos-plugin-betrieb -e /pfad/zu/fyos-plugin-konten -e ".[test]"
python -P -m pytest tests -q

Der Hub findet die Plugins über die Entry-Points mcp_hub.plugins, den Katalogeintrag über fyos.katalog. Die CI (.gitea/workflows/ci.yml) testet gegen fyos-hub und die Plugin-Pakete aus der Paket-Registry und veröffentlicht auf main. Auf GitHub prüft .github/workflows/tests.yml: die Tests gegen den Hub aus dem Quellbaum von fyos-os (mit den Schwester-Plugins betrieb und konten), tools/sauber.py über Baum und Historie und gitleaks.

Lizenz

Apache License, Version 2.0 (SPDX-Kennung Apache-2.0); Text in LICENSE, Urheberzeile in NOTICE.

from github.com/sirfyyn/fyos-plugin-haus

Installing Fyos Plugin Haus

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/sirfyyn/fyos-plugin-haus

FAQ

Is Fyos Plugin Haus MCP free?

Yes, Fyos Plugin Haus MCP is free — one-click install via Unyly at no cost.

Does Fyos Plugin Haus need an API key?

No, Fyos Plugin Haus runs without API keys or environment variables.

Is Fyos Plugin Haus hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Fyos Plugin Haus in Claude Desktop, Claude Code or Cursor?

Open Fyos Plugin Haus on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Fyos Plugin Haus with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs