# pollen-robotics/microduck

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/pollen-robotics-microduck).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

13,550 stars · 1,714 forks · Rust · Apache-2.0

## Links

- GitHub: https://github.com/pollen-robotics/microduck
- Homepage: https://pollen-robotics.com/microduck
- awesome-repositories: https://awesome-repositories.com/repository/pollen-robotics-microduck.md

## Description

Microduck is the software stack for a tiny two-legged, duck-shaped robot. It runs as a set of onboard background services that handle walking, sensing, sound and expressive animations, and it can be driven from a laptop, phone, gamepad or browser console. Walking comes from a trained reinforcement-learning policy, loaded as an ONNX model and evaluated in a fixed-rate control loop that commands every joint servo, with policies that can be swapped live for walking or rolling.

What sets it apart is how the robot is controlled and kept safe. Clients send high-level intents such as walking speed or gaze target, and a single control loop arbitrates between sources while enforcing joint, thermal and fall limits. Every device function is exposed through one JSON-RPC contract over local sockets and WebRTC, so apps, consoles, gamepads and scripts issue identical calls. Control, perception, Bluetooth, configuration and update services run as separate processes, so a stalled sensor or failed control loop does not block recovery. Bluetooth Low Energy lets a laptop or phone discover, configure and command the robot with no network at all. Signed over-the-air updates are verified, swapped in atomically, health-checked and rolled back automatically if the new release fails. A MuJoCo physics simulator runs the same robot daemons unchanged against a simulated body, alone or as a group of robots.

The wider surface covers gamepad driving with remappable controls and Bluetooth or NFC pairing, plus a browser console with WebRTC camera streaming and off-network access through a Hugging Face account. Behaviors include emotion animations, preset actions, object pickup, petting detection from microphone audio, a depth-sensor theremin and synchronized multi-robot singing. Command-line tools handle provisioning fresh boards, wifi and identity setup, configuration editing, health checks, log reading and live state monitoring. Build and release tooling covers cross-compilation for the board, containerized builds and packaged release artifacts.

## Tags

### Part of an Awesome List

