ESPresense-companion

A Home Assistant Add-on / Docker container that solves indoor positions using MQTT data received from multiple ESPresense nodes. The companion is the central brain of your ESPresense system. It:

• Processes distance readings from all nodes using trilateration to determine device locations
• Reports device room presence to Home Assistant via MQTT
• Visualizes BLE device locations on your floorplan
• Manages and configures ESPresense nodes
• Updates node firmware
• Adjusts device-specific settings
• Monitors and controls automatic node optimization

Documentation

1. Installation Guide
2. Configuration Guide
3. Node Setup
4. Optimization Guide

Need Help?

• Join our Discord Community
• Check the Troubleshooting Guide
• Report issues on GitHub

Contributing

• Submit pull requests
• Improve our documentation

trigger CI