Installing Python
By getting Python from the official website
- Download Python 3.12 or newer from https://www.python.org/downloads/.
- Verify the installation and version:
python --versionInstalling Ursina (stable release)
Install the latest stable build from PyPI:
python -m pip install ursinaDevelopment Version
The development build can contain fixes and features not yet released on PyPI. Be aware that things could break.
Install the most recent build from GitHub
python -m pip uninstall ursina
python -m pip install https://github.com/pokepetter/ursina/archive/master.zipInstall from GitHub by cloning the repo
If you plan to edit the source, clone the repository and install in editable mode. Make sure Git is installed (https://git-scm.com/):
git clone https://github.com/pokepetter/ursina.git
python -m pip install --editable .Install a specific commit
Replace <commit-hash> with the commit you need:
python -m pip uninstall ursina
python -m pip install https://github.com/pokepetter/ursina/archive/<commit-hash>.zipInstalling optional dependencies
Ursina ships with several optional extras. Install individual extras — or all of them at once — like so:
pip install ursina[extras]Troubleshooting
Ursina installed, but Python can’t find it
If you have multiple Python installs, make sure Ursina was installed to the interpreter you’re using:
python3.10 -m pip install ursinaIf you work inside a virtual environment, activate it before running pip install.