DB-GPT

用自然语言对话数据库,让数据分析像聊天一样简单。

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 3003 🐛 待处理 505 👀 关注 144
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 20277
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,可免费使用和部署。

项目预览

DB-GPT 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队eosphoros-ai
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,可免费使用和部署。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agents,bgi,database,deepseek,gpt,gpt-4,hacktoberfest,llm,private,rag,security,vicuna
GitHub 星标★ 20277
上线时间2023-04-13 00:00:00
代码更新2026-11-08
仓库体积512.7 MB
本站数据更新2026-11-09
维护状态活跃
收录时间2026-08-09
浏览次数4

项目介绍

DB-GPT 是一个开源的智能体 AI 数据助手,旨在将大语言模型与数据管理、分析场景深度结合,解决传统数据工具交互复杂、门槛高的问题。它提供自然语言转 SQL、数据问答、报表生成、数据库诊断等核心能力,并支持多模型接入(如 Llama、GPT)、私有化部署和插件扩展。项目内置了智能体编排框架,允许用户通过对话方式完成数据查询、分析和可视化,同时强调数据安全与隐私保护,适合企业级 AI+数据产品建设。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 20277

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 8 步

环境要求

  • macOS 或 Linux 系统(一键安装脚本支持)
  • Python 3.10+(PyPI 方式安装前置要求)
  • 已安装 uv(推荐)或 pip
  • 准备一个模型服务的 API Key(OpenAI / Moonshot / MiniMax)

安装与启动步骤

  1. 1一键安装

    官方一键脚本会自动完成安装,适用于 macOS 与 Linux,默认克隆到 ~/.dbgpt/DB-GPT。

    curl -fsSL https://raw.githubusercontent.com/eosphoros-ai/DB-GPT/main/scripts/install/install.sh | bash
  2. 2指定 OpenAI 配置

    在安装命令前注入 OPENAI_API_KEY,并用 --profile openai 指定模型配置。

    curl -fsSL https://raw.githubusercontent.com/eosphoros-ai/DB-GPT/main/scripts/install/install.sh \
      | OPENAI_API_KEY=sk-xxx bash -s -- --profile openai
  3. 3改用 Kimi 2.5

    通过 Moonshot API 使用 Kimi 2.5,替换 API Key 并指定 kimi 配置。

    curl -fsSL https://raw.githubusercontent.com/eosphoros-ai/DB-GPT/main/scripts/install/install.sh \
      | MOONSHOT_API_KEY=sk-xxx bash -s -- --profile kimi
  4. 4改用 MiniMax

    MiniMax 走 OpenAI 兼容接口,注入 MINIMAX_API_KEY 并指定 minimax 配置。

    curl -fsSL https://raw.githubusercontent.com/eosphoros-ai/DB-GPT/main/scripts/install/install.sh \
      | MINIMAX_API_KEY=sk-xxx bash -s -- --profile minimax
  5. 5复用本地仓库

    若已自行 clone 过仓库,在仓库根目录执行脚本并用 --repo-dir 指向当前目录,避免重复克隆。

    OPENAI_API_KEY=sk-xxx \
      bash scripts/install/install.sh --profile openai --repo-dir "$(pwd)" --yes
  6. 6启动 Web 服务

    安装完成后进入安装目录,用生成的配置启动 webserver,profile 换成实际使用的名称。

    cd ~/.dbgpt/DB-GPT && uv run dbgpt start webserver --profile openai
  7. 7打开控制台

    浏览器访问本机 5670 端口,即可进入 DB-GPT 对话式数据问答界面。

  8. 8先审查脚本(可选)

    不放心直接管道执行时,可先下载脚本查看内容,再本地运行安装。

    curl -fsSL https://raw.githubusercontent.com/eosphoros-ai/DB-GPT/main/scripts/install/install.sh -o install.sh
    less install.sh
    bash install.sh --profile openai

关键配置

