DB-GPT

An open-source AI data assistant that connects to your data, writes SQL and code, runs skills in sandboxed environments, and turns analysis into reports, insights, and action.
DB-GPT is also a platform for building AI-native data agents, workflows, and applications with agents, AWEL, RAG, and multi-model support.

GitHub · Releases · Community

Quick start

📜 Shell Quick Start

One-line installer for macOS & Linux — downloads, configures, and sets up DB-GPT automatically.

1

Install DB-GPT

curl -fsSL https://raw.githubusercontent.com/eosphoros-ai/DB-GPT/main/scripts/install/install.sh | bash

2

Start the server

cd ~/.dbgpt/DB-GPT && uv run dbgpt start webserver --profile <profile>

⚡ PIP Quick Start

Install with pip and start in seconds — the fastest way to try DB-GPT on any platform.

1

Install the package

pip install dbgpt-app

🌏Users in China region can use a mirror for faster downloads:

pip install dbgpt-app -i https://pypi.tuna.tsinghua.edu.cn/simple

2

Start DB-GPT

dbgpt start

What is DB-GPT?

DB-GPT is an open-source agentic AI data assistant for the next generation of AI + Data products.

It helps users and teams:

• connect to databases, CSV / Excel files, warehouses, and knowledge bases
• ask questions in natural language and let AI write SQL autonomously
• run Python- and code-driven analysis workflows
• load and execute reusable skills for domain-specific tasks
• generate charts, dashboards, HTML reports, and analysis summaries
• execute tasks safely in sandboxed environments

Why DB-GPT?

🧠

Agentic data analysis

Plan tasks, break work into steps, call tools, and complete analysis workflows end to end.

💻

Autonomous SQL + code execution

Generate SQL and code to query data, clean datasets, compute metrics, and produce outputs.

🗂️

Multi-source data access

Work across structured and unstructured sources, including databases, spreadsheets, documents, and knowledge bases.

🧩

Skills-driven extensibility

Package domain knowledge, analysis methods, and execution workflows into reusable skills.

📈

Reporting and decision support

Produce charts, dashboards, HTML reports, and decision-ready business outputs.

🛡️

Sandboxed execution

Run code and tools in isolated environments for safer, more reliable analysis.

Product workflow

🔍

Explore data

Connect files, databases, and knowledge bases in one workspace.

🪄

Plan and execute

Let AI reason through the task, write SQL and code, and execute step by step.

🧰

Use skills

Load reusable skills for repeatable business analysis workflows.

📄

Generate reports

Produce charts, dashboards, HTML reports, and decision-ready outputs.

Core capabilities

🤖

Agentic Analysis

Task planning, step-by-step execution, tool use, and iterative reasoning.

🧮

SQL + Code Execution

Natural language to SQL, Python-based analysis, metric calculation, and chart generation.

🗃️

Multi-Source Data Access

Relational databases, CSV / Excel, documents, knowledge bases, and mixed-source workflows.

🧠

Skills and Agents

Reusable skills, domain workflows, agent orchestration, and customizable execution flows.

📊

Reporting

Database profiling reports, financial analysis reports, dashboards, summaries, and insights.

🔐

Safe Execution

Sandboxed code execution, controlled tool use, and reproducible outputs and artifacts.

Platform & ecosystem

🔄

AWEL

Agentic workflow orchestration for structured AI + data pipelines.

🤝

Agents

Autonomous task execution with tools, memory, planning, and collaboration.

📚

RAG

Knowledge-enhanced reasoning across documents, graphs, and private knowledge bases.

⚙️

SMMF

Service-oriented multi-model management for open-source and API-based models.

🎛️

DB-GPT-Hub

Text2SQL and fine-tuning workflows for domain adaptation and model improvement.

🔗

Connections

Connect databases, files, warehouses, and external data systems.

Terminology

Term	Description
DB-GPT	DataBase Generative Pre-trained Transformer — open-source framework around databases and LLMs
Data App	An intelligent data application built on DB-GPT
Text2SQL	Generate SQL from natural language using LLM capabilities
KBQA	Knowledge-Based Q&A system
GBI	Generative Business Intelligence — analysis and decisions through dialogue
LLMOps	End-to-end workflow for training, tuning, deploying, and monitoring LLMs
Embedding	Methods to convert text, audio, video into vectors
RAG	Retrieval Augmented Generation
AWEL	Agentic Workflow Expression Language
AWEL Flow	Workflow orchestration using AWEL
SMMF	Service-oriented Multi-model Management Framework

Community

If you encounter problems, submit an issue, join discussions, or check the releases.