Skip to main content
Check that your system meets the requirements before installing Crimsonland.

​
Python version

Crimsonland requires Python 3.13 or higher.
Check your Python version: 
python3 --version
If you need to install or upgrade Python: 
# Ubuntu/Debian
sudo apt update
sudo apt install python3.13

# Fedora
sudo dnf install python3.13

# Arch
sudo pacman -S python

​
Dependencies

Crimsonland has the following runtime dependencies (automatically installed via PyPI):
PackageVersionPurpose
raylib≥5.5.0.4Graphics and game engine
construct≥2.10.70Binary parsing for PAQ/JAZ formats
msgspec≥0.20.0Fast serialization for replays
pillow≥12.1.0Image processing
platformdirs≥4.5.1Cross-platform directory paths
structlog≥25.1.0Structured logging
tqdm≥4.67.3Progress bars
typer≥0.21.1CLI framework
zstandard≥0.25.0Compression

​
Platform-specific requirements

​
Linux

Wayland users: Current PyPI raylib wheels are X11-oriented on x86_64. You may need xwayland and libX11.See electronstudio/raylib-python-cffi#199 for details.
Install X11 dependencies if needed: 
# Ubuntu/Debian
sudo apt install xwayland libx11-6

# Fedora
sudo dnf install xorg-x11-server-Xwayland libX11

# Arch
sudo pacman -S xorg-xwayland libx11

​
macOS

No additional dependencies required beyond Python 3.13+.

​
Windows

No additional dependencies required beyond Python 3.13+.

​
Hardware requirements

​
Minimum

  • CPU: Any modern dual-core processor
  • RAM: 512 MB
  • GPU: OpenGL 3.3 compatible graphics card
  • Storage: 100 MB free space
  • CPU: Quad-core processor or better
  • RAM: 2 GB
  • GPU: Dedicated graphics card with OpenGL 4.3+
  • Storage: 500 MB free space (for assets and replays)

​
Optional dependencies

For chart rendering (optional, used by some analysis tools): 
uv pip install crimsonland[charts]
This installs:
  • altair ≥6.0.0
  • vl-convert-python ≥1.9.0.post1

​
Development requirements

If you’re planning to contribute or run tests, see the Install from source guide for development dependencies.

​
Verification

Once you’ve confirmed your system meets the requirements, proceed to installation:

Install from PyPI

Quick installation using uvx or pip

Install from source

Development setup from GitHub

Build docs developers (and LLMs) love

Get started for freeTalk to us