piumy@switchboard: ~/download
โ† piumy.app

Get Piumy running ๐Ÿฆ‰

It's free. Pay $0 and take everything โ€” it's open-source on GitHub. Two steps and it's live; a third if you want your AI to answer.

๐Ÿ”“ AGPL-3.0 ยท no account ยท no tracking ยท it's yours
1
Install

One command on your Raspberry Pi

On a Pi Zero 2 W with Raspberry Pi OS Lite, paste this. The installer does the rest โ€” display, services, anti-ban defaults โ€” and prints your MCP token once.

bash ยท on the Pi
$ git clone https://github.com/chamilonster/Piumy
$ cd Piumy && sudo ./deploy/install.sh
2
Link

Scan the QR with WhatsApp

When it's up, Piumy shows a QR (on the e-paper, or in the dashboard). On your phone: WhatsApp โ†’ Linked devices โ†’ Link a device, and scan it. Use a dedicated number, not your main one. That's it โ€” Piumy is live.

3
Optional

Let your AI answer โ€” MCP

Point your AI (Claude Code, OpenCode, any MCP client) at Piumy with the token the installer printed:

bash ยท in your AI's terminal
$ claude mcp add --transport http piumy \
    http://piumy.local:8081/mcp \
    --header "Authorization: Bearer <token>"

Prefer a config file? The .mcp.json snippet is in the README. There's also a ready-made Claude Code skill that teaches your agent the rules and a human pace.

No Raspberry Pi?

Try it on your laptop first

No board, no WhatsApp โ€” just watch the face render. The core writes status.json; the file adapter draws it.

bash
$ cd core && go run . responding
$ cd ../adapters/display/file
$ pip install -r requirements.txt && python render.py
More