Pular para o conteúdo principal

Simulação do Reachy Mini - Guia de Configuração

Você não precisa de um robô físico para começar a construir! A simulação do Reachy Mini roda em MuJoCo e fornece um ambiente de física realista para prototipar, testar e depurar suas aplicações.

Simulation

1. Instalação​

Pré-requisitos

Antes de configurar a simulação, você deve primeiro concluir a instalação básica e a configuração do ambiente virtual seguindo o Guia de Instalação. Este guia assume que você já tem o Reachy Mini SDK instalado e o seu ambiente virtual ativado.

A simulação exige os bindings Python do mujoco. Você pode instalá-los junto com o software do Reachy Mini usando a tag extra [mujoco].

Com pip
pip install "reachy-mini[mujoco]"
Com uv
uv pip install "reachy-mini[mujoco]"

2. Executando a Simulação​

Para iniciar o robô simulado, basta executar o comando do daemon com a flag --sim:

Iniciar simulação
reachy-mini-daemon --sim

Uma janela deve abrir exibindo a visualização 3D do robô. Você pode interagir com a visualização usando o mouse (arraste para girar, clique direito para mover, rolagem para aproximar/afastar o zoom).

🍎 Usuários Mac (Apple Silicon / Intel)​

Específico para macOS

No macOS, o MuJoCo requer um launcher específico para funcionar corretamente com a interface gráfica. Em vez do comando acima, use mjpython:

mjpython -m reachy_mini.daemon.app.main --sim
Usuários macOS

uv pode ter problemas de compatibilidade com o MuJoCo no macOS. Se você encontrar problemas de instalação ou de execução, é recomendado usar pip diretamente em vez de uv para pacotes relacionados ao MuJoCo.

3. Dashboard e Apps​

info

Você pode acessar o Dashboard em http://localhost:8000.

  • Apps: Você pode instalar e executar Apps! Eles serão executados dentro da simulação (por exemplo, o robô se moverá no visualizador 3D).

4. Cenas e Opções​

Personalização

Você pode personalizar o ambiente de simulação usando o argumento --scene.

  • empty (padrão): Apenas o robô no vazio.
  • minimal: Adiciona uma mesa e alguns objetos (maçã, croissant, pato) para brincar.
Exemplo
reachy-mini-daemon --sim --scene minimal

5. Conectando o seu Código​

Depois que a simulação estiver em execução, ela se comporta exatamente como um Reachy Mini Lite real conectado via USB. O daemon escuta em localhost, e você pode executar qualquer script Python do SDK sem modificações:

from reachy_mini import ReachyMini
from reachy_mini.utils import create_head_pose

# Connects to the simulation running on localhost
with ReachyMini() as mini:
    print("Connected to simulation!")

    # Look up and tilt head
    print("Moving head...")
    mini.goto_target(
        head=create_head_pose(z=20, roll=10, mm=True, degrees=True),
        duration=1.0
    )

    # Wiggle antennas
    print("Wiggling antennas...")
    mini.goto_target(antennas=[0.6, -0.6], duration=0.3)
    mini.goto_target(antennas=[-0.6, 0.6], duration=0.3)

    # Reset to rest position
    mini.goto_target(
        head=create_head_pose(),
        antennas=[0, 0],
        duration=1.0
    )

Próximos Passos​

Continue aprendendo
  • Python SDK: Aprenda a mover, ver, falar e ouvir.
  • AI Integrations: Conecte LLMs, crie Apps e publique na Hugging Face.
  • Core Concepts: Arquitetura, sistemas de coordenadas e limites de segurança.

❓ Solução de Problemas​

Encontrou algum problema? 👉 Confira o Guia de Solução de Problemas e FAQ

Loading Comments...