Before you get started, you're going to need a few things:

• Your favorite IDE or text editor
• Python 3.6 - 3.8
• PIP

If you haven't already, take a few minutes to read through Main concepts to understand Streamlit's data flow model.

Regardless of which package management tool you're using, we recommend running the commands on this page in a virtual environment. This ensures that the dependencies pulled in for Streamlit don't impact any other Python projects you're working on.

Below are a few tools you can use for environment management:

• pipenv
• poetry
• venv
• virtualenv
• conda

pip install streamlit

Now run the hello world app to make sure everything is working:

streamlit hello

Now that everything's installed, let's create a new Python script and import Streamlit.

1. Create a new Python file named first_app.py, then open it with your IDE or text editor.

2. Next, import Streamlit.

   import streamlit as st
   # To make things easier later, we're also importing numpy and pandas for
   # working with sample data.
   import numpy as np
   import pandas as pd

3. Run your app. A new tab will open in your default browser. It'll be blank for now. That's OK.

   streamlit run first_app.py

   Running a Streamlit app is no different than any other Python script. Whenever you need to view the app, you can use this command.

   .. tip::
      Did you know you can also pass a URL to `streamlit run`? This is great when combined with Github Gists. For example:
   
      `$ streamlit run https://raw.githubusercontent.com/streamlit/demo-uber-nyc-pickups/master/streamlit_app.py`
   

4. You can kill the app at any time by typing Ctrl+c in the terminal.