aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorNathan Cain <[email protected]>2025-05-07 09:41:37 -0500
committerGitHub <[email protected]>2025-05-07 15:41:37 +0100
commit32204095e52c5492f8eabc2821b779564a430d74 (patch)
tree1ba7f1d8ac384499ba0ecde7fd0d2e942392e09f /docs
parent396fb4dde75a10486c538ac173afb8d35c33a868 (diff)
downloadqmk_firmware-32204095e52c5492f8eabc2821b779564a430d74.tar.gz
qmk_firmware-32204095e52c5492f8eabc2821b779564a430d74.zip
Docs update for installing qmk with uv (#24995)
Diffstat (limited to 'docs')
-rw-r--r--docs/cli.md12
-rw-r--r--docs/newbs_getting_started.md6
2 files changed, 18 insertions, 0 deletions
diff --git a/docs/cli.md b/docs/cli.md
index 7d4c10cedd..b46180cdde 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -18,6 +18,18 @@ export QMK_HOME='~/qmk_firmware' # Optional, set the location for `qmk_firmware`
qmk setup # This will clone `qmk/qmk_firmware` and optionally set up your build environment
```
+### Install Using uv {#install-using-uv}
+
+If you have installed [uv](https://docs.astral.sh/uv/), the QMK CLI can be installed and managed as a uv tool:
+
+```
+uv tool install qmk
+export QMK_HOME='~/qmk_firmware' # Optional, set the location for `qmk_firmware`
+qmk setup # This will clone `qmk/qmk_firmware` and optionally set up your build environment
+```
+
+This installation can be updated via `uv tool upgrade qmk`. See [Upgrading tools](https://docs.astral.sh/uv/guides/tools/#upgrading-tools) for more information.
+
### Install Using pip {#install-using-easy_install-or-pip}
If your system is not listed above you can install QMK manually. First ensure that you have Python 3.7 (or later) installed and have installed pip. Then install QMK with this command:
diff --git a/docs/newbs_getting_started.md b/docs/newbs_getting_started.md
index 9ebcccc77f..1d2b60781b 100644
--- a/docs/newbs_getting_started.md
+++ b/docs/newbs_getting_started.md
@@ -101,6 +101,12 @@ Install the QMK CLI by running:
python3 -m pip install --user qmk
```
+Alternatively, install the QMK CLI as a [uv](https://docs.astral.sh/uv/) managed tool, kept isolated in a virtual environment (requires uv to be installed):
+
+```sh
+uv tool install qmk
+```
+
#### Community Packages
These packages are maintained by community members, so may not be up to date or completely functional. If you encounter problems, please report them to their respective maintainers.