using-streamlit-cli

Manage and run Streamlit apps via command line with configuration and diagnostics.

629|85|Updated May 4, 2020
One-click install
npx skills add https://github.com/andfanilo/streamlit-echarts --skill using-streamlit-cli-andfanilo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-streamlit-cli
Source: https://github.com/andfanilo/streamlit-echarts/tree/main/.claude/skills/developing-with-streamlit/skills/using-streamlit-cli
Command: npx skills add https://github.com/andfanilo/streamlit-echarts --skill using-streamlit-cli-andfanilo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides clear, actionable command-line guidance to run Streamlit applications, manage runtime configuration, and perform basic diagnostics so developers can quickly launch and troubleshoot apps locally or in CI.

Core Features & Use Cases

  • Run apps reliably: Start apps from files, directories, or remote URLs and pass script arguments to your app.
  • Configuration management: Apply temporary flags, use environment variables, or persist settings in local and global config files with clear precedence rules.
  • Diagnostics & maintenance: Inspect current config, clear cache, check Streamlit version, and scaffold starter projects; use uv run for automatic virtual environment and dependency handling.
  • Use Case: During development, launch a prototype with uv run to ensure reproducible environments, set server.port and server.headless flags for CI, and run streamlit config show to verify settings before deploying.

Quick Start

Start a reproducible run environment and launch your app by running uv run streamlit run app.py from your project directory.

Frequently Asked Questions about using-streamlit-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a Streamlit app from the command line with specific configuration flags?

To run a Streamlit app from the command line, use `streamlit run` with your script, directory, or remote URL, and pass temporary configuration flags like `--server.port` directly to override default settings for that session.

What is the precedence order for Streamlit configuration when using flags and environment variables?

Streamlit configuration precedence follows command-line flags first, then environment variables, and finally local and global config files, ensuring temporary flags override persistent settings when managing runtime behavior.

Can I use uv to run Streamlit apps in an isolated virtual environment?

Yes, you can run Streamlit apps using `uv run streamlit run app.py` to automatically handle virtual environment creation and dependency management, ensuring a reproducible local development or CI setup.

What is the best way to troubleshoot and inspect current Streamlit configuration settings?

The best way to troubleshoot Streamlit configuration is to run `streamlit config show` from the command line to inspect current settings, clear cache, or check the Streamlit version for diagnostics.

Does Streamlit CLI support passing script arguments to my application?

Yes, the Streamlit CLI supports passing script arguments to your application when you run it from files, directories, or remote URLs, allowing you to parameterize app execution directly from the command line.

Why are my Streamlit CI checks failing due to port conflicts or browser auto-launching?

Streamlit CI checks often fail from port conflicts or browser auto-launching; resolve this by setting command-line flags like `--server.port` and `--server.headless` to configure the runtime environment for automated testing.