setting-up-streamlit-environment

name	setting-up-streamlit-environment
description	Setting up Python environments for Streamlit apps. Use when creating a new project or managing dependencies. Covers uv for dependency management and running apps.
license	Apache-2.0

Streamlit environment

Use whatever dependency management the project already has (pip, poetry, conda, etc.). If starting fresh and uv is available, it's a good default—fast, reliable, and creates isolated environments automatically.

If uv is not installed, ask the user before installing it.

CRITICAL: Always Use Latest Streamlit

Always specify streamlit>=1.53.0 (or latest) in dependencies. Many Streamlit features and patterns in these skills require recent versions. Older streamlit versions will cause errors with:

• Material icons (:material/icon_name:)
• st.pills(), st.segmented_control()
• Modern caching decorators
• Navigation APIs

When setting up a new project or fixing an existing one, always check and update the streamlit version.

Using uv

If uv is available, here's how to set up a Streamlit project.

Quick start (venv only)

For simple apps, just create a virtual environment:

uv venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
uv pip install streamlit

Run with:

streamlit run streamlit_app.py

Full project setup