preswald

把 Python 数据应用打包成单个 HTML，浏览器里离线跑，分享像发文档。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 647 🐛 待处理 330 👀 关注 8

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4267

维护状态低维护

是否开源开源

定价模式 🏷️完全免费开源项目，Apache-2.0 许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类开源模型

开发团队StructuredLabs

官网地址https://www.preswald.com

GitHubhttps://github.com/StructuredLabs/preswald

定价模式🏷️完全免费

价格说明开源项目，Apache-2.0 许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Python

技术栈/模型ai,analytics,analytics-engineering,copilot,data,data-applications,data-infrastructure,data-pipelines,data-sdk,data-visualization,gpt,llm,open-source,python,schema-management,vscode

GitHub 星标★ 4267

上线时间2024-12-14 00:00:00

代码更新2026-06-11

仓库体积99.2 MB

本站数据更新2026-11-09

维护状态低维护

收录时间2026-08-09

浏览次数8

项目介绍

Preswald 是一个面向 Python 交互式数据应用的 WASM 打包工具。它解决的核心问题是：传统数据应用（如仪表盘、报告）依赖服务器或 Python 环境，部署和分享成本高。Preswald 能将基于 Pandas、Plotly、Matplotlib 等库的复杂数据工作流打包成单个 HTML 文件，借助 Pyodide 在浏览器中直接运行，无需后端。用户可以用 Python 编写数据处理和可视化逻辑，最终产出一个离线可用、加载迅速、像文档一样易分享的文件。其核心能力包括：自动将 Python 依赖（如 DuckDB、Pandas）编译为 WebAssembly，集成 Plotly/Matplotlib 交互图表，支持构建仪表盘、报告和笔记本，并强调离线运行和文档式分发体验。该项目处于成长阶段，为数据科学家和开发者提供了一种全新的应用交付方式。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4267

技术标签

ai analytics copilot data data-pipelines

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Python 环境（README 指向 python.org/downloads，建议 3.9+）
已安装 pip 或 uv 包管理器
可访问 PyPI 的网络环境

安装与启动步骤

1安装 Preswald

用 pip 全局安装 preswald 包；若使用 uv，可执行 uv pip install preswald。建议在虚拟环境中安装以避免依赖冲突。
```
pip install preswald
```
2初始化应用

在当前目录生成名为 my_app 的模板工程，包含 hello.py、preswald.toml、secrets.toml、data/sample.csv 和 images/logo.png。
```
preswald init my_app
```
3进入项目目录

切换到刚生成的 my_app 目录，后续所有命令都在该目录下执行。
```
cd my_app
```
4编写应用逻辑

编辑 hello.py，用 preswald 提供的 text、table、get_df 等组件写页面。README 示例先输出标题，再读取 sample.csv 并渲染表格。
5启动开发服务器

在项目目录执行 preswald run，会拉起开发服务器。默认端口通常为 8501，可在 preswald.toml 的 [project] port 中修改。
```
preswald run
```
6浏览器访问应用

打开浏览器访问终端提示的地址，默认 http://localhost:8501，即可看到你的第一个 Preswald 应用。

关键配置

配置项	必填	说明	示例
`project.title`	否	应用标题元数据	`Preswald Project`
`project.version`	否	应用版本号	`0.1.0`
`project.port`	否	开发服务器监听端口	`8501`
`project.slug`	否	应用标识 slug	`preswald-project`
`project.entrypoint`	否	入口 Python 文件	`hello.py`
`logging.level`	否	日志级别，可选 DEBUG/INFO/WARNING/ERROR/CRITICAL	`INFO`