Skip to content
22 changes: 22 additions & 0 deletions content/guides/installing_esphome.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down