NVEIL

NVEIL Toolkit

描述数据，即可生成可用于生产环境的图表。数据始终留在本地。

快速开始 • API 参考 • 示例 • 更新日志

---

NVEIL 是一款 AI 驱动的数据可视化工具包。只需用自然语言写一句话，NVEIL 就会处理数据并生成可用于出版的可视化图表——无需编写图表代码，不会产生幻觉，数据也不会离开你的设备。

import nveil

nveil.configure(api_key="nveil_...")

# Pass a file path directly — no DataFrame loading required.
spec = nveil.generate_spec("Revenue by region, colored by quarter", "sales.csv")

fig = spec.render("sales.csv")   # 100% local — no API call
nveil.show(fig)                   # opens in browser

在 Shell 中使用

运行 pip install nveil 后，nveil 命令即可在 $PATH 中使用：

export NVEIL_API_KEY=nveil_...

# Ground yourself on the dataset (shape / dtypes / head preview)
nveil describe sales.csv

# Generate HTML + PNG + a reusable .nveil spec, print the explanation
nveil generate "Revenue by region, colored by quarter" \
  --data sales.csv --format all --explain

# Re-render an existing spec on fresh data — no API call
nveil render chart.nveil --data new_sales.csv

面向 AI Agent（Claude Code / Claude Desktop / Cursor / Codex / …）

NVEIL 提供一流的集成：

# Claude Code / Claude Desktop — install the bundled skill
nveil install-skill

# Claude Desktop, Cursor, any MCP client — add an MCP server:
# {"mcpServers": {"nveil": {"command": "nveil", "args": ["mcp"]}}}
nveil mcp                    # stdio server; launched by the MCP client

为什么选择 NVEIL？

功能	NVEIL	聊天机器人数据分析¹	大模型转可视化库²	传统绘图³
自然语言输入	✓	✓	✓	✗
原始数据保留在本机	✓	✗	✗	✓
仅向服务端发送架构和统计信息	✓	✗	✗	N/A
输出确定且可复现	✓	✗	✗	✓
离线重新渲染，无需 API 调用	✓	✗	✗	✓
可移植的已保存规格（.nveil 文件）	✓	✗	✗	✗
2D + 3D + 地理空间 + 科学可视化	✓	2D	2D	不定
多后端（Plotly、VTK、DeckGL）	✓	✗	✗	✗
数据处理引擎	✓	✓	部分支持	✗

_{¹ ChatGPT Advanced Data Analysis、Claude Analysis tool、Gemini Data Agent  ·  ² PandasAI、LIDA、Julius、Vanna  ·  ³ Plotly、Matplotlib、Seaborn}

工作原理

Your Data ──> Toolkit ──metadata only──> NVEIL AI ──> Processing Plan ──> Local Execution ──> Result
               ^                                                           ^
          raw data stays here                                     raw data stays here

1. 你描述想要什么，用通俗语言表达即可
2. NVEIL AI 规划数据处理和可视化（仅发送元数据——列名、类型和统计信息）
3. Toolkit 在本地执行——连接、聚合、透视、渲染，全部在你的设备上完成
4. 你获得图表——根据数据自动选择 Plotly、VTK 或 DeckGL

主要功能

🧠 双引擎合一 通过单条提示词，即可完成数据处理（连接、透视、聚合、地理编码、时间序列）和可视化生成。 🔒 隐私保护，融入设计 原始数据绝不会离开你的设备。只会发送列名、类型和聚合统计信息。 📈 多后端渲染 自动检测最佳引擎：Plotly（2D 图表）、VTK（3D/医疗）、DeckGL（地理空间）。

🧪 结果可审计 由约束求解驱动，而非随机生成。相同输入每次都会得到相同输出。 ⚡ 离线渲染 spec.render() 完全在本地运行，无需调用 API。 💾 可重复使用的规格 保存为 .nveil 文件，之后重新加载，并在新数据上渲染——无需服务端。

## 超越简单图表

NVEIL 支持地理空间热力图、3D 体数据、科学可视化、医学影像（DICOM）、生物信号数据（EDF/EDF+）、网络图以及其他 50 多种可视化类型，全部可通过自然语言完成。

保存一次，永久渲染

# Generate once (API call)
spec = nveil.generate_spec("Monthly trend by category", df)
spec.save("trend.nveil")

# Reload anywhere — no API call, no server, no cost
spec = nveil.load_spec("trend.nveil")
fig = spec.render(fresh_data)
nveil.save_image(fig, "report.png")

安装

pip install nveil

要求： Python 3.10+

入门

1. 在 app.nveil.com 创建账户
2. 在 Settings 中生成 API 密钥
3. 开始可视化

import os
import nveil

nveil.configure(api_key=os.environ["NVEIL_API_KEY"])

spec = nveil.generate_spec("scatter plot of price vs area", df)
fig = spec.render(df)
nveil.show(fig)

更多用法示例，请参阅 examples/ 目录。

文档

完整文档请访问 docs.nveil.com：

• 快速入门指南
• 核心概念 — 会话、规范和两阶段流程
• API 参考 — 所有公开函数的完整参考
• 隐私模型 — 哪些数据会发送，哪些数据保留在本地
• 示例 — 柱状图、多数据集、离线渲染

参与贡献

欢迎根据项目的贡献者许可协议参与贡献。欢迎通过 GitHub Issues 提交错误报告和功能请求。

许可证

GNU AGPL v3 或更高版本。详见 LICENSE。提供商业双重许可 — 请联系 [email protected]。

---

网站 • 文档 • 平台