欢迎来到 Streamlit 👋

更快地构建和分享数据应用。

什么是 Streamlit？

Streamlit 让你能够在几分钟内，而不是几周内，将 Python 脚本转化为交互式 Web 应用。你可以构建仪表盘、生成报告，或者创建聊天应用。一旦你创建了应用，就可以使用我们的 Community Cloud 平台 来部署、管理和分享你的应用。

为什么选择 Streamlit？

• 简单且符合 Python 风格： 编写美观、易读的代码。
• 快速、交互式的原型开发： 让他人与你的数据互动，并迅速提供反馈。
• 实时编辑： 在编辑脚本时，你的应用会立即更新。
• 开源且免费： 加入一个充满活力的社区，并为 Streamlit 的未来贡献力量。

安装

打开终端并运行：

$ pip install streamlit
$ streamlit hello

如果这会在你的浏览器中打开我们可爱的 Streamlit Hello 应用，那么你就准备好了！如果没有，请前往 我们的文档 查看具体的安装步骤。

该应用包含许多使用 Streamlit 可以实现的例子。跳转到 快速入门 部分，了解这些功能是如何工作的。

快速入门

一个小示例

在你的项目目录中创建一个名为 streamlit_app.py 的新文件，内容如下：

import streamlit as st
x = st.slider("选择一个值")
st.write(x, "的平方是", x * x)

现在运行它来打开应用！

$ streamlit run streamlit_app.py

还有更多！

Streamlit 提供了 大量强大的组件，可以为你的数据应用增添色彩，让观众眼前一亮。以下是一些例子：

输入组件	数据框	图表	布局	多页面应用	趣味应用

我们活跃的开发者社区还通过 🧩 Streamlit Components 扩展了 Streamlit 的功能。

获取灵感

使用 Streamlit 你可以构建很多东西：

• 🤖  大语言模型与聊天机器人应用
• 🧬  科学与技术应用
• 💬  NLP 与语言应用
• 🏦  金融与商业应用
• 🗺  地理与社会应用
• 以及更多！

快来看看我们的画廊吧！ 🎈

Community Cloud

使用我们的 Community Cloud 免费部署、管理和分享你的应用！请在此处注册：这里。

资源

• 浏览我们的 文档，了解 Streamlit 的工作原理。
• 在我们的 社区论坛 上提问并获取帮助。
• 阅读我们的 博客，获取来自开发者和创作者的实用技巧。
• 通过安装或创建自己的 Streamlit Components 来扩展 Streamlit 的功能。
• 帮助他人找到并体验你的应用，可以在你的仓库中使用 Streamlit GitHub 徽章：

[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](URL_TO_YOUR_APP)

贡献

🎉 感谢你对改进 Streamlit 的兴趣！ 🎉

在贡献之前，请阅读我们的贡献指南：https://github.com/streamlit/streamlit/blob/develop/CONTRIBUTING.md

许可证

Streamlit 是完全免费且开源的，采用 Apache 2.0 许可证授权。

Streamlit 快速上手指南

Streamlit 是一个能让你在几分钟内将 Python 脚本转化为交互式 Web 应用的开源工具，非常适合构建数据仪表盘、报告生成器或聊天机器人。

环境准备

• 操作系统：Windows, macOS, 或 Linux
• Python 版本：建议安装 Python 3.8 至 3.12 版本
• 前置依赖：确保已安装 pip 包管理工具

💡 国内加速建议：为避免网络延迟，建议使用国内镜像源进行安装（如清华大学源）。

安装步骤

打开终端（Terminal 或 CMD），运行以下命令安装 Streamlit：

pip install streamlit -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，运行官方自带的演示应用以验证安装是否成功：

streamlit hello

如果浏览器自动打开并显示 Streamlit Hello 界面，说明环境已配置就绪。

基本使用

1. 创建应用文件

在项目目录下创建一个新文件，命名为 streamlit_app.py，并写入以下代码：

import streamlit as st

x = st.slider("Select a value")
st.write(x, "squared is", x * x)

2. 运行应用

在终端中进入该文件所在目录，执行以下命令启动应用：

streamlit run streamlit_app.py

3. 体验交互

浏览器会自动打开本地地址（通常为 http://localhost:8501）。你可以拖动滑块，页面会实时显示计算结果。

核心特性：

• 热重载：修改 .py 文件并保存后，网页会自动更新，无需手动刷新。
• 纯 Python：无需编写 HTML、CSS 或 JavaScript，仅需 Python 代码即可构建复杂界面。

接下来，你可以探索 Streamlit API 文档 学习更多组件（如图表、数据表格、多页应用等），开始构建你的数据应用。