KS Smart Systems Get it on GitHub
Free · open source · privacy-oriented

Change your whole smart home by editing a script — not the wiring.

KS Smart Systems is a script-driven layer over your ESP32 and ESP8266 nodes. Wire the hardware once, then re-map every switch, sensor, and transmitter live over MQTT — no re-flashing, no soldering iron, no multimeter.

ESP32 / ESP8266 · MQTT · Python interpreter · Arduino framework

living_room.kst
# define what your home is made of
switch ceiling_light   node_01 pin 4
sensor motion         node_02 pin 13
transmitter ac        node_03

# wire behaviour — no soldering, no re-flash
on motion then ceiling_light = on
when temp > 26 then ac = on

Edit primitives — switches, sensors, transmitters — and the interpreter handles the pins and voltage.

01

Edit switches, not voltage

Once your nodes are wired, you stop thinking in pins and volts. You write KST primitives — switches, sensors, transmitters — and the AAU interpreter delegates the rest to your nodes over MQTT.

02

Rewrite the running system, live

Send commands to the admin MQTT topic and change the working script in real time — no restarting the system, no re-flashing a single controller.

03

Your home, your data

Privacy-oriented, free, and open source. No cloud account to create, no vendor lock-in. The whole stack runs on hardware you own.

From soldering iron to text editor

The hard, physical work happens once. After that, every change to your home is a line of script.

1

Set up the hardware once

Flash KS_NODE onto your ESP32 / ESP8266 controllers and connect your switches and sensors. That's the last time you touch the soldering iron.

2

Describe your home in .kst

Declare nodes, switches, sensors, and transmitters as script primitives. The AAU interpreter reads the script and talks to every node over MQTT.

3

Tweak it forever, from the keyboard

Change behaviour, re-map a switch, add a rule — all in script, pushed live through the admin topic. No re-flash, no restart.

Experimental

Hand the script to an AI agent

KS Smart Systems ships an AI skill, tested with Hermes and OpenCode running local models like Gemma 3 and Nemotron 3 Nano. Agent-driven switching works today; more controls are landing in upcoming releases. It runs against local models, so your home stays private.

It's early — switching is implemented and the rest is in active development. Follow the GitHub repo to track each release.

# you, to a local agent
> turn the living room lights off
agent → AAU → node_01: ceiling_light = off
✓ done, on-device, no cloud round-trip

What's inside

PYTHON · CORE

AAU — the interpreter

Reads your .kst script, delegates instructions to nodes, and applies the values they send back. It owns every MQTT topic, plus an admin topic for sending direct commands and swapping the working script in real time.

ARDUINO · ESP32 / ESP8266

KS_NODE — the firmware

The application for your microcontrollers, built with the Arduino framework in VS Code and PlatformIO. Flash it once per node; from then on the node takes its orders from the script.

Build a smart home you actually control

Free and open source. Clone the repo, flash a node, and write your first line of .kst.