| | --- |
| | 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: |
| |
|
| | ```bash |
| | open index.html # macOS |
| | xdg-open index.html # Linux |
| | start index.html # Windows |
| | ``` |
| |
|
| | #### Option 2: Serve with Python |
| |
|
| | ```bash |
| | python server.py |
| | ``` |
| |
|
| | Then open http://localhost:7860 in your browser. |
| |
|
| | #### Option 3: Serve with any HTTP server |
| |
|
| | ```bash |
| | # 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 |
| |
|
