boneIO Black

boneIO Black is a DIN-rail home automation controller: relays, inputs and sensors in one box, ready to wire into a switchboard. This repository is the software that runs on it — configured from the browser, integrated with Home Assistant over MQTT, and working on its own when the network or the server is down.

boneio.eu · Documentation · Releases

The controller

32x10A — 32 relay outputs, 10 A each, plus inputs for wall switches.
24x16A — 24 relay outputs, 16 A each, for heavier loads.
Cover and Cover Mix — boards made for roller blinds, venetian blinds and gates.

Every board has an OLED status screen, a temperature sensor, power monitoring and RS-485 for Modbus devices. It comes with the system image installed: power it up, open the panel, pick the board type, done.

What the software does

Web panel — configure outputs, inputs, covers and devices from the browser, with no YAML editing needed (YAML stays available for those who want it). Accounts with roles, HTTPS, works as a phone app (PWA).
Home Assistant — every output, input and sensor appears in Home Assistant by itself through MQTT discovery. MQTT over TLS is supported.
Local logic — inputs drive outputs directly on the controller, with click / double click / long press actions and conditions. Lights still work when Home Assistant or the network does not.
Covers — time-based roller blinds, venetian blinds with tilt, gates.
Modbus — ready definitions for energy meters, inverters, HVAC units and sensors (SDM630, ORNO, Socomec, Sofar, SHT30, PT100 and more).
Templates — thermostats, alarm panel, irrigation, schedules, presence simulation, sunrise / sunset triggers, virtual switches and energy sensors.
Remote devices — ESPHome, WLED and other controllers over MQTT or CAN, used as inputs and outputs as if they were local.
Updates from the panel — application and system updates, backups and configuration restore without SSH.

Getting started

The controller ships ready to use. Connect it to the network and open https://<controller-ip>:8443, or plug in USB and open http://192.168.7.2:8090. The first-run wizard creates the administrator account and asks which board this is.

Full guide: boneio.eu/docs.

The supported way to run this software is the boneIO system image on boneIO hardware. Installing the Python package by hand on another system is not supported.

Development

uv sync
uv run boneio run -c ~/boneio/config.yaml -dd

Python 3.13 or newer. Frontend sources are in frontend/.

License

GNU General Public License v3.0.

Metadata

Release files for boneio 1.6.0.dev42

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for boneio 1.6.0.dev42
File	Size	Uploaded
boneio-1.6.0.dev42.tar.gz	5.8 MB	Oct 11, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for boneio 1.6.0.dev42
File	Interpreter	ABI	Platform	Reset
boneio-1.6.0.dev42-py3-none-any.whl 6.1 MB Oct 11, 2026	Python 3	none	any	Details

Total release size: 11.9 MB

Release files / boneio-1.6.0.dev42.tar.gz

Download URL	boneio-1.6.0.dev42.tar.gz
Size	5.8 MB
Tags	Source
SHA-256 checksum How to use checksums	`c6a198cb09feebf5af627424ea052dca07db91b3f6e6a0a892113a7f5e91c1e0`
BLAKE2b-256 checksum How to use checksums	`a73ab16e8ac8a17e080acfda606f80d140ce26cd3bd1747ea0f1fb20c0bc529b`
Upload date	Oct 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Release files / boneio-1.6.0.dev42-py3-none-any.whl

Download URL	boneio-1.6.0.dev42-py3-none-any.whl
Size	6.1 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`309f4470b55702dd7472790141522b44ad9020fb0670f639aa56a27b9b7212c6`
BLAKE2b-256 checksum How to use checksums	`98f4583796d95f16cae418c163a6e683be87cd532727a7dd67be9edbcab168a4`
Upload date	Oct 11, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.16`