README.md

metadata

title: Reachy Mini Simple Control Panel
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: static
pinned: false

Reachy Mini Simple Control Panel

A lightweight, static HTML/JS control panel for Reachy Mini robot using WebSockets for real-time control.

Features

• Real-time WebSocket Control: Instant response using WebSocket streaming
• Task Space Control: Real-time head pose control (X, Y, Z, Roll, Pitch, Yaw)
• Body & Antennas: Control body yaw and antenna positions
• Auto-reconnect: Automatically reconnects if connection is lost
• No Dependencies: Pure HTML/CSS/JavaScript
• 100% Client-Side: No backend needed, runs entirely in the browser

How to Use

On HuggingFace Spaces

Just open the Space - the app will automatically try to connect to your local robot at localhost:8000.

Requirements:

• Reachy Mini daemon running on localhost:8000 on your local machine
• Modern web browser with WebSocket support

Local Testing

Option 1: Open Directly (Simplest)

Just open index.html in your web browser:

open index.html  # macOS
xdg-open index.html  # Linux
start index.html  # Windows

Option 2: Serve with Python

python server.py

Then open http://localhost:7860 in your browser.

Option 3: Serve with any HTTP server

# Using Python 3
python3 -m http.server 7860

# Using Node.js
npx http-server -p 7860

# Using PHP
php -S localhost:7860

Requirements

• Reachy Mini daemon running on localhost:8000
• Modern web browser with WebSocket support

Architecture

This app uses:

• WebSocket (ws://localhost:8000/api/move/ws/set_target) for real-time pose streaming
• Pure client-side JavaScript (no backend needed)
• Automatic reconnection if connection is lost

Note: Due to browser security (Mixed Content policy), the WebSocket connection from HuggingFace Spaces (HTTPS) to localhost (HTTP) may be blocked. For best results, run the app locally.

Technical Details

• Slider Updates: Use input event for real-time updates
• Auto-reconnect: WebSocket reconnects every 2 seconds if disconnected
• State Management: Client-side state tracking prevents feedback loops
• Error Handling: Graceful error messages and automatic recovery
• No Backend: Fully static - runs entirely in the browser