Skip to content


Repository files navigation

The Brain Modeling Toolkit

A software development package for building, simulating, and analyzing large-scale networks of different levels of resolution.

Please give feedback via our brief user survey, which will inform future development, fixes, and documentation.

Registering allows us to communicate with BMTK users and is encouraged, but not required: registration link.

See the paper about BMTK: link.

Please cite BMTK as follows:

Dai et al. Brain Modeling Toolkit: An open-source software suite for multiscale modeling of brain circuits. PLoS Comput Biol 16(11): e1008386.

Level of Support

We are releasing this code to the public as a tool we expect others to use. Questions concerning bugs and related issues are welcomed. We expect to address them promptly and pull requests will be vetted by our staff before inclusion.


bmtk requires Python 2.7 or 3.5+, plus additional python dependicies. To install with base requirements from a command-line:

 $ git clone
 $ cd bmtk
 $ python install

There are examples of building models and running simulations located in docs/examples/. Some of the simulation engines may require additional requirements to run.


There are a collection of unit tests in bmtk.tests which can be run using pytest

  $ cd bmtk
  $ py.test


User Guide

Copyright 2017 Allen Institute