项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 20277
使用教程
环境要求
- 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 <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···
Agent-Kernel
开源
用LLM驱动微内核架构,快速搭建自适应社会模拟多智能体系统
A MicroKernel Multi-Agents System Framework for Adaptive Social Simulation Powered b···
Agents-Anywhere
开源
手机远程操控本机编码 Agent,任务随时盯随时接管
跨设备的开源Agent工作台
Open-Interface
开源
让大模型直接操控你的电脑,一句话完成复杂操作。
Control Any Computer Using LLMs.
manor-ai
开源
自托管 AI 工作台,自带 Key 跑流程,关键步骤人工把关
Source-available, self-hosted AI agent workspace for small businesses and lean teams···
kitaru
开源
生产环境AI智能体记录回放,快速定位问题并优化
Instill trust in your agent evals.
ollama-mcp-bridge
开源
给本地 Ollama 装上 MCP 工具手,一句话调用外部能力
Extend the Ollama API with dynamic AI tool integration from multiple MCP (Model Cont···
CrewAI-GUI-Qt
开源
拖拽节点,可视化搭建 CrewAI 多智能体工作流
A Node-Based Frontend for CrewAI: Revolutionizing AI Workflow Creation
FlowVision
开源
一键把项目代码变成架构图,还能和 AI 联动
FlowVision,一键分析项目代码 · 自动生成架构流程图 · 可视化编辑 · MCP 实时同步
