Repolode
pollen-robotics

pollen-robotics/microduck

Software open source en Rust para controlar un pequeño robot pato bípedo, con control de movimiento, gamepad, actualizaciones y transmisión de video desde la cámara.

Estrellas
9,611
Forks
1,248
Issues abiertos
43
Último commit
hace 18 horas

¿Qué es?

Microduck es la pila de software de un pequeño robot pato bípedo, de unos 25 cm de altura y 800 g. Funciona con un Rockchip RK3566 y está compuesto por varios daemons: robotd ejecuta un bucle de control a 50 Hz que controla quince servos mediante políticas de redes neuronales, mientras que otros daemons se encargan de la wifi y la identidad, Bluetooth, la entrada del gamepad, la transmisión de video de la cámara mediante WebRTC y un sensor de profundidad.

Las políticas de locomoción del robot se entrenan en un repositorio aparte, microduck_rl, que usa MuJoCo y PPO y exporta modelos ONNX que carga este repositorio. Las actualizaciones están firmadas y se someten a comprobaciones de estado; si el robot no arranca correctamente, se pueden revertir. Los daemons se comunican mediante un único contrato JSON-RPC a través de sockets Unix, por lo que la app, la consola, el gamepad y los scripts realizan las mismas llamadas.

Un simulador basado en MuJoCo permite a los desarrolladores ejecutar los daemons reales con un cuerpo simulado, sin hardware, y una guía rápida documenta la herramienta de línea de comandos del robot.

Funciones clave

  • 01Ejecuta un bucle de control a 50 Hz que controla quince servos mediante políticas de redes neuronales.
  • 02Carga políticas ONNX exportadas desde el proyecto de entrenamiento microduck_rl.
  • 03Permite controlar el robot con un gamepad y acceder a él por Bluetooth desde una laptop.
  • 04Transmite video de la cámara mediante WebRTC y lee los datos de un sensor de profundidad.
  • 05Actualizaciones de software firmadas, sujetas a comprobaciones de estado y con posibilidad de revertirlas.

Casos de uso

  • Crear o personalizar el software de control de un robot Microduck bípedo.
  • Experimentar con locomoción por aprendizaje por refuerzo de la simulación al mundo real en un robot pequeño con patas.
  • Probar código para robots en un simulador MuJoCo antes de ejecutarlo en el hardware.

Inicio rápido

  1. 1

    Leer la guía de simulación

  2. 2

    Ejecutar el pato simulado sin hardware

    scripts/duck-sim

Antes de usarlo

  • Se ejecuta en un robot específico con un Rockchip RK3566 y quince servos, por lo que la mayoría de las funciones requieren el pato físico.
  • Las políticas que carga se entrenan en un repositorio aparte, microduck_rl.

Temas

Preguntas frecuentes

¿Qué es microduck?
Software open source en Rust para controlar un pequeño robot pato bípedo, con control de movimiento, gamepad, actualizaciones y transmisión de video desde la cámara. Microduck es la pila de software de un pequeño robot pato bípedo, de unos 25 cm de altura y 800 g. Funciona con un Rockchip RK3566 y está compuesto por varios daemons: robotd ejecuta un bucle de control a 50 Hz que controla quince servos mediante políticas de redes neuronales, mientras que otros daemons se encargan de la wifi y la identidad, Bluetooth, la entrada del gamepad, la transmisión de video de la cámara mediante WebRTC y un sensor de profundidad.
¿microduck es gratuito? ¿Qué licencia tiene?
microduck es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿microduck sigue mantenido?
Mantenimiento activo. El último commit de microduck fue el 19 oct 2026.
¿Para qué puedo usar microduck?
Crear o personalizar el software de control de un robot Microduck bípedo. Experimentar con locomoción por aprendizaje por refuerzo de la simulación al mundo real en un robot pequeño con patas. Probar código para robots en un simulador MuJoCo antes de ejecutarlo en el hardware.
¿Cómo se instala microduck?
Leer la guía de simulación Ejecutar el pato simulado sin hardware: scripts/duck-sim
¿Dónde consigo microduck?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/pollen-robotics/microduck

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados