nbss-upload

Upload notebooks (Jupyter, Rmd, etc) to a NotebookSharing.space instance.

Installation

nbss-upload is available on PyPI, and can be installed with pip.

pip install nbss-upload

Usage

Simply call it with the path to the notebook you want to upload.

$ nbss-upload test.ipynb
https://notebooksharing.space/view/04ab7ab45c2f08628eba9cb8fe5fb9a63f5961d5dfce622b9e26974ddc138916

This will upload the notebook and return the URL you can use to share it with others.

By default, only users who you share the URL with can access the notebook - it will not be visible to search engines. Annotations will also be turned off by default to help fight abuse.

You can enable annotations via hypothes.is by passing --enable-annotations or -a. The notebook can be made discoverable to search engines by passing --enable-discvery or -d.

All notebook formats supported by notebooksharing.space - .ipynb, .rmd, .html are supported.

Uploading from inside a Jupyter Notebook

You can add a cell to your Jupyter Notebook that calls nbss-upload, and each time you execute the cell (after saving your notebook), it will be uploaded and the URL printed.

!nbss-upload <name-of-notebook>