From 8fcaa614bd96c982805aaa97ad00f163a1c5a2be Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Tue, 14 Oct 2025 22:24:41 +0200 Subject: [PATCH 1/9] Add installation guide for ESPHome with uv Added instructions for installing ESPHome using the uv package manager. --- content/guides/installing_esphome.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index 0eaaa5ba53..8850a9c8fd 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -3,6 +3,27 @@ description: "Installing ESPHome Manually" title: "Installing ESPHome Manually" --- +## Cross platform using uv + +[uv](https://docs.astral.sh/uv/) is an extremely fast Python packages and project manager, written in Rust. + +It offers a simple way to install and run ESPHome on Windows, Mac and Linux. + +Once you've [installed uv](https://docs.astral.sh/uv/guides/install-uv/), you can easily [install Python](https://docs.astral.sh/uv/guides/install-python/) and Python packages. + +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 +# upgrade with: uv tool upgrade esphome +``` + +Now *esphome* will be available on your path + +```shell +esphome version +``` + ## Windows Download Python from [the official site](https://www.python.org/downloads/). From 11c5fc1e6eb157571ac466339308c8be70805a87 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Tue, 14 Oct 2025 23:09:04 +0200 Subject: [PATCH 2/9] Apply suggestion from @kellerza --- content/guides/installing_esphome.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index 8850a9c8fd..20be7a8731 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -3,7 +3,7 @@ description: "Installing ESPHome Manually" title: "Installing ESPHome Manually" --- -## Cross platform using uv +## Cross-platform using uv [uv](https://docs.astral.sh/uv/) is an extremely fast Python packages and project manager, written in Rust. From 4f6883f60653153d0d2634860f606192c09155f6 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Tue, 14 Oct 2025 23:09:16 +0200 Subject: [PATCH 3/9] Apply suggestion from @Copilot Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- content/guides/installing_esphome.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index 20be7a8731..fd2dda85b2 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -18,7 +18,7 @@ uv tool install esphome # upgrade with: uv tool upgrade esphome ``` -Now *esphome* will be available on your path +Now *esphome* will be available on your PATH ```shell esphome version From a4512ca525039813033e70e5c032a804afce2da3 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Tue, 14 Oct 2025 23:09:23 +0200 Subject: [PATCH 4/9] Apply suggestion from @kellerza --- content/guides/installing_esphome.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index fd2dda85b2..91b55237fe 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -5,7 +5,7 @@ title: "Installing ESPHome Manually" ## Cross-platform using uv -[uv](https://docs.astral.sh/uv/) is an extremely fast Python packages and project manager, written in Rust. +[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. From e8ee28614abf7b20c4dba4988b7d72dbb9929e2b Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Fri, 17 Oct 2025 04:57:02 +0200 Subject: [PATCH 5/9] Apply suggestion from @kellerza --- content/guides/installing_esphome.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index 91b55237fe..c66c87fc9d 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -24,6 +24,7 @@ Now *esphome* will be available on your PATH esphome version ``` +Upgrade to the latest version using `uv tool upgrade esphome` ## Windows Download Python from [the official site](https://www.python.org/downloads/). From 8ab61913ce8190dc9b763d4a8677c4e0513344f3 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Fri, 17 Oct 2025 04:57:29 +0200 Subject: [PATCH 6/9] Apply suggestion from @kellerza --- content/guides/installing_esphome.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index c66c87fc9d..c4776d0f77 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -25,6 +25,7 @@ esphome version ``` Upgrade to the latest version using `uv tool upgrade esphome` + ## Windows Download Python from [the official site](https://www.python.org/downloads/). From d480630c26b29bc13cc2e72e112914e2c864615d Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Fri, 17 Oct 2025 04:57:56 +0200 Subject: [PATCH 7/9] Apply suggestion from @kellerza --- content/guides/installing_esphome.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index c4776d0f77..e3172eefa4 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -15,7 +15,6 @@ Using uv, you can either run esphome without installing it (`uvx esphome version ```shell uv tool install esphome -# upgrade with: uv tool upgrade esphome ``` Now *esphome* will be available on your PATH From bc61f70ec94f3174b2b6864dbd9ced741a5de7f9 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Fri, 17 Oct 2025 05:25:41 +0200 Subject: [PATCH 8/9] Apply suggestion from @kellerza --- content/guides/installing_esphome.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index e3172eefa4..c23bd4e26f 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -9,7 +9,7 @@ title: "Installing ESPHome Manually" It offers a simple way to install and run ESPHome on Windows, Mac and Linux. -Once you've [installed uv](https://docs.astral.sh/uv/guides/install-uv/), you can easily [install Python](https://docs.astral.sh/uv/guides/install-python/) and Python packages. +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: From 12917d319925783bb244eeedc0d6ff4c8929f9e5 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Fri, 17 Oct 2025 12:49:25 +0200 Subject: [PATCH 9/9] Apply suggestion from @kellerza --- content/guides/installing_esphome.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/guides/installing_esphome.md b/content/guides/installing_esphome.md index c23bd4e26f..9392e9e95d 100644 --- a/content/guides/installing_esphome.md +++ b/content/guides/installing_esphome.md @@ -14,7 +14,7 @@ If you don't have Python installed, uv offers an easy way to [install and manage 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 +uv tool install esphome --with wheel,pip ``` Now *esphome* will be available on your PATH