> ## Documentation Index
> Fetch the complete documentation index at: https://humancomputerlab.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LeLamp - Build Your Own Expressive Robot Lamp

> Complete guide to building LeLamp, an open-source expressive robot lamp with 5 degrees of freedom, camera, audio, and programmable LEDs

# Welcome to LeLamp Documentation

LeLamp is an open-source expressive robot lamp that brings personality and interactivity to your space. With 5 degrees of freedom, camera vision, audio capabilities, and programmable LEDs, LeLamp can express emotions, respond to voice commands, and create engaging interactions.

> [card] [Quick Start](https://humancomputerlab.mintlify.site/prerequisites.md)
>
> Get started with the essential requirements and planning for your LeLamp build

> [card] [Hardware Setup](https://humancomputerlab.mintlify.site/servo-setup.md)
>
> Step-by-step assembly instructions for servos, electronics, and mechanical components

> [card] [Software Configuration](https://humancomputerlab.mintlify.site/raspberry-pi-setup.md)
>
> Configure your Raspberry Pi and set up the LeLamp runtime environment

> [card] [Troubleshooting](https://humancomputerlab.mintlify.site/troubleshooting.md)
>
> Solutions to common issues and debugging techniques

## What You'll Build

LeLamp features three main sections working together to create an expressive robotic companion:

### LeLamp Head

* **Camera** — Computer vision for environmental awareness
* **Speaker** — 4Ω/3W audio output for voice and sound effects
* **LED Matrix** — WS2812B programmable LEDs for visual expressions

### LeLamp Base

* **Raspberry Pi with ReSpeaker Hat** — Central control unit for servos, audio, and LEDs
* **Motor Driver** — Precise control of servo motors
* **Power Management** — Dual power supply system for optimal performance

### LeLamp Body

* **5 Servo Motors** — Provides expressive movement with multiple degrees of freedom
* **Precision Mechanics** — 3D printed components for smooth, reliable operation

## Key Features

> [accordion] Expressive Movement
>
> 5 degrees of freedom allow LeLamp to nod, turn, tilt, and gesture naturally, creating lifelike expressions and interactions.

> [accordion] Audio Interaction
>
> Built-in microphone and speaker enable voice commands, responses, and ambient audio reactions.

> [accordion] Visual Expression
>
> Programmable LED matrix displays emotions, status indicators, and custom light patterns.

> [accordion] Computer Vision
>
> Integrated camera allows LeLamp to see and respond to its environment and users.

> [accordion] Open Source
>
> Complete hardware designs, software, and documentation available for customization and improvement.

## Project Overview

> [!NOTE]
>
> **Skill Level**: Intermediate to Advanced\
> **Build Time**: 8-12 hours over 2-3 days\
> **Estimated Cost**: \$310 USD (components may vary by region)

This project requires experience with:

* Electronics (soldering, basic circuits)
* 3D printing and mechanical assembly
* Command line and basic Linux administration
* Software installation and configuration

## Getting Started

Ready to build your LeLamp? Start with the [Prerequisites](https://humancomputerlab.mintlify.site/prerequisites.md) page to ensure you have everything needed for a successful build.

> [!TIP]
>
> Join our [Discord community](https://discord.gg/4hmNW3Ep) for real-time help, build photos, and discussions with other LeLamp builders!

## Resources

* **Main Repository**: [LeLamp Hardware](https://github.com/humancomputerlab/le_lamp)
* **Runtime Software**: [LeLamp Runtime](https://github.com/humancomputerlab/lelamp_runtime)
* **3D Models**: [OnShape Assembly](https://cad.onshape.com/documents/16c9706360b5ad34f9c8db49/w/2edfa54c83253c120fbc9e58/e/a35eec618cd78ea5d74bf01b)
* **Bill of Materials**: [Component Spreadsheet](https://docs.google.com/spreadsheets/d/1C50qqSxJjCHEnh6j_Dcfx8JzyLlGobKSOYA0ePJUDVk/edit?gid=1580017414#gid=1580017414)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.