Install Python and uv
Last checked . Checked against Getting started, Install python.
In short. You only install uv. When a project needs Python, uv downloads the right version by itself, so you do not install Python separately. Paste one command, open a new window, and check the version.
Before you start
You need a terminal (Open a terminal) and an internet connection. Python is the programming language that tools such as twin-flow are written in, and uv is a free program that installs and runs it for you. twin-flow needs Python 3.11 or newer, and uv picks a matching one on its own. The installer comes from astral.sh, the makers of uv, and it adds uv to your own user folder, not to the whole computer.
Steps
Step 1. Paste the uv install command
On a Mac, paste this and press Return:
curl -LsSf https://astral.sh/uv/install.sh | sh
On Windows, in Windows PowerShell, paste this and press Enter:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Step 2. Open a new terminal window
Close the window and open a new one, because the new window is the one that knows where uv lives.
Step 3. Optional: fetch Python now
You can skip this, since uv fetches Python the first time a project needs it. If you want it done ahead of time, paste this:
uv python install 3.12
It downloads Python into uv's own folder and leaves any Python already on your computer alone.
Check it worked
Type this and press Return or Enter:
uv --version
It prints uv and a version number, for example uv 0.13.6. Any version number means uv is ready.
If something goes wrong
- "command not found: uv" or "uv is not recognized". Close the window and open a new one. The installer puts uv in a
.local/binfolder in your user folder and updates your settings, and only new windows read them. - The Mac command says
curlis not found. Usewget -qO- https://astral.sh/uv/install.sh | shinstead. - Windows blocks the script. The
ExecutionPolicy ByPasspart of the command is there to allow this one script, so paste the whole line exactly, in PowerShell and not Command Prompt. - A company computer refuses the install. Your IT team may block downloads, so ask them to install uv for you.
- You want to see which Pythons uv knows about. Run
uv python list.