Python version support

Officially Python 3.8 and 3.9.

Installing from PyPI

pyxnat can be installed via pip from PyPI.

pip install pyxnat


For development purposes:

  • python-nose v1.2.1+ to run the unit tests

  • coverage v3.6+

The manual way

To install pyxnat, first download the latest tarball (e.g. from and expand it.

Installing in a local environment

If you do not need to install for all users, we strongly suggest that you create a local environment and install pyxnat in it. One advantage of this method is that you never have to become administrator and thus all changes are local and easy to clean up.

  1. First, create the following directory (where ~ is the home folder, or any directory that you want to use as a base for your local Python environment, and X is your Python version number, e.g. 2.6):

  2. Second, make sure that you add this directory in your environment variable PYTHONPATH. Windows users may do this by editing your environment variables in the system configuration dialog. Unix users may add the following line to their .bashrc or any file sourced at login:

    export PYTHONPATH=$HOME/usr/lib/python2.6/site-packages:$PYTHONPATH
  3. In the folder resulting from the pyxnat tarball, run the following command:

    python install --prefix ~/usr

    You should not be required to become administrator, provided you have write access to the destination folder.

Installing for all users

If you have administrator rights and want to install for all users, all you need to do is to go in directory created by expanding the pyxnat tarball and run the following line:

python install

For Unix users, we suggest that you install in ‘/usr/local’ in order not to interfere with your system:

python install --prefix /usr/local