microduck_rl
microduck_rl explicado: entornos de RL para Microduck
Simulador mjlab, bucle de entrenamiento y límites sim-to-real.

Qué aprenderás
- Map environment, simulator, and runner
- Run a reproducible simulation
- Identify sim-to-real gates
Antes de empezar
- Basic Git and command-line usage
- Comfort reading a project README
You can explain the project, run its documented first step, and decide what to verify before adopting it.
Conclusiones clave
- microduck_rl exposes an RL/simulation loop for Microduck.
- Reward and termination define the task and must be versioned.
- Hardware transfer is a separate safety gate.
The short answer
microduck_rl ofrece entornos de reinforcement learning para Microduck sobre mjlab; el éxito en simulación no sustituye la validación de sensores, actuadores y seguridad física.
The repository is most useful as a reproducible experiment surface: environment definitions, simulator settings, reward terms, seeds, and policy checkpoints can be inspected together. That makes it easier to teach the difference between a benchmark result and a control policy that is ready for hardware.
Start reproducibly
Pin the repository, simulator, CUDA/PyTorch stack, and seed. Run the smallest environment or evaluation script first, inspect observation/action shapes and reward terms, and save configuration, checkpoints, telemetry, and videos. Compare wall-clock cost only when parallel environments, physics steps, and rollout length match.
Architecture and deployment boundary
Inspect the environment adapter, mjlab physics loop, and RL runner separately. Keep reward shaping and termination explicit. A fourth deployment boundary covers policy export, control frequency, actuator limits, sensor dropout, watchdogs, and emergency stop; these must be tested before hardware.
When it fits
Use it to learn robot RL and prototype policies in simulation. Do not transfer a checkpoint directly to a robot without qualified operator review and sim-to-real validation under disturbances and saturation.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Pin environment and seed.
- 2
Run a small evaluation episode.
- 3
Train with bounded parallelism.
- 4
Validate sim-to-real constraints before hardware.
Ejemplo para copiar
git clone https://github.com/pollen-robotics/microduck_rl.git
cd microduck_rl
# Follow the pinned environment instructionsPreguntas frecuentes
Can I send the checkpoint directly to a robot?
No. Export, timing, actuator, sensor, watchdog, and operator checks are required.
What makes runs comparable?
Use the same revision, config, seed, simulator, rollout, and evaluation protocol.
Fuentes
- microduck_rl repositoryFuente verificada 2026-08-31