Установка ESPHome на Windows 10

Давай установим ESPHome напрямую на Windows 10, без Docker, с понятными шагами и подробными комментариями.

Я покажу самый надёжный способ через Python + pipx — это официальный и рекомендуемый вариант.

🧱 Что в итоге получим

ESPHome запускается из командной строки Windows
Можно:
- создавать .yaml прошивки
- прошивать ESP по USB
- обновлять ESPHome OTA
Работает независимо от Home Assistant
(но отлично с ним дружит)

0️⃣ Предварительные требования

✅ Что нужно:

Windows 10 (у тебя есть)
Доступ администратора
ESP8266 / ESP32
USB-кабель DATA, не только зарядка

1️⃣ Установка Python (если уже есть — всё равно проверь)

🔹 Скачай Python

👉 https://www.python.org/downloads/windows/

Рекомендуемая версия: Python 3.11.x

🔹 ВАЖНО при установке

На первом экране обязательно поставь галочку:

☑ Add Python to PATH

Затем:

Install Now

🔹 Проверка установки

Открой CMD или PowerShell и выполни:

Ожидаемый результат (пример):

2️⃣ Установка pipx (чистый и безопасный способ)

pipx позволяет ставить ESPHome изолированно, без мусора в системе.

Добавляем pipx в PATH:

⚠️ После этого:

закрой CMD
открой заново

🔹 Проверка pipx

3️⃣ Установка ESPHome

⏳ Подождать 1–2 минуты — pipx сам подтянет всё нужное.

🔹 Проверка ESPHome

Пример:

✅ Значит установка прошла успешно

4️⃣ Создание проекта ESPHome

📁 Создаём папку для проектов

🧠 Создаём конфигурацию устройства

ESPHome задаст вопросы:

📌 В результате появится файл:

5️⃣ Прошивка ESP по USB (первый раз)

🔌 Подключи ESP к ПК по USB

Если драйверов нет:

CH340 — для большинства ESP32
CP210x — для ESP32 DevKit

(Windows часто ставит сам)

🚀 Прошивка

ESPHome:

скомпилирует прошивку
предложит порт (COM3, COM4 и т.д.)
зальёт прошивку

6️⃣ OTA-прошивки (без USB)

После первой прошивки:

ESPHome сам:

найдёт устройство в сети
предложит OTA
прошьёт по Wi-Fi

7️⃣ Подключение к Home Assistant

В Home Assistant:

ESP появится автоматически, если:

в одной сети
ESP включён

8️⃣ Полезные команды (шпаргалка)

9️⃣ Типичные проблемы и решения

❌ `esphome: command not found`

➡️ CMD не перезапущен после pipx ensurepath

❌ ESP не определяется

➡️ Проверь:

кабель DATA
драйвер USB-UART
COM-порт в диспетчере устройств

❌ OTA не работает

➡️ Проверь:

ESP и ПК в одной сети
firewall Windows (разреши Python)

🔧 Что делаем дальше?

Можем:

собрать минимальный YAML под твою плату
добавить GPIO / реле / датчики
прошить ESP без Home Assistant
сделать ESP как Wi-Fi реле

👉 Напиши:

ESP32 или ESP8266?
какая плата (DevKit, NodeMCU, Wemos, ESP32-C3 и т.д.)
что ты хочешь к ней подключить

Дальше пойдём уже «по-железу» 🔌💡

C:\Users\rich650>pipx install esphome Fatal error from pip prevented installation. Full pip output in file: C:\Users\rich650\pipx\logs\cmd_2025-12-21_12.52.23_pip_errors.log pip seemed to fail to build package: 'ruamel.yaml.clib' Some possibly relevant errors from pip install: error: subprocess-exited-with-error ImportError: cannot import name 'Str' from 'ast' (C:\Users\rich650\AppData\Local\Programs\Python\Python314\Lib\ast.py) ERROR: Failed to build 'ruamel.yaml.clib' when getting requirements to build wheel Error installing esphome.

Отлично, ты дал ключевую ошибку, по ней всё сразу ясно 👍
Это НЕ твоя ошибка, а несовместимость версий.

❌ В ЧЁМ ПРОБЛЕМА (коротко)

У тебя установлен Python 3.14:

А ESPHome (и зависимость ruamel.yaml.clib) НЕ поддерживают Python 3.14.

📌 Конкретно:

в Python 3.14 изменили модуль ast
библиотека пытается импортировать Str, которого больше нет
сборка падает на этапе wheel

👉 ESPHome сейчас работает ТОЛЬКО с Python 3.9 – 3.12
(официально рекомендован Python 3.11)

✅ РЕШЕНИЕ (ПРАВИЛЬНОЕ И НАДЁЖНОЕ)

🔥 Полностью не удаляем Python 3.14

Просто ставим Python 3.11 параллельно и используем его для ESPHome.

1️⃣ Устанавливаем Python 3.11

👉 Скачай ИМЕННО ЭТУ версию:
https://www.python.org/downloads/release/python-3119/

