Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ideonate/cdsdashboards

JupyterHub extension for ContainDS Dashboards
https://github.com/ideonate/cdsdashboards

bokeh data-science jupyter jupyterhub panel plotly-dash rshiny streamlit visualization

Last synced: 6 days ago
JSON representation

JupyterHub extension for ContainDS Dashboards

Awesome Lists containing this project

README 

        
# ContainDS Dashboards for JupyterHub



> [!WARNING]

> This code may still be useful to you, but please note it does not generally work with the latest versions of JupyterHub.

> Please try [jhub-apps](https://github.com/nebari-dev/jhub-apps) for a more active codebase (which might still need configuration and custom code for your setup).



A Dashboard publishing solution for Data Science teams to share results with decision makers.



Run a private on-premise or cloud-based JupyterHub with extensions to instantly publish apps and notebooks as user-friendly

interactive dashboards to share with non-technical colleagues.



Currently supported frameworks:

- Jupyter notebooks ([Voilà](https://voila.readthedocs.io/en/stable/))

- [Streamlit](https://streamlit.io/) apps

- [Plotly Dash](https://plotly.com/dash/) apps

- [Bokeh](https://docs.bokeh.org/) / [Panel](https://panel.holoviz.org/) apps and notebooks

- [R Shiny](https://shiny.rstudio.com/) apps

- Any custom server or framework



This open source package allows data scientists to instantly and reliably publish interactive

notebooks or other scripts as secure interactive web apps.



Source files can be pulled from a Git repo or from the user's Jupyter tree.



Any authorised JupyterHub user can view the dashboard, or choose to give permission only to named users.



See [full documentation](https://cdsdashboards.readthedocs.io/)



## How it works



- Data scientist creates a Jupyter Notebook as normal or uploads Python/R files etc

- Data scientist creates a new Dashboard to clone their Jupyter server

- Other logged-in JupyterHub users see the dashboard in their list

- Click to launch as a server, using OAuth to gain access

- User sees a safe user-friendly version of the original notebook - served by Voilà, Streamlit, Dash, Bokeh, Panel, R Shiny etc.



All of this works through a new Dashboards menu item added to JupyterHub's header.



_Data scientist creates a Jupyter Notebook as normal_



![Original Jupyter Notebook](./docs/_static/screenshots/1_Original_Jupyter_Notebook.png "Original Jupyter Notebook")



_Data scientist creates a new Dashboard to clone their Jupyter server_



![Create New Dashboard](./docs/_static/screenshots/2_Create_New_Dashboard.png "Create New Dashboard")



_Other logged-in JupyterHub users see the dashboard in their list_



![Other User sees dashboard](./docs/_static/screenshots/3_Other_User_sees_dashboard.png "Other User sees dashboard")



_Uses OAuth to gain access_



![Other user OAuths](./docs/_static/screenshots/5_Other_user_OAuths.png "Other user OAuths")



_Other user sees a safe user-friendly Voilà version of the original notebook_



![Voilà Dashboard](./docs/_static/screenshots/6_Voila_Dashboard.png "Voilà Dashboard")



_Or other app frameworks_



![App Collage](./docs/_static/screenshots/AppCollage.png "App Collage")



## Requirements



Basic requirements:



- JupyterHub 1.x

- Python 3.6+



Note that JupyterHub 2.x is not supported. You will need to install a version 1.x (e.g. 1.5).



You should be able to use any authenticator for users to login - for example, corporate Google email sign in, or LDAP.



Any JupyterHub distribution should be suitable, depending on configuration. See [requirements](https://cdsdashboards.readthedocs.io/en/stable/chapters/requirements.html).



## Installation



Full [Setup and Installation details](https://cdsdashboards.readthedocs.io/en/stable/chapters/setup/setup.html) are in the documentation.



## Contact and Support



Please see LICENSE for details.



Please do get in touch if you try out the package, or would like to but need some support. I would be very interested to find out how it can be used, and to work (without charge) to help you get it running. The project needs feedback in order to develop further!



Contact [[email protected]](mailto:[email protected]) with any comments or questions at all.



There is a [Gitter room](https://gitter.im/ideonate/ContainDS?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) for general chat with other community members, e.g. for confguration and use case tips.



[![Join the chat at https://gitter.im/ideonate/ContainDS](https://badges.gitter.im/ideonate/ContainDS.svg)](https://gitter.im/ideonate/ContainDS?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![Documentation Status](https://readthedocs.org/projects/cdsdashboards/badge/?version=stable)](https://cdsdashboards.readthedocs.io/en/stable/?badge=stable)

[![Latest release](https://img.shields.io/pypi/v/cdsdashboards?color=blue)](https://pypi.org/project/cdsdashboards/)

[![Latest release](https://anaconda.org/conda-forge/cdsdashboards/badges/version.svg)](https://anaconda.org/conda-forge/cdsdashboards)