How to build Robbi: the whole process
62 steps to build Robbi, from buying parts, printing and assembly to software, calibration and training, with the bill of materials, shop links and the official sources.
Robbi is a tiny Raspberry Pi companion robot with a face, camera, voice, and two encoder-equipped wheels. The repository provides printable enclosure parts, a custom PCB, a bill of materials, wiring and assembly instructions, and the software needed to set it up.
Bill of materials · Individual printable parts
| Part | Qty |
|---|---|
| Main chassis · Chassis · 01 · Supplied side down; motor axes vertical; bed-only tree/organic supports. | 1 |
| Rear electronics cover · Rear cover · 02 · Outside face down, Pi rails up; normal supports under raised end lips. | 1 |
| Side panels · Battery side · GPIO side · 03, both panels · Outside faces down; no supports. Preserve the 0.8 mm pocket skins. | 1 each |
| New front-fastened motor clip · Clip · 11 · Broad side down; no supports; four walls, 40% configured infill, 26 top and 26 bottom layers make this small part so | 1 |
| 11 mm stack spacers · One spacer · 04, four spacers · Upright; no supports. STL = one spacer; 3MF = four. | 4 |
| Button rocker · Nominal rocker · 06 · PETG, 0.16 mm, bearing axis vertical, bed-only tree supports. | 1 |
| Button keeper and split pivot pin · Keeper · Pin · 07, both parts · PETG, 0.16 mm, no supports; keeper flat, pin horizontal. Pin-only 3 mm outer brim, zero gap. | 1 each |
| Fixed head carrier and hollow neck · Head carrier · 08 · Front bezel down, rear open upward; normal supports from bed only. | 1 |
| Head rear service cover · Head cover · 09 · Outside rear face down, posts up; no supports; reference outer-wall speed 40 mm/s. | 1 |
Buy parts
- Read Prototype Limitations First
Read the current prototype limitations before ordering parts or beginning assembly.
- Consult the Parts List
Use bom.csv for part quantities, variants, and purchase links.
- Order the Robbi parts
Follow the linked parts list to obtain the components needed for Robbi.
Print and make
- Use the Matching 2026-10-13 Files
Use all files from the 2026-10-13 folder together. Do not mix in earlier chassis, panels, motor clips, or head parts.
- Import STLs at Full Scale
The STL models are already oriented for printing. Import them at 100% scale without resizing.
- Configure and Slice the Print
Select your actual printer, nozzle, filament, and build plate. The reference projects use a Bambu A1 with a 0.4 mm nozzle; inspect and slice the models again.
- Treat 3MF Files as Projects
The supplied 3MF files contain models and slicer settings. They are not ready-to-run G-code, so generate the G-code from the selected settings.
- Apply Default Reference Settings
Use PLA, 0.20 mm layers, three walls, and 15% infill as the default reference settings. These settings have not been physically validated as a print recipe.
- Print Small Parts Solid
For the button reference, use three walls, 15% configured infill, and 20 top and 20 bottom layers. These settings make the small parts solid.
- Remove the Fork Brim Carefully
Support the fork while gently clipping off its brim.
- Preserve Button and Pin Dimensions
Preserve the flexible rocker leaf, keeper spring, and split pin. Do not enlarge the 2.4 mm button bores or sand away the 2.30 mm pin’s working diameter.
- Upload and check the Gerbers
Upload the Gerber ZIP unchanged, then check the rendered outline, layer assignment, drill alignment, and preview against the board photographs.
- Enter the PCB fabrication settings
Use four layers, a 75 × 45 mm outline, 1.6 mm FR-4, 1 oz outer copper, 0.5 oz inner copper, green mask, white silkscreen, and lead-free HASL. Confirm how the manufacturer interprets via treatment and that it prepares the required assembly rails.
- Upload assembly BOM and placement
Request PCB assembly and upload the matching BOM and pick-and-place CSV files together. If prompted, select UTF-8 and tab delimiters, then review the imported part mapping.
- Match parts by manufacturer numbers
Match each part using the specified manufacturer part number and supplier part number. Do not allow unrelated products referenced by free-text link fields to override the MPN/LCSC selection.
- Review the PCB assembly preview
Check polarized capacitor polarity, USB-C orientation, and the underside connector in the assembly preview. Resolve any substitutions against the intended footprint and electrical function before ordering.
- Confirm the U6 socket assembly scope
U6 is a 2 × 20 female socket on the bottom side marked “HAND SOLDER BACK SIDE”. Agree whether the manufacturer fits it or whether it is supplied for hand assembly; do not fit it twice or on the top side.
- Check optional assembly components
Determine whether BAT, LCD, H1/H2, encoder, speaker/servo headers, test pins, and switches are included in the assembly service or supplied separately. Keep any optional fitted connectors electrically unused when the guide does not use them.
- Prepare the Printed Revision Files
Use the matching individual STL files, reference 3MF projects, revised fasteners, and mechanical assembly order from the print files.
- Use Matching PCB and Print Revisions
Use the PCB revision and print revision listed in the guide together.
- Prepare PCB Manufacturing Files
Use the linked PCB manufacturing files for the Gerbers, BOM, placement, schematic PDF, and editable EasyEDA source.
- Use the Enclosure Model
Use the linked enclosure model from hardware/prints/README.md.
- Prepare the printing tools and parts
Follow the linked printing and tool preparation guide before producing the printed parts.
Assemble
- Orient the PCB
Place the board component side up with the USB-C connector on the left and the LCD and H1 headers along the top.
- Identify connector pin-one ends
For the LCD, H1 and both motor connectors, pin 1 is at the left end in the top view.
- Identify and leave H2 empty
H2 pin 1 is at the top end in this view, and H2 remains empty in this build.
- Identify battery polarity
BAT pin 1 is the right-hand pad and connects to battery positive; pin 2 is negative.
- Identify the speaker connector
SPEAKER/H3 pin 1 is on the left. H3 is the manufacturing-file reference, while SPEAKER is the board label.
- Position the U6 socket
The female 40-pin socket fits on the board underside. Use the top-view drawing without mirroring it when identifying copper pads.
- Disconnect power before wiring
Disconnect both the battery and USB before performing wiring and continuity checks.
- Preconnect LCD and encoder
Preconnect the LCD and MENCODER_L before inserting the board stack, and leave their remote ends free for routing.
- Route display housings separately
Feed each display housing individually through the 12 mm diameter neck.
- Leave servo outputs unused
Do not use H2 or the servo outputs in this build.
- Connect the LCD display
Match the printed signal names: the display starts with GND and VCC, while the PCB starts with VCC and GND. Do not use an unverified straight-through harness; the display's SDA and SCL are SPI data and clock, not the ToF sensor's I²C bus.
- Wire the forward distance sensor
Connect VCC, GND, SDA, SCL and XSHUT according to the sensor's printed labels rather than physical left-to-right order. H1 pin 5 has no routed connection, H1 pin 6 reaches Pi physical pin 33 / BCM13, and the empty H2 connector uses physical pin 32 / BCM12 for XSHUT.
- Connect the left motor encoder
Connect the left six-wire motor cable using the MENCODER_L table. Encoder VCC is 3.3 V, and motor power is a separate circuit.
- Connect the right motor encoder
Connect the right six-wire motor cable using the MENCODER_R table. Encoder VCC is 3.3 V, and motor power is a separate circuit.
- Terminate the supplied motor cables
Use the supplied motor cable at the encoder board and terminate the other end to match the corresponding wiring table. Left and right are always defined from Robbi's viewpoint while looking forward.
- Identify motor pins before power
The exact motor-cable colour assignment has not been established from the available references. Identify the motor maker's pin labels before powering the motor and do not guess encoder power from wire colours.
- Build Electronics and Fit the Body
Build the electronics on the bench before fitting them into the printed robot body.
- Identify Motors and Wheels
Use the motors-and-wheels video for component identification and general assembly techniques. The revised motor clip is not demonstrated by the older footage.
- Identify the Head Assembly
Use the head-assembly video for component identification and general techniques. The fixed head and revised stack insertion order must be followed from the written revision because they are absent from the older footage.
- Complete the Dry-Fit Checks
Complete all dry-fit checks before gluing the enclosure or using the robot with power. CAD fit and slicer checks alone do not establish real-world fit or strength.
- Leave Unused Connections Unconnected
The second ToF connector and servo outputs are unused in this build.
- Use the Wiring Reference
Use WIRING.md for the top-view connector drawing, numbered pins, display power-pin swap, and power test points.
- Disconnect Power During Assembly
Keep the power disconnected while changing wiring or fitting parts.
- Assemble the robot mechanics and electronics
Fit the motors, clip, holder and button, then insert the electronics stack. Attach the fixed head only after inserting the electronics stack, following the assembly guide for the 13 October 2026 printed design.
Software
- Start the First-Install Walkthrough
Use the complete first-install walkthrough for the reusable runtime in `software/`.
- Install the Runtime Over SSH
After the Raspberry Pi is reachable by SSH, run the supplied installation command.
- Configure the Terminal Wizard
Enter your API keys and choose the model, voice, dashboard password, Wi-Fi settings, and optional Telegram configuration in the terminal wizard. Normal operation then moves to the dashboard.
- Follow the One-Command Installation
Follow 03-software.md for the minimal terminal setup, automatic startup, and generated configuration.
- Set the right encoder pin
Set `hardware.right_encoder_b_pin: 16` for this PCB. GPIO7 was only a repair on the original robot's faulty Pi, so do not join GPIO7 and GPIO16.
- Install the Raspberry Pi software
Prepare Raspberry Pi OS Bookworm Lite 64-bit and connect to the Raspberry Pi by SSH. Follow the linked first setup guide.
Calibrate and test
- Watch the Component and Test Guide
Use the 4K silent build video for component identification, electronics tests, and general assembly techniques. The footage shows an earlier enclosure, so follow the written steps for the 13 October 2026 printed revision.
- Perform the Final Checks
Use the final-checks video for the shown final check procedures. Account for unresolved wheel and tread print settings, fasteners, motor-cable identification, and measured power and load limits.
- Finish Bench Tests Before Shell Assembly
Complete the bench tests before mounting the electronics in the shell.
- Record Build Revisions and Results
Use build-record.csv to record revisions, measurements, and test results.
- Raise Both Wheels for Motor Checks
Raise both wheels for the first powered motor checks.
- Use a Safe Area for Floor Tests
Use a clear, level area away from edges for floor tests because the forward ToF sensor does not provide cliff detection.
- Test the electronics on the bench
Verify the bare PCB before connecting it to the Raspberry Pi. Use the linked bench tests to check each peripheral.
- Calibrate Robbi and run final checks
Complete the IMU and motor calibration and the voice tests using the linked calibration guide. If a check fails, use the troubleshooting guide.
- Verify the square pin-one pad
Verify the square copper pad when a fitted connector hides the pin-one outline.