README

Welcome to Streamlit 👋

A faster way to build and share data apps.

 What is Streamlit?

Streamlit lets you transform Python scripts into interactive web apps in minutes, instead of weeks. Build dashboards, generate reports, or create chat apps. Once you’ve created an app, you can use our Community Cloud platform to deploy, manage, and share your app.

 Why choose Streamlit?

- Simple and Pythonic: Write beautiful, easy-to-read code.
- Fast, interactive prototyping: Let others interact with your data and provide feedback quickly.
- Live editing: See your app update instantly as you edit your script.
- Open-source and free: Join a vibrant community and contribute to Streamlit's future.

 Installation

Open a terminal and run:

bash
$ pip install streamlit
$ streamlit hello


If this opens our sweet _Streamlit Hello_ app in your browser, you're all set! If not, head over to our docs for specific installs.

The app features a bunch of examples of what you can do with Streamlit. Jump to the quickstart section to understand how that all works.



 Quickstart

 A little example

Create a new file named streamlit_app.py in your project directory with the following code:
python
import streamlit as st

x = st.slider("Select a value")
st.write(x, "squared is", x  x)


Now run it to open the app!

$ streamlit run streamlit_app.py




 Give me more!

Streamlit comes in with a ton of additional powerful elements to spice up your data apps and delight your viewers. Some examples:


  
    
      
        
      
    
    
      
        
      
    
    
      
        
      
    
    
      
        
      
    
    
      
        
      
    
    
      
        
      
    
  
  
    Input widgets
    Dataframes
    Charts
    Layout
    Multi-page apps
    Fun
  



Our vibrant creators community also extends Streamlit capabilities using  🧩 Streamlit Components.

 Get inspired

There's so much you can build with Streamlit:
- 🤖  LLMs & chatbot apps
- 🧬  Science & technology apps
- 💬  NLP & language apps
- 🏦  Finance & business apps
- 🗺  Geography & society apps
- and more!

Check out our gallery! 🎈

 Community Cloud

Deploy, manage and share your apps for free using our Community Cloud! Sign-up here. 


 Resources

- Explore our docs to learn how Streamlit works.
- Ask questions and get help in our community forum.
- Read our blog for tips from developers and creators.
- Extend Streamlit's capabilities by installing or creating your own Streamlit Components.
- Help others find and play with your app by using the Streamlit GitHub badge in your repository:
markdown




 Contribute

🎉 Thanks for your interest in helping improve Streamlit! 🎉

We have paused accepting pull requests from outside the Streamlit maintainer team. You can still
make a valuable contribution by reporting bugs,
requesting features,
improving or upvoting existing issues,
commenting on open specs, creating
custom components,
and contributing to streamlit-extras.

Read our contribution gu

Top issues

Latest release

What's Changed
 New Features 🎉
 [feature] Update default light and dark named theme colors by @mayagbarnes in https://github.com/streamlit/streamlit/pull/17450
 [feature] Add required parameter to st.date_input by @lukasmasuch in https://github.com/streamlit/streamlit/pull/17165
 [feature] Allow a pixel width on st.dialog by @lukasmasuch in https://github.com/streamlit/streamlit/pull/17412
 [feature] Update default theme surfaces and sidebar fallback by @mayagbarnes in https://github.com/streamlit/streamlit/pull/17467
 [feature] Use theme primary for st.map default markers by @mayagbarnes in h