Tutorial 1: AI steruje moim domem#

Hook: Jedna komenda na Raspberry Pi, 5 minut konfiguracji — i AI włącza światło w Twoim domu głosem. Brzmi jak science fiction? To działa dzisiaj.

Co zbudujemy#

Na koniec tego tutoriala będziesz miał:

  • vCLU działające na Raspberry Pi
  • 2-3 urządzenia widoczne w systemie
  • agenta AI, który steruje domem naturalnym językiem

Czas: ~10 minut.

1. Instalacja#

Potrzebujesz Raspberry Pi z Raspbian. Wystarczy wersja Lite — żadne dodatkowe pakiety nie są potrzebne.

curl -sSL https://vclu.pl/install.sh | bash

Skrypt pobiera binarkę, instaluje usługę systemd i startuje vCLU. Po kilkunastu sekundach:

http://<IP-raspberry>:8080

2. Kreator#

Kreator ma 5 kroków. Na potrzeby tego tutoriala wybieramy najszybszą ścieżkę.

Typ urządzenia → Standalone#

Tryb bez Grenton — działa z dowolnymi urządzeniami MQTT.

PIN → pomijamy#

W trybie standalone PIN nie jest potrzebny.

Hasło#

Ustaw hasło do panelu (min. 8 znaków).

Gotowe#

3. Dodaj urządzenia#

Jeśli masz urządzenia MQTT (Shelly, Zigbee2MQTT, Tasmota) — podłącz je do wbudowanego brokera MQTT w Settings → MQTT.

Jeśli nie masz — nic nie szkodzi. Możesz stworzyć wirtualne urządzenia w kodzie:

-- modules/urzadzenia.lua

local lampa = VirtualSwitch:new("lampa_salon")
expose(lampa, "switch", {
    name = "Lampa salon",
    area = "Salon"
})

local czujnik = VirtualSensor:new("temp_salon")
expose(czujnik, "sensor", {
    name = "Temperatura salon",
    area = "Salon",
    unit = "°C"
})

Urządzenia pojawiają się w Tools → Inspect:

4. Pierwszy agent AI#

Przejdź do Settings → MCP i utwórz bota.

Skonfiguruj klienta AI (np. Claude Code) z adresem vCLU i kluczem API bota.

Teraz rozmawiasz z domem:

Ty:   "Jakie mam urządzenia?"
AI:    → vclu_devices()
       Masz 2 urządzenia:
       • Lampa salon (switch) — OFF
       • Temperatura salon (sensor) — 21.5°C

Ty:   "Włącz lampę"
AI:    → vclu_device_set("lampa_salon", 1)
       ✓ Lampa salon włączona.

Co dalej?#

Masz działający system. Kolejne tutoriale:

Backward Tutorials Tutorial 2: Grenton Forward