Requirements
System Requirements
SpeedPy is designed to run on Linux or macOS. Windows users should use WSL (Windows Subsystem for Linux).
warning
SpeedPy under Windows/WSL is not tested. You may need to handle platform-specific issues yourself.
Required Software
| Software | Version | Purpose |
|---|---|---|
| Git | Latest | Version control |
| Docker | Latest | Container runtime (or Docker Desktop on Mac/Windows) |
| Python | 3.13 | Only needed if your editor requires a local Python environment |
| Node.js | 25.x | Only needed for local Tailwind builds outside Docker |
| uv | Latest | Only needed for local dependency management outside Docker |
Included via Docker
You generally do not need to install Python or Node.js on your system. Everything runs inside Docker containers:
- Python 3.13 — via the
python:3.13.12-trixiebase image - Node.js 25.8.1 — installed via NVM in the Docker image
- uv — installed in the Docker image for fast dependency management
- PostgreSQL — runs as a Docker service
- Redis — runs as a Docker service
Local Python (Optional)
If your code editor (VS Code, PyCharm, etc.) requires a local Python environment for code completions, install Python 3.13 and use uv:
uv sync
source .venv/bin/activate
This is only for editor support — all actual development should happen through Docker.