Table Of Contents

Previous topic


Next topic

Getting Started

This Page

Quick links



For the easiest installation download and install the Standalone package for your system:

The latest stable release (the version we recommend you install is 1.85.4, although on win32 1.85.3 is the same) and you can get that here:

For previous recent versions see the PsychoPy releases on github

See below for options:

Notes on OpenGL drivers

On windows, if you get an error saying “ Unable to share contexts” then the most likely cause is that you need OpenGL drivers and your built-in Windows only have limited support for OpenGL (or possibly you have an Intel graphics card that isn’t very good). Try installing new drivers for your graphics card from the manufacturer web page not from Microsoft.

Manual 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. That isn’t the officially-supported method (because we can’t track which versions of packages you have) but for many people it’s the preferred option if they use Python for other things as well.


You need a copy of Python 2.7.x from here, wxPython and probably pyo (or use an alternative audio library listed below). None of these support pip install yet so you need to download them:

Then, if you want everything available you could paste this in to your terminal/commandline and go and get a coffee (will take maybe 20mins to download and install everything?):

pip install numpy scipy matplotlib pandas pyopengl pyglet pillow moviepy lxml openpyxl xlrd configobj pyyaml gevent greenlet msgpack-python psutil tables requests[security] pyosf cffi pysoundcard pysoundfile seaborn psychopy_ext python-bidi psychopy
pip install pyserial pyparallel egi iolabs
pip install pytest coverage sphinx

Needed on Windows:

pip install pypiwin32

Needed on macOS:

pip install pyobjc-core pyobjc-framework-Quartz

OR you could just install the subsets of packages that you want:

pip install numpy scipy matplotlib pandas pyopengl pyglet pillow moviepy lxml openpyxl configobj psychopy

# to use iohub
# you need to install the hdf5 lib before installing tables (`brew install hdf5` on mac))
pip install pyyaml gevent greenlet msgpack-python psutil tables

# better excel file reading (than openpyxl)
pip install xlrd

# making online connections (e.g.
pip install requests[security] pyosf

# alternative audio (easier than pyo to install)
pip install cffi sounddevice pysoundfile

Handy extra options:

pip install seaborn  # nice graphing
pip install psychopy_ext  # common workflows made easy
pip install python-bidi  # for left-right language formatting

For hardware boxes:

pip install pyserial pyparallel
pip install egi  # for egi/pynetstation
pip install iolabs  # button box
pip install pyxid  # possible but the version on github has fewer bugs!
# labjack needs manual install:

For developers:

pip install pytest coverage sphinx
#this installs psychopy links rather than copying the package
pip install -e /YOUR/PsychoPy/Repository

Anaconda and Miniconda

The following should allow you to get PsychoPy working using Ana/MiniConda:

conda config –add channels conda install -c erik psychopy conda create -n psychopyenv psychopy source activate psychopyenv

but the recipe may be out of date and pygame was not available in the past (now?)


This may be/get out of date but users of macports should be able to install PsychoPy and all its dependencies simply with:

  sudo port install py25-psychopy

(Thanks to James Kyles.)


Debian and Ubuntu systems:

PsychoPy is in the Debian packages index so you can simply do:

sudo apt-get install psychopy

To get the newer version you may need to add the NeuroDebian repository <> (Thanks to Yaroslav Halchenko for packaging for Debian and NeuroDebian.)


PsychoPy is in the Gentoo Science Overlay (see sci-biology/psychopy for the ebuild files).

After you have enabled the overlay simply run:

emerge psychopy


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