Connecting to sources…

How to build Mini Pupper 2: the whole process

94 steps to build Mini Pupper 2, from buying parts, printing and assembly to software, calibration and training, with the bill of materials, shop links and the official …

Pre-assembled kit $649, legs-pre-assembled kit $604, upgrade kit $399 (mangdang.store, 2026‑10‑31; the page says taxes included, shipping extra); the manual puts shipping to most of North America, Japan, the EU and UK within $30 with duties paid. No self-sourced total for Mini Pupper 2

Buy parts

  • Order the LiDAR Accessories

    When ordering the Lidar, the 3D-printed Lidar holder and custom cable are shipped together.

  • Order the pre-built robot

    The pre-built robot already has the software on its SD card, so you can proceed directly to the following steps.

  • Obtain the additional tools

    Beginners need the additional items shown in the document in addition to the tools included in the kit.

Print and make

  • Print the LiDAR Holder

    Alternatively, print the holder yourself using the linked STL files.

  • Print the Camera Holder

    Download the STL files and print the holder. Mini Pupper 2 supports either a single Pi camera or an OpenCV OAK-D-Lite camera module.

  • Print the Lidar holder

    If you order the Lidar, the 3D-printed Lidar holder and custom cable are shipped together. You can also print the holder yourself using the STL files.

  • Print the camera holder

    Mini Pupper 2 supports the single Pi camera or OpenCV OAK-D-Lite camera module. You can also print the holder yourself using the STL files.

Assemble

  • Check All Parts

    Check the complete set of parts shown in the picture.

  • Connect Legs to Bottom Plate

    Connect the four legs to the bottom plate using M2 x 5mm screws.

  • Connect Top PCB and LCD

    Insert the four-legged connection wire into the top board and connect the LCD screen cable to the PCB, observing the direction.

  • Route the Power Line

    Pass the power line on the PCB through the hole in the bottom plate.

  • Secure PCB and Bottom Board

    Fix the PCB board and bottom board using M2 x 5mm screws.

  • Install the Side Panels

    Install the side panels by following the cover-assembly video.

  • Install the Shin Guards

    Use four M2x10mm countersunk screws for the shin guards.

  • Insert the Shoulder Parts

    Insert only the screws first, then insert the shoulder parts into the gap.

  • Tighten the Shoulder Screws

    Insert the 2 mm hex driver into the hole in the shoulder part and tighten the screws.

  • Install Four Shoes

    Put four shoes on the robot.

  • Attach Three Holder Connectors

    Connect the three holders to the 3D-printed part.

  • Connect Cable to PCB LiDAR

    Connect the custom cable to the LiDAR connector on the PCB board.

  • Mount the 3D-Printed Holder

    Fix the 3D-printed part on the PCB board.

  • Install the LiDAR Module

    Connect the custom cable to the LiDAR module and secure it with self-tapping screws.

  • Prepare all the parts

    Use the picture to identify all the parts needed for assembly.

  • Assemble the bottom plate

    Connect the four legs to the bottom plate using M2 x 5mm screws.

  • Assemble the top PCB board

    Insert the four-legged connection wire into the top board, then connect the LCD screen cable to the PCB board in the correct direction.

  • Adjust the power line

    Pass the power line on the PCB board through the hole in the bottom plate.

  • Assemble the speaker

    Fix the PCB board and bottom board using M2 x 5mm screws.

  • Perform the cover assembly

    Follow the video clip below for the cover assembly.

  • Install the side panels

    Assemble and install the side panels.

  • Install the shin guards

    Assemble and install the shin guards.

  • Install the shoulder covers

    Assemble and install the shoulder covers.

  • Install the shoes

    Assemble and install the shoes.

  • Assemble the Lidar

    Connect the 3 holders to the 3D-printed part, connect the custom cable to the Lidar connector on the PCB board, and fix the 3D-printed part to the PCB board.

  • Connect and secure the Lidar module

    Connect the custom cable to the Lidar module and secure it with self-tapping screws.

  • Disconnect the Compute Module

    Turn off the Raspberry Pi Compute Module 4 and unplug all power. Discharge static electricity from your body before handling the ribbon cable, camera module, and connector.

  • Locate the CM4 MIPI Connector

    Locate the MIPI CSI camera interface on the CM4 board. It is a small rectangular connector with a row of metal pins and typically has a hinged, flip-up latch.

  • Connect the Ribbon Cable to CM4

    Use a ribbon cable compatible with the camera module and board interface. Face the metal contacts toward the bottom of the CM4 board, lift the latch, fully insert and align the cable with the pins, then gently push the latch down to secure it.

  • Connect the Cable to Camera

    Insert the other end of the ribbon cable into the camera module. Lift the module connector's latch, align the metal contacts with the direction of the camera lens, insert the cable, and lower the latch to secure it. Handle the cable and connector carefully and double-check their alignment.

  • Assemble the camera module

    For convenient shipping, the camera module may be unassembled by default; assemble it yourself after receiving the robot.

  • Connect the battery by hand

    Connect the battery to the robot by hand.

  • Insert the SD Card into Mini Pupper

    Put the SD card into the Mini Pupper.

