man-group / notebooker

Productionise & schedule your Jupyter Notebooks as easily as you wrote them.

Productionise and schedule your Jupyter Notebooks, just as interactively as you wrote them. Notebooker is a webapp which can execute and parametrise Jupyter Notebooks as soon as they have been committed to git. The results are stored in MongoDB and searchable via the web interface, essentially turning your Jupyter Notebook into a production-style web-based report in a few clicks.

Run a Jupyter notebook as a report with parameters

Execute Jupyter notebooks either on the webservice or command line

View the output of notebooks as static HTML

All results are accessible from the home page

Drill down into each template's results

Getting started

See the documentation at https://notebooker.readthedocs.io/ for installation instructions.

Notebooker has been tested on Linux, Windows 10, and OSX; the webapp has been tested on Google Chrome.

If you want to explore an example right away, you can use docker-compose:

cd docker
docker-compose up

That will expose Notebooker at http://localhost:8080/ with the example templates.

Contributors

Notebooker has been actively maintained at Man Group since late 2018, with the original concept built by Jon Bannister. It would not have been possible without contributions from:

• Douglas Bruce
• Franek Jemiolo
• Sam Ratcliff
• Matthew Dodds
• Dominik Christ

And these fantastic projects:

• Jupytext
• papermill
• nbconvert
• Fomantic-UI