配置项必填说明示例
--profile是选择模型配置档,决定使用哪家模型服务openai
OPENAI_API_KEY是使用 openai 配置档时必须提供的大模型密钥sk-xxx
MOONSHOT_API_KEY否使用 kimi 配置档(Moonshot API)时的密钥sk-xxx
MINIMAX_API_KEY否使用 minimax 配置档时的密钥sk-xxx
--repo-dir否指定已存在的本地仓库目录,避免重复克隆$(pwd)

如何确认成功

执行启动命令后无报错,浏览器打开 http://localhost:5670 能看到 DB-GPT 页面即成功。

常见问题

Q:安装完成后不知道如何启动服务?

A:进入安装目录执行 cd ~/.dbgpt/DB-GPT && uv run dbgpt start webserver --profile <profile>,把 <profile> 换成安装时使用的 openai、kimi 或 minimax。

Q:不想使用脚本默认克隆的仓库怎么办?

A:在本地仓库根目录运行 bash scripts/install/install.sh --profile openai --repo-dir "$(pwd)" --yes,让脚本复用已有代码。

Q:Windows 系统能用一键脚本吗?

A:README 中一键安装脚本标注适用于 macOS 和 Linux;Windows 用户请参考官方文档中的 Docker 或源码安装方式。

Q:没有 API Key 能安装吗?

A:安装需要为所选配置档提供对应密钥(如 sk-xxx);也可参考官方文档使用 vLLM、llama.cpp 等本地模型部署。

注意事项

  • 一键安装脚本仅面向 macOS 与 Linux,其他系统请走官方文档的 Docker/源码路径。
  • 安装默认目录为 ~/.dbgpt/DB-GPT,启动命令需在该目录下执行。
  • Web 服务默认访问地址为 http://localhost:5670。
  • PyPI 安装方式前置要求 Python 3.10+ 以及 uv(推荐)或 pip。

核心亮点

  • 支持自然语言直接生成 SQL 并执行查询,大幅降低数据库使用门槛
  • 内置智能体编排与多模型接入,可灵活适配不同业务场景
  • 提供可视化报表和图表生成,让数据洞察更直观

不足之处

  • 文档/社区待观察

适用场景

  • 企业内部数据查询与报表自动化
  • 数据分析师快速探索数据并生成可视化
  • 构建对话式 AI 数据助手产品

替代项目

Vanna、Text-to-SQL、Databricks SQL Assistant

上一篇:12-factor-agents

下一篇:LangBot

同类项目推荐

loopgain 开源

让 Agent 循环该停就停,省 token 还不掉质量

An open-source cost controller for AI agent loops — stops a loop when it's actually···

★ 127 2026-09-12
Agent-Kernel 开源

用LLM驱动微内核架构,快速搭建自适应社会模拟多智能体系统

A MicroKernel Multi-Agents System Framework for Adaptive Social Simulation Powered b···

★ 570 2026-08-09
Agents-Anywhere 开源

手机远程操控本机编码 Agent,任务随时盯随时接管

跨设备的开源Agent工作台

★ 3217 2026-09-16
Open-Interface 开源

让大模型直接操控你的电脑,一句话完成复杂操作。

Control Any Computer Using LLMs.

★ 2734 2026-08-09
manor-ai 开源

自托管 AI 工作台,自带 Key 跑流程,关键步骤人工把关

Source-available, self-hosted AI agent workspace for small businesses and lean teams···

★ 158 2026-09-12
kitaru 开源

生产环境AI智能体记录回放,快速定位问题并优化

Instill trust in your agent evals.

★ 317 2026-08-09
ollama-mcp-bridge 开源

给本地 Ollama 装上 MCP 工具手,一句话调用外部能力

Extend the Ollama API with dynamic AI tool integration from multiple MCP (Model Cont···

★ 105 2026-09-24
CrewAI-GUI-Qt 开源

拖拽节点,可视化搭建 CrewAI 多智能体工作流

A Node-Based Frontend for CrewAI: Revolutionizing AI Workflow Creation

★ 211 2026-08-09
FlowVision 开源

一键把项目代码变成架构图,还能和 AI 联动

FlowVision,一键分析项目代码 · 自动生成架构流程图 · 可视化编辑 · MCP 实时同步

★ 89 2026-08-09