using-streamlit-cli

Run and configure Streamlit apps via CLI flags, URLs, and uv run.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/fangshine01/AI_agent --skill using-streamlit-cli-fangshine01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-streamlit-cli
Source: https://github.com/fangshine01/AI_agent/tree/main/.github/skills/using-streamlit-cli
Command: npx skills add https://github.com/fangshine01/AI_agent --skill using-streamlit-cli-fangshine01

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlit's command-line options and environment differences can be confusing when launching apps, configuring runtime behavior, or diagnosing issues; this Skill consolidates the essential CLI commands and configuration guidance to make starting, configuring, and troubleshooting Streamlit apps faster and more reliable.

Core Features & Use Cases

  • Run Apps: Guidance for running entrypoints by file, directory, or remote URL and an IDE-friendly alternative using python -m streamlit run.
  • Configuration Management: How to pass server and theme settings via command-line flags, environment variables, and persistent .streamlit/config.toml with precedence rules.
  • Diagnostics & Maintenance: Commands for viewing configuration, clearing cache, checking version, and opening docs, plus recommendations for reproducible environments using uv run.
  • Use Case: Launch a development instance of app.py with hot-reload for iterative UI development, or run a production containerized app with explicit server settings and diagnostics enabled.

Quick Start

Start the Streamlit app app.py on port 8080 in headless mode using uv run and enable server.runOnSave.

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 custom port and headless mode?

Run a Streamlit app from the command line by passing entrypoints as files, directories, or remote URLs alongside server configuration flags like port and headless mode to control runtime behavior directly.

What is the precedence order when configuring Streamlit runtime options via flags, environment variables, and config.toml?

Streamlit configuration precedence applies command-line flags first, then environment variables, and finally the persistent .streamlit/config.toml file, ensuring explicit runtime flags override default project settings.

Can I use uv run to execute Streamlit apps for reproducible dependency management?

Yes, you can execute Streamlit apps using uv run within a virtual environment, which ensures reproducible dependency management and consistent application launches across local development and CI pipelines.

How do I clear the Streamlit cache and run diagnostics from the CLI?

Clear the Streamlit cache and run diagnostics by executing dedicated CLI commands for viewing configuration, checking the installed version, and opening documentation to troubleshoot application issues.

Does Streamlit CLI support passing custom script arguments when launching an app?

Yes, Streamlit CLI supports passing custom script arguments when launching apps, allowing you to parameterize application logic and configure runtime options for local development or production containerized environments.