WrenAI 完整安装指南跑通 Text-to-SQL 自然语言查询【免费下载链接】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/WrenAIWrenAI 是一款开源 Text-to-SQL 引擎接入数据库后你直接用自然语言提问它自动生成 SQL、执行并返回结果。你不需要手写 SQL也不用先记住表结构和关联关系。本文带你从零完成 WrenAI 的安装并跑通一次自然语言查询最后给出停止服务与清理方法。WrenAI 环境要求开始安装前确认以下组件已就绪组件版本用途备注系统Linux / macOS / Windows命令执行环境Windows 上所有命令须在 WSL2 或 Git Bash 等 bash 环境中运行Python3.12.xWrenAI 服务运行时建议用 pyenv 管理多版本避免与系统环境冲突Docker Docker Compose最新稳定版运行配套服务容器首次启动时自动拉取镜像Poetry1.8.3Python 依赖管理—Just1.36执行项目命令—WrenAI 安装与启动步骤克隆源码并初始化项目克隆仓库并进入 AI 服务目录git clone https://gitcode.com/GitHub_Trending/wr/WrenAI cd WrenAI/wren-ai-service just init执行后当前目录会生成config.yaml服务核心配置与.env.dev环境变量只想生成生产环境配置时用just init --non-dev。.env.dev需要设置的参数OPENAI_API_KEYOpenAI API 密钥使用 OpenAI 模型时必填WREN_AI_SERVICE_PORTAI 服务端口默认 5556WREN_UI_PORTWeb 界面端口默认 3000安装 Python 依赖poetry install预期看到 Installing dependencies from lock file 一类的日志自动创建虚拟环境并安装依赖耗时几分钟。启动容器化服务与 AI 服务just up预期 Qdrant 向量数据库存储与检索嵌入向量、Wren Engine数据查询与计算、Ibis Server数据访问接口三个容器全部进入 running 状态首次运行需拉取镜像会稍慢。just start预期看到 Uvicorn running on http://127.0.0.1:5556AI 服务监听 5556 端口Web 界面在 http://localhost:3000 可访问。WrenAI 自然语言查询流程首次连接数据库后索引工作只执行一次此后的每个问题都经过以下流程读取结构从数据库读取表结构与表间关系。建立索引为每个对象生成结构化描述构建向量嵌入并写入 Qdrant。意图分类判断你这次提问的意图。检索表字段从索引中召回相关的表和字段。生成 SQL基于检索到的上下文输出查询语句。执行与解释执行查询返回结果集并用自然语言解释结果。两个常用调整项config.yaml中的table_retrieval_size控制每次检索召回的表数量。just prep datasetspider1.0批量准备 Spider 评估数据集用于效果验证。WrenAI 常见问题速查症状处理启动时报端口被占用把.env.dev里的WREN_AI_SERVICE_PORT或WREN_UI_PORT改成空闲端口依次执行just down和just up重启想切换 LLM 模型如 GPT-4、Claude修改config.yaml中llm部分的model字段确认已配置对应模型的 API Key再执行just start重启服务找不到 API Key 设置位置所有密钥、数据库连接信息与第三方凭证统一存放在.env.dev中.env.dev含 API 密钥等敏感信息不要将该文件提交进代码仓库。WrenAI 停止服务与清理数据cd wren-ai-service just down该命令停止并移除所有相关容器释放系统资源若要彻底清理生成的数据删除数据目录rm -rf tools/dev/etc下一步可以探索docs/ 目录有更多使用文档README.md 是项目总览examples/v5-jaffle/ 是一个可直接参考的示例项目你也可以继续在config.yaml中调整模型与检索参数。【免费下载链接】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），仅供参考