Skip to content
CAI
Software that uses CAICheck a score

pollen-robotics/microduck

57.2

Adequate · 14 November 2026

159.3k

lines of production code

Rust

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add systemd unit and user configuration for the BLE transport daemon (btd)

Introduces the systemd service file and system user configuration for btd, the new BLE front-door daemon that exposes the robot API over Bluetooth. The service runs as an unprivileged user (btd) with strict security hardening (NoNewPrivileges, ProtectSystem=strict, restricted address families) to safely parse incoming radio bytes, while ensuring it starts independently of robotd or updaterd to support recovery scenarios. It relies on bluetoothd for D-Bus communication and uses a retry loop to handle late hardware initialization on specific boards like the Radxa.

btd/systemd · high confidence

Duck chorale: multi-duck singing with score-based synchronization and MIDI import

The sounds module now supports a 'chorale' mode where multiple ducks sing together in harmony. This introduces a text-based score format (.duckscore) for defining musical pieces, a MIDI importer to convert standard notation files into duck arrangements, and a BLE-based synchronization system that uses a 'conductor' beacon to keep the ensemble in time without requiring a shared clock. The system handles voice casting (Bass, Tenor, Alto, Soprano) based on each duck's unique personality and pitch range, allowing for realistic multi-voice performances.

sounds · high confidence

