The local brain of your home

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.

Install it today · View on GitHub

Everything runs on it.

One hub is one home: its devices, what they do by themselves, and the agents you talk to.

  • Your devices. Matter, Zigbee through a USB stick, and your own boards over MQTT — in one app.
  • Your rules. They run on the hub around the clock, with no AI key, while every phone is out.
  • Your agents. An assistant, an agent that writes rules, and one that works out an unknown Zigbee device — on your own key.

Built to be left alone.

  • Back after a power cut. Everything the install sets up starts again when the computer does.
  • An update can’t strand you. A new build takes over only once it answers. One that won’t start is rolled back.
  • A week of history. Temperature, humidity, air quality and power, in five-minute steps.
  • It guards your hardware. A rule can’t flick a relay faster than once in two seconds, and one that runs away is switched off.
  • Only on your network. Nothing is opened through your router. Your phone reaches the hub over your own Wi-Fi.
  • One file, on its own card. Your devices, rooms, rules, history and members live in a single file on the hub.

Runs on what you have.

A Raspberry Pi is what it is tested on, and any 64-bit Linux machine, ARM or x86, runs it. Memory decides the rest.

  • 2 GB or more. Both radios together, and never a choice to make.
  • 1 GB or less. One radio at a time as it comes. Switch both on and the hub watches its own memory.
  • Zigbee needs a USB coordinator stick. Without one: Matter, Wi-Fi and MQTT devices.
  • Thread devices work behind a border router you already own.
  • A 64-bit system and 512 MB of memory are the least it asks for.

Choosing hardware

Set it up from your Mac.

We recommend gethome studio: it’s the easiest way in, and it does more once the hub is running.

gethome studio for Mac

  • No terminal. A card for a Pi that isn’t set up yet, or a Pi already on your network.
  • No pairing code. It watches the install, names anything that goes wrong, and claims the hub for you.
  • More once it runs. The broker’s live traffic, the schema library and every AI run with what it cost. None of them is in the iPhone app.

About gethome studio

Or one line, on the hub itself.

No Mac, or rather a terminal? Run it on the computer that will be the hub.

curl -fsSL https://raw.githubusercontent.com/gethome-inc/gethome-hub/main/deploy/install.sh | bash
  1. Run the line — Over SSH, on 64-bit Linux
  2. It installs itself — And finds your Zigbee stick
  3. It prints a pairing code — Eight digits, used once
  4. Claim it from the app — The first to claim it owns it

Either way, you live with the hub in gethome for iPhone, free on the App Store.

Read the install guide

Built to be built on.

  • 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.

Get it on the App Store

Do I need a Mac?

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.

About gethome studio

Can I reach it when I’m out?

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.

Read the license

Can my coding agent build on it?

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.

The skills on GitHub

How is it different from Home Assistant?

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.

gethome vs Home Assistant

Which Zigbee stick?

Any coordinator Zigbee2MQTT supports. The hardware guide names the one the hub is developed against, and the ones the installer recognises by itself.

Choosing hardware

What leaves my network?

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.

Privacy and network security

The hub is here. So is the app.

Free on the App Store, for iPhone: the rooms, scenes, rules and assistant your hub runs, in one app.

Download gethome for iPhone on the App Store