WrenAI

环境要求

• Python 环境与 pip（用于安装 wrenai CLI）
• Node.js / npx（用于安装 AI 客户端发现存根）
• 一个 AI 客户端，如 Claude Code、Cursor、Cline 或 Codex
• 可访问 PyPI 与 HuggingFace（国内可换镜像源加速）

安装与启动步骤

1. 1安装 CLI 核心包

   用 pip 安装 wrenai 核心包，DuckDB 已内置，装完即可在终端使用 wren 命令。

   pip install wrenai

   复制

2. 2加装数据源扩展

   需要连接 PostgreSQL 或启用 memory 记忆能力时，安装带 extras 的版本。

   pip install "wrenai[postgres,memory]"

   复制

3. 3国内镜像加速

   中国大陆网络下 pip 安装慢或失败时，改用清华 PyPI 镜像重装。

   pip install wrenai -i https://pypi.tuna.tsinghua.edu.cn/simple

   复制

4. 4安装客户端存根

   该命令自动检测 Claude Code、Cursor、Cline、Codex 等客户端并写入约 50 行的发现存根。

   npx skills add Canner/WrenAI

   复制

5. 5拉取工作流指南

   让代理通过 CLI 按需获取工作流指南，指南随已安装版本提供，内容始终匹配。

   wren skills get genbi

   复制

6. 6自然语言提问

   用 wren ask 向代理提出业务问题，--guided 为引导模式，--direct 为直接模式。

   wren ask "本季度各渠道的销售额是多少？" --guided

   复制

7. 7试用示例数据集

   没有自己的数据库时，让代理使用内置 jaffle_shop 示例数据集，几分钟端到端跑通。

关键配置

如何确认成功

执行 wren skills get genbi 能返回指南内容，且代理可响应 wren ask 提问，说明 CLI 与客户端已接通。

常见问题

注意事项

• WrenAI 是代理驱动设计：先装 CLI 和客户端存根，其余配置交给 AI 代理按 CLI 内置指南完成。
• 生成 SQL 与仪表盘部署由代理执行；部署环节需自备 Vercel 或 Cloudflare Pages 账号。
• 旧版 Docker 聊天式 BI 应用已移至 legacy/v1 分支（tag v1-final），现称 Wren GenBI Classic。
• 完整文档见 https://docs.getwren.ai。