pi-hub // self-hosted home OS

Your home, in your terminal
— and in your kitchen.

$ For the geeks: an agent that drives MQTT, containers, scripts, and your Pi — over SSH-free long-polling.

♥ For everyone else: just ask. "Dim the kitchen." "Is the dryer done?" "Goodnight." That's it.

$curl -fsSL https://pi-hub.benniwie.com/install.sh | sh

Install on my Pi Open dashboard

Works on Raspberry Pi 3/4/5 · Debian/Ubuntu · ~30s to first boot.

~/pi-hub · zsh

voice + chat demo

Telegram, web, or voice — same agent.

No menus. No 12-tap routines. Talk to your home like a competent roommate that happens to speak fluent MQTT.

Dim the kitchen to 30%.

Done. Kitchen ceiling at 30%. Want the under-cabinet warm too?

Yeah, and is the dryer finished?

Dryer cycle ended 4 min ago. Energy: 0.42 kWh.

Arm night mode in 20.

Scheduled. I'll lock doors, dim hallway to 5%, and mute Telegram alerts.

how it works

Pi ↔ Cloud, outbound only.

Your Pi long-polls the cloud — no inbound ports, no router config, no exposed services. Commands ride back on the same connection.

Your Pi

· pi-agent.service

· MQTT · Docker · scripts

long-poll · HTTPS

→→

pi-hub cloud

· queues commands

· no shell access

Your Telegram

· 1 bot per user

· voice + text

webhook · per-user

←•

pi-hub cloud

· routes to your device

· audit log

Outbound only

No open ports on your home network. Ever.

Your data, your Pi

MQTT, sensor history, scenes — stays on device.

Per-user Telegram bot

One bot per user, scoped to your devices only.

for the whole household

Not just for the person who flashed the SD card.

Ask in plain language

No app to learn. No buttons to memorize. Type or speak the way you'd ask anyone in the house.

Works on the family phone

Telegram is the remote. Everyone in the household already has it — kids included.

No app store. No subscriptions

One install on your Pi. The rest is just chat. Spouse-approved.

One command. Your home, online.

Free, open, self-hosted. Ditch the clunky dashboard — keep the power.