KULVEX HomeOverview

KULVEX Home

KULVEX Home is the native smart home control system. It communicates directly with your devices — no Home Assistant required.

Supported Protocols

ProtocolIntegrationDevices
Zigbeezigbee2mqttLights, sensors, switches, plugs
Z-Wavezwavejs2mqttLocks, thermostats, dimmers
WiFiTuya/Sonoff local APIPlugs, bulbs, cameras
Matter/ThreadNativeNext-gen smart home devices

Control Methods

  • Chat — “Turn on the living room lights”
  • Voice — Speak naturally, intent detection handles the rest
  • Dashboard — Visual controls in the web UI
  • Scenes — One-tap presets (Movie Night, Good Morning, etc.)
  • Automations — Time-based or sensor-triggered rules

Architecture

Voice / Chat / UI


  Home Agent (priority 35)

      ├── zigbee2mqtt (MQTT)
      ├── Tuya local API
      ├── Matter bridge
      └── Z-Wave JS

The Home agent handles natural language commands, maps them to device actions, and executes them via the appropriate protocol.

Entity Management

KULVEX discovers devices automatically from connected bridges (zigbee2mqtt, etc.) and maintains an entity registry.

# List all entities
curl http://localhost:9100/api/home/entities
 
# Control a device
curl -X POST http://localhost:9100/api/home/control \
  -H "Content-Type: application/json" \
  -d '{"entity_id": "light.living_room", "action": "on"}'