Skip to main content

A tool to run a Jupyter Notebook from a (partial) Github repository.

Project description


This description can be found on GitHub here

GitMiller is a tool for running Jupyter Notebooks from a (partial) Github repository. It downloads the repository in your temp folder, runs a designated notebook within it, and removes all downloaded files afterwards.


$ pip install gitmiller

After installation you can use the gitmiller command-line tool to run your github notebooks.


The command-line interface takes the following input parameters:

parameter description
-u, --username Username to gain access to GitHub repository
-p, --password Password Github repository
-r, --repository URL of GitHub repository (can be a subfolder)
-n, --notebook filename of notebook you wish to execute, this file must exist in the root folder of the (partially) downloaded folder structure.
-o, --output local path where GitMiller will put the executed version of your notebook
-c, --config local path of YAML file in which you can add all mentioned paramaters

GitMiller uses Papermill to run your remote notebook. Besides executing, Papermill also enables you to parameterize notebooks. If you would like to override certain variables in your notebook, add the variables and values in the config YAML file under the papermill key. See example below.

This repository contains a folder example in which a notebook test.ipynb exists. If you would like to run this notebook with GitMiller, use either:

$ gitmiller -u <GITHUB USERNAME> -p <GITHUB PASSWORD>, -r, -n test.ipynb, -o <LOCAL OUTPUT-PATH>

or create the following YAML file:

notebook: test.ipynb

  a: 10
  b: 60

and run with:

$ gitmiller -c <PATH TO YAML-FILE>

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gitmiller-0.1.tar.gz (4.3 kB view hashes)

Uploaded Source

Built Distribution

gitmiller-0.1-py3-none-any.whl (4.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page