Installation - cogstat/cogstat Wiki

Click here to subscribe for an email notification when a new version of CogStat is released.

Install and use CogStat on Windows

  1. If you update from a previous version, uninstall the previous CogStat first (uninstall is available in the Start menu). Parallel installed versions may not work.
  2. Download the installer (.exe file), and run it.
    • The installer is not signed at the moment. Your operating system or your anti-virus package may warn you about this.
  3. After the installation, CogStat is available from the Start menu.

(If you want to use CogStat in Jupyter Notebook or if you want to use smaller installer by adding CogStat to your existing Python installation, see the instructions in the relevant section below.)

Install and use CogStat on Mac

  1. Download the installer (.dmg file), and install the software.
    • The installer is not signed at the moment. Your operating system or your anti-virus package may warn you about this. Find more information about how to install such packages here, if you have issues with those warnings.
  2. After the installation, CogStat is available to run on your system.

(If you want to use CogStat in Jupyter Notebook or if you want to use smaller installer by adding CogStat to your existing Python installation, see the instructions in the relevant section below.)

Install and use CogStat on Linux

At the moment we don't have a simple installer for Linux. However, Python is most probably already installed on your Linux, and it is relatively easy to install CogStat to your Python distribution. See the description in the relevant section below how to install CogStat on your system.

Also, you can add a shortcut to your menu via the menu editor of your desktop environment, or to anywhere else. If you need an icon, you can download it from here.

After installing CogStat, you'll be able to use it in Jupyter Notebook too.

Install CogStat in your existing Python installation for smaller installer size or to use it in Jupyter Notebook

  1. Download the CogStat python package (.tar.gz file)
  2. Install it. The method may depend on your system, choose one of these:
    • Use pip: pip3 install cogstat-version.tar.gz (use the version number of your downloaded file)
      • On Linux, use root/admin access to install it system-wise.
    • Or Anaconda users should use the Anaconda prompt for the installation.
  3. Run CogStat with the graphical user interface:
    • (New in v2.3) Type in your console: cogstat
    • (New in v2.3) Or type in your console: python3 -m cogstat
    • (Up to v2.2) Type in your console: python3 -c 'from cogstat import cogstat_gui; cogstat_gui.main()'
  4. Or use CogStat in Jupyter Notebook.
    • After installation, CogStat is available to use in Jupyter Notebook

Install the preview versions of CogStat

Preview versions (beta and release candidate) are our test releases before we release the final version. You can try the new features and can give us feedback about the software.

  1. Go to the Releases page, and see if the latest release (the one at the top of the page) is a preview release (you can see a Pre-release label next to the version number).
    • If not, then use our latest stable release and enjoy CogStat. Otherwise:
  2. From the Assets category, depending on your operating system, download the relevant .exe (for Windows), .dmg (for Mac), or .tar.gz (for Linux) file, and follow the OS-specific installation procedure as seen above.