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.