# LeLamp

**Repository Path**: dirtywave/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**: 0
- **Forks**: 0
- **Created**: 2025-12-16
- **Last Updated**: 2025-12-16

## 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:** ~$260 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.%203D%20Print.md) - Components and 3D Printed Models
3. [🎯 Lamp Assembly](./docs/3.%20LeLamp%20Assembly.md) - Mechanical and electrical assembly
4. [🏗️ Lamp Setup](./docs/4.%20LeLamp%20Setup.md) - Runtime Setup
5. [🎮 Lamp Control](./docs/5.%20LeLamp%20Control.md) - Controlling LeLamp
6. [🔍 Common Issues](./docs/6.%20Common%20Issues.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))
- **Order the Kit**: [Register interest here](https://docs.google.com/forms/d/e/1FAIpQLSfOXO2q_I2LKqYE0LoPN8VtrpKWrvJ1OkRAiS1iBFML1eqoGw/viewform?usp=sharing&ouid=105369619268976630712)
- **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.

## Maintainers
Maintained by [Human Computer Lab](https://www.humancomputerlab.com).

## Acknowledgments & Sponsors
See [CONTRIBUTORS.md](./CONTRIBUTORS.md) for contributors and their roles.  
See [SPONSORS.md](./SPONSORS.md) for sponsor thanks and how to support the project.

## License

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