DB-GPT

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

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

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 20033

维护状态活跃

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队eosphoros-ai

所属国家

官网地址http://docs.dbgpt.cn

GitHubhttps://github.com/eosphoros-ai/DB-GPT

定价模式free

价格说明开源项目，MIT许可证，可免费使用和部署。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agents,bgi,database,deepseek,gpt,gpt-4,hacktoberfest,llm,private,rag,security,vicuna

GitHub 星标★ 20033

30天Star增速

HF 下载量

上线时间2023-04-13 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

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

环境要求

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

安装与启动步骤

1一键安装

官方一键脚本会自动完成安装，适用于 macOS 与 Linux，默认克隆到 ~/.dbgpt/DB-GPT。
```
curl -fsSL https://raw.githubusercontent.com/eosphoros-ai/DB-GPT/main/scripts/install/install.sh | bash
```

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改用 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改用 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复用本地仓库

若已自行 clone 过仓库，在仓库根目录执行脚本并用 --repo-dir 指向当前目录，避免重复克隆。
```
OPENAI_API_KEY=sk-xxx 
  bash scripts/install/install.sh --profile openai --repo-dir "$(pwd)" --yes
```
6启动 Web 服务

安装完成后进入安装目录，用生成的配置启动 webserver，profile 换成实际使用的名称。
```
cd ~/.dbgpt/DB-GPT && uv run dbgpt start webserver --profile openai
```
7打开控制台

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

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 ，把换成安装时使用的 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

项目介绍

DB-GPT 是智能体领域的开源项目，由 eosphoros-ai 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（20,033）位列前 3%，在智能体分类的 2,517 个项目里位列前 3%。

近 41 天，它的 GitHub 星标从 19,706 增加到 20,033，净增 327。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，可免费使用和部署。

它主要面向的使用场景是：企业内部数据查询与报表自动化。同类可对比的替代方案包括 Vanna、Text-to-SQL、Databricks SQL Assistant。

上一篇：12-factor-agents

下一篇：LangBot