💻 :brain: Registrations will open soon for the 2021 edition! :brain: 💻:

Project guide

Project template

The project template was added in the BHS gallery. You can also help improve the template by posting an issue on the template repo. Project repositories are hosted in the Brainhack school 2020 github organization.

Adding your project to the gallery

The gallery can be found here. Instructions to push your project to this gallery through a pull request to the BHS website are now available! Keep reading:

Last but not least, the final deliverable that will be displayed in the Project Gallery. We don’t want you to write new stuff, you have done more than enough :raised_hands:. In fact, this page should reflect your final report (aka your README.md).

PS: You don’t have to install Hugo to add your document and make the pull request. The file you will have to edit has all the instruction embedded for the two different sections you need to fill in. (e.i, the frontmatter or header of the document, and the content section).

This document will guide you through the whole Git/Github workflow that you are probably becoming expert at ;).


Project evaluation

You will have to present your project to the class during week 4, and finalize the deliverables of your project. Both the presentation and the written deliverables will be evaluated with the following criteria, using a 3-level scale:

  • 1: does not meet expectations
  • 2: partially meets expectations
  • 3: totally meets expectations

Grades will be given by several instructors and averaged to obtain the final presentation grade.

Use of open-science best practices (1-3)

Expectation: the project uses 3 open-science tools learnt during week 1, or provides a convincing reason to not use them. The 3 tools may be selected in the following list, but other relevant tools will be accepted too.

  • Git
  • GitHub
  • Containers
  • Python
  • BIDS
  • Jupyter notebooks
  • Binder

Skills and technologies learnt (1-3)

Expectation: the project uses 1 skill, method or technology learnt by the student during the school, through formal presentations or informal interactions. The skill, method or technology may be selected in the following list, but other relevant ones will be accepted too.

  • Machine learning
  • Multivariate statistics and matrix factorizations
  • Estimation of connectivity
  • High-performance computing
  • DataLad

Project relevance (1-3)

Expectation: the project is relevant to brain data analysis.

Clarity (1-3)

Expectation: the presentation is easy to follow, and supported by convincing material (e.g., slides).


  • Highly reproducible project (0-1)
  • Technological achievement (0-1)
  • Exciting presentation (0-1)
  • Nice brain picture (0-1)