Installation¶
Install Python¶
Jam.py requires Python 3. If it is not installed you can get the latest version of Python at https://www.python.org/download/
Although Jam.py supports Python 3.4, the minimum recommended version is 3.10 and newer.
Tip: If you using
GNU/Linux, you have probably Python 3 already installed by default. Check your version.
Check your Python version¶
For Python 3 installed try to type into a terminal: python3 --version on Linux, or python --version on Windows.
Expected result:
Python 3.14.4
Tip: If you want fully informations about your Python version, don’t use the --version option in previous commands.
Expected result:
Python 3.14.4 (main, Apr 8 2026, 04:02:31) [GCC 15.2.0] on linux Type "help", "copyright", "credits" or "license" for more information.
Install Jam.py¶
Jam.py on Windows¶
If you are just starting with Jam.py and using Windows, you may find How to install Jam.py on Windows useful.
Installing an official release with pip¶
This is the recommended way to install Jam.py.
Install pip. The easiest is to use the standalone pip installer. If your distribution already has
pipinstalled, you might need to update it if it’s outdated. (If it’s outdated, you’ll know because installation won’t work.)If you’re using Linux, Mac OS X or some other flavour of Unix, enter the command at the shell prompt:
sudo pip3 install jam.py-v7If you’re using Windows, start a command shell with administrator privileges and run the command:
python -m pip install jam.py-v7
Installing an official release manually¶
Download the package archive (https://github.com/jam-py-v5/jam-py-v7/releases).
Create a new directory and unpack the archive there.
Go into the directory and run the setup command from command line
python setup.py install
Note
On some unix like systems you may need to switch to root or run:
sudo python setup.py install
Caution
This two differents installation method, will install Jam.py in your Python global installation’s site-packages directory.
Upgrading¶
If you installed Jam.py from pip you can simply upgrade it with:
python -m pip install --upgrade jam.py-v7