SuperAPI AI 工具集

setting-up-streamlit-environment

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:为 Streamlit 应用建立 Python 环境、管理依赖并启动应用,适用于新建项目或修复已有项目。

主要能力与原则:优先使用项目已有的依赖管理方式(pip、poetry、conda 等);若从零开始且可用 uv,可将 uv 作为默认选择,因为它快速、可靠并自动创建隔离环境。若未安装 uv,需先询问用户再安装。关键要求:依赖中始终指定 streamlit>=1.53.0(或最新版),因为相关技能中的许多特性和写法依赖较新版本,旧版本会导致 Material 图标(:material/icon_name:)、st.pills()、st.segmented_control()、现代缓存装饰器和导航 API 等出错;新建或修复项目时都要检查并更新 Streamlit 版本。

使用方式:仅需虚拟环境时执行 uv venv、source .venv/bin/activate(Windows 用 .venv\Scripts\activate)、uv pip install streamlit,然后运行 streamlit run streamlit_app.py。完整项目用 uv init my-streamlit-app、cd my-streamlit-app、uv add streamlit,会生成 pyproject.toml、uv.lock 和 .venv/,运行 uv run streamlit run streamlit_app.py。添加依赖可用 uv pip install 或 uv add。不建议随意设置启动选项,除非有明确理由,例如自动化或 CI 环境可用 streamlit run streamlit_app.py --server.headless true。

项目结构与约定:多数应用保持简单,只需 .venv/ 与 streamlit_app.py;仅在需要时添加 app_pages/(多页应用)、.streamlit/config.toml(自定义主题或设置)、.streamlit/secrets.toml(使用密钥,并加入 .gitignore)、pyproject.toml(用 uv init 做可复现构建)。主文件统一命名为 streamlit_app.py:使用导航时它是定义并运行页面的路由,无导航时它是包含主内容的首页。

限制:资料未提供其他安装方式、具体版本兼容性细节或完整示例代码之外的额外说明;是否安装 uv 需先征得用户同意。