README.md

---
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:
```json
{"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

```bash
pip install .
reachy-mini run notification_buddy
```