How to build LeLamp (open-source expressive robot lamp): the whole process
102 steps to build LeLamp (open-source expressive robot lamp), from buying parts, printing and assembly to software, calibration and training, with the bill of materials…
Not sold and no kit. The creators' BOM sheet totals $310.64 at US reference prices (read 2026‑11‑01; includes $30 of 3D prints, excludes tools, shipping and tax); the README separately says about $260. The creators note that the BOM's shopping links are for reference only
Buy parts
- Confirm Skills and Build Time
Confirm experience with electronics soldering and circuits, component identification, 3D printing and post-processing, command-line and SSH use, basic Linux administration, heat inserts, and servo mounting. Plan 8–12 hours of work over 2–3 days.
- Prepare Electronics Tools
Gather a 15–25W temperature-controlled soldering iron, 60/40 rosin-core solder (0.6–0.8mm), wire strippers, small screwdrivers, a multimeter for continuity testing, and an anti-static wrist strap.
- Prepare Mechanical Tools
Gather a heat-insert soldering iron tip or dedicated heat-insert tool, M2 and M3 hex drivers, small needle-nose pliers, wire or flush cutters, and digital calipers for verification.
- Review the LeLamp BOM
Review the complete LeLamp bill of materials. The links are references only; find the best deals in your region if possible, with an estimated United States total cost of $310.64 USD.
- Prepare a 3D printer or service
Before starting, ensure you have access to a 3D printer or printing service.
- Prepare a computer for Pi setup
Before starting, ensure you have a computer for Raspberry Pi setup and servo configuration.
- Prepare WiFi for Pi connectivity
Before starting, ensure you have a WiFi network for Raspberry Pi connectivity.
- Download and review all documentation
Download and review all documentation before continuing with preparation, printing, and assembly.
- Source all components
Source all components according to the bill of materials and verify that they work.
- Gather Tools and Servo Components
Gather a computer, servo driver board, USB cable, 5 STS3215 servos, and a servo driver board.
- Prepare the required components
Prepare a Raspberry Pi, ReSpeaker Hat, speaker, LED Matrix, SD card, and servo driver.
- Gather the required hardware
Prepare a Raspberry Pi, an SD Card, a computer, a USB cable, and an SD Card Reader.
- Register Interest in the Kit
Register interest in ordering the kit using the Google Form linked in the document.
Print and make
- Get the LeLamp print files
Find all LeLamp `.3mf` print files in the repository’s `/3D/` folder; you can also view the OnShape design linked in the document.
- Print the Lamp Base
Print 1 Lamp Base. It contains the servo driver and a normal pi.
- Print the Lamp Base Cover
Print 1 Lamp Base Cover to cover the lamp base.
- Print the Base-to-Elbow LampArm
Print 1 LampArm (Base to Elbow). It contains the base pitch and elbow pitch servos.
- Print the Elbow-to-Wrist LampArm
Print 1 LampArm (Elbow to Wrist). It contains the elbow pitch and wrist roll servos.
- Print Two Pitch LampArms
Print 2 LampArm (Pitch) pieces. The part contains a base pitch or wrist pitch servo.
- Print the Lamp Head
Print 1 Lamp Head. It contains the LED matrix and speaker.
- Print the Lamp Head Diffuser
Print 1 Lamp Head - Diffuser to diffuse the light from the LED matrix.
- Use the Optimal Print Orientation
Use the Print Plate image for the optimal print orientation and part-printing order.
- Set the Print Parameters
Follow your preferred printer’s default settings, with these values: PLA filament, 0.2mm layer height, 15% infill density, supports enabled, and tree-type supports.
- Set 3D Printing Requirements
Use a printer with a minimum bed size of 200×200×150mm; PLA+ is recommended and PETG is acceptable. Use a 0.2mm standard layer height, 0.15mm for critical parts, at least 20% infill, 30% for structural components, and supports for some parts.
- 3D print all parts
3D print all parts using a 3D printer or printing service.
Assemble
- Prepare the Ethernet cable
Strip the insulation from the Ethernet cable to expose the individual wires.
- Solder the speaker and LED matrix
Solder each Ethernet wire to the pads of the speaker and LED matrix, and keep track of which wire connects to which pad.
- Consult the WS2812B wiring tutorial
If you are unfamiliar with WS2812B LED wiring, refer to the linked tutorial.
- Optionally use individual wires
You may use individual wires instead of an Ethernet cable, provided each wire is at least 50 cm long to reach from the head to the base.
- Mount the Base Electronics
Secure the motor driver board and Raspberry Pi inside the base as shown.
- Connect Driver Board and Raspberry Pi
Use a USB Type-C cable to connect the motor driver board to the Raspberry Pi.
- Solder ReSpeaker Hat Header Pins
Solder the header pins onto the ReSpeaker Hat as shown in the image.
- Connect the ReSpeaker Hat
Connect the ReSpeaker Hat in the orientation shown in the image below.
- Connect Head and Speaker Wiring
At the other end of the Ethernet cable coming from the lamp head, solder female header connectors to each wire and a JST2.0 male connector to the speaker wire. Match each wire to the corresponding ReSpeaker Hat pin according to the schematics, and connect the speaker JST2.0 directly to the ReSpeaker Hat speaker port.
- Check Connections Before Powering On
Double-check all connections before powering on because incorrect wiring can damage components.
- Reference the OnShape Lamp Assembly
Read the full section before assembling the motors, then use the OnShape Assembly viewer to reference the exact orientation and placement of each motor and lamp part.
- Follow Mechanical Safety
Heat inserts reach over 200°C, so use appropriate tools. Wear eye protection when handling servo horns under tension, and note that small parts present a choking hazard.
- Solder headers and connectors
Solder the headers and connectors for the electronic components.
- Install heat inserts
Install heat inserts into the 3D-printed parts.
- Mount servos in printed parts
Secure the servos in their mounting positions within the 3D-printed parts.
- Route wiring through the body
Route the electronic wiring through the body and into its intended positions.
- Assemble the head components
Assemble and install the components of the LeLamp head.
- Unbox and Arrange the Servos
Unbox the servos and lay them on a table.
- Label five servo positions
Label all five servos with their intended positions.
- Connect Pi and Servo Driver
Connect the Pi to the servo driver through the USB port.
Software
- Flash Raspberry Pi OS Lite
Use Pi Imager to flash Raspberry Pi OS Lite (64-bit) onto the Raspberry Pi.
- Connect to the Pi over SSH
After flashing, SSH into the Raspberry Pi using your username and local hostname.
- Clone the LeLamp Runtime
Download the humancomputerlab lelamp_runtime repository.
- Install uv
Run the installation script to install uv for the LeLamp Runtime.
- Install audio dependencies
Install the portaudio19-dev audio dependency with apt-get.
- Synchronize runtime dependencies
Enter the lelamp_runtime directory and run uv sync with the hardware extra dependencies.
- Install the ReSpeaker device tree overlay
Get the DTS for the ReSpeaker 2-Mics Pi HAT (V2.0), compile it into a DTBO, then install and copy the overlay.
- Edit the Raspberry Pi boot configuration
Enable the ReSpeaker 2-Mics Pi HAT V2.0 overlay and i2s-mmap in /boot/firmware/config.txt.
- Edit sudo's sound configuration
Edit /etc/asound.conf to configure sound settings for sudo.
- Configure default Seeed 2-Mic audio
Set the default capture and playback device to the Seeed 2-Mic at hw:3,0, and set the default control card to 3.
- Reboot the device
Reboot the device so the default audio device configuration takes effect.
- Find the full path to uv
If uv cannot be found as root, run which uv to locate it.
- Add uv to the sudo secure path
Run sudo visudo and add /home/pi/.local/bin to sudo's secure_path.
- Set the sudo secure_path
Set Defaults secure_path as shown and replace <your_user_name_here> with the actual username.
- Download and Set Up LeLamp Runtime
On your personal computer, clone the LeLamp Runtime repository with the CLI terminal, enter the repository directory, install uv, and run uv sync to set up the runtime.
- Configure servo IDs from 1 to 5
Properly configure the servo IDs from 1 to 5 and ensure each ID is unique.
- Complete the motor setup script
Run the motor setup script and confirm that it completes successfully.
- Resolve permission errors
For permission errors, you may need to use `sudo` or add the user to the dialout group.
- Resolve servo ID conflicts
If servo IDs conflict, ensure that each servo has a unique ID.
- Obtain the LeLamp Runtime repository
Before starting, ensure you have access to the LeLamp Runtime repository at https://github.com/humancomputerlab/lelamp_runtime.
- Set up the software environment
Set up the required software environment for LeLamp during the preparation phase.
- Set up Raspberry Pi OS
Install and set up Raspberry Pi OS during electronics preparation.
Calibrate and test
- Configure Raspberry Pi settings
Set the Wifi SSID and password, username and password, and hostname, and enable SSH.
- Check whether the audio device is enabled
Run aplay -l; the expected output lists seeed2micvoicec and its tlv320aic3x-hifi subdevice.
- Adjust the Seeed 2-Mic sound level
In alsamixer, press F6 to select seeed2micvoicec and edit the Line, Line DAC, and PCM settings. Set the volume to 100 on the first try; if Line is muted, select it and press M to unmute it.
- Run the RGB functionality test
Run the lelamp.test.test_rgb module with sudo to test RGB.
- Test RGB with the full uv path
Replace uv with the path output by which uv, for example sudo /home/pi/.local/bin/uv run -m lelamp.test.test_rgb.
- Test Mic and Speaker
Run the audio test command to check LeLamp's microphone and speaker.
- Find Servo Driver Port
Run the port-finding command. You need to unplug the USB during this process; the servo is most likely connected to `/dev/ttyACM0`.
- Unplug USB to Identify Port
Unplug the USB during the process of finding which port the servo is connected to.
- Test Servo Availability
Run the motor test with the lamp name and servo driver port to check whether the servos are available.
- Verify All Tests
After completing the lamp setup, verify that all the above tests pass.
- Run the LeLamp calibration script
Enter `lelamp_runtime` on LeLamp, run the calibration command, and replace the name after `--id` with the lamp name used previously.
- Complete follower and leader calibration
Follow the steps shown in the CLI to complete calibration twice: once with the lamp as the follower and once as the leader.
- Place LeLamp in the zero position
When prompted by the script, put LeLamp into its zero position; the zero position can be viewed in the linked 3D model.
- Rotate joints safely during calibration
Rotate each joint fully except the first motor on the base or the second motor from the lamp head; for these two yaw servos, rotate only about 90° clockwise and 90° counterclockwise from the center position.
- Test all servo movements
Run the motor test command to check all servo movements.
- Test the LED ring
Run the RGB test command to test the LED ring.
- Test audio I/O
Run the audio test command to test audio input and output.
- Test the camera
Run the camera test command to test the camera.
- Check Electrical Safety
Always disconnect power while making connections and use ESD precautions when handling the Pi and servo driver. Verify that the main power supply is 5V and double-check polarity before powering on.
- Test all components individually
During electronics preparation, test every component individually.
- Configure servo IDs
Configure the unique IDs of the LeLamp servos.
- Complete integration and testing
After integrating all components, perform final testing of the complete robot.
- Check the pre-build checklist
Verify that all components are sourced and working, the 3D parts are printed and post-processed, tools and workspace are prepared, software and accounts are ready, safety equipment is available, and adequate time is allocated without rushing.
- Run the Motor Setup Script
Inside lelamp_runtime, run the motor setup script with the lamp name and servo driver port, and connect the servo accordingly. Remember the lamp name for future use.
- Test all servo command responses
Check that all servos respond correctly to commands.
- Troubleshoot an undetected servo
If a servo is not detected, check the USB connection and port.
Data and training
- Record a movement
Run the recording command in runtime using your_lamp_name, your_port, and rotation as arguments.
- End and save recording
While recording movement, hold CTRL + C to end and save the recording.
- Replay a movement
Run the replay command in runtime with your_lamp_name, your_port, and rotation.
- List recorded movements
Run the listing command in runtime to see all recorded movements for the specified your_lamp_name.
- Position LeLamp safely
Position LeLamp in a safe working area with full range of motion.
- Record a simple movement
Record a simple movement to test the system.
- Replay and verify movement
Replay the recorded movement to verify its accuracy.
- Save successful recordings
Save successful recordings for future use.
Use it
- Confirm Functional LeLamp
Confirm that you now have a functional LeLamp.
Parts
- 5 × Feetech STS3215 serial bus servos: base yaw, base pitch, elbow pitch, wrist roll, wrist pitch ($23.99 each in the BOM) plus a Waveshare serial bus servo driver
- Raspberry Pi 4 (the BOM says a 3B/4/5 also works) with a 32 GB microSD; ReSpeaker 2-Mics Pi HAT V2.0
- Head: an 8×5 WS2812B LED matrix and a 4 Ω 3 W speaker, wired to the base through a stripped Ethernet cable
- Two supplies: a 5V 2A DC adapter for the servos and a 5V 2A USB‑C charger for the Pi
- 8 PLA prints: base, base cover, two arm sections, two pitch pieces, head and diffuser (15% infill, tree supports)
- M3 16 mm and M2 4 mm screws, M2/M3 heat-set inserts, pin headers and jumper wires
Tools
- 3D printer with at least a 200×200×150 mm bed, or a printing service
- Temperature-controlled soldering iron (15–25 W) with a heat-insert tip, wire strippers, multimeter
- M2/M3 hex keys, needle-nose pliers, flush cutters, digital calipers, small screwdrivers
- A computer for flashing the OS and setting up servos, plus an SD card reader
Skills
- Soldering and wiring: the WS2812B, ReSpeaker headers, extending servo leads
- Raspberry Pi OS Lite, SSH and the Linux command line, with uv for Python environments
- Servo ID setup and calibration (LeRobot-based scripts), with an optional LiveKit and OpenAI voice agent
Software
- lelamp_runtime (Python, LeRobot plus the Feetech servo SDK): servo setup, calibration, motion record and replay, with 11 pre-recorded motions
- Sample voice agent: LiveKit Agents with OpenAI Realtime, triggering motions and lights from conversation
- URDF and MuJoCo models in simulation/; public Onshape CAD and assembly