Skip to content


Repository files navigation


TASKontrol is an open source framework for developing behavioral experiments for neuroscience research.

It consists of modules written in Python and Qt (via QtPy) for designing behavioral paradigms and providing a graphical user interface to control the experiments. It also includes software that runs in an Arduino Due to provide an interface for detecting external events and triggering stimuli.

TASKontrol was developed by Santiago Jaramillo and it is maintained by the Jaramillo lab at the University of Oregon. The framework was largely inspired by systems such as BControl and the Linux+RTAI statemachine originally developed at Cold Spring Harbor Laboratory.

You can find the full documentation at:


NOTE: If installing the system in the Jaramillo lab, see instead to install the required packages from the Ubuntu repository rather than using conda/pip.

Outside the Jaramillo lab, you can install the package in a conda virtual environment. The installation requires that you have working versions of Anaconda and Git.

  1. Using Git, clone the stable version of TASKontrol:
  • git clone -b v1.1_stable --single-branch
  1. Go to the taskontrol folder that was just created:
  • cd taskontrol
  1. Create a conda environment for taskontrol:
  • conda env create -f environment.yml
  1. Activate the taskontrol environment:
  • conda activate taskontrol
  • The prompt should now say (taskontrol), indicating you are in the environment.
  1. Create a taskontrol rig settings file (based on the template):
  • cp
  • Edit the file if necessary (for example, to set a specific STATE_MACHINE_TYPE)
  1. Inside that virtual environment, install the package (in development mode):
  • pip install -e ./
  1. Test the installation:
  • python examples/
  • You should see a window with a big green button and an emulator window.


  1. XCode to get git
  2. Anaconda
  3. conda env create -f environment.yml
  • qt qtpy h5py numpy pyserial pyqtgraph

to avoid conflicts with system-wide Python packages. Below are the instructions to run on a terminal (on Linux or Mac):


A framework for developing behavioral experiments.






No releases published


No packages published

Contributors 4