PyGWalker 安装部署三条路径跑通不卡白屏【免费下载链接】pygwalkerPyGWalker: Turn your dataframe into an interactive UI for visual analysis项目地址: https://gitcode.com/GitHub_Trending/py/pygwalker在 Colab 里pip install pygwalker一分钟装完pyg.walk(df)一执行单元格却只剩一个白框换到公司内网机器conda 又卡在渠道依赖上出不来。这两种情况就是本文要解决的 PyGWalker 安装问题pip 怎么装、conda-forge 怎么装、内网源码怎么部署以及装完后 30 秒怎么确认自己真的装好了。边界先说清本文只讲到装好并跑通为止不涉及业务建模、拖拽操作讲解也不做与其他可视化工具的功能对比。⚙️ 前置确认四个硬性约束先过一遍只列硬性约束不堆建议。任何一项不满足先处理再进对应路径确认项要求不满足时怎么办Python 版本≥3.10发布说明在 3.10~3.13 上验证过conda create -n pyg python3.11 -y新建环境网络出口路径 A/B 需能访问 PyPI 或 conda-forge直接走路径 C有网机器构建后传产物conda 渠道必须启用 conda-forgeconda config --add channels conda-forgeNode.js仅路径 C 需要22.x与 CI 一致Yarn 1.x缺 yarn 时npm install -g yarn补上三条路径跑通三条路径的验收标准是同一个对任意一个小 DataFrame 执行pyg.walk单元格下方出现可交互面板。按使用场景选路径而不是按工具名选。路径 Apip 安装Notebook 单用户跑起来适用个人开发、Colab / Kaggle、本地 Jupyter。前提当前环境pip install能正常联网。下面这条命令完成全部安装预期产物是安装日志无报错且 Python 单元格能打印出版本号当前为 0.6 系列以仓库 release 为准# 基础安装需要更新时在命令后追加 --upgrade pip install pygwalker跑不通时第一个该查的地方pyg.walk不渲染界面时先看 kernel 报错里有没有 anywidget / ipywidgets 相关字样ipywidgets 过旧就跑pip install pygwalker[notebook]补齐 notebook 侧依赖。路径 Bconda-forge 安装锁出可复现环境适用团队多人要同一版本或者需要用环境文件分发。前提机器上有 conda或 mamba且 conda-forge 渠道已启用。这三条命令建环境、进环境、装包预期产物是conda list pygwalker显示的渠道列为 conda-forgeconda create -n pyg python3.11 -y conda activate pyg conda install -c conda-forge pygwalker跑不通时第一个该查的地方报PackagesNotFoundError大概率是渠道没启用或顺序不对用conda config --show channels确认 conda-forge 在列表里。需要团队分发时再上环境文件。仓库根目录自带environment.yml样例这里给一份把依赖对齐到当前 pyproject 要求的版本conda env create -f environment.yml一次建成# environment.yml建好后可用 conda env list 确认环境名 name: pygwalker channels: - conda-forge - defaults dependencies: - python3.10 - pandas - jupyterlab - pip: - pygwalker路径 C内网源码部署先把前端白屏解决掉适用无网/内网机器或者要改前端做定制。原理先交代一句Python 侧渲染时直接读pygwalker/templates/dist/下的 JS 包白屏大多意味着这个目录是空的。所以源码部署的核心就是让这一目录有内容。前提至少一台有网机器克隆、拉 Node 依赖目标内网机器可以无网靠产物拷贝。第 1 段克隆代码跑完应该看到本地多出一个pygwalker目录git clone https://gitcode.com/GitHub_Trending/py/pygwalker cd pygwalker第 2 段构建前端。这段装前端依赖并编译 React 应用跑完你应该看到 JS 包落在pygwalker/templates/dist/里含pygwalker-app.iife.js# 需要 Node.js 22.x缺 yarn 先执行 npm install -g yarn cd app yarn install yarn build若yarn: command not found→ 先npm install -g yarn再重跑本段若当前机器无网 → 本段挪到有网机器执行把pygwalker/templates/dist/整个拷到目标机第 3 段装 Python 侧。这段建隔离环境并以 editable 模式安装跑完pip show pygwalker的 Location 应指向源码目录python -m venv venv source venv/bin/activate pip install -e .跑不通时第一个该查的地方notebook 渲染报 Missing PyGWalker frontend asset说明第 2 段产物没生成或没拷全重跑cd app yarn build并确认 dist 目录非空。 验证安装真正成功PyGWalker 安装算不算成功用这个最小脚本判定。在 notebook 里执行跑通即算装好import pandas as pd import pygwalker as pyg df pd.DataFrame({x: [1, 2, 3], y: [4, 5, 6]}) walker pyg.walk(df, spec_path./gw_verify.json) print(安装验证 OK)预期看到单元格下方出现交互面板、磁盘上多出gw_verify.json→ 没看到时先重启 kernel新装的包只有新 kernel 才认还没有就往下走排障小节。两个进阶验证点确认计算真的走本地 DuckDB把pyg.walk那一行改成computationkernel重跑。预期看到 kernel 输出无额外依赖警告、查询无异常 → 没看到时跑python -c import duckdb; print(duckdb.__version__)确认 duckdb 在位。注意 0.6 系列用computation参数旧例子里的kernel_computationTrue已废弃计划在 0.7.0 移除。确认前端资源是本地而非外链预期看到pygwalker/templates/dist/pygwalker-app.iife.js存在源码安装→ 没看到时回到路径 C 第 2 段重跑。平台差异其实很小任何 Jupyter 内核环境装完即用只有以下几类有版本门槛以仓库 Tested Environments 列表为准Streamlit0.1.4.9 起用StreamlitRenderer嵌入VS Code / Databricks 的 Jupyter0.1.4a0 起普通内核环境无需额外配置Colab / Kaggle / Jupyter Lab0.1.0 起pip 或 conda-forge 均可 排障四个高频症状症状一白屏或报 Missing PyGWalker frontend asset30 秒定位看pygwalker/templates/dist/里有没有 .js 文件wheel 安装本应自带。 修复 one-liner源码装法跑cd app yarn buildwheel 装法跑pip install --force-reinstall --no-deps pygwalker。 出口上面没解决 → 去项目仓库 issue 列表搜 Missing PyGWalker frontend asset。症状二conda 拉不到包PackagesNotFoundError30 秒定位conda config --show channels看 conda-forge 是否缺席或被 defaults 顺序压制。 修复 one-linerconda install -c conda-forge pygwalker。 出口上面没解决 → 查 conda-forge 渠道里 pygwalker 的 feedstock 页面版本渠道包过旧就改用 pip 装。症状三widget 不渲染ipywidgets 冲突30 秒定位pip show ipywidgets jupyter-serveripywidgets 是 7.x 或 jupyter-server 低于 2.5 就是旧了。 修复 one-linerpip install pygwalker[notebook]会带 ipywidgets8.0.0、jupyter-server2.5.0。 出口上面没解决 → 去 issue 列表搜 ipywidgets。症状四内网机器 pip 一直卡住30 秒定位pip download --no-deps pygwalker -d ./wheels同样卡住即确认到不了 PyPI。 修复 one-liner有网机器跑上一条命令拷走 wheels 目录后内网执行pip install --no-index --find-links ./wheels pygwalker。 出口上面没解决 → 缺哪个依赖包就看 pip download 的报错逐包下载补齐。什么时候需要离开这篇指南当你要前端完全不发网络请求、数据量超过浏览器内存、或者要改 UI 外观时会碰到隐私模式pygwalker config --set privacy...offline / update-only / events 三档默认 update-only、内核计算computationkernel查询落本地 DuckDB和前端资源定制set_component_url这三个话题。本文只给方向不贴代码细节看仓库 README 与 docs 目录。下一步三选一跑通examples/里的样例如jupyter_demo.ipynb、streamlit_demo.py熟悉拖拽流程集成进 Streamlit 做成可分享的 Web 应用参考examples/streamlit_demo.py参与贡献先读docs/CONTRIBUTING.md从修文档和回复 issue 开始【免费下载链接】pygwalkerPyGWalker: Turn your dataframe into an interactive UI for visual analysis项目地址: https://gitcode.com/GitHub_Trending/py/pygwalker创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考