Open source · MIT licence

A voice assistant you can hold.

A round puck for the kitchen bench. Tap it and ask: it answers out loud, and it runs the house. The music, the TV, the lamps, the heating, even the PC. Build one yourself: the puck, the hub and its plugins are all on GitHub.

A day on the bench: one shot, from first light to lights out. With sound, and captions.

A day on the bench

Somebody talks to it all day. The house answers in light.

The film is one shot of one day. Nothing in the card house has any colour until it does something: yellow for music, blue-white for screens, a warm lamp, terracotta for the heating. Here is the day again, a moment at a time, with what was on the puck’s screen.

First light

It's an assistant first.

  • You What's the weather doing this afternoon?
  • Pucksley

    Clearing by two. Take a jacket till then.

Tap it and ask. It listens while you talk, notices when you stop, and answers out loud on its own speaker, with the web to hand when a question needs it. Nothing in the house has to be connected for that.

In the houseNothing happens in the house. It is still white, and the sun has just reached the bench.

First light on the kitchen bench: the white card house, a pot, a plant, a cup, and the black puck in front of the house.

Morning

It knows which room it's in.

  • You Play some jazz in the kitchen.
  • Pucksley

    Jazz, in the kitchen.

Every puck has a room, so music from the kitchen puck means the kitchen speaker. Then turn the puck itself, the whole of it, and the music turns up with it.

In the houseThe kitchen lights up yellow and notes rise from its speaker. When the puck is turned they grow, and so does the music.

The kitchen in the card house glows yellow, notes rising from it, and the puck shows two yellow bars.
The puck's volume face: 42, with a yellow arc most of the way round.

Midday

One room, then two.

  • You Group the kitchen with the ensuite.
  • Pucksley

    Done. Both rooms.

Sonos rooms can be grouped, moved and turned down by name, and Spotify plays anything on any speaker it can reach. The Home face shows what is playing in the puck's room: tap to pause, swipe for the next track.

In the houseThe ensuite upstairs lights yellow as well, and the music plays in both.

Two rooms of the card house glow yellow, the kitchen downstairs and the ensuite upstairs.
The puck's Home face: “Simply Joyful” by William Claeson, playing in the Kitchen.

Afternoon

Ten minutes. Starting now.

  • You Set a timer for pasta. Ten minutes.
  • Pucksley

    Ten minutes. Starting now.

  • Pucksley

    Your pasta's ready.

Timers, alarms and reminders, said out loud and counted down on the puck that set them. When one is done it chimes and says so, and the banner stays until you have seen it.

In the houseThe camera comes down to the puck and the real pot. By the time the pasta is ready, the television and the study’s screen have come on.

Down at the level of the bench: the puck in front of the house, the kitchen lit, the afternoon sun coming in from the side.
The puck's Timer face: 9:57 left on Pasta, a yellow ring almost full.

Sunset

The TV off. The lamp on.

  • You Turn off the downstairs TV.
  • Pucksley

    It's off.

  • You Lamp on.

Televisions, smart plugs and relays, and anything Home Assistant runs: on, off, or the input changed. The Controls face keeps the ones you use most a swipe away, as dials and buttons.

In the houseThe lounge’s blue goes out. After the sun has gone, a warm lamp comes on in its place.

After dark: the card house lit from inside, a warm lamp in the lounge and the television off.
The puck's Controls face: Lounge TV off, with a round Go button.The puck's Controls face: Lamp, with a round yellow On button.

Night

Half a degree warmer.

  • You Turn the heating up half a degree.
  • Pucksley

    Twenty-one and a half.

The heating too: up or down by half a degree, or one room at a time, through Home Assistant or a heating controller that has its own web API.

In the houseTerracotta spreads under every floor, a room at a time.

At night the card house glows: terracotta floors in every room, yellow where the music plays.
The puck's Controls face: House heating at 21.5 °C, with a terracotta arc.

Night

It asks first.

  • You Shut down the PC.
  • Pucksley

    Shut down the PC? Turn for yes.

Anything drastic waits for a yes on the puck itself: turn it to Yes, then tap. The Windows PC is one more thing it can run, from its volume and headphones to its apps and its power.

In the houseThe puck is turned, and tapped. The study’s screen goes dark.

The card house at night, the study upstairs on the right now dark.
The puck's Confirm face: “Shut down or restart this PC?”, with Yes picked in green.

Lights out

Everything off. Good night.

  • You Everything off. Good night.
  • Pucksley

    Good night.

One sentence for the whole house. The music stops and the rooms go out. The heating stays on, because nobody asked for that.

In the houseThe rooms go out one by one, and the music with them. Only the warm floors are left.

Lights out: the card house dark except for the terracotta glow of the heating, the puck quiet in front of it.

How it works

Tap, talk, turn.

The puck has a touch screen, but you hardly need it. The whole puck is the button, and the whole puck is the dial.

The puck on the kitchen bench, in the film, its screen showing two yellow bars.

Tap it, or pick it up, and talk

It listens until you stop, and shows your words as you say them. Talk over it to interrupt; after an answer it waits a moment for your reply.

The puck's volume face, at 42.

Turn it

Turn the puck itself: the volume while it talks or plays, Yes or No when it asks, minutes on a new timer.

The puck's Controls face: the Kitchen Sonos at 35%.

Swipe between faces

Home shows what is playing. Controls has the dials and switches you use most. The side button picks a face; hold it to switch off.

The puck's New timer face: 10 minutes, turn to set, tap to start.

Set things by hand

Turn to set the minutes, tap to start. Timers set on the puck work with no hub at all.

What it runs

One puck, the whole house.

Everything the puck can do comes from plugins on the hub. These come with it, and each card says where it does its work.

