Features
A gentle focus loop with personality
Designed for a desk setup: simple, playful, and obvious when you drift.
Phone + person detection
YOLO-based vision to spot your phone and understand context.
Expressive reactions
Movements + emotion make accountability feel like a companion, not a timer.
Home zone tracking
Define a "home" spot in front of the camera. Phone stays home? Focus vibes.
Web interface
Monitor and tune from your browser
Access Reachy's live status and tweak behavior for real-time feedback.
See what Reachy sees
- Live status of phone detection and current behavior state.
- Adjust behavior timings (how long before Reachy reacts).
- Toggle audio quips. While Reachy is cute, it can be distracting or can bother others
- Fine-tune detection confidence and processing intervals.
The web interface runs locally alongside the app—no cloud required.
Quick start
Install via the Reachy Mini Control App (Recommended)
Option A
Download the app & run
Recommended if you just want it working fast on Reachy Mini.
- Place your phone in front of Reachy (camera view).
- Launch it and let Reachy track the phone “home” zone.
Note: the first run may download YOLO weights automatically.
Option B (optional)
Clone & run with Python
Best for development and tweaking thresholds/behaviors.
git clone <YOUR_REPO_URL>
cd reachy_mini/reachy_phone_home
python reachy_phone_home_app.py
python reachy_phone_home_app.py --conf 0.15 --process-every 1
Option C (simulation)
Run without Reachy hardware
Test the app using simulation if you don't have a physical Reachy Mini.
Install the same way as Option A through the Reachy Mini Control app, but select Simulation mode instead of connecting to physical hardware.
Note: Simulation mode uses your webcam for phone detection, but Reachy's head movements won't change the camera POV—you'll miss the full "tracking" experience. Great for testing detection logic.