Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Documentation Status Tests Coverage Status Binder DOI


Python-Catmaid - or "pymaid" - is a Python 3 library to interface with CATMAID servers.

Tested with CATMAID release version 2020.02.15 - if you are working with older versions you may run into issues due to API changes.


  • pull and push data from/to a CATMAID server
  • visualize and analyse neuron morphology via navis
  • tools to analyse user stats (e.g. time-invested, project history)
  • clustering methods (e.g. by connectivity or synapse placement)


Pymaid is on ReadTheDocs.

Getting started

See the documentation for detailed installation instructions, tutorials and examples. For the impatient:

pip3 install python-catmaid

Important: there is a pymaid package on PyPI which has nothing to do with this pymaid!

To install the bleeding edge from Github:

pip3 install git+

Alternatively click on the launch binder badge above to try out pymaid hosted by mybinder!

pymaid example


This code is under GNU GPL V3


Pymaid implements/provides an interfaces with algorithms described in:

  1. Comparison of neurons based on connectivity: Science. 2012 Jul 27;337(6093):437-44. doi: 10.1126/science.1221762. The connectome of a decision-making neural network. Jarrell TA, Wang Y, Bloniarz AE, Brittin CA, Xu M, Thomson JN, Albertson DG, Hall DH, Emmons SW. link
  2. Comparison of neurons based on synapse distribution: eLife. doi: 10.7554/eLife.16799 Synaptic transmission parallels neuromodulation in a central food-intake circuit. Schlegel P, Texada MJ, Miroschnikow A, Schoofs A, Hueckesfeld S, Peters M, ... Pankratz MJ. link