🪐 👀 Jupyter Viewer

A revisited NbViewer as a modern Web application to view Jupyter notebooks.

NbViewer is built on top of the GitHub nbviewer repository and has been an attraction point for many data scientists since years.

Jupyter Viewer takes over the concept of easy visualisation and brings it to the Web application developers with React.js components to render Notebooks without any Kernel. It is also available as JupyterLab extension.

If needed, Users can then connect the static view o a Kernel and make it even more interactive.

Usage

This repository packages the Jupyter UI Viewer component as a JupyterLab extension. Install and launch with the following commands (you will need Python installed on your machine).

pip install jupyter_viewer
jupyter viewer

After launching, enjoy the 👀 views on http://localhost:8888/jupyter_viewer (served by Jupyter).

You can ask to view a Notebook hosted on GitHub.

# Apply the following pattern:
# open http://localhost:8888/github/{account}/{repo}/{branch}/{path}
# For example...
open http://localhost:8888/jupyter_viewer/github/datalayer/examples/main/pytorch-gpu/pytorch-gpu-example.ipynb

Develop

Develop the Web application.

yarn
yarn build
yarn start

# Browse the Webpack server.
open http://localhost:3063
open http://localhost:3063/github/datalayer/examples/main/pytorch-gpu/pytorch-gpu-example.ipynb

Develop the Jupyter Server

pip install -e .[test]
jupyter viewer

# Browse the Jupyter Server.
open http://localhost:8888/jupyter_viewer
open http://localhost:8888/jupyter_viewer/github/datalayer/examples/main/pytorch-gpu/pytorch-gpu-example.ipynb

Develop the JupyterLab extension.

pip install -e .[test]
jupyter labextension develop . --overwrite
jupyter labextension list
jupyter server extension list
yarn jupyterlab

# Browse JupyterLab.
open http://localhost:8888

Publish

make publish
open https://viewer.datalayer.tech
open https://viewer.datalayer.tech/github/datalayer/examples/main/pytorch-gpu/pytorch-gpu-example.ipynb

Releases

Jupyter Viewer is released as a python package in PyPI.