wrenai

WrenAI 是一个开源生成式商业智能（GenBI）引擎，设计为通过 AI 代理使用，而非作为独立聊天界面。它提供受治理的语义层（建模定义语言，即 MDL）和 AI 上下文层，使 Claude Code、Cursor、Cline、Codex、MCP 客户端以及 LangChain/LangGraph 应用等代理能够在既定护栏内将自然语言业务问题转化为经过验证的 SQL、答案和可共享仪表盘。 MDL 以对 Git 友好的 YAML 和 Markdown 文件定义模型、列、关系、视图、立方体、指标、枚举、单位和已批准的连接，将业务含义与任何单一数据仓库分离。额外上下文——指令、已实践查询示例和记忆——存放在可审查文件（instructions.md、queries.yml）以及带混合检索的本地 LanceDB 记忆索引中。查询规划具备模式感知能力，包括干计划验证、行数限制、值分析和带提示的结构化错误。 核心引擎基于 Apache DataFusion 用 Rust 构建，并附带 Python 绑定、用于浏览器端仪表盘应用的 WebAssembly 构建（wren-core-wasm）、Python SDK 和 CLI（wrenai PyPI 包）、MCP 服务器，以及 LangChain/LangGraph（wren-langchain）和 Pydantic AI（wren-pydantic）集成。README 列出了 22+ 连接器，包括 BigQuery、Snowflake、PostgreSQL、ClickHouse、Amazon Redshift、Databricks 和 DuckDB。 宣传的工作流分为三个阶段：用业务上下文丰富项目，通过 `wren query` 执行问题生成受治理的 SQL，并将结果部署为可过滤仪表盘到 Vercel 或 Cloudflare Pages。快速入门只需三条命令：用 pip 安装（添加连接器扩展，如 postgres 或 memory），运行 `npx skills add Canner/WrenAI` 安装代理发现桩，然后让代理配置数据库或使用内置的 jaffle_shop 示例。CLI 技能指南涵盖入门引导、上下文丰富和 GenBI 应用生成；`wren ask` 为较弱或较强的代理提供引导模式和直接模式。 Git Sync 允许将本地 Wren 仓库绑定到 Wren Cloud 或自托管安装，以便通过 git push/pull 部署团队级模型。认证使用短期令牌，而持久密钥保存在 ~/.wren/cloud.yml 中，权限为 0600，且不会交给 git。 该项目遵循开放核心模式。引擎、MDL 语义层、受治理的文本转 SQL、MCP 服务器、CLI、SDK、技能和连接器均采用 Apache-2.0 许可并可自托管，包括离线环境使用。商业版 Wren AI Cloud 和 Enterprise Plus 增加了行级和列级安全与访问控制、GenBI UI/仪表盘/嵌入/API、场景 AI 工具集（GenBI Apps、Agentic Mode、AI 辅助上下文准备）、高级安全与审计、支持与 SLA，以及云、VPC 或离线部署。 README 还提到仓库迁移：2026-05-07，Wren Engine 合并到本仓库的 core/ 目录下，原 Canner/wren-engine 仓库已归档，早期以聊天为主的产品作为 Wren GenBI Classic 保留在 legacy/v1 分支（标签 v1-final），不再添加新功能或安全修复。仓库结构包括 Rust 核心、Python 绑定和 CLI、MDL JSON 模式、SDK、代理技能、文档和示例项目。