Czym jest vCLU?#

vCLU to lekki runtime smart home, który działa lokalnie na Raspberry Pi lub zwykłym komputerze.

Jeden niewielki program łączy urządzenia, uruchamia automatyzacje, udostępnia dashboard oraz pozwala agentom AI zarządzać domem.

Nie potrzebuje chmury, kont ani zewnętrznych usług - cały system działa lokalnie w Twojej sieci.

Co robi vCLU#

vCLU jest centralnym punktem domu. Zbiera dane z urządzeń, reaguje na zdarzenia i udostępnia interfejs do sterowania.

Najważniejsze elementy systemu:

Integracja urządzeń#

vCLU łączy urządzenia działające przez MQTT, takie jak:

• Zigbee2MQTT
• Tasmota
• Shelly
• ESPHome
• inne urządzenia publikujące dane przez MQTT

Dashboard webowy#

Wbudowany panel webowy pozwala:

• monitorować urządzenia
• sterować domem z przeglądarki
• budować własne dashboardy

Automatyzacje w Lua#

Logika domu jest pisana w Lua:

• reakcje na zdarzenia
• sceny
• timery
• harmonogramy

Lua jest czytelna i bardzo lekka, dlatego dobrze nadaje się do automatyzacji.

Integracje systemowe#

vCLU może integrować się z innymi systemami smart home:

• Apple HomeKit
• Home Assistant (auto discovery)

System pluginów#

Funkcjonalność można rozszerzać przez pluginy.

Plugin może dodawać nowe funkcje, np.:

• pogodę
• powiadomienia
• integracje z API
• monitoring energii

Pluginy działają w sandboxie Lua i komunikują się z systemem przez API.

GPIO Raspberry Pi#

Jeśli vCLU działa na Raspberry Pi, może bezpośrednio sterować pinami GPIO:

• przekaźniki
• przyciski
• czujniki
• własne układy elektroniczne

Emulacja Grenton CLU#

Opcjonalnie vCLU może emulować kontroler Grenton CLU, co pozwala integrować go z instalacjami Grenton.

Na czym działa#

vCLU działa na wielu platformach:

• Raspberry Pi (od modelu 1 do RPi 5)
• Linux
• macOS

Do działania potrzebny jest tylko jeden program - około 13 MB binarki i ~13 MB RAM.

Jak wygląda typowa instalacja#

graph LR
    subgraph Urządzenia
        z2m[Zigbee2MQTT]
        tas[Tasmota]
        sh[Shelly]
        esp[ESPHome]
        gpio["GPIO RPi"]
    end

    subgraph vCLU
        broker[Broker MQTT]
        auto[Automatyzacje]
        dash[Dashboard]
        hk[HomeKit]
        mcp["Agent AI (MCP)"]
    end

    subgraph Aplikacje
        apple[Apple Home]
        ha[Home Assistant]
        web[Przeglądarka]
        ai["Claude / AI"]
    end

    z2m -->|MQTT| broker
    tas -->|MQTT| broker
    sh -->|MQTT| broker
    esp -->|MQTT| broker
    gpio --> auto

    dash --> web
    hk --> apple
    auto --> ha
    mcp --> ai

Kluczowe cechy#

Jeden program#

Cały system działa w jednym procesie - bez kontenerów, brokerów i dziesiątek usług.

Lokalny system#

vCLU działa w Twojej sieci:

• bez chmury
• bez kont
• bez wysyłania danych na zewnątrz

Lekki#

Może działać nawet na bardzo starych Raspberry Pi.

Hot reload#

Zmiany w kodzie Lua można wprowadzać bez restartu systemu.

Agent AI#

vCLU ma wbudowany serwer MCP (Model Context Protocol).

Dzięki temu agent AI może bezpośrednio pracować z systemem.

AI może:

• odkrywać urządzenia MQTT
• tworzyć automatyzacje w Lua
• budować dashboardy
• diagnozować problemy

Agent nie steruje systemem bezpośrednio - generuje kod, który jest wykonywany w sandboxie.