Installation

python_ico 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_ico Tip: If you using linux_pingui_ico 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_ico 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

windows_logo_ico 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.

  1. Install pip. The easiest is to use the standalone pip installer. If your distribution already has pip installed, you might need to update it if it’s outdated. (If it’s outdated, you’ll know because installation won’t work.)

  2. 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-v7
    

    If 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

  1. Download the package archive (https://github.com/jam-py-v5/jam-py-v7/releases).

  2. Create a new directory and unpack the archive there.

  3. Go into the directory and run the setup command from command line

python setup.py install

Note

linux_pingui_ico 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