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.9 | Only needed if your editor requires a local Python environment |
| Node.js | 20.x | Only needed for local Tailwind builds 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.9 — via the
python:3.13.9-bookwormbase image - Node.js 20.18.0 — installed via NVM in the Docker image
- 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.9 and create a virtual environment:
python3.13 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
This is only for editor support — all actual development should happen through Docker.