Please select the type of installation you would like:

Option 1: Install only NetPyNE (without the GUI).

Option 2: Install NetPyNE and the NetPyNE GUI (alpha version). This link includes installation instructions for NEURON and NetPyNE, using specific versions that have been fully tested with the GUI. Note that the NetPyNE GUI only supports Python 3.

If you have any issues during the installation please post a message with the details to the NetPyNE forum or the NetPyNE GitHub issues .

Install only NetPyNE (without the GUI)


Before installing NetPyNE, please ensure you have the following installed:

  1. Python 2 or 3 (2.7, 3.6 and 3.7 are supported). Download from the official Python web. Alternatively, you can download the Anaconda Distribution which also includes several data science and visualization packages.
  2. The NEURON simulator. See NEURON’s installation instructions. If you would like to run parallelized simulations, please ensure you install NEURON with MPI support (OpenMPI).
  3. The pip tool for installing Python packages. See pip installation here.

Upgrade to the latest released version of NetPyNE via pip

Use this option if you already have NetPyNE installed and just want to update to the latest version.

Linux or Mac OS: pip install netpyne -U

Windows: python -m pip install -U netpyne

Install the development version of NetPyNE via GitHub and pip

The NetPyNE package source files, as well as example models, are available via GitHub at: The following instructions will install the version in the GitHub “development” branch – it will include some of the latest enhancements and bug fixes, but could also include temporary bugs:

  1. git clone
  2. cd netpyne
  3. git checkout development
  4. pip install -e .

pip will add a symlink in the default python packages folder to the cloned netpyne folder (so you don’t need to modify PYTHONPATH). If new changes are available just need to git pull from cloned netpyne repo.

This version can also be used by developers interested in extending the package.

Install NetPyNE and the NetPyNE GUI (alpha version)

The NetPyNE-UI GitHub Wiki provides instructions to install NEURON, NetPyNE and NetPyNE-UI, using specific versions that have been fully tested with the GUI. There are 3 alternative ways to do this:

1) Install using pip - Installs NetPyNE and NetPyNE-UI on your system via a simple pip command, but requires having NEURON already installed (see instructions).

2) Install using Docker - Pre-packaged installation that includes everything you need in a Docker container: NEURON, NetPyNE and NetPyNE-UI.

3) Virtual machine - Download a virtual machine image with everything pre-installed. Requires the Virtual Box software.

An online version of the NetPyNE GUI is also available at: There is a maximum number of simultaneous users for this online version, so if you can’t log in, please try again later.

Note: the GUI also includes an interactive Python Jupyter Notebook (click “Python” panel at bottom) that you can use to directly run NetPyNE code/models (i.e. without using the actual graphical interface).