Your network

Sonos and Spotify

Rooms, volume, grouping, favourites, the TV input and a sleep timer. Spotify plays anything on any speaker it can reach, Sonos rooms included, and can tell you what that song was.

Your network

Televisions

Samsung, LG and Roku: off, on, louder, quieter, another input. Each one is paired once, from the hub’s page.

Your network

Plugs and relays

Shelly relays, TP-Link Kasa and Tapo plugs, or any address that switches something on: the lamp, the fan, the kettle.

Your network

Home Assistant

Anything Home Assistant already runs, its scenes and scripts included, and a way to ask it whatever the other plugins do not cover.

The internet

Heating

The house’s setpoint, or one room at a time, by half a degree, through Home Assistant or a heating controller with its own web API.

The hub

Weather, timers and lists

The forecast where you live, timers, alarms and reminders, the shopping list, and things to remember: “the bins go out on Tuesday nights”.

The PC

The Windows PC

Its volume and its headphones, what is playing, its apps and files, what is on its screen, and lock, sleep or shut down, after it asks.

The hub

Anything else

Custom actions that call a webhook or run a script without code, the tools of any MCP server, or a plugin of your own: a C# class with a few marked methods.

Where it thinks

A puck on the bench, a hub in the cupboard.

The puck listens, speaks and shows. The thinking happens on a hub at home, which asks Claude what you meant and then does it, on your own network.

  1. The puck

    On the bench

    Microphones, a speaker, a round screen. Joins your Wi‑Fi and finds the hub by itself.

  2. The hub

    On a NAS, or the PC

    Runs around the clock in Docker, or as a small app in the PC’s tray. Finds the speakers, TVs and plugs.

  3. Claude

    In the cloud

    Works out what you asked for and which tools will do it, and searches the web when it needs to.

No hub, still an assistant

If the hub is off, the puck still answers questions on its own, talking to Claude directly. The house waits until the hub is back.

Your choice of ears and voice

Hearing can run on the hub itself, or through a speech service. Answers come in the voice you pick; the puck’s own is Annette, an Australian voice.

Set up from your phone

A new puck opens its own Wi‑Fi network and shows a QR code. Give it yours, then approve it on the hub’s page with the three digits on its screen.

A puck in every room

Each puck has a name and a room, so “turn it down a bit” from the kitchen means the kitchen.

Build your own

One board, one hub, one key.

Everything Pucksley is, is on GitHub. A puck is a Waveshare board flashed with its firmware; the hub runs in Docker or on a Windows PC; Claude needs your Anthropic API key.

  1. Get the board

    A Waveshare ESP32-S3-Touch-AMOLED-1.75C: the round screen, the microphones, the speaker and the battery, all on one board.

  2. Run the hub

    On a NAS or a Linux box in Docker, or as a tray app on a Windows PC. Its page opens at port 8765.

    docker compose \n  -f hub/docker-compose.yml \n  up -d --build
  3. Flash the puck

    With ESP-IDF 5.5, over USB.

    cd firmware
    idf.py set-target esp32s3
    idf.py -p COM5 flash
  4. Join it up

    The puck opens its own Wi‑Fi network and shows a QR code. Give it yours, approve it on the hub’s page, and add your Anthropic key.

Questions

Where it is up to, and how it works.

Is it really open source?

Yes. The puck’s firmware, the hub and every plugin are on GitHub under the MIT licence, and so is this website. Build one, change it, and send what you make back if you like.

Can I buy one?

Not ready-made, yet. You can build one today: the puck is a Waveshare ESP32-S3 board with a round AMOLED screen, flashed with Pucksley’s firmware. We would like to make a ready-made one; leave your email at the bottom of this page and we will write once if we do.

What does it cost to run?

The software is free. Claude is paid for as you use it, with your own Anthropic API key. Cloud speech services charge for use too, unless you run Whisper and Piper on the hub instead.

Is it always listening?

No. It listens when you tap it or pick it up, and stops when you stop talking. After an answer it listens for a few seconds in case you reply, and then goes quiet by itself.

Does it need a computer?

To run the house it needs a hub at home: a NAS or other x86-64 machine that runs Docker, or a Windows PC with the Pucksley app in its tray. With no hub it still answers questions, on its own, over Wi‑Fi.

Which AI does it use?

Claude, made by Anthropic, with your own API key. The hub gives it the tools for your house, and it searches the web when a question needs it.

What leaves the house?

After a tap, what you say goes to your hub. It is turned into words there, by Whisper on the hub itself, or by the speech service you choose, and the words go to Claude. The answer is spoken by the voice you choose. The speakers, TVs and plugs are run on your own network.

What's inside the puck?

The Waveshare ESP32-S3-Touch-AMOLED-1.75C: a round 1.75-inch touch screen, microphones, a speaker, a motion sensor that knows when it is turned or picked up, a side button and a battery. A case of its own is still being designed: the puck in the film is a render.

Can I add my own things?

Yes. Custom actions call a webhook or run a script with no code at all, any MCP server’s tools become Pucksley’s, and a plugin is a C# class with a few marked methods, dropped into the hub’s plugins folder.

How can I help?

Build one and tell us what broke. Issues and pull requests are welcome on GitHub, for the puck, the hub and its plugins, and for this website.

Is the film real?

The house, the bench and the puck are computer-made, and the voices are computer voices. What is on the puck’s screen is its real faces. Every request in the film is one the hub handles today, and we are checking each one on a real puck, in a real house.

Rather have one ready-made?

We would like to make a finished puck, case and all. Leave your email and we will write once, if we do.

One email, if there is a ready-made puck. No newsletter. What we keep

You are on the list.

We will write once, if there is a ready-made puck.