using-streamlit-cli

Run, configure, and diagnose Streamlit apps via the CLI.

Updated Aug 29, 2025
One-click install
npx skills add https://github.com/DDTully/dotfiles --skill using-streamlit-cli-ddtully
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: using-streamlit-cli
Source: https://github.com/DDTully/dotfiles/tree/main/skills/.agent_skills/developing-with-streamlit/skills/using-streamlit-cli
Command: npx skills add https://github.com/DDTully/dotfiles --skill using-streamlit-cli-ddtully

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlit CLI helps you run Streamlit apps, configure runtime options, and diagnose issues directly from the command line, accelerating development and troubleshooting.

Core Features & Use Cases

  • Running apps with streamlit run and uv run, including basic entrypoint handling and URL-based scripts.
  • Managing configuration via --server.* flags and .streamlit/config.toml, with examples for port, address, headless mode, and theming.
  • Diagnostics and helper commands such as streamlit help, version, docs, and cache management; suitable for local development and multi-project workflows.

Quick Start

Start by running a sample Streamlit app with streamlit run app.py to see the CLI in action.

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?▼

To run a Streamlit app from the command line, use the `streamlit run` command with your Python script. This CLI approach streamlines development workflows by handling basic entrypoint execution and URL-based script launching directly.

How do I configure Streamlit server options and port settings via CLI?▼

Configure Streamlit server options via CLI using `--server.*` flags or a `.streamlit/config.toml` file. This configuration precedence allows you to manage port, address, headless mode, and theming for local testing and rapid prototyping.

Can I use uv to run Streamlit apps in a virtual environment?▼

Yes, you can use `uv run` to execute Streamlit apps within a virtual environment. This integration supports multi-project workflows across different machines by ensuring proper dependency isolation and virtual environment usage.

What CLI commands are available for diagnosing Streamlit issues?▼

Streamlit CLI provides diagnostic and helper commands like `streamlit help`, `version`, `docs`, and cache management. These commands support reflective diagnostics to accelerate troubleshooting and resolve local development issues.

Does Streamlit CLI support configuration precedence between flags and config files?▼

Streamlit CLI supports configuration precedence by prioritizing `--server.*` command-line flags over `.streamlit/config.toml` values. This hierarchy ensures runtime overrides for port, address, and headless mode function correctly during local testing.

Why is my Streamlit configuration not applying when running from the CLI?▼

Streamlit configuration may not apply due to configuration precedence rules where `--server.*` flags override `.streamlit/config.toml` settings. Use reflective diagnostics and helper commands to verify active settings and troubleshoot conflicts.