# LeLamp

**Repository Path**: leonbdong/LeLamp

## Basic Information

- **Project Name**: LeLamp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2025-09-17
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LeLamp

![LeLamp Banner](./docs/assets/images/README/Banner.png)

An open source robot lamp based on [Apple's Elegnt](https://machinelearning.apple.com/research/elegnt-expressive-functional-movement), made by [Human Computer Lab](https://www.humancomputerlab.com/)

## Overview

![LeLamp in real life](./docs/assets/images/README/lelamp_irl.jpg)

**Build specs:** ~$130 cost | 8-12 hours | Intermediate skill level

LeLamp is an expressive robot lamp featuring:

- 🎭 **5-axis articulated movement** with servo motors
- 📸 **Computer vision** via Pi Camera
- 🎤 **Audio interaction** with microphone and speaker
- 💡 **LED expressions** with 24 programmable LEDs
- 🎮 **Record & replay** custom movements

## Build Guide

**Start here:** [Prerequisites & Planning](./docs/0.%20Prerequisites.md)

### Complete Build Process

1. [📋 Prerequisites & Planning](./docs/0.%20Prerequisites.md) - Skills, tools, and BOM
2. [🔧 Components & 3D Parts](./docs/1.%20Schematics.md) - Technical specs and electrical layout
3. [⚙️ Servo Setup](./docs/2.%20Servos.md) - Configure servo motors
4. [🎯 Lamp Head Assembly](./docs/3.%20Lamp%20Head.md) - Pi, camera, audio, LEDs
5. [🏗️ Lamp Body Assembly](./docs/4.%20Lamp%20Body.md) - Mechanical assembly
6. [🎮 Lamp Control](./docs/5.%20Lamp%20Control.md) - Recording and playback
7. [🔍 Troubleshooting](./docs/6.%20Troubleshooting.md) - Common issues and solutions

### Quick Reference

- **Bill of Materials**: [Complete component list with suppliers](./docs/0.%20Prerequisites.md#bill-of-materials)
- **3D Print Files**: Available in `/3D/` directory ([OnShape CAD](https://cad.onshape.com/documents/16c9706360b5ad34f9c8db49/w/2edfa54c83253c120fbc9e58/e/a7196194821d9cfe2842a44a))
- **Software Control**: [LeLamp Runtime Repository](https://github.com/humancomputerlab/lelamp_runtime)

## Project Status

⚠️ **Early Development** - This project is actively being developed. We published our progress early to encourage community feedback and iteration.

## Community & Support

### Getting Help

- **Start here**: [Troubleshooting Guide](./docs/6.%20Troubleshooting.md) for common issues
- **Discord**: [Join our community](https://discord.gg/727JXBt8Zt) for real-time help and discussions
- **GitHub Issues**: [Report bugs or ask questions](https://github.com/humancomputerlab/le_lamp/issues)

### Contributing

We welcome contributions:

- 🐛 Bug reports and fixes
- 📖 Documentation improvements
- 🔧 Design enhancements
- 🌍 Regional supplier information
- 📸 Build photos and videos

Please check existing issues before creating new ones.

## License

This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.