Installation

Tip

Use virtual environments!

The BSB framework can be installed using pip:

pip install "bsb~=4.0"

You can verify that the installation works with:

from bsb import Scaffold

# Create an empty scaffold network with the default configuration.
scaffold = Scaffold()

You can now head over to the get started.

Parallel support

The BSB parallelizes the network reconstruction using MPI, and translates simulator instructions to the simulator backends with it as well, for effortless parallel simulation. To use MPI from Python the mpi4py package is required, which in turn needs a working MPI implementation installed in your environment.

On your local machine you can install OpenMPI:

sudo apt-get update && sudo apt-get install -y libopenmpi-dev openmpi-bin

On Windows, install Microsoft MPI. On supercomputers it is usually installed already, otherwise contact your administrator.

To then install the BSB with parallel MPI support:

pip install "bsb[parallel]~=4.0"

Simulator backends

If you’d like to install the scaffold builder for point neuron simulations with NEST or multicompartmental neuron simulations with NEURON or Arbor use:

pip install bsb[nest]
# or
pip install bsb[arbor]
# or
pip install bsb[neuron]
# or any combination
pip install bsb[arbor,nest,neuron]

Note

This does not install the simulators themselves. It installs the Python tools that the BSB needs to support them. Install the simulators separately according to their respective installation instructions.