- [Locomotion Policies](https://awesome-repositories.com/f/awesome-lists/ai/robotic-policy-learning/locomotion-policies.md) — Runs trained neural walking policies in a fixed-rate control loop, swaps policies live, and recovers from falls so a small biped walks and rolls.
- [Robotic Platforms](https://awesome-repositories.com/f/awesome-lists/devtools/robotic-platforms.md) — Provides a complete software platform for a tiny two-legged duck robot, with onboard daemons for walking, sensing, sound and expressive animations.
- [Unmodified Daemon Simulation Runtimes](https://awesome-repositories.com/f/awesome-lists/devtools/robotics-simulators/unmodified-daemon-simulation-runtimes.md) — Runs the real robot daemons unchanged against a physics-simulated body over a network socket, as one instance or several, so behavior is tested without hardware. ([source](https://github.com/pollen-robotics/microduck/blob/main/docs/README.md))
- [Sound Event Detection](https://awesome-repositories.com/f/awesome-lists/ai/sound-event-detection.md) — Classifies short windows of microphone audio with a tiny neural network to recognize head scratching, using hysteresis to avoid flickering detections. ([source](https://github.com/pollen-robotics/microduck/tree/main/pet-detect))
- [Robotic Physics and Sensor Simulators](https://awesome-repositories.com/f/awesome-lists/data/physics-and-simulation/robotic-physics-and-sensor-simulators.md) — Runs the robot's real daemons against a MuJoCo physics-simulated body with simulated depth and camera sensors, so behavior is testable without hardware.
- [Isolated Multi-Robot Simulations](https://awesome-repositories.com/f/awesome-lists/devtools/robotics-simulators/isolated-multi-robot-simulations.md) — Boots several simulated robots in one shared world, each in its own container with real service files, so updates and restarts behave like physical machines. ([source](https://github.com/pollen-robotics/microduck/blob/main/docs/robot/simulation.md))

### Artificial Intelligence & ML

- [Reinforcement Learning](https://awesome-repositories.com/f/artificial-intelligence-ml/reinforcement-learning.md) — Walks using a trained reinforcement-learning policy run as an ONNX model in a fixed-rate loop that commands every joint servo, with swappable walking and rolling policies.
- [Robotic Control Policies](https://awesome-repositories.com/f/artificial-intelligence-ml/robotic-control-policies.md) — Executes a trained reinforcement-learning policy in a fixed-rate control loop that commands every joint servo so the biped walks. ([source](https://github.com/pollen-robotics/microduck#readme))
- [Live Model Slot Swapping](https://awesome-repositories.com/f/artificial-intelligence-ml/live-model-slot-swapping.md) — Lists policy slots, loads a neural-network model into a slot live from a selectable source, persists slots across reboots and restores defaults. ([source](https://github.com/pollen-robotics/microduck/blob/main/docs/robot/duckctl.md))

### Hardware & IoT

- [Teleoperation Systems](https://awesome-repositories.com/f/hardware-iot/embedded-robotics/robotics-autonomous-systems/robotics-drones/robotic-tooling/teleoperation-systems.md) — Lets a small walking robot be driven from a gamepad, phone, laptop or browser console over network, Bluetooth or internet with safe commands.
- [Intent-Based Robot Control Arbitration](https://awesome-repositories.com/f/hardware-iot/intent-based-robot-control-arbitration.md) — Accepts high-level intents such as walking speed, gaze target or sit, and lets one control loop enforce joint, thermal and fall limits. ([source](https://github.com/pollen-robotics/microduck/blob/main/docs/design/architecture.md))
- [Over-the-Air Device Updates](https://awesome-repositories.com/f/hardware-iot/over-the-air-device-updates.md) — Installs signed releases on the robot board, health-checks them, and rolls back automatically or pushes development builds.
- [Robot Motion Daemons](https://awesome-repositories.com/f/hardware-iot/robot-motion-daemons.md) — Runs a central daemon that drives the biped duck's motion and exposes parameters and command-line tools for operating it. ([source](https://github.com/pollen-robotics/microduck#readme))
- [Bluetooth Connectivity](https://awesome-repositories.com/f/hardware-iot/bluetooth-connectivity.md) — Runs a Bluetooth daemon so nearby devices and phone apps can link to the robot to discover and command it without any network. ([source](https://github.com/pollen-robotics/microduck#readme))
- [Command-Line Bluetooth Robot Control](https://awesome-repositories.com/f/hardware-iot/bluetooth-connectivity/command-line-bluetooth-robot-control.md) — Sends commands from a laptop to the robot over Bluetooth Low Energy with a full subcommand set, without any network or remote shell. ([source](https://github.com/pollen-robotics/microduck/tree/main/docs))
- [Board Provisioning and Recovery](https://awesome-repositories.com/f/hardware-iot/board-provisioning-and-recovery.md) — Provisions fresh boards in one command, sets up wifi and identity, and ships rescue scripts for devices that fail to boot or lose their network.
- [Software-in-the-Loop Simulators](https://awesome-repositories.com/f/hardware-iot/embedded-robotics/hardware-in-the-loop-simulators/software-in-the-loop-simulators.md) — Runs the unmodified robot daemons against a physics-simulated body over a network socket so software is tested in containers without hardware.
- [Robot Emotion Animations](https://awesome-repositories.com/f/hardware-iot/robot-emotion-animations.md) — Plays named emotion animations combining head, body and beak motion with sound, with support for custom animation and audio files. ([source](https://github.com/pollen-robotics/microduck/blob/main/docs/robot/cheatsheet.md))

### Networking & Communication

- [JSON-RPC Interfaces](https://awesome-repositories.com/f/networking-communication/distributed-systems-p2p/distributed-computing/remote-procedure-call-frameworks/json-rpc-interfaces.md) — Exposes every device function through one line-delimited JSON-RPC contract over local sockets with push notifications, so apps, consoles, gamepads and scripts issue identical calls. ([source](https://github.com/pollen-robotics/microduck/blob/main/README.md))
- [JSON-RPC Implementations](https://awesome-repositories.com/f/networking-communication/json-rpc-implementations.md) — Exposes every device function through one line-delimited JSON-RPC contract over local sockets and WebRTC, so apps, consoles, gamepads and scripts issue identical calls.
- [Bluetooth LE Connectivity](https://awesome-repositories.com/f/networking-communication/bluetooth-connectivity/bluetooth-device-scanners/bluetooth-le-connectivity.md) — Carries commands and configuration over Bluetooth Low Energy so phones and laptops can control the robot with no network.
- [Off-Network Device Access](https://awesome-repositories.com/f/networking-communication/off-network-device-access.md) — Connects to a robot from beyond its LAN by authenticating with an online account and bridging through a rendezvous service. ([source](https://github.com/pollen-robotics/microduck/tree/main/docs))
- [Remote Video and Control Sessions](https://awesome-repositories.com/f/networking-communication/remote-video-and-control-sessions.md) — Carries camera, microphone, reliable control messages and low-latency input over one WebRTC session so a remote peer can drive and observe the robot. ([source](https://github.com/pollen-robotics/microduck/blob/main/docs/design/architecture.md))
- [WebRTC Streaming](https://awesome-repositories.com/f/networking-communication/webrtc-streaming.md) — Publishes the robot's camera and depth readings as encrypted H.264 video over WebRTC, with the control channel on the same session. ([source](https://github.com/pollen-robotics/microduck/blob/main/AGENTS.md))

### Software Engineering & Architecture

- [Fixed-Rate System Scheduling](https://awesome-repositories.com/f/software-engineering-architecture/constant-rate-request-schedulers/fixed-rate-system-scheduling.md) — Evaluates a trained walking policy at a constant rate in a control loop that commands every joint servo, with swappable policy slots.
- [Atomic Installation Swaps](https://awesome-repositories.com/f/software-engineering-architecture/atomic-installation-swaps.md) — Verifies a signed release directory, swaps it in whole, restarts services, health-checks, and restores the previous release automatically on failure.
- [Process Separation](https://awesome-repositories.com/f/software-engineering-architecture/process-separation.md) — Runs control, perception, Bluetooth, configuration and update services as independent processes so a stalled sensor or failed control loop never blocks recovery.
- [Robot Behavior Recoveries](https://awesome-repositories.com/f/software-engineering-architecture/robot-behavior-recoveries.md) — Detects when the robot has been knocked over and runs a stand-up routine so it returns upright without human help. ([source](https://github.com/pollen-robotics/microduck#readme))

### Development Tools & Productivity

- [Command Line Interfaces](https://awesome-repositories.com/f/development-tools-productivity/command-line-interfaces.md) — Offers cross-platform terminal commands to drive, configure and monitor the robot over a network or Bluetooth without a remote shell. ([source](https://github.com/pollen-robotics/microduck#readme))
- [Signed Atomic Updaters](https://awesome-repositories.com/f/development-tools-productivity/hot-code-reloading/desktop-hot-reloaders/signed-atomic-updaters.md) — Verifies signed releases, swaps them in atomically, restarts services, checks health, and reverts automatically if the new release is unhealthy. ([source](https://github.com/pollen-robotics/microduck/tree/main/docs))

### System Administration & Monitoring

- [Diagnostic Web Consoles](https://awesome-repositories.com/f/system-administration-monitoring/diagnostic-web-consoles.md) — Serves a web console from the robot that streams its camera, shows link and health stats, and drives it with on-screen pads or keys. ([source](https://github.com/pollen-robotics/microduck/blob/main/docs/robot/duckctl.md))
- [Gamepad Controls](https://awesome-repositories.com/f/system-administration-monitoring/hardware-control-interfaces/remote-control-interfaces/wireless-remote-controllers/gamepad-controls.md) — Translates gamepad input and forwarded Bluetooth commands into the same intents an app would send, without owning robot state. ([source](https://github.com/pollen-robotics/microduck/blob/main/docs/design/architecture.md))
- [Robot Telemetry Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/robot-telemetry-monitoring.md) — Shows a live terminal view of requested versus applied commands, joint angles, IMU gravity, fall status, loop rate, battery and temperatures, plus a posed 3D robot. ([source](https://github.com/pollen-robotics/microduck/blob/main/docs/robot/cheatsheet.md))

### Testing & Quality Assurance

- [Simulated Robot Testing](https://awesome-repositories.com/f/testing-quality-assurance/simulated-robot-testing.md) — Runs the unchanged robot daemons against a physics-simulated body, alone or as a group of robots, so behavior is testable without hardware.
