In short, gethome hub is software for a small computer you own — a Raspberry Pi, or any 64-bit Linux machine — that runs a home on your own Wi-Fi, with no cloud account. It speaks Matter, Zigbee through a USB stick, and MQTT for your own boards, and rules run on it around the clock with no AI key. With your own Anthropic or OpenAI key it adds an assistant, an agent that writes rules, and one that works out Zigbee devices it has never met. Its source is public.
Software for a small computer on your shelf. It runs your devices, your rules and your agents — on your own Wi-Fi, with your own AI key and no cloud account.
Your own boards, over MQTT. Anything that can publish JSON can be a device — by a documented convention, with no code on the hub. The MQTT convention
A documented API. REST and a WebSocket, on your own network — the same one the iPhone app talks to. The API
Source-available. The code is public under PolyForm Noncommercial: free for homes and hobby projects. Commercial use needs a license. The source
Build on it with your agent.
Two skills teach Claude Code, Codex, Cursor and the other coding agents how a hub works. Install them once; the agent picks the right one when a task fits.
npx skills add gethome-inc/gethome-hub
Needs Node.js, and no copy of the repository: it asks which of your agents to install for, and copies in the two skill folders. The skills on GitHub · What Agent Skills are
Software that uses your home (gethome-hub-api). A script, a dashboard, a bridge, an exporter, an agent of your own — on the hub’s REST and WebSocket API, with a key that does only what you gave it. Things you’d ask: “A dashboard of every room, for a screen in the kitchen.” “Export a week of temperatures to Grafana.” “A bridge that puts my devices in Node-RED.” Building on a hub
Hardware that is a device (gethome-mqtt-device). ESPHome, Arduino, MicroPython or Python on a board of your own, joining over MQTT by the hub’s convention — with no code on the hub. Things you’d ask: “An ESP32 with a relay, as a switch in the hall.” “A temperature and humidity sensor for the greenhouse.” “The weather station on the roof, as a device.” The MQTT convention
The key never enters the conversation. The agent reads it from its environment, and is told never to ask for one or print it.
It asks before anything hard to undo: unlocking a door, opening a garage, removing a device, switching on a rule it wrote.
They describe the newest hub. Yours may be older, and the agent is told to check what it advertises before relying on it.
Frequently asked questions
What is gethome hub?
In short, gethome hub is software for a small computer you own — a Raspberry Pi, or any 64-bit Linux machine — that runs a home on your own Wi-Fi, with no cloud account. It speaks Matter, Zigbee through a USB stick, and MQTT for your own boards, and rules run on it around the clock with no AI key. With your own Anthropic or OpenAI key it adds an assistant, an agent that writes rules, and one that works out Zigbee devices it has never met. Its source is public.
Do I need the app?
To live with a hub, yes: the home itself — its rooms, scenes, rules and the assistant — is in gethome for iPhone, free on the App Store.
No, but it’s the easiest way. gethome studio sets the hub up with no terminal and no pairing code, and shows what the iPhone app doesn’t — the broker’s live traffic, the schema library and every AI run with what it cost. Without a Mac, the hub installs with one line over SSH, and the iPhone app claims it.
Not yet. Your phone and the hub talk over your own Wi-Fi, and its ports are never to be forwarded through your router. Rules keep running while you’re away, and remote access is planned as an authenticated relay.
Is it open source?
It is source-available: the code is public under PolyForm Noncommercial 1.0.0, free for homes, hobby projects and evaluation. Hotels, rentals and paid installations need a commercial license.
Yes. Two agent skills in the hub’s repository teach Claude Code, Codex, Cursor and the other agents that read Agent Skills how a hub works: gethome-hub-api, for software that uses a home through the API with an API key, and gethome-mqtt-device, for a board of your own that joins over MQTT. One line installs both — npx skills add gethome-inc/gethome-hub — and the agent picks the right one when a task fits.
Both run a home on a computer you own. Home Assistant brings thousands of integrations for you to choose and assemble; this hub comes with Zigbee2MQTT and its broker, updates from the iPhone app with a rollback, and has an agent write your rules. It speaks Matter, Zigbee and MQTT — no Z-Wave, and no remote access yet.
Three things, from the hub itself: calls to your AI provider, if you gave it a key; a check with GitHub for a newer build; and, while a Zigbee device is being worked out on an OpenAI key, two public documentation sites. Installing and updating download from GitHub, nodejs.org and npm, and Zigbee2MQTT may ask GitHub about firmware for your devices. None of it reports your home to us.