ESPHome - Smart Home Made Simple

Introducing the ESPHome Starter Kit! The easiest path to building your own smart home devices – no soldering, breadboarding, or coding required.
When you can’t find the smart home device you need in a store, build it yourself! Turn inexpensive components into sensors, switches, displays, and more – just tell ESPHome what to do and it handles the rest, with no need to code unless you want to.
Already using ESPHome?
Building your own smart home device from scratch can feel daunting, particularly if you’re not familiar with coding. Not with ESPHome. Its intuitive Device Builder replaces code with simple visual choices for a hassle-free setup that brings you straight into building without touching a command line. And for experienced users who prefer writing code manually, YAML is always there if you need it. Every device works out of the box with Home Assistant, too – locally, privately, and securely.
Whether you’re building your first sensor or managing fifty devices, the initial workflow stays the same…
Step 1: Choose & configure
Select your board and components using the visual Device Builder or a YAML file. Pick sensors from the catalog and set your options without writing code.
Step 2: Build & install
ESPHome installs your configuration to your device straight from your browser, or wirelessly over the air.
Step 3: Connect & control
Your new device automatically pops up in Home Assistant over your local network: no cloud accounts or external servers required.
Be inspired by our community’s clever ideas for unique, customized smart home gear – and borrow their recipes for your next project.
A simple, web-configurable control panel for your smart home, built with cheap touchscreen displays.
Turns an ordinary doorbell into a smart notification system for just a couple of dollars in parts.
An e-ink display that blends into your home decor while showing live data from your smart home.
A custom air quality sensor with its own PCB and 3D-printed housing for monitoring the air you breathe at home.
A DIY thermostat and sprinkler controller that brings professional-grade climate control to Home Assistant.
Turns a non-smart energy meter with a pulse output into a fully monitored smart energy sensor.
Browse the Device List for community-documented devices, or check out Made for ESPHome certified products built by hardware manufacturers.
Ready to bring your smart home ideas to life? Grab a board (such as our official ESPHome Starter Kit or an ESP32 development board) and install in the way that suits you:
Choose your hardware
If you’re new to this type of hardware, we recommend the ESPHome Starter Kit: the easiest way to make your own smart home devices, and your gateway to learning ESPHome. The kit includes an ESP-32 board, ribbon cables, and a snap-apart panel with four modules (motion, temperature and humidity, notification, and button) – each one ready to become its own smart device. With all the components you need, along with a Learning Wiki and the visual ESPHome Device Builder, you can skip the guesswork and start building right away.
For the simplest setup: ESPHome Desktop App
A complete package containing everything you need to install with one click.
Available for Windows, macOS, and Linux.
A step-by-step guide
Our documentation walks you through everything from setting up your first device to more advanced configurations. Begin with our Get Started guide, then explore from there.
Ready-Made Projects: The fast route to a finished device
While installing ESPHome gives you freedom to build smart home devices your way, you may not need custom configuration. If you just want to quickly turn a board into a Bluetooth proxy, voice assistant, or media player for example, our Ready-Made Projects are the answer. They’re pre-configured to work with Home Assistant straightaway, so you can install them directly from your browser in a single click: no need to install ESPHome.
Now you’re set up it’s time to get cooking! Here are a few practical recipes to help you build your very first project – there’s something to suit all experience levels.
Get started with the ESPHome Starter Kit – the easiest path to building your own smart home devices.
Measure temperature, humidity, and air pressure using a BME280 sensor.
Build a mini desktop clock that shows live sensor data.
Browse our full Cookbook for more step-by-step recipes – and remember, you can also install our Ready-Made Projects in a single click without any configuration.
Tap into the knowledge and experience of the thousands of makers already using ESPHome. Get advice, troubleshoot tricky setups, and learn directly from people who’ve been there.
Chat with the community in real time.
Ask questions and share projects.
Follow development or contribute.
The modern standard for DIY smart devices. Powerful, budget-friendly, and packed with built-in Wi-Fi and Bluetooth.
The original low-cost Wi-Fi microcontroller. Ideal for basic sensors and simple projects.