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