Skip to content

MKY508/QueryGPT

Repository files navigation

QueryGPT

自然语言数据库查询助手 - 用中文问数据,AI 自动生成 SQL

License Python FastAPI Next.js

功能

  • 自然语言查询 - 用中文描述需求,AI 自动生成 SQL 并执行
  • 数据可视化 - 查询结果自动生成图表
  • Python 分析 - 支持 matplotlib/sklearn,说"用 python 画图"即可触发
  • 语义层 - 定义业务术语,AI 自动理解
  • 多用户 - JWT 认证,数据隔离

截图

登录

对话界面

语义层

表关系


本地开发

需要 Python 3.11+、Node.js 18+

git clone https://github.com/MKY508/QueryGPT.git
cd QueryGPT
./start.sh  # Windows 用 start.bat

访问:前端 http://localhost:3000 | API 文档 http://localhost:8000/api/docs

环境变量

后端 apps/api/.env:

DATABASE_URL=sqlite+aiosqlite:///./data/querygpt.db
JWT_SECRET_KEY=your-secret-key
ENCRYPTION_KEY=your-fernet-key

前端 apps/web/.env.local:

NEXT_PUBLIC_API_URL=http://localhost:8000

一键部署

无需本地环境,3 分钟完成:

Step 1: 部署后端

Deploy Backend

  1. 点击按钮,用 GitHub 登录 Render
  2. 点击 "Create New Resources"
  3. 等待部署完成,复制生成的 URL

Step 2: 部署前端

Deploy Frontend

  1. 点击按钮,用 GitHub 登录 Vercel
  2. NEXT_PUBLIC_API_URL 填入 Step 1 的后端 URL
  3. 点击 "Deploy"

Step 3: 开始使用

  1. 访问前端 URL,注册账号
  2. 进入设置页面,添加 AI API Key(OpenAI/Anthropic/DeepSeek)
  3. 开始查询

免费额度: Render 750h/月,Vercel 无限制


技术栈

后端 前端
FastAPI Next.js 15
SQLAlchemy 2.0 React 19
gptme + LiteLLM TypeScript

旧版

v1 是旧版单体架构,已停止维护,仅供参考:v1 分支


许可证

MIT License


觉得有用就给个 Star 吧