Open your hand.
The room responds.

Local gesture control for Home Assistant.

01 Vocabulary

Two shapes. Three commands. Nothing else to learn.

A handful of intentional shapes, chosen so they never trigger from regular hand movements around the room. Easy to remember, hard to fire by accident.

Open palm with fingers spread, the air_click gesture open_palm
Tap
air_click

Open the palm: the selected entity toggles. Example: a lamp turns on, a switch flips.

Hold
air_hold

Keep the palm open: the selected entity cycles through its preset values. Release to lock the one you want. Example: dim a light through its brightness levels.

L-shape with thumb and index finger, the l_select gesture l_shape
Cycle
l_select

Form an L with thumb and index: cycle through the entities you've assigned. Release to lock the selection. Example: pick which light in the room to control next.

Built for the way
you actually live.

From the couch, across the room, in the dark, with friends. The camera and the model are designed for real-room distances, not the close-up demos you see in product videos.

Open-palm gesture raising the window shutters in a living room
Open the shutters.
Gesture lighting up a home-office desk
Light up your workstation.
Gesture pausing the TV from the couch
Play and pause the TV.
Gesture detected at night through an infrared camera, low ambient light
Even in total darkness.
03 Computer vision

Vision that survives the living room.

Off-the-shelf hand-detection models are tuned for the conditions of public datasets: close range, good light. They fall apart the moment they meet a couch, a dimmer, or an infrared camera.

We use a proprietary training pipeline with data captured in real homes, specifically tuned for this use case. The result is small enough to run on low-resource hardware, with a Raspberry Pi 5 as the minimum.

Capability
Superhome custom for real rooms
Other off-the-shelf, e.g. MediaPipe
Range
9–10 m
1–1.5 m
Darkness
IR + low-light
Daylight only
Hardware
10 FPS on Raspberry Pi 5
30+ FPS on a stronger CPU, GPU or NPU
Too heavy for low-power SBCs
Training
Real homes, proprietary pipeline
Generic web datasets
The stack

Runs locally, on what you have.

Mini-PC, x86 desktop, ARM board, Raspberry Pi. If it runs Linux or Windows with Docker, or Home Assistant OS, Superhome runs on it. CPU-only inference, no GPU, no external service.

Camera
Any RTSP source. IP cam, NVR, USB webcam. IR or visible.
Tested and recommended: TP-Link Tapo C210 (2K).
rtsp://192.168.1.42/stream0
Cluster · multi-camera
One master app coordinates optional worker nodes, so a single Home Assistant controls cameras in different rooms with one license.
Integration
HAOS app or Docker on your LAN. Pairs with Home Assistant out of the box.
Local-first

Camera, model, and Home Assistant all run on your network. Nothing leaves the house.

  • · No outbound video
  • · No cloud account required
  • · Works offline
Companion

An ambient screen,
nothing to install.

A small ESP32-S3 display that shows what Superhome sees, in real time. It subscribes to HA sensors over the native API, so feedback lands in 20–40 ms. Optional. Bring your own panel.

JC3248W535C_I GUITION on AliExpress
Optional · ESP32-S3 · 3.5"
01 02 03 04
hand detected cycling entity
05 Setup

From clone to first gesture in three steps.

  1. 01

    Install

    Add the Superhome app repository to your Home Assistant Supervisor in one click.

  2. 02

    Activate

    Sign up to get a free beta license. The app installs everything it needs on first run, with no manual setup.

  3. 03

    Configure

    Paste your license key and the RTSP URL of any camera you trust into the app's Options tab. Pick the lights and switches you want to control, save, and you're done.

    • License key
    • RTSP camera stream
    • Entities to control
06 Plans

Beta is open. The rest activates as the product matures.

Available now

Beta

Free · during beta

Everything Superhome ships today, at no cost while we polish the product.

  • Full gesture set
  • 1 camera, 1 device activation
  • All HA entity types
  • IR & low-light support
  • ESP32 display support
  • Community support
After beta

Free

0€ · forever, limited

The permanent free tier that takes over when beta ends. Reduced scope, no expiry.

  • Core gesture set
  • 1 camera, 1 device
  • Basic HA entity types
  • Community support
Notify on release
After beta

Pro

TBD · price TBD

For households and tinkerers running multiple cameras and devices.

  • Full gesture set
  • Multiple cameras, multiple devices
  • Priority support
  • Commercial use
Notify on release
07 FAQ

Questions, answered.

Does Superhome work without the cloud?

Yes. Superhome runs entirely on your local network: the camera, the computer-vision models, and Home Assistant all stay in your home, and no video ever leaves the house. The only thing online is a free account to obtain your license.

What hardware do I need?

Any RTSP camera works (IP cam, NVR, or USB webcam, infrared or visible); we recommend a Tapo C210 (2K) or at least a 1080p/HD camera for reliable detection. You also need a machine that runs Home Assistant OS or Docker. A Raspberry Pi 5 is the minimum; inference is CPU-only, so no GPU is needed.

Does it work in the dark?

Yes. The models are trained for infrared and low-light conditions, so gestures are recognised even in total darkness, unlike off-the-shelf models.

How far from the camera can I stand?

Superhome reliably detects gestures at 9–10 metres, designed for real-room distances like across a living room, where off-the-shelf hand-tracking models stop working at about 1–1.5 metres.

How much does Superhome cost?

Superhome is free during the public beta, with the full gesture set, infrared and low-light support, and one camera per device. A permanent free tier and a paid Pro plan for multi-camera setups arrive after beta.

Which gestures does it recognise?

Two shapes drive three commands: an open palm taps to toggle (air_click) or holds to cycle through values, for example brightness levels (air_hold), and an L-shape with thumb and index selects which entity to control (l_select).

Does it integrate with Home Assistant?

Yes. Superhome installs as a Home Assistant OS add-on or a Docker container on your LAN and pairs with Home Assistant out of the box, driving any entity type: lights, switches, covers and more.