andito's picture
andito HF Staff
Update README.md
3badbb0 verified

A newer version of the Gradio SDK is available: 6.8.0

Upgrade
metadata
title: Reachy Mini Remote Control (Multi-User)
emoji: 🤖
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 5.49.1
app_file: app.py
pinned: false
license: apache-2.0
short_description: Remote control for Reachy Mini robots with authentication
hf_oauth: true
hf_oauth_expiration_minutes: 480

Multi-User Remote Control for Reachy Mini

This Space provides a centralized remote control server for Reachy Mini robots with HuggingFace OAuth authentication. Multiple users can connect their own robots and control them securely.

Features

  • Multi-user support: Each user can connect their own robot
  • Secure authentication: Uses HuggingFace OAuth tokens
  • Real-time video streaming: Live camera feed from your robot
  • Bidirectional audio: Talk to and hear from your robot
  • Robot state monitoring: View joint positions and status

How to Use

1. For Robot Owners

Set up your robot to connect to this Space:

# Set your HuggingFace token
export HF_TOKEN=hf_your_token_here

# Configure the robot app to point to this Space
# Edit your profile config to set:
# WEBSOCKET_URI=wss://YOUR-SPACE-NAME.hf.space

# Start the remote control app
python -m reachy_mini_remote_control_app

2. For Browser Users

  1. Visit this Space and click "Sign in with Hugging Face"
  2. Authorize the application
  3. Once authenticated, you'll see your robot if it's connected
  4. Control your robot through the web interface

Security

  • Each user can only see and control their own robots
  • Authentication is required for all connections
  • Tokens are validated with HuggingFace API
  • User sessions are isolated from each other

Requirements

Your robot must:

  • Be running the reachy_mini_remote_control_app
  • Have your HuggingFace token configured (HF_TOKEN environment variable)
  • Be configured to connect to this Space's WebSocket URL

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference