This project proposed a smart home semantic understanding framework that enables natural language interactions through edge computing and LLMs, facilitating a paradigm shift from command-based control to conversational interaction. The system achieves:Edge Computing and Large Language Model (LLMs) Powered Semantic Frameworks for Connected Smart Homes
- 94% accuracy in standard command recognition
- 91% accuracy in fault-tolerant testing
- 96.9% accuracy in distinguishing commands from non-commands
- Intent-based Interaction: Move beyond command-based to natural conversation
- Semantic Understanding: Advanced LLM-powered context awareness
- Multi-language Support: English and Chinese voice commands
- Scene Intelligence: Automated environment optimization
- Multi-room Support: Living room, bedroom, kitchen, study, bathroom
- Device Categories: Lighting, HVAC, fans, curtains, sensors
- Environmental Monitoring: Temperature, humidity, CO2, VOC, light levels
- Real-time Updates: WebSocket-based live status monitoring
- User Mode: Intuitive interface for daily home control
- Developer Mode: Advanced testing and debugging tools
- ESP32 Ecosystem: Audio processing, display control, sensor integration
- Scalable Architecture: Easy addition of new devices and rooms
- Edge Processing: Reduced latency and enhanced privacy
The system consists of 5 microservices running in Docker containers, designed for collaboration between low-power devices (ESP32) and PC-side Docker containers:
| Service | Port | Purpose | Health Check |
|---|---|---|---|
| 🎯 Coordinator | 8080 | Central orchestration | GET / |
| 🎤 STT | 8000 | Speech-to-Text using OpenAI Whisper | GET / |
| 🔊 TTS | 8001 | Text-to-Speech using Microsoft Edge TTS | GET / |
| 🏠 IoT | 8002 | Smart device management | GET / |
| 🧠 LLM | 11434 | LLM processing for natural language understanding | GET / |
https://github.com/ReikiC/SmartHome-Hardwares
Notice: The principle design of "Reiki" is refer and modified from: https://oshwhub.com/esp-college/esp-spot
-
Docker and Docker Compose
-
8GB+ RAM recommended
-
Network access for initial model downloads
Clone the repository
git clone https://github.com/Reikimen/SmartHome-Docker-LLM.git
cd SmartHome-Docker-LLMDeploy services using Docker Compose
docker-compose up -d --buildAccess the web interface
cd web
chmod +x start-web.sh
./start-web.shOr on Ubuntu 18.0:
cd web
chmod +x start-web-python.sh
./start-web-python.shInitialize LLM model (First time only)
- Access Developer Mode in the web interface
- Navigate to "Dynamic Model Management Module"
- Enter your preferred LLM model in "Quick Model Download"
- Wait 2-10 minutes for download completion
Stop services
docker-compose downDesigned by Fusion 360. Click to access: SmartHome-Model.f3d
Click to access: Documentation
This project is licensed under the MIT License - see the LICENSE file for details.
- UCL Centre for Advanced Spatial Analysis for research support
- OpenAI for Whisper speech recognition model
- Meta for Llama language models
- Microsoft for Edge TTS technology
- Espressif for ESP32 platform
Built with ❤️ for the future of smart homes








