README.md

metadata

title: Notification Buddy
emoji: 🔔
colorFrom: purple
colorTo: blue
sdk: static
pinned: false
short_description: Desktop notifications trigger robot reactions
tags:
  - reachy_mini
  - reachy_mini_python_app

Notification Buddy 🔔🤖

WebSocket server that receives notification events and makes the Reachy Mini robot react differently based on notification type.

Notification Types & Reactions

Type	Reaction
📧 email	Sideways glance
📅 calendar	Alert head-up + antenna perk
⚠️ system	Quick startle
💬 message	Friendly perk + nod
🔔 mention	Curious tilt
⏰ reminder	Double-take alert

Usage

The app starts a WebSocket server on ws://0.0.0.0:8765.

Send JSON messages:

{"type": "email", "priority": "normal"}
{"type": "calendar", "priority": "high"}
{"type": "system", "priority": "urgent"}

Priority scales the reaction intensity: low (0.5x), normal (1x), high (1.5x), urgent (2x).

Features

• Per-type cooldowns prevent reaction spam
• Priority-based intensity scaling
• Smooth keyframe interpolation
• Idle breathing when no notifications
• Queue system for multiple rapid notifications

Requirements

• websockets, numpy

Install & Run

pip install .
reachy-mini run notification_buddy