For the easiest installation download and install the Standalone package.

For all versions see the PsychoPy releases on github

Manual installations

See below for options if you don’t want to use the Standalone releases:

pip install

Now that most python libraries can be install using pip it’s relatively easy to manually install PsychoPy and all it’s dependencies to your own installation of Python.

The steps are to fetch Python. This method should work on any version of Python but we recommend Python 3.6 for now.

You can install PsychoPy and its dependencies (more than you’ll strictly need) by:

pip install psychopy

If you prefer not to install all the dependencies then you could do:

pip install psychopy --no-deps

and then install them manually.


There used to be neurodebian and Gentoo packages for PsychoPy but these are both badly outdated. We’d recommend you do:

# with --no-deps flag if you want to install dependencies manually
pip install psychopy

Then fetch a wxPython wheel for your platform from:

and having downloaded the right wheel you can then install it with something like:

pip install path/to/your/wxpython.whl

wxPython>4.0 and doesn’t have universal wheels yet which is why you have to find and install the correct wheel for your particular flavor of linux.

Building Python PsychToolbox bindings:

The PsychToolbox bindings for Python provide superior timing for sounds and keyboard responses. Unfortunately we haven’t bee able to build universal wheels for these yet so you may have to build the pkg yourself. That should be hard. You need the necessary dev libraries installed first:

sudo apt-get install libusb-1.0-0-dev portaudio19-dev libasound2-dev

and then you should be able to install using pip and it will build the extensions as needed:

pip install psychtoolbox

Anaconda and Miniconda

With Python 3.6:

conda create -n psypy3 python=3.6
conda activate psypy3
conda install numpy scipy matplotlib pandas pyopengl pillow lxml openpyxl xlrd configobj pyyaml gevent greenlet msgpack-python psutil pytables requests[security] cffi seaborn wxpython cython pyzmq pyserial
conda install -c conda-forge pyglet pysoundfile python-bidi moviepy pyosf
pip install zmq json-tricks pyparallel sounddevice pygame pysoundcard psychopy_ext psychopy

Developers install

Ensure you have Python 3.6 and the latest version of pip installed:

python --version
pip --version

Next, follow instructions here to fork and fetch the latest version of the PsychoPy repository.

From the directory where you cloned the latest PsychoPy repository (i.e., where resides), run:

pip install -e .

This will install all PsychoPy dependencies to your default Python distribution (which should be Python 3.6). Next, you should create a new PsychoPy shortcut linking your newly installed dependencies to your current version of PsychoPy in the cloned repository. To do this, simply create a new .BAT file containing:

"C:\PATH_TO_PYTHON3.6\python.exe C:\PATH_TO_CLONED_PSYCHOPY_REPO\psychopy\app\"

Alternatively, you can run the from the command line:

python C:\PATH_TO_CLONED_PSYCHOPY_REPO\psychopy\app\psychopyApp

Back to top