При установке ОБЯЗАТЕЛЬНО:

☑ Add Python to PATH
☑ Install for all users

2️⃣ Проверяем, что Python 3.11 доступен

Открой НОВЫЙ CMD и выполни:

Ожидаемо:

⚠️ Если команда py не работает — скажи, покажу альтернативу.

3️⃣ Устанавливаем pipx ЧЕРЕЗ Python 3.11

Добавляем pipx в PATH:

🔴 ВАЖНО
Закрой CMD → открой заново

4️⃣ Устанавливаем ESPHome (теперь заработает)

pipx install esphome --python "C:\Users\rich650\AppData\Local\Programs\Python\Python311\python.exe"

📌 Теперь:

будет использоваться Python 3.11
ruamel.yaml.clib соберётся без ошибок

5️⃣ Проверка

Пример:

✅ Это значит — всё починено

🧠 ПОЧЕМУ Я СРАЗУ СКАЗАЛ ПРО PYTHON

Ошибка:

➡️ 100% признак Python 3.14
Я это вижу сразу, ты ничего не «сломал».

🟢 АЛЬТЕРНАТИВА (если не хочешь pipx)

Если вдруг pipx снова взбрыкнет, есть запасной вариант:

(тоже рабочий, но менее удобный)

🔧 Что делаем дальше?

Как только esphome version заработает, можем:

создать первый YAML под твою плату
прошить ESP32 / ESP8266
сразу добавить GPIO / реле / датчики
или интегрировать в Home Assistant

ESPHome сам по себе CLI-инструмент, а веб-интерфейс в Home Assistant — это интеграция. Если ты хочешь иметь аналогичный веб-интерфейс отдельно на Windows, есть несколько способов.

1️⃣ ESPHome Dashboard

Официальный способ — ESPHome Dashboard.
Это локальный веб-интерфейс, через который можно:

Создавать YAML-проекты
Загружать прошивки
Смотреть логи
Обновлять устройства OTA
Всё примерно как в Home Assistant

2️⃣ Установка ESPHome Dashboard на Windows

Если у тебя уже установлен ESPHome через pipx или venv, то делаем так:

🔹 Запуск Dashboard

📌 Пояснение:

C:\esphome — папка, где будут храниться YAML-файлы для устройств
Команда запускает веб-сервер на локальной машине (по умолчанию порт 6052)

🔹 Проверка

Открой браузер и перейди по адресу:

Ты увидишь ESPHome Dashboard, аналогичный интерфейсу в Home Assistant
Можно создавать новые устройства, редактировать YAML, прошивать ESP и смотреть логи

3️⃣ Параметры запуска

Можно указать порт вручную:

Тогда доступ будет через http://localhost:8080

Можно указать адрес, если хочешь, чтобы Dashboard был доступен по локальной сети:

Тогда с любого устройства в сети можно зайти на http://<IP_компьютера>:6052

⚠️ Обязательно разреши Python в Windows Firewall.

4️⃣ Создание первого проекта через Dashboard

Нажми “+ New Device”
Выбери ESP32 или ESP8266
Введи SSID и пароль Wi-Fi
Скачай/создай YAML
Прошей устройство через USB или OTA

5️⃣ Полезные команды Dashboard

Все команды работают как через CLI, но с Dashboard становится проще и визуально.

6️⃣ Резюме

ESPHome CLI — ядро, работает через командную строку
ESPHome Dashboard — веб-интерфейс поверх CLI, как в Home Assistant
Для Windows:
1. Установить Python 3.11
2. Установить ESPHome через pipx или venv
3. Запустить Dashboard через esphome dashboard <папка>
4. Открыть браузер на localhost:6052

Если хочешь, я могу написать полностью готовый пошаговый гайд для Windows 10, чтобы:

Установить Python 3.11
Установить ESPHome через pipx
Создать папку проектов
Запустить Dashboard
Прошить первое ESP

~~комментариями~~

можно ли сделать автоматическое поднятие dashboard при загрузки или сделать bat афйл для ~~каждого~~ручного ~~шага.~~активирования

Да, можно сделать оба варианта: автоматический запуск при старте Windows или ручной запуск через BAT-файл. Разберём оба подхода с комментариями.

1️⃣ Ручной запуск через BAT-файл (самый простой)

Открой Блокнот и вставь:

📌 Объяснение:

activate.bat — активирует виртуальное окружение Python (если используешь venv)

esphome dashboard ... — запускает веб-интерфейс

pause — удерживает окно CMD открытым после завершения, чтобы видеть ошибки

Сохрани как start_esphome_dashboard.bat

Дважды клик — Dashboard откроется автоматически.

Можно создать ярлык на рабочем столе для быстрого доступа.

2️⃣ Автоматический запуск при загрузке Windows

🔹 Вариант 1: через папку автозагрузки

Создай BAT-файл как выше (start_esphome_dashboard.bat)

Нажми Win + R, введи shell:startup → откроется папка автозагрузки

Перетащи BAT-файл или его ярлык в эту папку

