Connecting to sources…

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

Documents