Connecting to sources…

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

  • Key chip has long lead times and needs a substitute #6
  • Motors become unresponsive after leg installation, suggesting zeroing failure #8
  • Motor configuration cannot discover Dynamixel servos #7

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

Documents