Canner/WrenAI

这是什么？

核心功能

• 01基于语义层（MDL）将自然语言问题转换为 SQL。
• 02通过 dry-plan 校验、行数限制和结构化错误提示保证查询可控。
• 03将智能体构建的仪表盘部署为浏览器端应用，发布到 Vercel 或 Cloudflare Pages。
• 04把指标定义、枚举和示例查询保存为可版本管理的 YAML 与 Markdown 文件。
• 05提供命令行工具，以及 LangChain、LangGraph、Pydantic AI 的集成 SDK。
• 06基于 Apache DataFusion 引擎连接 20 多种数据源。

适用场景

• 让 AI 智能体基于数据仓库，用受治理的 SQL 回答业务问题。
• 把智能体生成的分析结果做成可筛选、可分享的仪表盘。
• 将指标定义纳入 Git 管理，通过 Pull Request 评审口径变更。
• 为已有的 LangChain 或 MCP 智能体增加受控的 text-to-SQL 能力。

快速上手

1. 1

   从 PyPI 安装命令行工具

   pip install wrenai
2. 2

   安装智能体技能发现模块

   npx skills add Canner/WrenAI
3. 3

   在项目文件夹中打开智能体，并让它用 Wren 配置你的数据库

使用前须知

• !元数据中许可证显示为 NOASSERTION，但 README 称核心引擎为 Apache-2.0。
• !行级和列级安全、GenBI 界面与仪表盘等功能属于商业版，不包含在开源引擎中。
• !使用需要 AI 智能体和数据库连接，不是开箱即用的独立图形化工具。

标签

常见问题

WrenAI 是什么？

开源 GenBI 引擎，让 AI 智能体把自然语言问题转为受治理的 SQL 与可分享的仪表盘。 WrenAI 是面向 AI 智能体的生成式商业智能（GenBI）引擎。它位于智能体与数据仓库之间，通过语义层（MDL）定义指标、表关系、枚举、单位和认可的关联方式，让智能体基于业务含义而不只是原始表结构来生成 SQL。

WrenAI 可以免费使用吗？用的什么许可证？

WrenAI 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

WrenAI 还在维护吗？

活跃维护中。WrenAI 最近一次提交是在 2026年10月21日。

WrenAI 适合用来做什么？

让 AI 智能体基于数据仓库，用受治理的 SQL 回答业务问题。 把智能体生成的分析结果做成可筛选、可分享的仪表盘。 将指标定义纳入 Git 管理，通过 Pull Request 评审口径变更。 为已有的 LangChain 或 MCP 智能体增加受控的 text-to-SQL 能力。

WrenAI 怎么安装和运行？

从 PyPI 安装命令行工具: pip install wrenai 安装智能体技能发现模块: npx skills add Canner/WrenAI 在项目文件夹中打开智能体，并让它用 Wren 配置你的数据库

在哪里获取 WrenAI？

源代码和安装说明在 GitHub 上：https://github.com/Canner/WrenAI