Jupyter Notebooks

Create your narrative and document results right alongside your code and graphics, Kyso will render everything as a beautiful data document.

Publishing Notebooks

Kyso renders Jupyter notebooks as beautiful blog posts, while maintaining any interactivity in your graphical outputs. Some examples:
Any plotting library that uses a Javascript kernel in the backend will render nicely on Kyso. So any graph you make in Jupyter, using Plotly, Bokeh, Altair, etc.. will work. Note that graphs & widgets using a python kernel are currently not supported as notebook-rendered outputs. This feature is in Kyso's roadmap however. For now you can publish these types of widgets as HTML, and they will work:


Kyso now has Google Doc-style inline commenting on Jupyter notebooks!
This was made possible by Jupyter adding unique cell ids to notebooks. Kyso leverages these ids (which are unchanging) to create comments that refer to specific cells in the report. However, only Jupyter notebooks of v4.5 and above will have cell ids by default.
If you want to upload existing notebooks of older versions without updating everything locally, you can optionally allow Kyso to apply cell ids to your notebooks.
Make sure you have installed our CLI to the latest version:
And run the following from the command line, in the directory with the target notebooks:
// kyso format --jupyter
This will prompt you with:
Jupyter notebooks of v4.5 & above have unique cell identifiers, allowing Kyso
to add inline comments to the reports. It seems that you are using an older
version of Jupyter. If you want to allow for inline comments on your report
without updating your version of Jupyter, select 'yes' and Kyso will process all
notebooks in this push & set a random identifier automatically to all cells,
with no side effects to the content of the report(s). If you select 'no' the
notebooks will be published without cell ids.
These changes will modify your .ipynb files in your local filesystem, do you
want to continue? (y/n)


Inline Commenting

Users can comment directly on a specific cell on Kyso now - whether that be code input or a graphical output, just as they would on Google Docs or Notion.
Inline Comments

Cell Referencing

By leveraging cell ids in notebooks, we've also build Report Snippets. This is especially useful when sharing notebook reports that contain lots of graphs, and you want the receiver to hone in on a specific section of the report.
Note the URL in the image below:
Report Snippets
Users can open up the rest of the notebook in the top right of the report!