doc: Add macOS uv instructions to installations.md
What the developer wrote
Authored by Sangbida Chaudhuri
doc: Add macOS uv instructions to installations.md
Changelog-None
What changed, and why it matters
This commit only updates the macOS installation instructions in the project's documentation. It replaces the old Python setup using pyenv and poetry with a newer tool called 'uv' for managing Python dependencies. There are no code changes and no security implications.
No security action needed. This is a documentation-only change. If reviewing, verify the new uv instructions are accurate for supported macOS environments.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The diff modifies doc/getting-started/getting-started/installation.md to replace pyenv/poetry-based Python environment setup instructions with instructions for installing and using ‘uv’ (an Astral Python package/project manager). The build commands are updated from ‘poetry install’ / ‘poetry run make’ to ‘uv sync –all-extras –all-groups’ / ‘uv run make’. No source code, build scripts, or configuration logic is changed.
Changed components
doc/getting-started/getting-started/installation.mdInspect captured patch +6 / −9
diff --git a/doc/getting-started/getting-started/installation.md b/doc/getting-started/getting-started/installation.md
index ae97929e..c7199120 100644
--- a/doc/getting-started/getting-started/installation.md
+++ b/doc/getting-started/getting-started/installation.md
@@ -344,17 +344,14 @@ export CPATH=/opt/homebrew/include
export LIBRARY_PATH=/opt/homebrew/lib
```
-If you need Python 3.x for mako (or get a mako build error):
+Install uv for Python dependency management:
```shell
-brew install pyenv
-echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n eval "$(pyenv init -)"\nfi' >> ~/.bash_profile
-source ~/.bash_profile
-pyenv install 3.9
-pip install --upgrade pip
-pip install poetry==2.0.1
+curl -LsSf https://astral.sh/uv/install.sh | sh
```
+After installing uv, restart your shell or run `source ~/.zshrc` to ensure `uv` is in your PATH.
+
If you don't have bitcoind installed locally you'll need to install that as well:
```shell
@@ -382,9 +379,9 @@ git checkout v24.05
Build lightning:
```shell
-poetry install
+uv sync --all-extras --all-groups
./configure
-poetry run make
+uv run make
```
Running lightning:
Why this scored 15/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.