Introduce \`duckctl\` as a laptop-based robot control tool

A new \duckctl\ binary is added to provide a command-line interface for controlling robots from a developer machine, serving as a stand-in for the phone app and enabling testing of the \btd\ service over Bluetooth. The tool supports scanning for robots, managing Wi-Fi connections, renaming devices, executing RPC calls (such as \robot.health\), viewing logs, and performing firmware updates. It also includes a \udp-pad\ subcommand that maps a local gamepad to robot controls via UDP, featuring a live status panel, connection handling, and Y-axis inversion options for macOS. The implementation uses \btleplug\ for cross-platform Bluetooth support (macOS, Linux, Windows) and shares framing logic with the robot's \duck\_ble\ crate to ensure protocol correctness. Also in this area: 8 commits (0 fixes) modifying duckctl; 1 commit (0 fixes) modifying (repo-wide); Local audio playback and mute control for the UDP gamepad.

duckctl/src · low confidence · unverified

Introduce duck-control crate with hardware abstraction and fall prediction

The \duck-control\ crate provides the core robot control logic, including a \DynamixelIo\ bus implementation that uses fast sync reads to efficiently fetch IMU and servo data, a \FallPredictor\ that anticipates falls using IMU gravity derivatives to trigger limp-fall mode early, and an \Observation\ builder that constructs the 61-D state vector for ONNX policies. It also includes a \policy-rehearsal\ example for offline inference benchmarking and a \FakeIo\ implementation for testing without hardware. Also in this area: Fall detection now requires the robot to be standing before triggering; Pickup detection and safe shutdown pose; Corrects knee homing offset during robot adoption.

duck-control · high confidence

Introduce netpadd daemon for driving the robot via UDP gamepad

A new \netpadd\ daemon is added to allow driving the robot using gamepad state sent over UDP, sharing the same mapping logic as the local \padd\ tool. The daemon binds to a configurable UDP port, receives 28-byte datagrams, and applies a state machine to handle client presence, staleness, and timeouts—stopping the robot if the client goes silent and releasing the session if the client disconnects. It communicates with the \robotd\ backend via Unix sockets to send driving intents and to fetch the robot's health and posture status, which is then reported back to the driving client. The implementation uses a single-threaded Tokio runtime to ensure deterministic, low-latency processing of incoming packets.

netpadd/src · high confidence

Introduce padd as a dedicated, unprivileged systemd service for gamepad control

The gamepad daemon (padd) is now installed as a persistent systemd unit that starts at boot and runs under a dedicated, unprivileged system user. This replaces the previous requirement for manual SSH access and group membership changes, allowing the robot to automatically detect and pair with a gamepad via \robotctl pad pair\. The service includes hardening measures (strict system protection, no new privileges) and specific ordering to ensure it waits for Bluetooth and robotd availability, while standing down if a network pad (netpadd) is enabled.

padd/systemd · high confidence

Introduce pet-detect: on-device audio classifier for head-scratch detection

Adds a new pet-detect crate that enables the robot to detect when its head is being scratched using an onboard microphone. The crate includes a streaming PettingDetector library with hysteresis, a live binary (pet-detect) that reads raw PCM from stdin and outputs petting probability and state, and a feature-extraction binary (pet-features) to ensure training and inference use identical log-mel processing. A background worker (worker.rs) manages the arecord subprocess, implements an ambient sound sentry to gate inference and detect noise/voice events, and emits PettingEvent::Start/End. The system ships with a \~20 KB ONNX CNN model and a Python training script (training/train.py) that uses the Rust feature extractor to maintain train/infer parity.

pet-detect · high confidence

Introduce the microduck policy playground Space

Adds a new Hugging Face Space that lets users sign in with their Hugging Face account, select their robot duck, and install or run policy tricks. The Space is deployed as a Docker container that serves a self-contained HTML page, injecting OAuth credentials at runtime to enable secure sign-in without exposing secrets.

spaces/policy-playground · high confidence

Introduces duck-ether, a configurable simulated radio for testing duck chorale behavior

Adds a new \duck-ether\ tool that replaces the previous \btd\ radio implementation to simulate wireless beacon propagation between simulated ducks. This tool allows testers to configure radio range, simulate discovery delays and packet loss, and rotate duck addresses to reproduce real-world hardware conditions like split-brain scenarios and address changes, ensuring the chorale election logic is tested against imperfect network conditions rather than ideal ones.

duck-ether · high confidence

Introducing shareable microduck vet book cards

A new Hugging Face Space has been added to generate and serve shareable visual cards from microduck vet book data. The application renders HTML templates into PNG images using Playwright and headless Chromium, supporting eight distinct card designs (notebook, purikura, profile, receipt, passport, gameboy, polaroid, and FIFA Ultimate Team) along with seasonal themes. It exposes endpoints for 1200×630 cards and 1080×1920 stories, pulling data from public Hugging Face datasets and caching rendered images to ensure consistent, high-quality social media previews.

spaces/vetbook · high confidence

Introduction of netpadd service for network-based gamepad control

A new systemd service unit (netpadd.service) and system user configuration (netpadd.conf) have been added to support a UDP-based gamepad intent client. This service runs under a dedicated 'netpadd' user with strict security restrictions (no new privileges, protected system/home, restricted address families) and requires the 'robot' group to access the robotd socket. It is designed to run exclusively when the '\[netpad\] enabled' condition is met, ensuring it does not conflict with the existing Bluetooth-based 'padd' service, which takes precedence if both are present.

netpadd/systemd · high confidence

New BLE transport daemon (btd) for robot control

Introduces the \btd\ daemon, which serves as the Bluetooth Low Energy front door to the robot's API. It exposes a GATT service that transports JSON-RPC requests and responses, allowing a phone or laptop to control the robot, trigger updates, and configure Wi-Fi. The implementation includes a chorale beacon for multi-robot synchronization, a just-works pairing flow with a PIN-based authentication check, and specific tuning for advertising intervals and notification backpressure to ensure reliable communication on the target hardware.

btd/src · high confidence

New \`advwatch\` diagnostic tool for continuous Bluetooth advertisement monitoring

Added the \advwatch\ example tool, which continuously monitors Bluetooth advertisements for a specified robot over a two-minute window to diagnose connectivity issues. Unlike the standard \duckctl scan\ which uses a short window, \advwatch\ tracks arrival patterns and signal strength for all devices in range, allowing users to distinguish between a non-advertising robot, a robot advertising too slowly, and client-side faults. It also specifically measures the time delay between the first advertisement sighting and the receipt of the scan response containing the robot's name, helping to identify issues with name resolution or cached data.

duckctl/examples · high confidence

New development and simulation tooling for local robot iteration

Added scripts to streamline local development and simulation workflows. \dev-push.sh\ and \dev-build.Dockerfile\ enable building and deploying daemon updates directly from a laptop to a board, supporting both cross-compilation and native Docker-based builds to simplify the development loop. \bake-duck-mesh.py\ introduces a tool to optimize the robot's 3D visual model for terminal-based monitoring. Additionally, \migrate-network.sh\ automates the transition from netplan to NetworkManager for improved Wi-Fi management, and \pad-link-test.sh\ provides diagnostics to measure Bluetooth link reliability and latency between the gamepad and the robot.

scripts · high confidence

New duck-detect library and benchmarking tool for NPU-based detection

The \duck-detect\ crate now provides the core logic for detecting other Microducks using a quantized INT8 model on Rockchip NPUs, including a letterbox preprocessor, an ONNX Runtime fallback for CPU-only boards, and a Rust binding to the Rockchip NPU runtime (\librknnrt.so\) via dynamic loading. A new \duck-bench\ binary allows users to validate detector functionality, measure inference latency and CPU cost, and verify detection accuracy against a directory of JPEG frames without interfering with the live camera daemon.

duck-detect · high confidence

New head ToF sensor daemon with integrated head IMU support

The \tofd\ daemon is introduced to manage the head Time-of-Flight (ToF) sensor (VL53L5CX or VL53L8CX) and the head IMU (BMI088). This change adds a dedicated Linux-only driver that vendors ST's Ultra Lite Drivers, automatically detecting the sensor generation at runtime and publishing 8x8 depth frames. Additionally, the daemon now reads the BMI088 IMU, fusing the data to provide orientation, and exposes both streams via a Unix socket. The IMU functionality is controlled by a new \\[head\_imu\]\ configuration section in \robotd.toml\, which defaults to disabled to ensure backward compatibility and safe operation on boards without the sensor fitted.

tof · high confidence

New kinematics module with MJCF-driven forward kinematics and ToF sensor processing

The kinematics subsystem has been rewritten to parse the robot's MJCF model (robot\_walk.xml) at startup, compiling joint names and site chains for efficient, allocation-free forward kinematics queries in the control loop. This new module introduces a robust hand-tracking algorithm for the ToF sensor that uses configurable status bytes and a hold timer to stabilize distance readings for the Theremin instrument, replacing previous unstable background-subtraction approaches. It also provides head-chain forward kinematics with proper frame transformations (MJCF to cv2 and sensor frames), gaze inverse kinematics for aiming the camera, and ToF reprojection logic that filters floor returns and near-field noise using the robot's posture and IMU data.

kinematics · high confidence

New live UDP pad view in duckctl

Added a new \duckctl udp-pad\ command that provides a real-time monitoring interface for gamepad input and robot status. The tool displays connection state (Driving, Busy, Refused, Silent), round-trip latency, packet loss, and current gamepad button/axis values. It also shows robot health diagnostics including battery level, motor bus errors, IMU status, and posture (fallen/limp), rendering these details in a terminal UI or as periodic summary lines depending on the output destination.

_duckctl/src/udp\pad · high confidence

New pad-imu crate for gamepad IMU orientation tracking

Added a new \pad-imu\ library that processes raw inertial measurement unit (IMU) data from gamepads (such as Switch Pro Controller clones) into stable orientation quaternions. The implementation uses a complementary filter to integrate gyroscopic data while correcting pitch and roll using accelerometer gravity readings, and includes automatic gyro bias calibration during periods of stillness to prevent yaw drift. This module provides the core attitude computation used by \padd\ to pose robot heads and \robotctl monitor\ to visualize pad tilting.

pad-imu · high confidence

New pad-map library for unified controller mapping and intent generation

The \pad-map\ crate has been introduced as a shared library to centralize the logic for interpreting gamepad inputs into robot intents, allowing both the local \padd\ daemon and the new \netpadd\ UDP daemon to use the exact same mapping without drift. This library handles the full controller state—including stick axes, button presses, and IMU attitude—by reading configuration from \robotd.toml\ (sections like \\[pad\]\, \\[pad\_axes\]\, \\[pad\_head\]\) and applying command-line overrides for parameters like deadzone and max head travel. It implements specific behaviors such as a heartbeat mechanism to prevent deadman timeouts when the robot is stationary, hold-detection for Start/Select buttons (e.g., long press to home or power off), and a loss-detection state machine that sits the robot down if the pad disconnects. Additionally, it defines the 28-byte UDP wire format (\wire.rs\) used by \netpadd\ to transmit pad state over the network. Also in this area: 4 commits (1 fix) modifying pad-map; 2 commits (0 fixes) modifying pad-map, padd; 1 commit (0 fixes) modifying (repo-wide); Local audio playback and mute control for the UDP gamepad.

pad-map · low confidence · unverified

New padd daemon for gamepad-driven robot control and raw input monitoring

This change introduces the \padd\ daemon, a standalone process that reads gamepad input and translates it into robot intents via the \robotd\ socket, ensuring the intent API is exercised daily to prevent rot. It implements a specific button mapping where face buttons trigger skills, the D-pad selects movement modes (head-only, head+move, move, body+head), and long-presses on Start or Select handle safety actions like homing, rebooting servos, or powering off. The daemon also exposes a raw input tap socket (\tap.rs\) that streams unfiltered evdev events and IMU data for debugging and monitoring, allowing tools like \robotctl monitor\ to see the actual radio cadence and stick values without the filtering applied by the driving path.

padd/src · high confidence

New robot health cards and inbound video streaming

Users can now generate shareable 'vetbook' cards that display a robot's health status, activity stats, badges, and fun facts derived from its operational data. Additionally, the vision demo now supports an inbound streaming model where robots push video frames directly to a Space endpoint, improving reliability for home-networked robots by avoiding WebRTC relay constraints.

python · high confidence

New robotctl monitor blocks for camera, 3D robot view, and pad IMU

The \robotctl monitor\ command now includes several new visual blocks: a live camera feed (toggled with \c\) that requests frames on-demand from \mediad\ to minimize overhead, a 3D wireframe view of the robot's kinematic pose rendered in terminal cells, and a wireframe representation of the pad's orientation based on its IMU data. Additionally, a new \robotctl frame\ command allows exporting a single camera snapshot to disk, and \robotctl configure\ now provides a structured, interactive editor for \robotd.toml\ that intelligently suggests whether changes require a restart, reload, or apply live.

robotctl/src · high confidence

New test-support fixtures for minting signed releases and systemd environments

The test-support module now includes dedicated examples to generate test fixtures: \fake-release\ creates signed release trees without systemd units for driving the updater engine logic, while \systemd-fixture\ generates releases containing real systemd units (including stand-ins for robotd and btd) to verify restart and recovery machinery. These tools allow manual and automated tests to exercise end-to-end update scenarios, including rollback on bad hooks, broken units, and user-account provisioning, using the same signing and packaging logic as the production engine.

test-support · high confidence

Remote console sign-in via Hugging Face Space

The mediad webclient now supports remote access through a Hugging Face Space, enabling users to sign in with Hugging Face OAuth to drive a robot outside their local network. This change introduces a Docker-based Space deployment (including a Dockerfile, entrypoint script, and README) that injects OAuth credentials into the console page, allowing the browser to authenticate with the rendezvous service. The console page itself has been updated with a proper HTML structure to support this injection, fixes for alert visibility and layout wrapping, and CSS for rotating the video feed to match the camera's physical orientation.

mediad/webclient · high confidence

Robotd daemon now implements full 50 Hz control loop, health monitoring, and audio features

The robotd daemon has moved from a skeleton health-checker to a fully functional control system. It now runs a 50 Hz control loop that processes sensor data, executes ONNX policies for walking and balancing, and manages one-shot skills like ground-picking and sitting. Health reporting has been upgraded to verify the loop meets its timing deadlines, enabling safe auto-rollback during updates. The daemon also introduces new audio capabilities, including a ToF-based theremin that converts hand distance into pitch, a multi-robot 'chorale' for synchronized singing, and a sound system for voice and effects. Additionally, it now monitors board temperature and CPU throttling to provide comprehensive hardware health status. Also in this area: 5 commits (0 fixes) modifying robotd; 1 commit (0 fixes) modifying (repo-wide); Fall detection now requires the robot to be standing before triggering; Idle head behavior now centers on the neutral pose; Robot pauses policy when lifted and eases into rest pose on shutdown; and 1 more.

robotd/src · low confidence · unverified

configd introduces dedicated services for robot identity, gamepad pairing, and system logging

The \configd\ daemon now manages the robot's unique identity by deriving a stable default name from the SoC serial number, handles gamepad pairing via BlueZ with transport-specific ordering for LE and BR/EDR devices, and provides a secure interface for reading daemon logs via \journalctl\. It also manages WiFi configuration through NetworkManager without storing credentials, ensuring these critical configuration tasks remain available even when the main robot daemon is offline. Also in this area: 4 commits (0 fixes) modifying configd; 1 commit (0 fixes) modifying configd; Simplified log access for robotctl; Enable NFC daemon (nfcd) integration in configd and deployment scripts.

configd · medium confidence · unverified

mediad: new camera geometry, auto-exposure, duck detection, and local frame endpoint

The mediad daemon now publishes camera intrinsics (focal length, principal point, and distortion) so that consumers can map pixels to directions for SLAM or visual odometry, with geometry derived from the sensor's 62° horizontal field of view and scaled to the delivered frame resolution. It implements software-based auto-exposure that samples luma twice a second and adjusts shutter, analogue gain, and digital gain to maintain a target brightness, compensating for the board's 3A engine which only converges once at stream start. A new duck detection module runs inference on raw frames at 2 Hz on a dedicated thread to avoid blocking the WebRTC signalling path, supporting both NPU (.rknn) and CPU (.onnx) backends. Additionally, a local Unix socket endpoint (media.frame) allows on-robot processes to request raw camera frames on demand without copying pixels through the WebRTC control channel.

mediad/src · high confidence

updaterd: new account, policy, and safety subsystems with improved update reliability

The updater daemon now includes several new capabilities and reliability improvements. It supports Hugging Face account integration for remote access, allowing the robot to sign in and be reachable from outside the LAN. A configurable policy library enables fetching and managing policy sets from the Hub without requiring a full daemon release. To prevent update failures caused by orphaned systemd units, the updater now checks for and refuses releases that would leave installed units with missing executables. Additionally, the updater verifies that scheduled restarts actually occurred and restarts any stale units on startup, and it handles transient 'Text file busy' errors during process spawning to prevent intermittent update failures.

updater/src · high confidence

Removals

Removal of robot-proto IPC contract definitions

The \robot-proto\ crate, which previously defined the JSON-RPC 2.0 wire format and API contracts (including methods like \update.apply\ and \robot.health\) for communication between \robotd\ and \updaterd\, has been removed. This eliminates the shared protocol definitions and associated error codes that clients and services relied on for update and health status interactions.

robot-proto · high confidence

Removal of updater playground example

The \updater/examples/playground.rs\ file has been removed. This example previously allowed users to drive the update engine locally without a daemon for hands-on testing of initialization, publishing, and application workflows. Its removal indicates a shift away from this specific local testing mechanism, likely in favor of the board tests that exercise the shipped binaries directly.

updater/examples · high confidence

Behavioural changes

11 commits (1 fix) modifying maploc/src

A change to existing behaviour in maploc/src — 11 commits (1 fix), 11 files: “maploc: the sensor model, bumps and relocalization fixed against ground truth”; “maploc: a map too young to be recognised starts over instead of staying lost”; “maploc: a pick-up over 1 s is a carry, not a bump”; and 8 more.

maploc/src · medium confidence · unverified

116 commits (4 fixes) modifying robotd-params

A change to existing behaviour in robotd-params — 116 commits (4 fixs), 7 files: “Revert "padd: Start stops the policy on a 1 s hold, not on a tap"”; “rustfmt over this branch's files”; “limp-fall: arm the fall predictor only from standing”; and 113 more (refs \#232, \#583).

robotd-params · medium confidence · unverified

133 commits (1 fix) modifying deploy

A change to existing behaviour in deploy — 133 commits (1 fix), 15 files: “Sync behavior with microduck\_runtime @7e4ab6d: rebased roller, la roulade”; “limp-fall: arm the fall predictor only from standing”; “robot-boot-check: decide once the daemons settle, not 180 s in”; and 130 more (refs \#1, \#4, \#48).

deploy · medium confidence · unverified

2 commits (0 fixes) modifying uyvy

A change to existing behaviour in uyvy — 2 commits, 1 file: “Docs: the camera mount is per board, not a quarter turn everywhere”; “uyvy: the camera's pixels move out of duck-detect, which nothing else can link”.

uyvy · medium confidence · unverified

22 commits (1 fix) modifying nfc

A change to existing behaviour in nfc — 22 commits (1 fix), 21 files: “nfcd: send the ST25R100's runs of register writes as one SPI message”; “nfc: read NDEF-formatted MIFARE Classic cards on the ST25R100”; “nfc: drive the beta board's ST25R100, on both antennas”; and 19 more.

nfc · medium confidence · unverified

3 commits (0 fixes) modifying robotctl/assets

A change to existing behaviour in robotctl/assets — 3 commits, 1 file: “robotctl monitor draws the robot: the sim model, live, in terminal cells”; “robotctl: draw the battery in the monitor's 3D view”; “robotctl: draw the battery black, as it is”.

robotctl/assets · medium confidence · unverified

4 commits (0 fixes) modifying duck-auth

A change to existing behaviour in duck-auth — 4 commits, 3 files: “Prototype shared authenticated BLE session”; “Add opt-in secure BLE transport path”; “Add opt-in authenticated local media gateway”; and 1 more.

duck-auth · medium confidence · unverified

6 commits (1 fix) modifying duck-gateway

A change to existing behaviour in duck-gateway — 6 commits (1 fix), 2 files: “Setup code: the robot's first name as its id, and robotctl to install and show it”; “Setup code from the ID EEPROM, and secure mode whenever a robot has one”; “Bound gateway sessions and fix board artifact fixture”; and 3 more.

duck-gateway · medium confidence · unverified

7 commits (0 fixes) modifying autod

A change to existing behaviour in autod — 7 commits, 4 files: “autod: see a get-up through — init pose and a second try, as the stress test does”; “autod: a dot wakes a napping duck”; “autod: stand up again after robotd restarts, not only after a boot”; and 3 more.

autod · medium confidence · unverified

7 commits (1 fix) modifying maploc/examples

A change to existing behaviour in maploc/examples — 7 commits (1 fix), 1 file: “maploc: the sensor model, bumps and relocalization fixed against ground truth”; “maploc: a map too young to be recognised starts over instead of staying lost”; “maploc: onboard ToF mapping, redesigned around stops”; and 4 more.

maploc/examples · medium confidence · unverified

9 commits (1 fix) modifying mapd

A change to existing behaviour in mapd — 9 commits (1 fix), 7 files: “maploc: the sensor model, bumps and relocalization fixed against ground truth”; “maploc: a map too young to be recognised starts over instead of staying lost”; “mapd: the onboard map as a service, map.\* (API v42)”; and 6 more.

mapd · medium confidence · unverified

Automated boot recovery and daemon identity publishing

The system now includes a new boot-check mechanism that automatically verifies whether the newly booted release is healthy; if the release fails to start within 180 seconds, the system falls back to the golden release via a new \robot-boot-check\ service and timer. Additionally, the \updaterd\ service now publishes its running release identity to \/run/updaterd/identity.json\, enabling health checks to verify which version is active, and its restart logic has been updated to use a systemd transient unit for post-update restarts rather than relying on the previous configuration.

updater/systemd · high confidence

Automated installation of system units and hardware dependencies via update hooks

The update process now automatically installs systemd units, GStreamer plugins, the RKAIQ camera engine, and the NPU runtime during updates, ensuring that new services and hardware capabilities are enabled without manual intervention. A new postinstall hook copies service files and enables them, while a preinstall hook verifies and installs required dependencies like ONNX Runtime and GStreamer before the update is applied, preventing failures caused by missing components on previously provisioned boards.

hooks · high confidence

Contact odometry now uses mesh-sampled anchor points for improved accuracy

The odometry module has been rewritten to derive foot contact points directly from the robot's MJCF mesh rather than using hand-transcribed bounding boxes. This change introduces a new \anchors\ module defining three anchor sets: \V15\ (legacy bounding box), \ALPHA4\ (four sole corners), and \ALPHA16\ (a 4x4 grid over the sole). The default production estimator (\Odometry::alpha\) now uses \ALPHA16\, which reduces drift to 9 mm over a 3.2 m walk compared to 17 mm for the legacy \V15\ set, while also correcting height estimation errors. The implementation optimizes performance by evaluating the kinematic chain once per tick instead of per corner.

odometry · high confidence

Extracted BLE wire contract into a shared library

The BLE wire contract has been extracted from the \btd\ daemon into a new, platform-independent \duck-ble\ library. This change defines the shared interface for the GATT service and characteristic UUIDs, the NDJSON framing logic (including chunking and reassembly bounds), and the advertisement format (encoding the robot's IPv4 address). By isolating these components, both the Linux daemon and external clients (such as \duckctl\ or mobile apps) can now implement the same protocol without depending on the daemon's internal implementation, ensuring consistent behavior across different platforms.

duck-ble · high confidence

New control-only transport for Space-to-robot communication

Spaces can now communicate with robots using a lightweight HTTP-based protocol (JSON-RPC over the rendezvous relay) instead of relying on WebRTC datachannels. This change introduces \spaces/shared/control.py\ for JSON-RPC handling, \spaces/shared/rendezvous.py\ for robot status and listing, and \spaces/shared/wire.py\ for the control-only session management. This transport is more reliable in restricted network environments (e.g., data centers) as it avoids WebRTC ICE/SDP negotiation, though it does not support video streaming. It also includes improved error handling for rate limits and authentication, and ensures the client identifies itself properly to avoid being blocked by edge proxies.

spaces/shared · high confidence

Protocol version bump to v26 with new robot capabilities

The IPC protocol version has been bumped to v26, introducing several new robot control methods including \robot.look\ for gaze aiming, \robot.skills\ for managing skill slots, and \robot.setSkill\/\robot.removeSkill\ for adding or removing skills via API. The update also adds \robot.rebootMotors\ for servo rebooting, \robot.sitting\ and \robot.homed\ status publications, and exposes camera intrinsics through \robot.model\. Additionally, the \update.show\ method is now available to retrieve update transcripts, and the protocol now strictly refuses unknown parameters with \INVALID\_PARAMS\ errors instead of silently ignoring them. Also in this area: 9 commits (0 fixes) modifying duck-ipc-proto; 1 commit (0 fixes) modifying (repo-wide); Report robot pick-up status in safety state; Updated gamepad button documentation to include 'b' and 'y'.

duck-ipc-proto · low confidence · unverified

Release tooling: stable promotion decoupling, zstd optimization, and preinstall hook automation

The release packaging and promotion workflow has been updated to improve reliability and CI performance. The \promote\ command now requires a \--stable-tag\ argument, ensuring that stable releases host their own artifact copies rather than pointing to staging tags, which prevents broken links if staging releases are deleted. The \package\ command now accepts a \--zstd-level\ argument (defaulting to 19) to allow lower compression for throwaway CI artifacts, significantly reducing build times. Additionally, the packaging process now automatically generates and includes a \hooks/preinstall\ script to assert board prerequisites, removing the need for manual inclusion and ensuring this check is always present in every release.

xtask/src · high confidence

Robotd daemon now publishes runtime identity and adjusts logging guidance

The robotd systemd unit now creates a runtime directory at /run/robotd to publish an identity file (identity.json), which is read by robotctl health and the updater startup check. The unit also clarifies that configuration parameters are loaded from the default /etc/robot/robotd.toml path (omitting an explicit --params flag to keep the config optional) and updates the logging rationale to explain why per-tick debug logs are avoided at 50 Hz to prevent log eviction under journald's size cap.

robotd/systemd · high confidence

Updater adds staging channel support and improves GitHub asset retrieval

The updater now supports a dedicated staging channel for release candidates via the \--staging\ flag, allowing users to install pre-release builds from GitHub. It also enables installing specific branches by name using \--ref\, which is supported by both the GitHub and local directory sources. To fix issues with private repositories and improve reliability, the GitHub source now fetches release assets via the API using the \application/octet-stream\ header instead of browser download URLs, and includes a fallback mechanism to resolve empty asset lists. Additionally, error messages for network failures and 404s have been enhanced to provide clearer diagnostics, such as suggesting the use of a token for private repos.

updater/src/source · high confidence

Vision demo now receives robot frames via outbound WebSocket

The vision-demo Space has been redesigned to receive camera frames directly from the robot via an outbound WebSocket connection, replacing the previous WebRTC pull model. This change eliminates the need for a media relay, allowing the Space to scale more efficiently and bypass NAT issues that previously prevented connections from home networks. The Space now hosts a FastAPI server with a custom \/frames\ WebSocket route and Gradio UI, processing incoming H.264 or JPEG streams locally on Hugging Face hardware. Additionally, a new 'hello duck' Space was added as a minimal test environment to validate the Docker setup, WebSocket routing, and Gradio integration without OAuth complexity.

spaces/vision-demo · high confidence

mediad is now a managed systemd service with automatic startup

The mediad daemon is now installed as a systemd unit (mediad.service) with an \[Install\] section, meaning it is automatically enabled and started on boot and during updates without manual intervention. The service runs under a dedicated unprivileged 'mediad' user, granted access to hardware devices (VPU, NPU, video nodes) and internal sockets via supplementary groups (video, render, robot). It includes hardening measures, automatic restarts on failure, and relies on configuration in /etc/robot/robotd.toml for video settings rather than command-line flags.

mediad/systemd · high confidence

Test coverage

6 commits adding/updating tests in maploc/tests; Added integration tests for release packaging, boot recovery, and sideloading paths; Added integration tests for robotd startup locking and health-gate behavior; Refactored updater test infrastructure and added coverage for degraded and starting robot states.

Dependencies

Workspace restructure and dependency updates for new robot services

The workspace has been restructured to include new crates for robot control, kinematics, odometry, and configuration, alongside the existing daemons. This change introduces several key dependencies: \btleplug\ 0.13 for the \duckctl\ client to prevent process aborts on macOS, \ort\ 2.0.0-rc.11 for ONNX Runtime support in control and detection, \bluer\ 0.17.4 for Linux Bluetooth transport, and \zbus\ 5 for Linux configuration services. It also adds \gstreamer\ 0.24 for media streaming, \axum\ 0.8.9 for the mediad console, and \reqwest\ 0.13.4 for relay communication. The \robot-proto\ crate was renamed to \duck-ipc-proto\. Also in this area: 6 commits updating dependencies (4 manifests); Version bump to 0.17.7; Add local audio playback support for UDP pad sounds; Release 0.15.1 and Rust 1.99 minimum requirement; Add NFC daemon for gamepad pairing.

(dependencies) · medium confidence · unverified

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 59 → 57 (-1.3)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 67 → 69 (+1.9)
  • Architecture 95 → 95 (+0.2)
  • Maturity 69 → 72 (+2.9)
  • Readiness 52 → 58 (+6.1)
  • Security 56 → 55 (-0.5)
  • Event Sourcing 100 → 100 (+0.0)
  • Accessibility 65 → 52 (-13.1)
  • Performance 100 → 85 (-15.0)

Resolved (46)

  • Boundary-crossing change coupling: main.rs ↔ ipc.rs (robotd/src/main.rs)
  • Duplicated block (10 lines × 2) (configd/src/nm.rs)
  • Duplicated block (10 lines × 2) (robotctl/src/main.rs)
  • Duplicated block (11 lines × 2) (robotctl/src/main.rs)
  • Duplicated block (11–16 lines × 2) (duckctl/src/main.rs)
  • Duplicated block (12–13 lines × 3) (updater/src/ipc.rs)
  • Duplicated block (13 lines × 2) (robotctl/src/main.rs)
  • Duplicated block (18 lines × 3) (mediad/src/frame.rs)
  • Duplicated block (5 lines × 2) (duck-ipc-proto/src/lib.rs)
  • Duplicated block (5 lines × 2) (robotd-params/src/edit.rs)
  • Duplicated block (5 lines × 3) (mediad/src/frame.rs)
  • Duplicated block (6 lines × 2) (mediad/src/pipeline.rs)
  • Duplicated block (6 lines × 2) (robotd/src/sound.rs)
  • Duplicated block (6–9 lines × 2) (mediad/src/frame.rs)
  • Duplicated block (7 lines × 2) (padd/src/tap.rs)
  • Duplicated block (7 lines × 3) (robotctl/src/main.rs)
  • Duplicated block (8 lines × 2) (robotctl/src/main.rs)
  • Duplicated block (8 lines × 3) (mediad/src/main.rs)
  • Duplicated block (9 lines × 2) (btd/src/upstream.rs)
  • Duplicated block (9 lines × 2) (updater/src/engine.rs)
  • …and 26 more

New (260)

  • BlueZ::find (cognitive 18) (configd/src/bluez.rs)
  • Boundary-crossing change coupling: safety.rs ↔ main.rs (duck-control/src/safety.rs)
  • Brain::enter (cognitive 16) (autod/src/brain.rs)
  • Brain::enter (cyclomatic 23) (autod/src/brain.rs)
  • Brain::pick_next_state (cognitive 49) (autod/src/brain.rs)
  • Brain::pick_next_state (cyclomatic 29) (autod/src/brain.rs)
  • Brain::step (cognitive 249) (autod/src/brain.rs)
  • Brain::step (cyclomatic 152) (autod/src/brain.rs)
  • Brain::take_fix (cognitive 17) (autod/src/brain.rs)
  • ClassTooLong: Brain (autod/src/brain.rs)
  • ClassTooLong: DynamixelIo (duck-control/src/bus.rs)
  • ClassTooLong: Mapper (maploc/src/mapper.rs)
  • ClassTooLong: Sound (robotd/src/sound.rs)
  • Duplicated block (10 lines × 2) (configd/src/nm.rs)
  • Duplicated block (10 lines × 2) (robotctl/src/main.rs)
  • Duplicated block (10 lines × 2) (robotctl/src/path_map.rs)
  • Duplicated block (10 lines × 2) (robotd/src/laser.rs)
  • Duplicated block (10 lines × 2) (robotd/src/laser.rs)
  • Duplicated block (11 lines × 2) (robotctl/src/main.rs)
  • Duplicated block (11 lines × 2) (robotd/src/sound.rs)
  • …and 240 more

Changes since last survey

  • 287 commits — 279 feature/other, 8 fixes

By area

  • (repo) — 104 commits
  • (root) — 24 commits
  • docs/robot — 21 commits
  • docs/design — 20 commits
  • robotd-params/src — 15 commits
  • configd/src — 13 commits
  • nfc/src — 13 commits
  • duck-control/src — 8 commits
  • robotctl/src — 8 commits
  • btd/src — 7 commits
  • mediad/src — 7 commits
  • updater/src — 7 commits
  • autod/src — 6 commits
  • deploy/robotd.toml — 6 commits
  • duckctl/src — 4 commits
  • robotd/src — 4 commits
  • .github/workflows — 3 commits
  • pad-map/src — 3 commits
  • docs/project — 2 commits
  • duck-gateway/src — 2 commits

Notable commits

  • fix: Bound gateway sessions and fix board artifact fixture
  • fix: Fix CI: robotd's gate fixture opts in, and the revert log line is back
  • fix: Merge pull request #584 from pollen-robotics/revert-dpad-remap
  • fix: Place security regression tests after daemon code
  • fix: Revert "nfcd: send the ST25R100's runs of register writes as one SPI message"
  • fix: Revert the AGENTS.md section on the simulator
  • fix: Revert the D-pad remap (#583): back to left move, right head + move, down body + head
  • fix: telemetry: review fixes — no false success, a tested policy diff, a snapshot per id
  • change: Add opt-in authenticated local media gateway
  • change: Add opt-in secure BLE transport path
  • change: Add the face-board-v1 board
  • change: Adopt old edits on the first write too, and trim the layer helpers
  • change: Bound authenticated BLE request envelope
  • change: Bump the workspace to 0.18.8
  • change: Cargo.lock: duck-auth and duck-gateway at 0.19.0
  • change: Carry existing robots across: adopt old edits, link the old token path
  • change: Choose candidate Noise app handshake
  • change: Console: draw the laser detector's dot over the video
  • change: Default media and BLE listeners to secure access
  • change: Dim the face indicator LEDs; leave the flashlight at full
  • …and 267 more

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

pollen-robotics/microduck was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 094d4bb4af31ec181156e1ea772437fdd7a55978 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.