Integration with Github

Github is one of the popular choices that data scientists prefer for storing their notebooks. In this section, we will explain how you can create a Github Space and synchronize your Github notebooks.

Note that files should be saved in Apache Zeppelin(*.json) or Ipython(*.ipynb) format.

Create a Github Repository Space

Click "New Space" button in the main page to create a new Space and check "External Repository". Then select the Github from the dropdown menu.

Connecting to a Github Repository

In order for ZEPL to connect to your Github repository, you will need a Github personal access tokens.

Go to Github settings and follow the Github documentation

The access scope that ZEPL requires is the repo scope, as is pictured below.

The following fields will need to be filled in: the Github credentials, the repository URL, and the branch name.

In our example, the dialog form would look similar to the image below:

You can now click on Apply to create your Github space. ZEPL will first test the connection to the Github repository. If the test succeeds, you will be redirected to the newly created space. ZEPL will connect automatically to your Github repository and load any notebook it finds. The loaded notebooks should appear inside your repository space.

The Github space will automatically re-synchronize to the Github repository every 10 mins and will add new notebooks, update any modified notebooks, and remove any deleted notebooks. You can also manually retrigger the synchronization.

You can now enjoy the power of ZEPL with your notebooks store in Github.