Create your narrative and document results right alongside your code and graphics, Kyso will render everything as a beautiful data document.
Kyso renders Jupyter notebooks as beautiful blog posts, while maintaining any interactivity in your graphical outputs. Some examples:
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)
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.
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:
Users can open up the rest of the notebook in the top right of the report!