Sphinx BlueBrain Theme

Build Status license black documentation status


Sphinx BlueBrain Theme is the standard Blue Brain Project documentation theme.

You can view the changelog to see what has changed recently.


You can install the theme using pip:

pip install sphinx-bluebrain-theme


Refer to the usage guide for how to use the theme.


The code for the theme is licensed under the MIT License.

The name “Blue Brain Project” and the EPFL logo are property of their respective owners and do not fall under the MIT license.

The theme incorporates third party components which are listed below, along with their relevant licenses:

Material for MkDocs theme

MIT License, see the license.

Open Sans font

Apache License Version 2.0, see the license.

Titillium Web font

Open Font License Version 1.1, see the license.

EPFL logo

The EPFL logo is copyright EPFL. All rights reserved.


Sphinx BlueBrain Theme is a Sphinx theme based on the excellent Material for MkDocs theme by Martin Donath (@squidfunk).

The original theme is licensed under the MIT license and is hosted on GitHub.

You can see examples (and the associated rst source) in the samples page.

Sphinx BlueBrain Theme is built through a combination of text replacement rules, HTML template overrides, a small amount of additional CSS and Javascript, and a python module which injects additional required context.


The development of this software was supported by funding to the Blue Brain Project, a research center of the École polytechnique fédérale de Lausanne (EPFL), from the Swiss government’s ETH Board of the Swiss Federal Institutes of Technology.

Copyright (c) 2020-2024 Blue Brain Project/EPFL