• Stars
    star
    256
  • Rank 159,219 (Top 4 %)
  • Language
    Jupyter Notebook
  • License
    Apache License 2.0
  • Created almost 2 years ago
  • Updated 3 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Simple Python package to preview and develop streamlit apps in jupyter notebooks

streamlit-jupyter

CI Badge Open Streamlit App

Docs & links

Install

pip install streamlit_jupyter

How to use

Take a look at our example notebook, streamlit version runs here

The main idea is for you do experiment and develop in your notebook, visually see all the pieces, and then convert the notebook to .py to be run by streamlit

start by importing streamlit and patching it with streamlit-jupyter:

import streamlit as st

from streamlit_jupyter import StreamlitPatcher, tqdm

StreamlitPatcher().jupyter()  # register streamlit with jupyter-compatible wrappers

And now develop your notebook as usual, but with the ability to use Streamlit widgets and components.

See how it works below, and check out the example notebook

Currently supported methods

Refer to excellent streamlit docs for more details on each method

method docstring
st.cache_data Implements the public st.cache_data API: the @st.cache_data decorator, and
st.cache_resource Implements the public st.cache_resource API: the @st.cache_resource decorator,
st.cache Function decorator to memoize function executions.
st.caption Display text in small font.
st.checkbox Display a checkbox widget.
st.code Display a code block with optional syntax highlighting.
st.dataframe Display a dataframe as an interactive table.
st.date_input Display a date input widget.
st.expander Insert a multi-element container that can be expanded/collapsed.
st.experimental_data_editor Display a data editor widget.
st.header Display text in header formatting.
st.json Display object or string as a pretty-printed JSON string.
st.latex Display mathematical expressions formatted as LaTeX.
st.markdown Display string formatted as Markdown.
st.metric Display a metric in big bold font, with an optional indicator of how the metric changed.
st.multiselect Display a multiselect widget.
st.radio Display a radio button widget.
st.selectbox Display a select widget.
st.subheader Display text in subheader formatting.
st.text_area Display a multi-line text input widget.
st.text_input Display a single-line text input widget.
st.text Write fixed-width and preformatted text.
st.title Display text in title formatting.
st.write Write arguments to the app.

Currently unsupported methods

Most of the other methods are not supported yet.

If you need any of them, you have one of 2 options:

  • please open an issue or a PR

  • use them in your notebook regardless, they will still work once you convert your notebook to streamlit. You just won’t be able to preview them in jupyter.

Demonstration

Jupyter Streamlit
Markdown and headings alt alt
Interactive data entry alt alt
Pick and choose alt alt
Dataframes, caching and progress bars alt alt
Plots alt alt
Metrics alt alt