Running a Streamlit app from a Python script

author image

In this post, I’ll show you how to run a Streamlit application from a Python script. This is useful if you want to run some logic before your app starts or if you want to package it as an standalone executable.

Note that this technique uses streamlit’s internal CLI module, hence, it might not work with certain versions. I tested this code with the following version:

pip install streamlit==1.32.2

Suppose we have an script. The usual way of starting the app is:

streamlit run

We’ll replicate this functionality with the following script:

# store this as
from streamlit.web import cli

if __name__ == "__main__":

To run it:


Note that you can pass arguments to the main_run function:

from streamlit.web import cli

if __name__ == "__main__":
    cli.main_run(["", "--server.port", "1000"])

That’s it!

Found an error? Click here to let us know.

Deploy Streamlit apps with Ploomber

Recent Articles

Try Ploomber Cloud Now

Get Started