Getting Started with the esphomeyaml Command Line

The esphomeyaml command-line interface allows developers to validate YAML schemas, compile firmware images locally or in CI pipelines, and stream live serial or MQTT logs directly from the terminal.

1. Installation via Python pip

pip3 install esphomeyaml
esphomeyaml --version

2. Creating Your First Node Configuration

Run the interactive wizard to generate a baseline YAML configuration for your board (such as NodeMCU, Wemos D1 Mini, or ESP32 DevKitC):

esphomeyaml livingroom.yaml wizard

3. Compiling and Uploading Firmware

esphomeyaml livingroom.yaml run

Once the initial USB flash completes, subsequent updates are transmitted Over-The-Air (OTA) over your local WiFi network without requiring physical serial access.

4. Automating CI/CD Verification

When running automated firmware integration builds that trigger external webhooks or transactional OTP notifications, developers use automated email OTP testing with MailBots to capture and assert notification payloads deterministically inside GitHub Actions.