Homuncu PI is a lightweight, modular home automation middleware that runs on any Raspberry Pi — from the original Pi 1 to the latest Pi 5. It bridges your IoT hardware to Home Assistant (or any MQTT broker) with zero hassle.
Just connect your sensors, configure a YAML file, and you are up and running. No cloud, no bloat, just your Pi doing what it does best.
A growing set of modular services — just enable what you need.
Reed switches, PIR motion detectors — detect open windows, doors, or intruders.
Connect a Pi Camera and see what is going on — even when you are not home.
Monitor CPU temperature, memory, disk usage, and overall Pi health.
Feed a DNS server like Unbound with current hostname & IP combos — no more stale DHCP addresses.
Control WS2812 LED strips or WLED devices via MQTT — light up your home.
Multiroom audio with Squeezelite — everyone listens to their own music.
DHT22 / DHT11 / AM2302 support — track your environment with configurable polling.
Read RFID tags and trigger actions — perfect for access control or an audiobook player for kids.
Make your Pi resilient to power outages by running the filesystem read-only.
Stay up to date — the built-in update service checks for new versions automatically.
Wire your sensors to the GPIO pins — DHT22, PIR, reed switch, RFID, camera, etc.
Edit config.yaml — enable the services you need, set pins and intervals.
Execute ./run.sh — Homuncu PI starts, discovers services, and publishes to MQTT.
Home Assistant subscribes to the MQTT topics and you are done — full home automation.
Get the latest Homuncu PI release for your Raspberry Pi.
Battle-tested releases recommended for production use.
The easiest way to install is following command in your Raspberry Pi terminal:
wget {{base_url}}/dl/installer.sh -O - | shAlternatively, you can download the archive yourself and put it on your raspberry yourself:
Download Stable tarSHA256: —
Latest developments — may be experimental, includes newest features.
The easiest way to install is following command in your Raspberry Pi terminal:
wget {{base_url}}/dl/installer.sh -O - | shAlternatively, you can download the archive yourself and put it on your raspberry yourself:
Download Dev Build tarSHA256: —
Homuncu PI comes with a built-in update service. Configure your config.yaml:
update:
active: True
type: stable
autoupdate: True
The service periodically checks for new versions and if autoupdate is set to True it keeps your Pi (and Homuncu itself) up to date.
If you like to have more control over when an update is applied, set autoupdate to False and send it an MQTT message like this:
topic:
home/raspi
hostname: $HOSTNAME
message: { update: "now" }