Environment Setup

Requirements

• A Unix-like shell (macOS or Linux). On Windows, use WSL2.
• Install Docker Desktop
• Install Visual Studio Code
• Install uv
• Python 3.14, installed with uv python install 3.14
• git

Validating Requirements

After installing the required tools, open a new terminal window.

You're ready to get started if you can run the commands below in your terminal.

Your version numbers may be different, but make sure you have Python 3.14 installed.

shell

~ > docker --version
Docker version 29.8.0, build 88096ef

~ > docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

~ > git --version
git version 2.54.0 (Apple Git-157)

~ > code --version
1.141.0
2a59476c9bfcb90b3ddc372c36762471b7dfad1c
arm64

~ > uv --version
uv 0.12.21 (7af826859 2026-09-29 aarch64-apple-darwin)

~ > uv python find 3.14
/Users/nina/.local/share/uv/python/cpython-3.14-macos-aarch64-none/bin/python3.14

If docker ps prints an error, open Docker Desktop, finish its setup steps, and run it again.

Success

If all these commands work, you're ready to get started.