WrenAI 智能查询快速上手：10 分钟跑通自然语言问数
【免费下载链接】WrenAIGenBI (Generative BI) for AI agents, an open-source, governed text-to-SQL through an open context layer that turns natural-language questions into trusted dashboards, charts, and SQL across 20+ data sources, such as BigQuery, Snowflake, PostgreSQL, ClickHouse, Amazon Redshift, Databricks and more.项目地址: https://gitcode.com/GitHub_Trending/wr/WrenAI
WrenAI 智能查询把一句大白话变成可信 SQL，并直连 BigQuery、Snowflake、PostgreSQL 等 20 多种数据源。适合想少写 SQL、又嫌 BI 工具笨重的数据工程师和开发者。按本页顺序操作，大约 10 分钟就能看到第一次自然语言问数返回结果，WrenAI 安装与配置流程到此也就走完了。
值不值得投入
- 用自然语言问数，不用手写 SQL
- 向量库、嵌入都不用你操心
- 装好就能出第一次查询结果
最短路径：克隆到出结果
先装好前置工具。Windows 下请先用 WSL2 或 Git Bash，否则后续命令跑不起来。
| 工具 | 版本 | 作用 |
|---|---|---|
| Python | 3.12.x | 运行 WrenAI 核心服务，建议用 pyenv 隔离环境 |
| Docker + Docker Compose | 任意新版 | 以容器跑向量数据库、查询引擎等配套组件 |
| Poetry | 1.8.3 | Python 包管理器，负责依赖安装 |
| Just | 1.36+ | 命令运行器，把多步命令收敛成一条 |
下面五条命令在终端依次执行：
git clone https://gitcode.com/GitHub_Trending/wr/WrenAI cd WrenAI/wren-ai-service just init拉取 WrenAI 源码并进入 AI 服务目录 wren-ai-service/。 成功标志：just init后多出 config.yaml 与 .env.dev 两个文件。
打开.env.dev，填入OPENAI_API_KEY；想换端口就在这改。只生成生产配置可用just init --non-dev。
poetry install装齐全部 Python 依赖并自动建好虚拟环境。 成功标志：终端停在 "Installing dependencies from lock file" 之后。
just up启动 Qdrant 向量数据库、Wren Engine、Ibis Server 三个容器。 成功标志：全部容器进入 running 状态；首次拉镜像稍慢。
just start拉起 AI 服务（5556 端口）与 Web 界面（3000 端口）。 成功标志：终端出现 Uvicorn 运行在 127.0.0.1:5556 的提示。
它是怎么干活的
你用一句自然语言提问，WrenAI 智能查询先把问题拆开读懂，再从数据模式索引里捞出相关的表和字段，接着拼出一条 SQL 交给你指定的数据源执行，最后把查回的字段和数字重新讲回成一句话。中间那步索引平时就在后台维护好，不用你碰向量库细节。
配置速查表
| 参数 | 默认值 | 什么时候改 |
|---|---|---|
OPENAI_API_KEY | 空 | 换模型供应商或密钥失效时，在.env.dev里填 |
WREN_AI_SERVICE_PORT | 5556 | AI 服务端口被占用时 |
WREN_UI_PORT | 3000 | 3000 被占，或你想让 Web 界面换端口 |
model（config.yaml 的 llm 部分） | 按模板预填 | 想换 GPT-4、Claude 等模型时改这一项 |
table_retrieval_size | 按模板预填 | 调每次检索的表数量，问题定位不准时动它 |
排障速查表
| 现象 | 最常见原因 | 处理办法 |
|---|---|---|
| 启动时报端口被占用 | 5556 或 3000 已被别的进程占了 | 在.env.dev把对应*_PORT改成空闲端口，just down后再just up |
| 换 LLM 不生效 | config.yaml 改了但服务没重启 | 确认 llm 部分的model已改、对应 API 密钥就位，再just start |
| API 密钥不生效 | 密钥写错位置或没重启服务 | 密钥一律放.env.dev，改完重启 AI 服务；别把密钥提交进仓库 |
收尾与日常清理
到这里 WrenAI 智能查询的安装、配置、排错都过了一遍，日常就是改配置、重启、查排障表。用完跑just down停掉并移除所有容器；想清掉生成数据，删掉tools/dev/etc即可。再往下想深入，去翻 docs/ 目录或直接提 issue。
【免费下载链接】WrenAIGenBI (Generative BI) for AI agents, an open-source, governed text-to-SQL through an open context layer that turns natural-language questions into trusted dashboards, charts, and SQL across 20+ data sources, such as BigQuery, Snowflake, PostgreSQL, ClickHouse, Amazon Redshift, Databricks and more.项目地址: https://gitcode.com/GitHub_Trending/wr/WrenAI
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
