using-streamlit-cli

You can run a Streamlit app by executing the `streamlit run` command with your app file, directory, or URL as the entrypoint. Optional environment tweaks and server options can be passed directly through CLI flags.

To configure Streamlit runtime options consistently, use a combination of CLI flags and recommended settings in the `.streamlit/config.toml` file. This ensures uniform behavior across local development and CI workflows.

The Streamlit CLI helps with diagnosing issues by providing commands to access help, version info, docs, and cache management. These tools allow developers to quickly resolve common runtime problems and clear stale caches.

Yes, you can use Streamlit CLI commands in CI workflows and onboarding scenarios. The CLI provides consistent execution and environment handling, allowing automated pipelines to run apps and diagnose issues reliably.

Your Streamlit configuration may not apply if CLI flags override `.streamlit/config.toml` settings or if the file is misplaced. Ensure your config file is correctly located and use CLI flags to enforce specific runtime options.

No, you do not need `uv` to run Streamlit apps, but you can use `uv run streamlit run app.py` if you prefer. Standard execution using `streamlit run app.py` works perfectly for local development and CI workflows.