How to build Q8bot miniature quadruped: the whole process
84 steps to build Q8bot miniature quadruped, from buying parts, printing and assembly to software, calibration and training, with the bill of materials, shop links and t…
Not sold as a robot or kit; the creator's BOM estimate (US sourcing, with estimated tax and shipping in brackets): $311.55 ($337.29) with your own 3D printer and reflow, $333.62 ($365.88) with MJF printing outsourced, and $404.13 ($435.68) with PCB assembly also outsourced (assembly estimated at $100); the 8 DYNAMIXEL XL330s alone are $219.92. Tools, a Li-ion charger and the optional U2D2 are excluded. The README calls the BOM unoptimised at about $300–400
Buy parts
- Review the complete BOM
Open the complete Q8bot bill of materials; its links and prices are mainly for purchasing within the US.
- Prepare the required tools
Prepare a PH-0 or JIS-1 screwdriver, a soldering iron with basic consumables, a modern laptop capable of running VS Code, a USB Type-A to Type-C or Type-C to Type-C cable, and masking tape or similar.
- Buy eight motors
Buy 8 DYNAMIXEL XL330-M077-T motors; each includes M2 self-tapping screws used to assemble Q8bot.
- Buy twelve bearings
Buy 12 692ZZ bearings measuring 2mm x 6mm x 3mm; alternatives with the same dimensions will also work.
- Buy two batteries
Buy 2 14500 KeepPower 1000mAh P1450C2 batteries to run the robot; additional pairs can be purchased for hot-swapping, and regular AA batteries will not work.
- Obtain a lithium-ion charger
If you do not already have one, purchase a lithium-ion battery charger; an example is listed in the BOM under "Recommended Tools".
- Order MJF Parts Online
Upload the .STL files under `hw-vx.x/CAD/Q8_VX.X_MJF` to the vendor's website and configure the materials and quantity.
- Buy a Li-ion Battery Charger
If you do not already have one, buy the linked Li-ion battery charger.
- Build an Optional ESPNow USB Dongle
Optionally build the USB dongle using the linked ESPNowDongle instructions; the ESP32C3 uses it to communicate wirelessly with the laptop.
- Purchase U2D2 and Power Hub
DYNAMIXEL motors require proper configuration; purchasing the U2D2 and U2D2 Power Hub allows individual motors to be configured directly from the laptop for easier debugging and troubleshooting.
- Obtain or Reflow the PCB
Purchase the fully assembled Q8bot PCB from PCBWay, or reflow solder the PCB yourself using the information in the /PCBA folder.
- Gather All Components
Gather 2 lithium-ion batteries, 3D-printed parts, 12 692ZZ ball bearings, battery clips, a separate Seeed Studio XIAO ESP32C3, the fully assembled Q8bot PCB, and 8 brand new DYNAMIXEL XL330-M077-T motors. Use only the 6mm screws supplied with the motors, and start charging the batteries so they are ready later.
- Order the assembled PCB
Order the fully assembled Q8bot PCB through the PCBWay project page, which contains assembly-related files including the BOM and centroid files.
Print and make
- Download the hardware files
Download the zipped folder from the latest release to access STLs, Gerbers, CAD, and other hardware-related files.
- Print 2 Q8bt_Frame Parts
Prepare 2 Q8bt_Frame parts for 1 Q8bot; printing extra spare parts is also recommended.
- Print 4 Q8bot_LL_Left Parts
Prepare 4 Q8bot_LL_Left parts for 1 Q8bot; printing extra spare parts is also recommended.
- Print 4 Q8bot_LL_Right Parts
Prepare 4 Q8bot_LL_Right parts for 1 Q8bot; printing extra spare parts is also recommended.
- Print 4 Q8bot_UL1 Parts
Prepare 4 Q8bot_UL1 parts for 1 Q8bot; printing extra spare parts is also recommended.
- Print 4 Q8bot_UL2 Parts
Prepare 4 Q8bot_UL2 parts for 1 Q8bot; printing extra spare parts is also recommended.
- Print Parts Yourself Using FDM
Download and slice the files under `hw-vx.x/CAD/Q8_VX.X_FDM`, then print them with a Bambu Lab, Prusa, or similar 3D printer. The document used a Bambu Lab A1 mini with the default 0.12 mm settings.
Assemble
- Attach Battery Clips
Attach battery clips to both main frames. With the battery geometry on the left, place the negative clip with the spring on the left and the flat positive clip on the right, with the notches facing inward.
- Secure Frames to Center PCB
Use 8 M2x6mm self-tapping screws supplied with the DYNAMIXEL motors to attach the main frames to the center PCB.
- Solder the Battery Clips
Solder the battery clips to the PCB, taking care not to melt the 3D-printed frame parts. Using solder flux can be helpful.
- Insert Bearings into Leg Links
Insert ball bearings into the 3D-printed leg links, using 12 bearings in total. You may need to lightly push them in with the back of a screwdriver.
- Assemble Two Mirrored Leg Pairs
Assemble two mirrored pairs of legs, using 3 M2x6mm screws per leg. First orient the parts without screws according to the image to understand the small differences between them. Set the assembled legs aside for later.
- Assemble Each Leg
Position the leg elements as indicated and insert the bottom screw. Flip the setup and install the other 2 screws.
- Remove Motor Bottom Shells
It is recommended to place a piece of tape on each motor at the indicated location to make handling easier. Loosen the 4 screws and detach the bottom shells from ALL 8 motors, exposing the electronics.
- Install the Batteries
Install the batteries with the negative side connected to the clip with the spring and the positive side connected to the flat clip.
- Align PCB headers and install first motor
Align the PCB headers with the motor pins and install the first motor without screwing it in place. As soon as the first new motor is connected, the laptop's serial monitor should show: New motor connected! DXL Params set. Changing ID to 11.
- Secure first motor with long screws
You may now use the long screws from detaching the shells to secure the first motor in place; only 2 screws are needed instead of 4. If the assembly used longer (black) female pin headers that are too tall, trim them down with a flush cutter or sandpaper.
- Repeat motor install for IDs 12-18
Repeat steps 15-17 for the remaining motors: ID12 - ID18. Follow the labeling numbers sequentially, as the calibration code is written to only look for the next available motor.
- All motors move automatically when connected
Once all motors are connected, the program should automatically move all motors in preparation for leg installation. You may disconnect the robot from the laptop now, but keep it powered on.
- Install left and right leg pairs
Install the legs, making sure one identical pair of legs is on the left and the other mirrored pair on the right. Refer to the CAD model of the robot if you find this confusing.
- Assembly complete: power off or set up software
Congratulations, you have finished assembling your Q8bot. You may turn off the robot power now, or directly proceed to Software Setup.
Software
- Install Python dependencies
Run the installation of the dependencies listed in requirements.txt in the project directory.
- Install PyInstaller
Install PyInstaller to build the single-file executable.
- Run the Windows build script
On Windows, run build_exe.bat. The build output is dist/q8bot.exe.
- Manually build the Windows executable
Alternatively, manually run PyInstaller on q8bot_build.spec. The output is dist/q8bot.exe.
- Run the Linux or macOS build script
First make build_exe.sh executable, then run the script. The build output is dist/q8bot.
- Manually build the Linux or macOS executable
Alternatively, manually run PyInstaller on q8bot_build.spec. The output is dist/q8bot.
- Run the Windows executable
On Windows, run dist\q8bot.exe. It can auto-detect the COM port or use COM3, and can enable debug logging.
- Run the Linux or macOS executable
On Linux or macOS, run ./dist/q8bot. It can auto-detect the serial port or use /dev/ttyUSB0, and can enable debug logging.
- Review the build configuration
q8bot_build.spec uses a single file, console mode, and embeds joystick configuration in Python code. It includes numpy, scipy, pygame, and pyserial; excludes matplotlib, PIL, and sympy; and enables UPX compression.
- Install All Python Dependencies
Run the dependency installation command for requirements.txt.
- Check hiddenimports in Spec File
Check that the spec file's hiddenimports setting includes the missing modules.
- Use Embedded Joystick Configuration
The joystick configuration is embedded directly in control_config.py; no external JSON file is needed or bundled.
- Install Windows Runtime Libraries
On Windows, make sure Visual C++ Redistributables are installed before running the executable.
- Set Linux Executable Permissions
On Linux, add executable permissions to dist/q8bot.
- Review UPX Compression
UPX compression is enabled, but it can be improved.
- Exclude Unused Scientific Modules
If needed to reduce file size, consider excluding unused scipy or numpy submodules.
- Distribute the Windows Version
Windows users need q8bot.exe, which must be built on Windows.
- Distribute the Linux Version
Linux users need q8bot, which must be built on Linux.
- Distribute the macOS Version
macOS users need q8bot, which must be built on macOS.
- Set up PlatformIO
Set up the environment using the PlatformIO documentation and tutorials.
- Select the firmware build
Select the desired permanent (perm) or automatic (auto) build in PlatformIO. The default is robot_permanent/controller_permanent.
- Upload the robot firmware
Use PlatformIO to upload `firmware/q8bot_robot` to the Q8bot robot.
- Upload the controller firmware
Use PlatformIO to upload `firmware/q8bot_controller` to the separate Seeed Studio XIAO ESP32C3 controller.
- Flash robot firmware with esptool
Advanced users can use Espressif esptool to flash the permanent ESP-NOW robot firmware, replacing `COM9` with the actual device port.
- Flash controller firmware with esptool
Advanced users can use Espressif esptool to flash the permanent ESP-NOW controller firmware, replacing `COM9` with the actual device port.
- Run the standalone executable
Download q8bot_operate.exe from the latest release, connect the controller, turn on the robot, and double-click the file. Wait for a blank window named "pygame" to appear before controlling the robot with the same keyboard commands listed later; this method only works on Windows.
- Install Python
If Python is not already installed, download and install the latest version from the official Python website. Make sure to select the "add python.exe to PATH" option.
- Create a virtual environment
Open a terminal of your choice, navigate to the /python-tools folder, and create a virtual environment for the project.
- Activate the virtual environment
Activate the newly created virtual environment in the same directory. The document notes that the activation command is different for macOS/Linux.
- Install project dependencies
Run the dependency installation command in the same directory to force-reinstall the necessary libraries in the virtual environment. If the command does not work on your system, manually use pip to install the libraries instead.
- Open the Software Setup Guide
Open the linked Software Setup page for details on running the Q8bot control software from source.
- Clone the q8bot Repository
Clone the q8bot repository, then enter the python-tools directory.
- Create a Virtual Environment
On Windows Command Prompt or PowerShell, create the environment with python -m venv venv and activate it; on macOS/Linux, use python3 -m venv venv and activate it.
- Install Dependencies
First install the runtime dependencies from requirements.txt, then install PyInstaller for building the executable. The --force-reinstall flag ensures all packages are properly installed even if they already exist.
- Build the Executable
Run the build script for your operating system. The process checks PyInstaller, cleans previous builds, packages the application with its dependencies, embeds instruction images, and creates a single-file executable.
- Find the Built Executable
Look in the dist/ directory for q8bot.exe on Windows or q8bot on macOS/Linux.
- Auto-detect the COM Port
Run dist/q8bot and let the program auto-detect the COM port.
- Specify the COM Port
Use COM3 on Windows or /dev/ttyUSB0 on Linux as the command-line argument.
- Enable Debug Logging
Run q8bot with the --debug option to enable debug logging.
- Combine Port and Debug Options
Specify a COM port while also enabling debug logging.
Calibrate and test
- Power On and Check LED
Locate the switch and slide it toward the USB-C port to turn on the power. If the PCB has been assembled correctly, the onboard LED of the Seeed Studio XIAO board should light up.
- Manually Configure Reused Motors
The following motor setup instructions only work with brand new DYNAMIXEL motors that have not been configured before. Reused motors from previous projects must be manually configured using DXL_config_manual.md.
- Open the Serial Monitor
After the upload succeeds, click the cable-plug-shaped button to open the serial monitor.
- Confirm No Motor Found Message
The serial monitor should print "No new Dynamixel motors found" approximately every 5 seconds.
Use it
- Distribute the Self-contained Executable
The executable in dist/ can be copied to other computers without Python, run from a USB drive, or distributed to end users.
- Use the Matching Operating System Version
The executable is platform-specific: a Windows .exe will not run on macOS/Linux, and vice versa.
Common problems
Parts
- 8 ROBOTIS DYNAMIXEL XL330‑M077‑T smart servos (their bundled M2 self-tapping screws assemble the whole robot)
- Central PCB (hardware v2.5): Seeed XIAO ESP32C3, MAX17043 fuel gauge, SN74LVC2G241 buffer; orderable fully assembled from PCBWay
- A second XIAO ESP32C3 plugged into the laptop as the ESP‑NOW dongle
- 2 KeepPower 14500 1000 mAh protected Li-ion cells (regular AA batteries will not work) with Keystone 1087‑1/1087‑2 battery clips
- 12 × 692ZZ bearings (2×6×3 mm)
- 3D prints: 2 main frames and 16 leg links, printed in PLA on an FDM printer (under $1 of filament) or outsourced in MJF
Tools
- PH0 or JIS‑1 screwdriver
- Soldering iron (for the battery clips)
- A laptop that runs VS Code and a USB‑C cable; masking tape
- Self-assembled PCBs need a mini reflow hot plate and top and bottom stencils; a Li-ion charger and a U2D2 for servo debugging are recommended
Skills
- Basic soldering (reflow if you assemble the PCB yourself)
- Flashing ESP32 firmware and configuring DYNAMIXEL servos with PlatformIO
- Python: gait generation and kinematics, with parameters to explore new gaits
Software
- Firmware 2.0.1: hybrid Arduino/FreeRTOS structure, ESP‑NOW auto-pairing, with permanent and automatic pairing modes
- python-tools: pygame interface, gait manager and kinematics solver; Xbox controller and Joy‑Con support since 2025‑11
- q8bot.exe: a Windows build that needs no Python install (experimental)
- q8bot_motor_config: sets IDs 11–18 automatically as each new servo is plugged in