nabaztag

On boot the rabbit fetches its bytecode (/vl/bc.jsp) and a locate file (/vl/locate.jsp) that points it at our server, then opens an XMPP stream. Our server completes the handshake using the documented SASL success-bypass (no Violet password needed), keeps the rabbit idle, pushes violet:packet commands, and logs everything the rabbit sends. No OpenJabNab, no reverse proxy — one clean process.

What you can do from Home Assistant

Commands use the two violet:packet channels reverse-engineered from the bytecode — programs (MessagePacket) for the rich stuff, ambient (AmbientPacket) for the at-a-glance indicators:

• 🗣️ make it speak any text — built-in local TTS (/api/say, espeak-ng; no cloud, nothing to install)
• 🔊 play audio — stream any MP3 or WAV (e.g. a Piper TTS media URL); the rabbit fetches it over HTTP from the add-on
• 🎵 original Nabaztag jingles — the iconic Violet sounds (extracted from the firmware as MIDI, synthesized on the fly): acquired, ack, rfid_ok, …
• 👂 move the ears to precise positions (independent left / right) via a choreography
• 💡 RGB light shows on the 5 LEDs (bottom / left / middle / right / top)
• 🌦️ belly icons — weather (sun/cloudy/smog/rain/snow/storm), stock, e-mail, air quality   👃 nose blink   💤 sleep / wake
• 🎤 talk to it — hold the head button, ask a question; it transcribes (bundled whisper.cpp), asks a conversation agent (e.g. Claude), and speaks the reply — which can itself move the ears/LEDs
• 🐇 give it standing orders — "préviens-moi quand la batterie de l'aspirateur est pleine", "rappelle-moi de sortir le linge dans 40 minutes". Nabi remembers, watches the condition (or the clock) and pipes up on its own — then forgets the task. See Give Nabi standing orders.
• 📟 (v2) react to button presses, RFID/Ztamp tags and ears moved by hand — re-emitted as nabaztag_event Home Assistant events to trigger automations (Nabi as an input device)

Give Nabi standing orders

Beyond one-off questions, you can hand Nabi a deferred task in plain French and let it watch for you:

"Nabi, préviens-moi quand la batterie de l'aspirateur est pleine." "Rappelle-moi de sortir le linge dans 40 minutes." "Oublie tout."

Nabi remembers the order, Home Assistant watches the condition (a state threshold, an entity state, or the clock), and the rabbit announces it on its own in Violet's voice once it's met — then forgets the task (single shot, up to 5 at a time).

It works by exposing three scripts as tools to your Claude conversation agent (no add-on change): the spoken request already flows to that agent, which calls nabaztag_remember_task / nabaztag_remind / nabaztag_forget. A 1-minute engine in home-assistant/nabaztag_tasks.yaml evaluates the stored tasks and routes the announcement through script.nabaztag_notify (so quiet hours still apply unless the reminder is marked urgent).

Setup (once):

1. Drop home-assistant/nabaztag_tasks.yaml into /config/packages/ (it reuses proactive.yaml's script.nabaztag_notify — install that too).
2. Anthropic integration → enable "Control Home Assistant" (the LLM API).
3. Settings → Voice assistants → Expose the three nabaztag_* scripts and the entities Nabi should watch (vacuum, washer, weather…) so Claude knows their entity_id.
4. Reload YAML. Try it by voice, or test from Developer Tools → Actions.

Repository layout

.
├── repository.yaml          # declares this as an HA add-on repository
├── nabaztag-violet/         # ⭐ primary add-on — our own Violet-protocol server
│   ├── server.py            #    dependency-free Python (HTTP boot + XMPP + control API)
│   ├── config.yaml          #    options (server_address, log_level), ports, arch
│   ├── Dockerfile           #    installs python3, fetches the bytecode at build
│   ├── build.yaml
│   └── DOCS.md              #    install / pairing / API / status
├── nabaztag-server/         # OpenJabNab add-on (superseded — kept for reference)
│   └── …                    #    its HTTP listener is non-functional in the upstream image
│                            # (Le Terrier — the public warren at
│                            #  terrier.cyberloutre.fr — lives in a separate
│                            #  private repo; the live site is the showcase.)
├── firmware-arm/            # Naboot — custom ARM7 firmware (Phase 4/5). Forks
│   ├── apply-mods.py        #    RedoXyde/nabgcc wpa2 + Ed25519-gated httpflash +
│   ├── boot-mods/mdns.mtl   #    modernized config UI + boot-side mDNS announcer.
│   ├── crypto/              #    Build via ./build.sh --remote HOST --runtime
│   ├── pages/               #    {docker,podman} --mode {minimal|full|max|lean|…}.
│   ├── BRICK_FORENSICS.md   #    Recovery plan + bisection ladder.
│   └── RECOVERY.md
├── firmware/                # Runtime-side bytecode add-ons (mic stream, mDNS,
│   ├── micstream.mtl        #    OTA helper) compiled into the hybrid bootcode
│   ├── mdns.mtl             #    served by the add-on.
│   └── patch_main.py
├── home-assistant/
│   ├── nabaztag.yaml        # ready-to-paste HA package (rest_commands + scripts)
│   ├── ambient.yaml         # ambient automations (belly/ears/nose) over the REST API
│   ├── entities.yaml        # optional dashboard controls (sleep/nose/ears/belly) over REST
│   ├── proactive.yaml       # Nabi "alive" — proactive companion (quips, briefing, notify)
│   ├── nabaztag_tasks.yaml  # standing orders ("préviens-moi quand…") via Claude tools
│   └── rfid.yaml            # RFID tag → action (remembers last tag; dispatches known ones)
├── README.md
└── LICENSE

Quick start

1. In Home Assistant: Settings → Add-ons → Add-on Store → ⋮ → Repositories, add https://github.com/ClaraVnk/nabaztag.
2. Install Nabaztag Violet Server. In Configuration, set server_address to a hostname such as nabaztag.lan — not a raw IP: the bytecode resolves the XMPP server by DNS, so an IP literal fails. (bootcode option: ojn is the default and works.) Start the add-on.
3. Add a DNS record so the rabbit resolves that hostname to the HAOS host: nabaztag.lan → <haos-ip> (UniFi "Local DNS Records", AdGuard/Pi-hole rewrite…). Verify from any device: nslookup nabaztag.lan → <haos-ip>.
4. Point the rabbit at the server: hold its head while powering it (LEDs go blue), join its NabaztagXX Wi-Fi, open 192.168.0.1, set Violet Platform to http://<haos-ip>/vl (the IP is fine here — boot/locate don't need DNS), then update and start.
5. Watch the add-on log: serving bootcode → … → bound and idle — ready for commands. Optionally drop home-assistant/nabaztag.yaml into /config/packages/.

Rabbit on its own VLAN/subnet? Allow it through the firewall to the HAOS