Changelog
This page lists highlights, bug fixes, and known issues for official Streamlit releases. If you're looking for information about nightly releases, beta features, or experimental features, see Try pre-release features.
Tip
To upgrade to the latest version of Streamlit, run:
$ pip install --upgrade streamlit
Version 1.5.0
Release date: Jan 27, 2022
Notable Changes
- ๐ Favicon defaults to a PNG to allow for transparency (#4272).
- ๐ฆ Select Slider Widget now has the
disabled
parameter that removes interactivity (completing all of our widgets) (#4314).
Other Changes
- ๐ค Improvements to our markdown library to provide better support for HTML (specifically nested HTML) (#4221).
- ๐ Expanders maintain their expanded state better when multiple expanders are present (#4290).
- ๐ณ Improved file uploader and camera input to call its
on_change
handler only when necessary (#4270).
Version 1.4.0
Release date: Jan 13, 2022
Highlights
- ๐ธ Introducing
st.camera_input
for uploading images straight from your camera.
Notable Changes
- ๐ฆ Widgets now have the
disabled
parameter that removes interactivity. - ๐ฎ Clear
st.experimental_memo
andst.experimental_singleton
programmatically by using theclear()
method on a cached function. - ๐จ Developers can now configure the maximum size of a message to accommodate larger messages within the Streamlit application. See
server.maxMessageSize
. - ๐ We formally added support for Python 3.10.
Other Changes
- ๐ตโ๐ซ Calling
str
orrepr
onthreading.current_thread()
does not cause a RecursionError (#4172). - ๐น Gracefully stop screencast recording when user removes permission to record (#4180).
- ๐ Better scale images by using a higher-quality image bilinear resampling algorithm (#4159).
Version 1.3.0
Release date: Dec 16, 2021
Notable Changes
- ๐ฏ Support for NumPy values in
st.metric
. - ๐ Support for Mesh Layers in PyDeck.
- ๐ Updated Plotly chart version to support the latest features.
- ๐
st.spinner
element has visual animated spinner. - ๐ฐ
st.caption
supports HTML in text withunsafe_allow_html
parameter.
Other Changes
- ๐ชฒ Bug fix: Allow
st.session_state
to be used to set number_input values with no warning (#4047). - ๐ชฒ Bug fix: Fix footer alignment in wide mode (#4035).
- ๐ Bug fix: Better support for Graphviz and Bokeh charts in containers (columns, expanders, etc.) (#4039).
- ๐ Bug fix: Support inline data values in Vega-Lite (#4070).
- โ๏ธ Types: Updated type annotations for experimental memo and singleton decorators.
- โ๏ธ Types: Improved type annotations for
st.selectbox
,st.select_slider
,st.radio
,st.number_input
, andst.multiselect
.
Version 1.2.0
Release date: Nov 11, 2021
Notable Changes
- โ๏ธย
st.text_input
ย andst.text_area
now have aยplaceholder
ย parameter to display text when the field is empty. - ๐ Viewers can now resize the input box in
st.text_area
. - ๐ Streamlit can auto-reload when files in sub-directories change.
- ๐ We've upgraded Bokeh support to 2.4.1! We recommend updating your Bokeh library to 2.4.1 to maintain functionality. Going forward, we'll let you know if there's a mismatch in your Bokeh version via an error prompt.
- ๐ Developers can access secrets via attribute notation (e.g.
st.secrets.key
vsst.secrets["key"]
) just like session state. - โ๏ธ Publish type annotations according to PEP 561. Users now get type annotations for Streamlit when running mypy (#4025).
Other Changes
- ๐ Visual fixes (#3863, #3995, #3926, #3975).
- ๐ Fixes to the hamburger menu (#3968).
- ๐จ๏ธ Ability to print session state (#3970).
Version 1.1.0
Release date: Oct 21, 2021
Highlights
- ๐ง Memory improvements: Streamlit apps allocate way less memory over time now.
Notable Changes
- โป๏ธ Apps automatically rerun now when the content of
secrets.toml
changes (before this you had to refresh the page manually).
Other Changes
- ๐ Redirected some links to our brand-new docs site, e.g. in exceptions.
- ๐ชฒ Bug fix: Allow initialization of range slider with session state (#3586).
- ๐ Bug fix: Refresh chart when using
add_rows
withdatetime
index (#3653). - โ๏ธ Added some more type annotation in our codebase (#3908).
Version 1.0.0
Release date: Oct 5, 2021
Highlights
- ๐Announcing Streamlit 1.0! To read more about check out our 1.0 blog post.
Other Changes
- ๐ Fixed an issue where using
df.dtypes
to show datatypes for a DF fails while using Arrow (#3709), Image captions stay within image width and are readable (#3530).
Version 0.89.0
Release date: Sep 22, 2021
Highlights
- ๐ฐ Introducing
st.experimental_memo
andexperimental_singleton
, a new primitive for caching! See our blog post. - ๐ Streamlit allows developers to configure their hamburger menu to be more user-centric.
Notable Changes
- ๐ We updated our UI to a more polished look with a new font.
- ๐จ We now support
theme.base
in the theme object when it's sent to custom components. - ๐ง We've modified session state to reset widgets if any of their arguments changed even if they provide a key.
- Some widget behavior may have changed, but we believe this change makes the most sense. We have added a section to our documentation describing how they behave.
Other Changes
Version 0.88.0
Release date: Sep 2, 2021
Highlights
- โฌ๏ธ Introducing
st.download_button
, a new button widget for easily downloading files.
Notable Changes
- ๐ We made changes to improve the redacted exception experience on Streamlit Cloud. When
client.showErrorDetails=true
exceptions display the Error Type and the Traceback, but redact the actual error text to prevent data leaks.
Version 0.87.0
Release date: Aug 19, 2021
Highlights
- ๐ข Introducing
st.metric
, an API for displaying KPIs. Check out the demo app showcasing the functionality.
Other Changes
- ๐ Bug Fixes: File uploader retains state upon expander closing (#3557), setIn Error with
st.empty
(#3659), Missing IFrame embeds in docs (#3706), Fix error writing certain PNG files (#3597).
Version 0.86.0
Release date: Aug 5, 2021
Highlights
- ๐ Our layout primitives are graduating from beta! You can now use
st.columns
,st.container
andst.expander
without thebeta_
prefix.
Notable Changes
- ๐ฑ When using
st.columns
, columns will stack vertically when viewport size <640px so that column layout on smaller viewports is consistent and cleaner. (#3594).
Other Changes
- ๐ Bug fixes: Fixed
st.date_input
crashes if its empty (#3194), Opening files with utf-8(#3022),st.select_slider
resets its state upon interaction (#3600).
Version 0.85.0
Release date: Jul 22, 2021
Highlights
- ๐น Streamlit now uses Apache Arrow for serializing data frames when they are sent from Streamlit server to the front end. See our blog post.
- (Users who wish to continue using the legacy data frame serialization can do so by setting the
dataFrameSerialization
config option to"legacy"
in theirconfig.toml
).
- (Users who wish to continue using the legacy data frame serialization can do so by setting the
Other Changes
- ๐ Bug fixes: Unresponsive pydeck example (#3395), JSON parse error message (#2324), Tooltips rendering (#3300), Colorpicker not working on Streamlit Sharing (#2689).
Version 0.84.0
Release date: Jul 1, 2021
Highlights
- ๐ง Introducing
st.session_state
and widget callbacks to allow you to add statefulness to your apps. Check out the blog post
Notable Changes
- ๐ช
st.text_input
now has anautocomplete
parameter to allow password managers to be used
Other Changes
- Using st.set_page_config to assign the page title no longer appends โStreamlitโ to that title (#3467)
- NumberInput: disable plus/minus buttons when the widget is already at its max (or min) value (#3493)
Version 0.83.0
Release date: Jun 17, 2021
Highlights
- ๐ฃ๏ธ Updates to Streamlit docs to include step-by-step guides which demonstrate how to connect Streamlit apps to various databases & APIs
Notable Changes
- ๐
st.form
now has aclear_on_submit
parameter which "resets" all the form's widgets when the form is submitted.
Other Changes
Version 0.82.0
Release date: May 13, 2021
Notable Changes
- โป๏ธ Improvements to memory management by forcing garbage collection between script runs.
Version 0.81.1
Release date: Apr 29, 2021
Highlights
- ๐ Introducing
st.form
andst.form_submit_button
to allow you to batch input widgets. Check out our blog post - ๐ค Introducing
st.caption
so you can add explainer text anywhere in you apps. - ๐จ Updates to Theming, including ability to build a theme that inherits from any of our default themes.
- ๐ Improvements to deployment experience to Streamlit sharing from the app menu.
Other changes
- Support for binary files in Custom Components (#3144)
Version 0.80.0
Release date: Apr 8, 2021
Highlights
- ๐ Streamlit now support Secrets management for apps deployed to Streamlit Sharing!
- โ๏ธ Titles and headers now come with automatically generated anchor links. Just hover over any title and click the ๐ to get the link!
Other changes
- Added
allow-downloads
capability to custom components (#3040) - Fixed markdown tables in dark theme (#3020)
- Improved color picker widget in the Custom Theme dialog (#2970)
Version 0.79.0
Release date: Mar 18, 2021
Highlights
- ๐ Introducing support for custom themes. Check out our blog post
- ๐ This release also introduces dark mode!
- ๐ ๏ธ Support for tooltips on all input widgets
Other changes
Version 0.78.0
Release date: Mar 4, 2021
Features
- If you're in the Streamlit for Teams beta, we made a few updates to how secrets work. Check the beta docs for more info!
- Dataframes now displays timezones for all DateTime and Time columns, and shows the time with the timezone applied, rather than in UTC
Notable Bug Fixes
- Various improvement to column alignment in
st.beta_columns
- Removed the long-deprecated
format
param fromst.image
, and replaced withoutput_format
.
Version 0.77.0
Release date: Feb 23, 2021
Features
- Added a new config option
client.showErrorDetails
allowing the developer to control the granularity of error messages. This is useful for when you deploy an app, and want to conceal from your users potentially-sensitive information contained in tracebacks.
Notable bug fixes
- Fixed bug where
st.image
wasn't rendering certain kinds of SVGs correctly. - Fixed regression where the current value of an
st.slider
was only shown on hover.
Version 0.76.0
Release date: February 4, 2021
Notable Changes
- ๐จ
st.color_picker
is now out of beta. This means the old beta_color_picker function, which was marked as deprecated for the past 3 months, has now been replaced with color_picker. - ๐ Display a warning when a Streamlit script is run directly as
python script.py
. st.image
'suse_column_width
now defaults to anauto
option which will resize the image to the column width if the image exceeds the column width.- โ๏ธ Fixed bugs (2437 and 2247) with content getting cut off within a
st.beta_expander
- ๐ Fixed a bug in
st.dataframe
where the scrollbar overlapped with the contents in the last column. - ๐พ Fixed a bug for
st.file_uploader
where file data returned was not the most recently uploaded file. - โ Fixed bugs (2086 and 2556) where some LaTeX commands were not rendering correctly.
Version 0.75.0
Release date: January 21, 2021
Notable Changes
- ๐ณ
st.empty
previously would clear the component at the end of the script. It has now been updated to clear the component instantly. - ๐น Previously in wide mode, we had thin margins around the webpage. This has now been increased to provide a better visual experience.
Version 0.74.0
Release date: January 6, 2021
Notable Changes
- ๐พ
st.file_uploader
. has been stabilized and the deprecation warning and associated configuration option (deprecation.showfileUploaderEncoding
) has been removed. - ๐
st.bokeh_chart
is no longer duplicated when the page loads. - ๐ Fixed page icon to support emojis with variants (i.e. ๐คฆโโ๏ธ vs ๐คฆ๐ผโโ๏ธ) or dashes (i.e ๐ - crescent-moon).
Version 0.73.0
Release date: December 17, 2020
Notable Changes
- ๐ Streamlit can now be installed on Python 3.9. Streamlit components are not yet compatible with Python 3.9 and must use version 3.8 or earlier.
- ๐งฑ Streamlit Components now allows same origin, enabling features provided by the browser such as a webcam component.
- ๐ Fix Streamlit sharing deploy experience for users running on Git versions 2.7.0 or earlier.
- ๐งฐ Handle unexpected closing of uploaded files for
st.file_uploader
.
Version 0.72.0
Release date: December 2, 2020
Notable Changes
- ๐ Establish a framework for theming and migrate existing components.
- ๐ฑ Improve the sidebar experience for mobile devices.
- ๐งฐ Update
st.file_uploader
to reduce reruns.
Version 0.71.0
Release date: November 11, 2020
Notable Changes
- ๐ Updated
st.file_uploader
to automatically reset buffer on app reruns. - ๐ Optimize the default rendering of charts and reduce issues with the initial render.
Version 0.70.0
Release date: October 28, 2020
Notable Changes
- ๐งช
st.set_page_config
andst.color_picker
have now been moved into the Streamlit namespace. These will be removed from beta January 28th, 2021. Learn more about our beta process here. - ๐ Improve display of bar charts for discrete values.
Version 0.69.0
Release date: October 15, 2020
Highlights:
- ๐ Introducing Streamlit sharing, the best way to deploy, manage, and share your public Streamlit appsโfor free. Read more about it on our blog post or sign up here!
- Added
st.experimental_rerun
to programatically re-run your app. Thanks SimonBiggs!
Notable Changes
- ๐น Better support across browsers for start and stop times for st.video.
- ๐ผ Bug fix for intermittently failing media files
- ๐ฆ Bug fix for custom components compatibility with Safari. Make sure to upgrade to the latest streamlit-component-lib.
Version 0.68.0
Release date: October 8, 2020
Highlights:
- โ Introducing new layout options for Streamlit! Move aside, vertical layout. Make a little space for... horizontal layout! Check out our blog post.
- ๐พ File uploader redesigned with new functionality for multiple files uploads and better support for working with uploaded files. This may cause breaking changes. Please see the new api in our documentation
Notable Changes
- ๐
st.balloon
has gotten a facelift with nicer balloons and smoother animations. - ๐จ Breaking Change: Following the deprecation of
st.deck_gl_chart
in January 2020, we have now removed the API completely. Please usest.pydeck_chart
instead. - ๐จ Breaking Change: Following the deprecation of
width
andheight
forst.altair_chart
,st.graphviz_chart
,st.plotly_chart
, andst.vega_lite_chart
in January 2020, we have now removed the args completely. Please set the width and height in the respective charting library.
Version 0.67.0
Release date: September 16, 2020
Highlights:
- ๐ฆท Streamlit Components can now return bytes to your Streamlit App. To create a component that returns bytes, make sure to upgrade to the latest streamlit-component-lib.
Notable Changes
- ๐ Deprecation warning: Beginning December 1st, 2020
st.pyplot()
will require a figure to be provided. To disable the deprecation warning, please setdeprecation.showPyplotGlobalUse
toFalse
- ๐
st.multiselect
andst.select
are now lightning fast when working with large datasets. Thanks masa3141!
Version 0.66.0
Release date: September 1, 2020
Highlights:
- โ๏ธ
st.write
is now available for use in the sidebar! - ๐ A slider for distinct or non-numerical values is now available with
st.select_slider
. - โ Streamlit Components can now return dataframes to your Streamlit App. Check out our SelectableDataTable example.
- ๐ฆ The Streamlit Components library used in our Streamlit Component template is now available as a npm package (streamlit-component-lib) to simplify future upgrades to the latest version. Existing components do not need to migrate.
Notable Changes
- ๐ผ Support StringDtype from pandas version 1.0.0
- ๐งฆ Support for running Streamlit on Unix sockets
Version 0.65.0
Release date: August 12, 2020
Highlights:
- โ๏ธ Ability to set page title, favicon, sidebar state, and wide mode via st.beta_set_page_config(). See our documentation for details.
- ๐ Add stateful behaviors through the use of query parameters with st.experimental_set_query_params and st.experimental_get_query_params. Thanks @zhaoooyue!
- ๐ผ Improved pandas dataframe support for st.radio, st.selectbox, and st.multiselect.
- ๐ Break out of your Streamlit app with st.stop.
- ๐ผ Inline SVG support for st.image.
Callouts:
- ๐จDeprecation Warning: The st.image parameter format has been renamed to output_format.
Version 0.64.0
Release date: July 23, 2020
Highlights:
- ๐ Default matplotlib to display charts with a tight layout. To disable this,
set
bbox_inches
toNone
, inches as a string, or aBbox
- ๐ Deprecation warning for automatic encoding on
st.file_uploader
- ๐ If
gatherUserStats
isFalse
, do not even load the Segment library. Thanks @tanmaylaud!
Version 0.63.0
Release date: July 13, 2020
Highlights:
- ๐งฉ Support for Streamlit Components!!! See documentation for more info.
- ๐ Support for datetimes in
st.slider
. And, of course, just like any other value you use inst.slider
, you can also pass in two-element lists to get a datetime range slider.
Version 0.62.0
Release date: June 21, 2020
Highlights:
- ๐จ Ability to turn websocket compression on/off via the config option
server.enableWebsocketCompression
. This is useful if your server strips HTTP headers and you do not have access to change that behavior. - ๐๏ธ Out-of-the-box support for CSRF protection using the
Cookie-to-header token
technique. This means that if you're serving your Streamlit app from multiple replicas you'll need
to configure them to to use the same cookie secret with the
server.cookieSecret
config option. To turn XSRF protection off, setserver.enableXsrfProtection=false
.
Notable bug fixes:
- ๐ผ๏ธ Added a grace period to the image cache expiration logic in order to fix multiple related bugs
where images sent with
st.image
orst.pyplot
were sometimes missing.
Version 0.61.0
Release date: June 2, 2020
Highlights:
- ๐
Support for date ranges in
st.date_picker
. See docs for more info, but the TLDR is: just pass a list/tuple as the default date and it will be interpreted as a range. - ๐ฃ๏ธ You can now choose whether
st.echo
prints the code above or below the output of the echoed block. To learn more, refer to thecode_location
argument in the docs. - ๐ฆ Improved
@st.cache
support for Keras models and Tensorflowsaved_models
.
Version 0.60.0
Release date: May 18, 2020
Highlights:
- โ๏ธ Ability to set the height of an
st.text_area
with theheight
argument (expressed in pixels). See docs for more. - ๐ก Ability to set the maximimum number of characters allowed in
st.text_area
orst.text_input
. Check out themax_chars
argument in the docs. - ๐บ๏ธ Better DeckGL support for the H3 geospatial indexing
system. So now you can use things like
H3HexagonLayer
inst.pydeck_chart
. - ๐ฆ Improved
@st.cache
support for PyTorch TensorBase and Model.
Version 0.59.0
Release date: May 05, 2020
Highlights:
- ๐จ New color-picker widget! Use it with
st.beta_color_picker()
- ๐งช Introducing
st.beta_*
andst.experimental_*
function prefixes, for faster Streamlit feature releases. See docs for more info. - ๐ฆ Improved
@st.cache
support for SQL Alchemy objects, CompiledFFI, PyTorch Tensors, andbuiltins.mappingproxy
.
Version 0.58.0
Release date: April 22, 2020
Highlights:
- ๐ผ Made
st.selectbox
filtering case-insensitive. - ใฌ Better support for Tensorflow sessions in
@st.cache
. - ๐ Changed behavior of
st.pyplot
to auto-clear the figure only when using the global Matplotlib figure (i.e. only when callingst.pyplot()
rather thanst.pyplot(fig)
).
Version 0.57.0
Release date: March 26, 2020
Highlights:
- โฒ๏ธ Ability to set expiration options for
@st.cache
'ed functions by setting themax_entries
andttl
arguments. See docs. - ๐ Improved the machinery behind
st.file_uploader
, so it's much more performant now! Also increased the default upload limit to 200MB (configurable viaserver.max_upload_size
). - ๐ The
server.address
config option now binds the server to that address for added security. - ๐ Even more details added to error messages for
@st.cache
for easier debugging.
Version 0.56.0
Release date: February 15, 2020
Highlights:
- ๐ Improved error messages for st.cache. The errors now also point to the new caching docs we just released. Read more here!
Breaking changes:
- ๐ As announced last month, Streamlit no longer supports Python 2. To use Streamlit you'll need Python 3.5 or above.
Version 0.55.0
Release date: February 4, 2020
Highlights:
- ๐บ Ability to record screencasts directly from Streamlit! This allows you to easily record and share explanations about your models, analyses, data, etc. Just click โฐ then "Record a screencast". Give it a try!
Version 0.54.0
Release date: January 29, 2020
Highlights:
- โจ๏ธ Support for password fields! Just pass
type="password"
tost.text_input()
.
Notable fixes:
- โณ๏ธ Numerous st.cache improvements, including better support for complex objects.
- ๐ฃ๏ธ Fixed cross-talk in sidebar between multiple users.
Breaking changes:
- If you're using the SessionState
hackGist, you should re-download it! Depending on which hack you're using, here are some links to save you some time:
Version 0.53.0
Release date: January 14, 2020
Highlights:
๐บ๏ธ Support for all DeckGL features! Just use Pydeck instead of
st.deck_gl_chart
. To do that, simply pass a PyDeck object tost.pydeck_chart
,st.write
, or magic.Note that as a preview release things may change in the near future. Looking forward to hearing input from the community before we stabilize the API!
The goals is for this to replace
st.deck_gl_chart
, since it is does everything the old API did and much more!๐ Better handling of Streamlit upgrades while developing. We now auto-reload the browser tab if the app it is displaying uses a newer version of Streamlit than the one the tab is running.
๐ New favicon, with our new logo!
Notable fixes:
- Magic now works correctly in Python 3.8. It no longer causes docstrings to render in your app.
Breaking changes:
Updated how we calculate the default width and height of all chart types. We now leave chart sizing up to your charting library itself, so please refer to the library's documentation.
As a result, the
width
andheight
arguments have been deprecated from most chart commands, anduse_container_width
has been introduced everywhere to allow you to make charts fill as much horizontal space as possible (this used to be the default).
Version 0.52.0
Release date: December 20, 2019
Highlights:
๐ค Preview release of the file uploader widget. To try it out just call
st.file_uploader
!Note that as a preview release things may change in the near future. Looking forward to hearing input from the community before we stabilize the API!
๐ Support for emoji codes in
st.write
andst.markdown
! Try it out withst.write("Hello :wave:")
.
Breaking changes:
- ๐งน
st.pyplot
now clears figures by default, since that's what you want 99% of the time. This allows you to create two or more Matplotlib charts without having to callpyplot.clf
every time. If you want to turn this behavior off, usest.pyplot(clear_figure=False)
- ๐ฃ
st.cache
no longer checks for input mutations. This is the first change of our ongoing effort to simplify the caching system and prepare Streamlit for the launch of other caching primitives like Session State!
Version 0.51.0
Release date: November 30, 2019
Highlights:
- ๐ You can now tweak the behavior of the file watcher with the config option
server.fileWatcherType
. Use it to switch between:auto
(default) : Streamlit will attempt to use the watchdog module, and falls back to polling if watchdog is not available.watchdog
: Force Streamlit to use the watchdog module.poll
: Force Streamlit to always use polling.none
: Streamlit will not watch files.
Notable bug fixes:
- Fix the "keyPrefix" option in static report sharing #724
- Add support for getColorX and getTargetColorX to DeckGL Chart #718
- Fixing Tornado on Windows + Python 3.8 #682
- Fall back on webbrowser if xdg-open is not installed on Linux #701
- Fixing number input spin buttons for Firefox #683
- Fixing CTRL+ENTER on Windows #699
- Do not automatically create credential file when in headless mode #467
Version 0.50.1
Release date: November 10, 2019
Highlights:
- ๐ฉโ๐ SymPy support and ability to draw mathematical expressions using LaTeX! See
st.latex
,st.markdown
, andst.write
. - ๐ You can now set config options using environment variables. For example,
export STREAMLIT_SERVER_PORT=9876
. - ๐ฑ Ability to call
streamlit run
directly with Github and Gist URLs. No need to grab the "raw" URL first! - ๐ Cleaner exception stack traces. We now remove all Streamlit-specific code from stack traces originating from the user's app.
Version 0.49.0
Release date: October 23, 2019
Highlights:
- ๐ฏ New input widget for entering numbers with the keyboard:
st.number_input()
- ๐บ Audio/video improvements: ability to load from a URL, to embed YouTube videos, and to set the start position.
- ๐ค You can now (once again) share static snapshots of your apps to S3! See
the S3 section of
streamlit config show
to set it up. Then share from top-right menu. - โ๏ธ Use
server.baseUrlPath
config option to set Streamlit's URL to something likehttp://domain.com/customPath
.
Notable bug fixes:
- Fixes numerous Windows bugs, including Issues #339 and #401.
Version 0.48.0
Release date: October 12, 2019
Highlights:
- ๐ง Ability to set config options as command line flags or in a local config file.
- โ๏ธ You can now maximize charts and images!
- โก Streamlit is now much faster when writing data in quick succession to your app.
- โณ๏ธ Ability to blacklist folder globs from "run on save" and
@st.cache
hashing. - ๐๏ธ Improved handling of widget state when Python file is modified.
- ๐ Improved HTML support in
st.write
andst.markdown
. HTML is still unsafe, though!
Notable bug fixes:
- Fixes
@st.cache
bug related to having your Python environment on current working directory. Issue #242 - Fixes loading of root url
/
on Windows. Issue #244
Version 0.47.0
Release date: October 1, 2019
Highlights:
- ๐ New hello.py showing off 4 glorious Streamlit apps. Try it out!
- ๐ Streamlit now automatically selects an unused port when 8501 is already in use.
- ๐ Sidebar support is now out of beta! Just start any command with
st.sidebar.
instead ofst.
- โก Performance improvements: we added a cache to our websocket layer so we no longer re-send data to the browser when it hasn't changed between runs
- ๐ Our "native" charts
st.line_chart
,st.area_chart
andst.bar_chart
now use Altair behind the scenes - ๐ซ Improved widgets: custom st.slider labels; default values in multiselect
- ๐ต๏ธโโ๏ธ The filesystem watcher now ignores hidden folders and virtual environments
- ๐ Plus lots of polish around caching and widget state management
Breaking change:
- ๐ก๏ธ We have temporarily disabled support for sharing static "snapshots" of Streamlit apps. Now that we're no longer in a limited-access beta, we need to make sure sharing is well thought through and abides by laws like the DMCA. But we're working on a solution!
Version 0.46.0
Release date: September 19, 2019
Highlights:
- โจ Magic commands! Use
st.write
without typingst.write
. See https://docs.streamlit.io/en/latest/api.html#magic-commands - ๐๏ธ New
st.multiselect
widget. - ๐ Fixed numerous install issues so now you can use
pip install streamlit
even in Conda! We've therefore deactivated our Conda repo. - ๐ Multiple bug fixes and additional polish in preparation for our launch!
Breaking change:
- ๐ก๏ธ HTML tags are now blacklisted in
st.write
/st.markdown
by default. More information and a temporary work-around at: https://github.com/streamlit/streamlit/issues/152
Version 0.45.0
Release date: August 28, 2019
Highlights:
- ๐ฑ Experimental support for sidebar! Let us know if you want to be a beta tester.
- ๐ Completely redesigned
st.cache
! Much more performant, has a cleaner API, support for caching functions called by@st.cached
functions, user-friendly error messages, and much more! - ๐ผ๏ธ Lightning fast
st.image
, ability to choose between JPEG and PNG compression, and between RGB and BGR (for OpenCV). - ๐ก Smarter API for
st.slider
,st.selectbox
, andst.radio
. - ๐ค Automatically fixes the Matplotlib backend -- no need to edit .matplotlibrc
Version 0.44.0
Release date: July 28, 2019
Highlights:
- โก Lightning-fast reconnect when you do a ctrl-c/rerun on your Streamlit code
- ๐ฃ Useful error messages when the connection fails
- ๐ Fixed multiple bugs and improved polish of our newly-released interactive widgets
Version 0.43.0
Release date: July 9, 2019
Highlights:
- โก Support for interactive widgets! ๐๐
Version 0.42.0
Release date: July 1, 2019
Highlights:
- ๐พ Ability to save Vega-Lite and Altair charts to SVG or PNG
- ๐ We now cache JS files in your browser for faster loading
- โ Improvements to error-handling inside Streamlit apps
Version 0.41.0
Release date: June 24, 2019
Highlights:
- ๐ Greatly improved our support for named datasets in Vega-Lite and Altair
- ๐ Added ability to ignore certain folders when watching for file changes. See the
server.folderWatchBlacklist
config option. - โ More robust against syntax errors on the user's script and imported modules
Version 0.40.0
Release date: June 10, 2019
Highlights:
- Streamlit is more than 10x faster. Just save and watch your analyses update instantly.
- We changed how you run Streamlit apps:
$ streamlit run your_script.py [script args]
- Unlike the previous versions of Streamlit,
streamlit run [script] [script args]
creates a server (now you don't need to worry if the proxy is up). To kill the server, all you need to do is hit Ctrl+c.
Why is this so much faster?
Now, Streamlit keeps a single Python session running until you kill the server. This means that Streamlit can re-run your code without kicking off a new process; imported libraries are cached to memory. An added bonus is that st.cache
now caches to memory instead of to disk.
What happens if I run Streamlit the old way?
If you run $ python your_script.py
the script will execute from top to bottom, but won't produce a Streamlit app.
What are the limitations of the new architecture?
- To switch Streamlit apps, first you have to kill the Streamlit server with Ctrl-c. Then, you can use
streamlit run
to generate the next app. - Streamlit only works when used inside Python files, not interactively from the Python REPL.
What else do I need to know?
The strings we print to the command line when liveSave is on have been cleaned up. You may need to adjust any RegEx that depends on those.
A number of config options have been renamed:
Old config New config proxy.isRemote server.headless proxy.liveSave server.liveSave proxy.runOnSave server.runOnSave proxy.watchFileSystem server.runOnSave proxy.enableCORS server.enableCORS proxy.port server.port browser.proxyAddress browser.serverAddress browser.proxyPort browser.serverPort client.waitForProxySecs n/a client.throttleSecs n/a client.tryToOutliveProxy n/a client.proxyAddress n/a client.proxyPort n/a proxy.autoCloseDelaySecs n/a proxy.reportExpirationSecs n/a
What if something breaks?
If the new Streamlit isn't working, please let us know by Slack or email. You can downgrade at any time with these commands:
$ pip install --upgrade streamlit==0.37
$ conda install streamlit=0.37
What's next?
Thank you for staying with us on this journey! This version of Streamlit lays the foundation for interactive widgets, a new feature of Streamlit we're really excited to share with you in the next few months.
Version 0.36.0
Release date: May 03, 2019
Highlights
- ๐ฃโโ๏ธ
st.progress()
now also accepts floats from 0.0โ1.0 - ๐คฏ Improved rendering of long headers in DataFrames
- ๐ Shared apps now default to HTTPS
Version 0.35.0
Release date: April 26, 2019
Highlights
- ๐ท Bokeh support! Check out docs for
st.bokeh_chart
- โก๏ธ Improved the size and load time of saved apps
- โพ๏ธ Implemented better error-catching throughout the codebase