Software

  • Set the phone's default WiFi

    Before booting the robot, set the default WiFi on the phone.

  • Boot and wait for connection

    After turning on Mini Pupper, the display connects to the default WiFi after about 30 seconds and shows the IP address.

  • Connect in the browser

    Connect the phone or PC to the default WiFi, make sure it is on the same network as the robot, and enter the robot's IP address with port 8080 in a browser.

  • Disable the AI functions

    Click the “AI off” button to disable the AI functions.

  • First connect default WiFi

    First follow the preceding steps to connect Mini Pupper to the default WiFi.

  • Open the robot web interface

    Check the robot's IP address, connect the phone or PC to the default WiFi, and enter that IP address with port 8080 in the browser.

  • Set and apply your WiFi

    Click “Setting” at the bottom left, enter the home or office WiFi SSID and password, then click “Connect” and “Reboot.” Make sure WiFi is active before restarting.

  • Start Mini Pupper

    Start Mini Pupper.

  • Log in to Mini Pupper

    Log in to Mini Pupper.

  • Set your own WiFi

    Edit /etc/netplan/50-cloud-init.yaml, save it, apply the netplan configuration, and reboot.

  • Open SSH ports remotely

    Without an HDMI display, use a PC to connect to Mini Pupper over SSH; allow, reload, and enable firewall port 22.

  • Download and Flash the Ubuntu Image

    Download `ubuntu-22.04.2-preinstalled-server-arm64+raspi.img.xz` from the official Ubuntu website and flash it into the SD card.

  • Configure the WiFi Network

    Edit `/etc/netplan/50-cloud-init.yaml`, update the AP name to "Mangdang" and the password to "mangdang", then apply the network configuration.

  • Update the System and Reboot

    Run the system update commands, then reboot the robot.

  • Clone and install the software

    Clone the mini_pupper_2_bsp repository, run install.sh, and reboot.

  • Install the ESP-IDF Environment

    Run the multipass-orchestrator-configurations build.sh in an Ubuntu 22.04 environment to create a working ESP-IDF environment. The build system used is a Raspberry Pi 4B with 2GB of RAM.

  • Build the ESP32 Project

    Clone the mini_pupper_2_bsp repository, enter the esp32 directory, set the target to esp32s3, and build the project using all default values in menuconfig.

  • Monitor and Flash the ESP32

    After building the project, set the serial port to /dev/ttyUSB0, monitor the ESP32 with idf.py monitor, and flash the firmware with idf.py flash. Set the ESP32 to download mode when using a simple serial adapter.

  • Connect and run the MIPI camera

    Connect the MIPI camera module to Mini Pupper and install it by following the instructions in the RPiCamera directory. After installation, run ./camera_ffplay_test.py.

  • Install Camera Driver and Configure Raspberry Pi

    Go to the RPiCamera directory, run install.sh to set the camera configurations, and then reboot the Raspberry Pi.

