Command-line interface

When you install Streamlit, the Streamlit command-line CLI tool gets installed as well. The main purpose of this tool is to help you diagnose and fix issues.

You can find docs for our CLI tool as usual:

$ streamlit --help

Below are a few of the most useful commands accepted by Streamlit CLI:

Run Streamlit apps

$ streamlit run [-- script args]

Runs your app. At any time you can kill the server with Ctrl+c.


When passing your script some custom arguments, they must be passed after two dashes. Otherwise the arguments get interpreted as arguments to Streamlit itself.

You can also pass in config options to streamlit run. These allow you to do things like change the port the app is served from, disable run-on-save, and more. To see all options, run:

$ streamlit run --help


If you want to permanently set certain config options, just add them to $CWD/.streamlit/config.toml or to a global ~/.streamlit/config.toml (in Windows this would be %userprofile%/.streamlit/config.toml). More info below.

Run a cool demo

$ streamlit hello

Opens Streamlit’s Hello World app in a web browser. This is useful for testing Streamlit.

View all config options

$ streamlit config show

Shows all config options available for Streamlit, including their current values. You can set these options in four different ways:

  • In a global config file at ~/.streamlit/config.toml. For instance:

    port = 80
  • In a per-project config file at $CWD/.streamlit/config.toml, where $CWD is the folder you’re running Streamlit from.

  • Through STREAMLIT_* environment variables, such as:

  • As flags in the command line when running streamlit run. For example:

    $ streamlit run --server.port 80

Clear the cache

$ streamlit cache clear

Clears persisted files from the Streamlit cache, if any.

View documentation

$ streamlit docs

Opens Streamlit’s documentation (i.e. this website) in a web browser.