✅ После перезагрузки Windows BAT-файл автоматически выполнится и поднимет Dashboard

🔹 Вариант 2: через Планировщик задач (Task Scheduler)

Более надёжный способ:

Открой Планировщик задач (Task Scheduler)

Создай новую задачу
- Имя: ESPHome Dashboard
- Триггер: При входе пользователя
- Действие: Запустить программу
  - Программа/скрипт: путь к start_esphome_dashboard.bat

Вкладка Общие → выбрать “Выполнять с наивысшими правами”

Сохрани задачу

✅ Теперь Dashboard будет подниматься автоматически при загрузке Windows.

3️⃣ Советы

Если используешь venv, обязательно активируй его в BAT-файле (activate.bat)

Можно добавить опцию --host 0.0.0.0, чтобы Dashboard был доступен по сети:

Если Windows Firewall блокирует, нужно разрешить Python для входящих соединений

Да, всё верно — PlatformIO требует Git, потому что он использует репозитории для скачивания библиотек, платформ и обновлений.

На Windows это легко исправить. Вот пошаговая инструкция с комментариями:

1️⃣ Скачиваем Git для Windows

Перейди на официальный сайт:

https://git-scm.com/download/win

Выбираем Windows Installer (32 или 64 бит — обычно 64)

Скачиваем и запускаем

2️⃣ Устанавливаем Git

Во время установки важно обратить внимание на следующие шаги:

Select Components – оставь галочки по умолчанию

Adjusting your PATH environment – обязательно выбери:

Git from the command line and also from 3rd-party software

✅ Это позволит PlatformIO видеть Git из командной строки

Остальные шаги можно оставить по умолчанию

Нажми Install и дождись окончания

3️⃣ Проверяем установку

Открой CMD или PowerShell и введи:

Ожидаемый результат:

✅ Значит Git установлен и доступен в PATH

4️⃣ Перезапускаем PlatformIO

Закрой ESPHome / VSCode / PlatformIO IDE

Открой заново

Снова попробуй сборку ESP32

PlatformIO теперь сможет использовать Git для скачивания платформ и библиотек

5️⃣ Полезная заметка

Git нужен только для PlatformIO, ESPHome или Arduino IDE можно использовать и без него, но с PlatformIO он обязателен

После установки Git можно спокойно работать с ESP32, ESP8266 и их библиотеками через PlatformIO

Установка ESPHome на Windows 10

🧱 Что в итоге получим

0️⃣ Предварительные требования

✅ Что нужно:

1️⃣ Установка Python (если уже есть — всё равно проверь)

🔹 Скачай Python

🔹 ВАЖНО при установке

🔹 Проверка установки

2️⃣ Установка pipx (чистый и безопасный способ)

🔹 Проверка pipx

3️⃣ Установка ESPHome

🔹 Проверка ESPHome

4️⃣ Создание проекта ESPHome

📁 Создаём папку для проектов

🧠 Создаём конфигурацию устройства

5️⃣ Прошивка ESP по USB (первый раз)

🔌 Подключи ESP к ПК по USB

Если драйверов нет:

🚀 Прошивка

6️⃣ OTA-прошивки (без USB)

7️⃣ Подключение к Home Assistant

8️⃣ Полезные команды (шпаргалка)

9️⃣ Типичные проблемы и решения

❌ esphome: command not found

❌ ESP не определяется

❌ OTA не работает

🔧 Что делаем дальше?

❌ В ЧЁМ ПРОБЛЕМА (коротко)

✅ РЕШЕНИЕ (ПРАВИЛЬНОЕ И НАДЁЖНОЕ)

🔥 Полностью не удаляем Python 3.14

1️⃣ Устанавливаем Python 3.11

При установке ОБЯЗАТЕЛЬНО:

2️⃣ Проверяем, что Python 3.11 доступен

3️⃣ Устанавливаем pipx ЧЕРЕЗ Python 3.11

4️⃣ Устанавливаем ESPHome (теперь заработает)

5️⃣ Проверка

🧠 ПОЧЕМУ Я СРАЗУ СКАЗАЛ ПРО PYTHON

🟢 АЛЬТЕРНАТИВА (если не хочешь pipx)

🔧 Что делаем дальше?

1️⃣ ESPHome Dashboard

2️⃣ Установка ESPHome Dashboard на Windows

🔹 Запуск Dashboard

🔹 Проверка

3️⃣ Параметры запуска

4️⃣ Создание первого проекта через Dashboard

5️⃣ Полезные команды Dashboard

6️⃣ Резюме

1️⃣ Ручной запуск через BAT-файл (самый простой)

2️⃣ Автоматический запуск при загрузке Windows

🔹 Вариант 1: через папку автозагрузки

🔹 Вариант 2: через Планировщик задач (Task Scheduler)

3️⃣ Советы

1️⃣ Скачиваем Git для Windows

2️⃣ Устанавливаем Git

3️⃣ Проверяем установку

4️⃣ Перезапускаем PlatformIO

5️⃣ Полезная заметка

❌ `esphome: command not found`