Open Source Robotics

A curated collection of high-quality open source robotics projects, tools, and software to propel the robotics community forward.

Assembly guide for Q8bot

Palm-sized open-source quadruped with eight DYNAMIXEL servos and no wires

License

MIT

MIT licence for the repository (firmware, Python tools, docs). The hardware package (STEP, STL, Gerbers, schematics, BOM) is published in the repository's releases without a separate licence file, so it is covered by that MIT licence. The DYNAMIXEL servos are proprietary parts. Checked 2026-10-23.

Assembly guide

1. Prepare the parts

Get the board, the printed parts and the off-the-shelf components ready

1.1 Get the main PCB

Order it assembled, or reflow it yourself.

  1. Either order the fully assembled board through the PCBWay shared project (PCB + Assembly), plus the battery clips and a second XIAO ESP32-C3 from upstream's DigiKey cart
  2. Or order the blank board with top and bottom stencils from the Gerbers in the hw-v2.5 release, buy the parts from the DigiKey cart and reflow them on a hot plate
  3. The MAX17043 fuel gauge can be left unpopulated if you cannot find one; only the battery reading is lost

1.2 Make the printed parts

Print in PLA or order in MJF.

  1. Print 2 frames and 4 each of the lower-left, lower-right, upper-short and upper-tall leg links
  2. For FDM, use the files under CAD/Q8_V2.5_FDM; upstream used a Bambu Lab A1 mini at the default 0.12 mm settings and recommends a 0.2 mm nozzle for the frame
  3. For MJF, upload the files under CAD/Q8_V2.5_MJF to a printing service

1.3 Gather the components

Lay everything out before starting.

  1. 2 lithium-ion 14500 cells (start charging them now)
  2. 12 692ZZ ball bearings
  3. Battery clips
  4. A separate XIAO ESP32-C3 for the wireless dongle
  5. The assembled PCB
  6. 8 new DYNAMIXEL XL330-M077-T servos, whose 6 mm screws are the only screws used

2. Assemble the body

Fit the frames and battery clips to the board

2.1 Fit the battery clips

Clip them into both frames.

  1. Holding a frame with the battery recess on the left, put the negative (spring) clip on the left and the positive (flat) clip on the right, notches facing inward
  2. Repeat for the second, identical frame

2.2 Screw the frames to the PCB

Attach both frames to the centre board.

  1. Use 8 M2 × 6 mm self-tapping screws from the servo packs

2.3 Solder the battery clips

Join the clips to the board.

  1. Solder each clip to its pad on the PCB
  2. Take care not to melt the printed frame; flux helps

3. Build the legs

Press in the bearings and assemble four leg linkages

3.1 Insert the bearings

Press the bearings into the leg links.

  1. Fit 12 bearings in total into the printed leg links
  2. The back of the screwdriver helps push them in

3.2 Assemble the legs

Make two mirrored pairs.

  1. Lay out each leg's links first to see the small differences between parts, checking against the CAD model
  2. Fix each leg with 3 M2 × 6 mm screws: insert the bottom screw, flip the leg and add the other two
  3. Make two pairs mirrored to each other and set them aside

4. Install and configure the servos

Seat each servo on the board while the configuration firmware assigns its ID

4.1 Open the servos

Remove the bottom shells.

  1. Put a strip of tape across each servo so the top shell stays on
  2. Undo the 4 screws on each of the 8 servos and remove the bottom shell to expose the pins

4.2 Power the board

Insert the batteries and switch on.

  1. Insert both cells: negative to the spring clip, positive to the flat clip
  2. Slide the switch towards the USB-C port; the XIAO's LED should light

4.3 Upload the configuration firmware

Flash q8bot_motor_config from PlatformIO.

  1. Open firmware/q8bot_motor_config from the repository in VS Code with PlatformIO
  2. Connect the board by USB-C, pick the COM port or leave it on Auto, and upload
  3. Open the serial monitor; it should report that no new DYNAMIXEL motors were found every few seconds

4.4 Fit the servos one by one

Each new servo gets its ID as it is plugged in.

  1. Seat the first servo on the headers marked ID 11; the monitor should report that its ID was changed to 11
  2. Secure it with 2 of the long shell screws
  3. Repeat in order for IDs 12 to 18; the firmware only looks for the next ID
  4. If the female headers on a PCBWay board are too tall, trim them with flush cutters or sandpaper

4.5 Attach the legs

Fit the legs once the servos have homed.

  1. When all 8 servos are connected the firmware moves them into position for the legs
  2. Disconnect the laptop but keep the robot powered
  3. Fit one identical pair of legs on the left and the mirrored pair on the right, checking against the CAD model

5. Set up the software

Flash the robot and the dongle, then drive it from a laptop

5.1 Flash the robot and the dongle

Upload the firmware for the robot and the dongle.

  1. Upload firmware/q8bot_robot to the robot and firmware/q8bot_controller to the second XIAO with PlatformIO, choosing the fixed-pairing build to start
  2. Or flash the prebuilt .bin files from the release with esptool at address 0x10000
  3. The dongle pairs with the first robot it sees and both remember each other

5.2 Install the Python tools

Set up the control program on the laptop.

  1. Create a virtual environment in python-tools and install requirements.txt
  2. On Windows you can instead run the prebuilt q8bot.exe from the release

5.3 Drive it

Run the control program.

  1. Power the robot and plug the dongle into the laptop
  2. Run python operate.py in python-tools/q8bot and click the Pygame window to give it focus
  3. The robot moves to its home pose; drive it with the keyboard or a connected Xbox gamepad or Joy-Con
  4. If it stops responding, restart the robot and re-plug the dongle, or force re-pairing by sending p to both boards over serial

This website requires JavaScript to function properly. Please enable JavaScript to explore our collection of open source robotics projects.