⚡️ GenBI (Generative BI) queries any database in natural language, generates accurate SQL (Text-to-SQL), charts (Text-to-Chart), and AI-powered business intelligence in seconds.
💡 Use Cases
最适合让非技术用户通过自然语言直接查询和分析多源数据,并快速集成到现有应用中的场景。
业务人员自助分析
Problem: 业务人员需要分析数据但不懂SQL,依赖技术团队写查询导致分析效率低下。
Solution: 业务人员直接用自然语言提问,WrenAI自动生成SQL并返回图表和洞察,实现自助数据分析。
Example: 市场经理问“上个月各渠道的转化率对比如何?”,系统自动生成SQL查询并返回柱状图及趋势分析。
快速构建数据应用
Problem: 开发者需要为内部系统或SaaS产品添加自然语言查询数据的功能,但开发成本高。
Solution: 通过WrenAI的API直接集成文本转SQL和图表生成能力,快速构建智能数据查询功能。
Example: 在CRM系统中集成WrenAI API,让销售团队直接问“本季度Top 10客户是谁?”并实时展示图表。
跨数据库统一查询
Problem: 企业数据分散在多个数据库(如PostgreSQL、BigQuery、MySQL),查询需要分别写SQL且语法不同。
Solution: WrenAI支持多种数据源,通过语义层统一建模,用户用自然语言即可跨库查询。
Example: 用户问“合并销售库和用户库,分析高价值用户的购买行为”,系统自动关联多表并生成跨库查询SQL。
实时数据报告生成
Problem: 制作周期性数据报告需要手动编写SQL、制作图表并撰写分析结论,耗时耗力。
Solution: 输入分析需求,WrenAI一次性生成SQL查询结果、可视化图表和AI撰写的洞察摘要。
Example: 每周运营报告只需输入“生成上周用户活跃度报告”,系统自动输出SQL结果、趋势图和AI总结的关键发现。
📊 Project Info
- Language
- TypeScript
- Stars
- ⭐ 13,897
- Forks
- 1,506
- Today
- +89
- Ranking
- #7
- Collection
- Overall
- Trending Date
- February 4, 2026
🏷️ Topics
5分钟上手 WrenAI
通过本指南,您将在5分钟内使用Docker快速部署WrenAI,并体验用自然语言查询示例数据库的完整流程。
🖥️ OS
⚙️ Runtime
🔧 Tools
📝 Steps
克隆项目并进入目录
获取WrenAI的最新代码
克隆仓库
$ git clone https://github.com/Canner/WrenAI.git进入项目目录
$ cd WrenAI配置环境变量
设置必要的API密钥和配置
复制环境变量模板
$ cp .env.example .env启动WrenAI服务
使用Docker Compose一键启动所有服务
后台启动所有容器
$ docker-compose up -d访问Web界面
打开浏览器访问WrenAI的Web界面
连接示例数据库
使用内置的示例数据源快速体验
体验自然语言查询
用中文或英文提问,查看AI生成的SQL和图表
✅ 验证成功
确认WrenAI已正常运行并能处理自然语言查询
- ✓浏览器能正常访问 http://localhost:3000
- ✓成功登录到管理界面
- ✓能连接示例数据库并看到表结构
- ✓输入自然语言问题后能返回SQL查询和图表
⚡ Quick Tips
🔍 Troubleshooting
❓ 端口3000被占用
→ 修改docker-compose.yml中的端口映射,如将"3000:3000"改为"3001:3000",然后访问http://localhost:3001
❓ Docker容器启动失败
→ 运行'docker-compose logs'查看具体错误,常见原因是内存不足或端口冲突
❓ 无法连接示例数据库
→ 检查容器状态'docker-compose ps',确保所有服务都正常运行。可以尝试'docker-compose down && docker-compose up -d'重启服务
❓ 查询返回错误或无结果
→ 检查.env中的API密钥配置是否正确,或尝试使用更简单的问题如"显示所有产品"
🎯 Next Steps
连接自己的数据库
在Web界面中添加真实的数据源,如PostgreSQL或MySQL
配置语义层
定义业务指标和关联关系,提升查询准确性
探索API集成
查看API文档,将WrenAI集成到自己的应用中
加入社区
访问Discord社区获取帮助和最新动态


