⚡️ Launched in 1.33: st.experimental_fragment

[jcarroll]

Update April 5: @st.experimental_fragment was released in Streamlit 1.33!

Hi everyone!

The Streamlit team is excited to share st.experimental_fragment, a new feature released in Streamlit 1.33 that provides a whole new level of flexibility and control for your apps.

@st.experimental_fragment is a new decorator that turns any function into a “fragment” that can run independently of the wider page. Whenever an input widget inside the fragment changes, only the fragment reruns. This app introduces the feature and some common use cases.

A quick example

with st.spinner("Doing a slow thing"):
    time.sleep(2)

@st.experimental_fragment # Just add the decorator
def simple_chart():
    st.write("When you move the slider, only the chart updates")
    val = st.slider("Number of bars", 1, 20, 4)
    st.bar_chart(np.random.default_rng().random(val))

simple_chart()

This new decorator will turn any function into a Streamlit container that can run independently of the wider page.

It will also include a run_every= kwarg that allows you to automatically rerun the function and update the app every N seconds.

Want to learn more?

• View the demo app for more use cases and examples.
• Check out the docs article and API reference for more details. We’ll be adding more tutorials and examples in the coming days.
• Try it yourself: pip install streamlit>=1.33

Happy Streamlit-ing!

[REPNOT]

This will get put to immediate use!! Thank you for sharing!

[gabrielc]

This is very exciting!

Some naming ideas:

• @st.isolate
• @st.separate

[gabrielc]

Just wanted to add that with this, no more crazy hacks with st.session_states too!

[Tsadoq]

Love this! It will make stream lit even more central in my toolbox.

Personally I think that there are two routes for the naming:

• One is to simple and call it st.partial and call it a day: it might be not very particular but it contains the info needed.

• Else, I think that st.echo or st.refresh or st.rerun might be a little more creative but still show quite well the point of the decorator

[edsaac]

@jcarroll

Ideas on API name? We’d love to hear your input and ideas on what to name the API for partial reruns!

There is already a “partial” in the standard library, in the functools library. I don’t have a better name though… st.sublit?

[public-git-ui]

I would avoid the name partial due to commonly used concept of partial functions. I suggest st.standalone.

[ferdy]

On naming, how about:

isolated_rerun
rerun_inplace
rerun_this
local_rerun
selective_rerun

The use of two words further enhanced clarity.

[Daniel_Attard]

I placed a copy of streamlit-1.30.0-py2.py3-none-any.whl in my .streamlit folder and then did pip install streamlit-1.30.0-py2.py3-none-any.whl from that folder. Now when I the command streamlit --version I can see that it is now using Streamlit, version 1.30.0

When I try to run the Simple example code however, I get AttributeError: module 'streamlit' has no attribute 'partial'

What am I doing wrong?

[ferdy]

@Daniel_Attard

I placed a copy of streamlit-1.30.0-py2.py3-none-any.whl in my .streamlit folder

This is how I setup.

1. Place the whl in project folder.
2. Create requirements.txt and write the whl filename.
3. Create virtual environment venv to not mess up with other library version when installed globally.

PS F:\Project\streamlit_isolated_rerun> python -m venv venv

4. Activate venv.

Windows 10.

./venv/scripts/activate

5. Update pip inside the venv.

(venv) PS F:\Project\streamlit_isolated_rerun> python -m pip install pip -U

6. Install the libs in the requirements.txt.

pip install -r requirements.txt

That should do it.

[ferdy]

Do some exploration and encountered an issue.

Executing a task outside of a decorated function while simultaneously interacting with it can lead to a RuntimeError.

I am aware of the current limitations, but it seems this is a different issue.

[jcarroll]

@ferdy

Executing a task outside of a decorated function while simultaneously interacting with it can lead to a RuntimeError.

Thanks @ferdy ! I agree, it looks like a slightly different issue. Will investigate. Not sure we will fix it for the whl file but it’s a good case to test for the final version!

[Dan_Attard]

Thanks for the detailed instructions. Once I followed them closely, everything fell into place and started working. Isolated_rerun is a great feature!

[Dan_Attard]

I also noticed the same RuntimeError when simultaneously interacting with the decorated function and executing a task.

[guxi]

This is the most useful feature that immediately improved my app efficiency and adoption. Please release ASAP! Thanks for your advise and help, @mliu !

[lkdd-ao]

I can’t think of a more exciting name than this👇.
free_engine

Long-awaited API

[REPNOT]

Thank you for sharing!

[REPNOT]

Ticket Stream - Live Events Search Application Built with Streamlit → Powered by Ticketmaster

Whether you’re planning a trip, looking to catch the next big game, or can’t wait for the next visit to your favorite venue featuring live local bands, you can find it all here with instant access to live event listings wherever you go!

Ticket Stream - Built with Streamlit → Powered by Ticketmaster

@jcarroll Putting great work, to work!!

@jcarroll

Share what you build: Leave a comment with either a public app link, of your app or a screen shot/gif of the partial rerun feature in action. We may want to elevate your work to the entire Streamlit community when the feature officially goes live!

[PhilsburyDoboy]

I found an issue where the partial decorator is very inconsistent with normal operation. If an element on a partial-rerun is not rendered after an update, it will not be removed in the diff and will remain on the page. Here is a super simple script to reproduce:

import streamlit as st

@st.partial
def main():
    toggle = st.toggle('This toggle is bugged')
    
    if toggle:
        st.header('You should see "Toggle ON"')
    else:
        st.header('You should NOT see "Toggle ON"')
    
    if toggle:
        st.header('Toggle ON')

main()

When you remove the decorator, it works as expected. When you keep the decorator, the “Toggle ON” header will be rendered after you turn the toggle on and off again.