Calibrate and test

  • Start the Raspberry Pi

    Start the Raspberry Pi on Mini Pupper.

  • Log in

    Log in to the Raspberry Pi.

  • Set the keyboard (optional)

    Set the keyboard if needed.

  • Open the SSH port (optional)

    If using SSH, allow port 22 through UFW, reload UFW, and enable UFW.

  • Calibrate each servo

    Calibrate each servo by moving the bars or clicking the space position near the bars.

  • Save the servo settings

    After calibrating each servo, press the “Update” button to save the settings.

  • Close and save the calibration

    Press × to close the calibration interface and save the calibration.

  • Use the Reset button

    Use the Reset button when you want to restart from the last saved state.

  • Restore factory settings

    Press the Restore button to restore factory settings, then press × to close.

  • Connect the controller

    Connect the controller to control the robot.

  • Calibrate the legs

    Perform the leg calibration using the calibration video clip in the document.

  • Run with a web browser

    Use a web browser to run the calibration.

  • Enable AI on mobile
  • Enable AI on PC

    Select “Activate/Deactivate,” “Settings,” and then “AI On” in the PC interface.

  • Confirm AI startup

    After clicking “AI On,” wait about 15 seconds until the display blinks once or twice and shows “Hello, World.”

  • Install and run the IMU demo

    Enter the demos directory, install the required Python modules from requirements.txt, and run ./quaternion_plotter.py. The script displays a GUI on a connected monitor or through SSH X Windows forwarding, and the application must correct the IMU orientation because it is mounted upside down on the main board.

  • Test the joint limits

    Use test_joint_limit.py to exercise and validate the configured joint limits. The script automatically sweeps every joint on all four legs beyond the nominal limits and records the servo load for each motor, providing data for tuning joint limits and evaluating servo performance near the limits.

  • Calibrate Mini Pupper

    Run the calibrate command to calibrate mini pupper.

  • Test demos to confirm installation

    Test the demos to confirm the installation; refer to the demos link for details.

  • Test MIPI Camera Live Video

    Open a terminal, connect to Mini Pupper over SSH, change to the demos directory, and run camera_ffplay_test.py for the live video test.

  • Capture a Camera Image

    Open a terminal and run the command to capture one image from /dev/video0 and save it as snapshot.jpg.

Data and training

  • Record Camera Video

    Run the command to record output.mp4 at 1280x720 resolution and 30 frames per second. Press q in the terminal to stop recording and save the video.

Use it

  • Run the robot with controller

    The controller can operate Stanford Pupper, Mini Pupper, and Mini Pupper 2; the steps are the same.

  • Follow the controller controls

    Control the robot using the controller buttons shown in the image.

  • Check power and choose adapter

    A green LED means there is enough power, while red means the robot needs charging. A 5V/1A adapter is recommended; with a 5V/2A adapter, the battery IC changes it to 1A.

  • Charge battery to eighty percent

    After about 1 hour, the battery reaches 80% and the light turns green; you can use the robot then.

  • Continue charging to full

    After the light becomes green, allow another hour to reach 100%.

  • Connect adapter for long use

    The battery runs continuously for about 30 minutes; connect the power adapter if the robot needs to work for a long time.

  • Hold battery button to power on

    Manually press and hold the battery button for more than 3 seconds; the battery indicator turns green and lights up.

  • Start automatically with adapter

    The robot starts automatically when the power adapter is connected.

  • Talk with keywords

    You can now talk to the robot and control it using keywords.

  • Manage extended AI use

    The AI function works continuously for about 20 minutes; for longer use, turn it off manually and restart it every 15 minutes.

  • Run the haptic demo

    Run ./haptic-demo.py, then move the front right leg while the other legs follow. Some legs move in the opposite direction because of the servo orientation, and correcting this is left as an exercise for the user.

  • Run the audio recording demo

    Make sure no HDMI cable is connected to Mini Pupper, then run ./audio_test.py. The script gives you 5 seconds to record your voice and replays the recording afterward; see the script code for detailed information.

Parts

  • Raspberry Pi CM4 with an ESP32‑S3 co-processor, Ubuntu 24.04/22.04 (spec table)
  • 12 serial bus servos with position feedback, one each at hip, upper and lower leg (spec table and BSP demos)
  • IMU, touch sensor, microphone and speaker, 320×240 screen
  • 1000 mAh battery, about 2 hours to full over USB, about 30 minutes of runtime (manual)
  • Options: STL‑06P lidar ($119), Raspberry Pi Camera v2 or OAK‑D‑Lite

Tools

  • The site says no soldering is needed and tools are included
  • A 32 GB SD card is recommended for flashing your own image (manual)

Skills

  • Ubuntu and ROS 2 (Humble/Jazzy)
  • Python kinematics examples and the ESP32 interface API
  • OpenCV vision and Scratch blocks (the manual's K12 starting point)

Software

  • mini_pupper_ros (ROS 1/2, SLAM and Nav2 navigation)
  • mini_pupper_2_bsp (board support, calibration and Python API)
  • Web controller (runs with the StanfordQuadruped fork) and blocks.mangdang.org block coding

Documents