diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index b2b35e8dec..6eab7c7eb1 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -3,6 +3,28 @@ description: "Installing ESPHome Manually" title: "Installing ESPHome Manually" --- +## Cross-platform using uv + +[uv](https://docs.astral.sh/uv/) is an extremely fast Python package and project manager, written in Rust. + +It offers a simple way to install and run ESPHome on Windows, Mac and Linux. + +If you don't have Python installed, uv offers an easy way to [install and manage Python versions](https://docs.astral.sh/uv/guides/install-python/). + +Using uv, you can either run esphome without installing it (`uvx esphome version`) or you can install it as a [tool](https://docs.astral.sh/uv/guides/tools/) with the following command: + +```shell +uv tool install esphome --with wheel,pip +``` + +Now *esphome* will be available on your PATH + +```shell +esphome version +``` + +Upgrade to the latest version using `uv tool upgrade esphome` + ## Windows Download Python from [the official site](https://www.python.org/downloads/). Confirm that the version is at least 3.11; versions 3.14 or higher are not yet recommended.