This project has moved to intercom-api
intercom-api is the successor to this project. It provides:
- Full-duplex Browser ↔ Home Assistant ↔ ESP32 audio
- Native ESPHome + Home Assistant integration (HACS compatible)
- Custom Lovelace card with one-click calling
- TCP-based protocol — reliable locally and remotely
- Voice Assistant integration (wake word, STT, TTS)
- ESP-to-ESP bridged calls through Home Assistant
This repository contains the original ESPHome intercom component based on UDP streaming and go2rtc/WebRTC. It is no longer actively maintained.
The UDP/WebRTC approach had inherent limitations: audio could become one-directional, streaming stopped when the browser tab lost focus, and NAT traversal issues prevented reliable remote access.
intercom-api solves all of these problems. If you're starting a new project, use intercom-api.
Direct ESP-to-ESP peer-to-peer communication over UDP (no Home Assistant needed). If that's your use case, the code in this repo works fine.
MIT License — see LICENSE
Developed by @n-IA-hane with Claude Code