Skip to content

Commit a3f2135

Browse files
chore: update 0.8.0 version (#3004)
1 parent eb5920b commit a3f2135

26 files changed

Lines changed: 550 additions & 17 deletions

File tree

README.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -189,6 +189,36 @@ Then open [http://localhost:5670](http://localhost:5670).
189189
> bash install.sh --profile openai
190190
> ```
191191
192+
### Install via PyPI
193+
194+
Install DB-GPT from PyPI and start it with a single command — no source checkout required.
195+
196+
> **Prerequisites:** Python **3.10+** and [uv](https://docs.astral.sh/uv/getting-started/installation/) (recommended) or pip.
197+
198+
**1. Install**
199+
200+
```bash
201+
# Recommended: use uv
202+
uv pip install dbgpt-app
203+
204+
# Or with pip
205+
pip install dbgpt-app
206+
```
207+
208+
The default installation includes the core framework (CLI, FastAPI, Agent), OpenAI-compatible LLM support, DashScope / Tongyi support, RAG document parsing, and ChromaDB vector store.
209+
210+
**2. Start**
211+
212+
```bash
213+
dbgpt start
214+
```
215+
216+
On first run, an interactive setup wizard will guide you through choosing an LLM provider and entering your API key. Once complete, the web server starts automatically.
217+
218+
**3. Open the Web UI**
219+
220+
Visit [http://localhost:5670](http://localhost:5670) — you're all set! 🎉
221+
192222
### Advanced Installation
193223

194224
![Docker](https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge&logo=docker&logoColor=white)

README.zh.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -180,6 +180,36 @@ cd ~/.dbgpt/DB-GPT && uv run dbgpt start webserver --profile <profile>
180180
> bash install.sh --profile openai
181181
> ```
182182
183+
### 通过 PyPI 安装
184+
185+
从 PyPI 安装 DB-GPT,一条命令即可启动,无需克隆源码仓库。
186+
187+
> **前置条件:** Python **3.10+**,推荐使用 [uv](https://docs.astral.sh/uv/getting-started/installation/) 包管理器,也支持 pip。
188+
189+
**1. 安装**
190+
191+
```bash
192+
# 推荐使用 uv
193+
uv pip install dbgpt-app
194+
195+
# 或使用 pip
196+
pip install dbgpt-app
197+
```
198+
199+
默认安装包含核心框架(CLI、FastAPI、Agent)、OpenAI 兼容 LLM 支持、DashScope / 通义支持、RAG 文档解析和 ChromaDB 向量存储。
200+
201+
**2. 启动**
202+
203+
```bash
204+
dbgpt start
205+
```
206+
207+
首次运行时,交互式向导会引导你选择 LLM 提供商并输入 API Key,配置完成后服务自动启动。
208+
209+
**3. 打开 Web 界面**
210+
211+
访问 [http://localhost:5670](http://localhost:5670) — 开始使用!🎉
212+
183213
![Docker](https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge&logo=docker&logoColor=white)
184214
![Linux](https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black)
185215
![macOS](https://img.shields.io/badge/mac%20os-000000?style=for-the-badge&logo=macos&logoColor=F0F0F0)

assets/schema/dbgpt.sql

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -567,6 +567,19 @@ CREATE TABLE `benchmark_summary` (
567567
PRIMARY KEY (`id`)
568568
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
569569

570+
-- share_links, Store conversation share link tokens
571+
CREATE TABLE `share_links` (
572+
`id` int NOT NULL AUTO_INCREMENT COMMENT 'Primary key',
573+
`token` varchar(64) NOT NULL COMMENT 'Unique random share token',
574+
`conv_uid` varchar(255) NOT NULL COMMENT 'The conversation uid being shared',
575+
`created_by` varchar(255) DEFAULT NULL COMMENT 'User who created the share link',
576+
`gmt_created` TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'Creation time',
577+
PRIMARY KEY (`id`),
578+
UNIQUE KEY `uk_share_token` (`token`),
579+
KEY `ix_share_links_token` (`token`),
580+
KEY `ix_share_links_conv_uid` (`conv_uid`)
581+
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='Conversation share link table';
582+
570583

571584
CREATE
572585
DATABASE IF NOT EXISTS EXAMPLE_1;
Lines changed: 163 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,163 @@
1+
# DB-GPT V0.8.0 — Paradigm Shift: AI + Data Driven Analytics Experience
2+
3+
A paradigm shift from "conversational Q&A" to "task delivery" — from passive answering to autonomous analysis, exploring true Agentic productivity.
4+
5+
## Introduction
6+
7+
DB-GPT V0.8.0 introduces a self-driven AI Data Assistant that autonomously handles the entire analytics pipeline:
8+
9+
🎯 Business Goal → 🧠 Task Decomposition → 🧩 Skill Invocation → 💻 Code Generation (SQL/Python) → 🛡️ Sandbox Execution → 📊 Chart Generation → 📝 Report Delivery
10+
11+
You no longer need to know which table your data lives in, nor write Python scripts for intermediate data cleaning. Simply state your business objective, and the **DB-GPT AI Data Assistant** will take care of everything.
12+
13+
### Key Highlights
14+
15+
- 🌟 **Autonomous Data Analytics** — A brand-new autonomous data analytics experience, orchestrating AI-driven analysis through Skills
16+
- 🤖 **Agent Skills** — Support for Agent Skills, enabling more powerful and flexible agent capabilities
17+
- 📊 **Autonomous SQL Generation** — AI agents can now autonomously write SQL queries for data analysis
18+
- 💻 **Autonomous Code Execution** — AI agents can automatically generate and execute Python code for data analysis tasks
19+
- 🛡️ **Sandbox Environment** — A secure, isolated sandbox environment for executing untrusted code
20+
- 💬 **Conversation Sharing & Replay** — View not only the final polished HTML reports, but also replay the entire reasoning process
21+
- 🚀 **One-Click Setup Script** — A new streamlined installation script to get DB-GPT up and running faster than ever
22+
23+
## Features
24+
25+
### ✨ Agentic Data Analytics Engine
26+
27+
The DB-GPT AI Data Assistant can now autonomously orchestrate an entire execution pipeline around your analysis goals, moving beyond the limitations of traditional single-turn conversations to deliver a brand-new autonomous data analytics experience:
28+
29+
- **Multi-Source Data Integration**: Seamlessly connect to relational databases, CSV/Excel files, data warehouses, knowledge bases, documents, and more.
30+
- **Autonomous Reasoning & Exploration**: For complex problems, the AI Data Assistant automatically analyzes database schemas or data files and plans multi-step execution strategies.
31+
- **Execution Capabilities**: Autonomously generates and executes SQL / Python code.
32+
- **Out-of-the-Box Experience**: A newly designed Welcome Page with rich analysis examples, reducing the learning curve for new users to nearly zero.
33+
34+
#### CSV/Excel Autonomous Data Analysis
35+
36+
Upload local spreadsheet files with one click, and the AI automatically understands the data structure, autonomously performs data cleaning, multi-dimensional calculations, and chart visualization — making routine report processing easier than ever.
37+
38+
<img src="/img/agentic_data/csv_data_analysis.jpg" width="720px" />
39+
40+
#### Intelligent Database Insights & Analysis Reports
41+
42+
Built on the new Agentic architecture, the engine autonomously performs data diagnostics, feature extraction, and multi-dimensional analysis, generating dedicated analysis reports with beautiful charts and deep insights — making data value crystal clear.
43+
44+
<img src="/img/agentic_data/agentic_db_data.jpg" width="720px" />
45+
46+
#### Deep Financial Report Analysis
47+
48+
Purpose-built for financial scenarios, precisely extracting core metrics such as revenue and profit. Automatically performs year-over-year / quarter-over-quarter calculations and trend forecasting, generating professional financial health diagnostic reports with one click.
49+
50+
<img src="/img/skill/financial_report_analysis_skill.jpg" width="720px" />
51+
52+
#### Autonomous SQL Generation & Code Execution
53+
54+
Powered by advanced large language models, the system not only accurately translates natural language into complex SQL queries, but also supports autonomous Python code execution in a secure sandbox — handling even the most demanding computational requirements.
55+
56+
<img src="/img/agentic_data/agentic_sql_query.png" width="720px" />
57+
58+
<img src="/img/agentic_data/agentic_gen_code.png" width="720px" />
59+
60+
### 🤖 Agent Skill Ecosystem
61+
62+
The LLM determines the intelligence baseline, but ecosystem extensibility determines the business ceiling. Different business scenarios require vastly different analysis approaches. V0.8.0 officially introduces the **Agent Skill** system — a new way to codify team expertise into reusable assets:
63+
64+
- 📦 **Custom Skill Packaging**: Encapsulate your unique data cleaning logic, business analysis models, and more into standalone Skills — write once, reuse across the entire team.
65+
- 🔗 **One-Click GitHub Import**: Import high-quality Skills directly from community or enterprise private repositories, breaking down information silos.
66+
- 📊 **Built-in Skills**: Ships with CSV/Excel deep analysis Skill, financial report analysis Skill, Agent Browser Skill, and more. Create business-specific Skills with one click using the Skill Creator.
67+
68+
<img src="/img/skill/skill_list.png" width="720px" />
69+
70+
### 🛡️ Sandbox Secure Execution Environment
71+
72+
Granting AI the power to execute code often comes with system-level risks. To address this, we introduce the isolated **Sandbox**:
73+
74+
- 🛡️ **Isolated Sandbox Execution**: All shell code generated by Agents that hasn't been manually reviewed runs in isolated containers. Supports strict resource threshold limits and execution timeout controls — protecting the host system while balancing agent execution power with enterprise-grade data security.
75+
- ⚙️ **Resource Configuration**: Session-level sandbox resource limits and execution timeout guarantees, making analysis artifacts more reproducible and auditable.
76+
77+
<img src="/img/agentic_data/sanbox_running.png" width="720px" />
78+
79+
### 💬 Collaboration & Product Experience Upgrades
80+
81+
Great tools need to flow smoothly, transforming analysis reports and processes from "personal use" to "team reuse":
82+
83+
- 💬 **Conversation Sharing & Execution Replay**: Generate share links with one click. Your team members can not only view the final polished HTML reports, but also replay every step of the Agent's thinking and reasoning process — making retrospectives and knowledge sharing simpler.
84+
- 📝 **Conversation Task List**: Search historical conversation records at any time, facilitating review and documentation.
85+
- 🔗 **Native App & Agent Modes**: Retains native application, Agent, AWEL, and other capabilities, supporting diverse product enhancements and feature usage.
86+
87+
<img src="/img/agentic_data/agentic_playback.jpg" width="720px" />
88+
89+
### 🚀 One-Click Setup Script
90+
91+
We provide multiple new streamlined installation scripts to get DB-GPT up and running faster.
92+
93+
**Option 1: Install via PyPI**
94+
95+
```bash
96+
# Step 1: Install dbgpt-app
97+
pip install dbgpt-app
98+
99+
# Step 2: Start DB-GPT
100+
dbgpt start
101+
```
102+
103+
**Option 2: Install via Shell Script**
104+
105+
```bash
106+
# Using OpenAI as an example, quickly initialize the environment
107+
curl -fsSL https://raw.githubusercontent.com/eosphoros-ai/DB-GPT/main/scripts/install/install.sh \
108+
| OPENAI_API_KEY=sk-xxx bash -s -- --profile openai
109+
110+
# Start DB-GPT
111+
cd ~/.dbgpt/DB-GPT && uv run dbgpt start webserver --config ~/.dbgpt/configs/<profile>.toml
112+
```
113+
114+
**Option 3: Install from Source (same as previous versions)**
115+
116+
```bash
117+
uv sync --all-packages \
118+
--extra "base" \
119+
--extra "proxy_openai" \
120+
--extra "rag" \
121+
--extra "storage_chromadb" \
122+
--extra "dbgpts"
123+
124+
uv run dbgpt start webserver --config configs/dbgpt-proxy-openai.toml
125+
```
126+
127+
🚀 Open your browser and visit [http://localhost:5670](http://localhost:5670)
128+
129+
For detailed installation instructions, see the [Installation Guide](http://docs.dbgpt.cn/docs/next/installation/).
130+
131+
### 📖 Documentation Overhaul with Multi-Language Support
132+
133+
The official documentation has been completely revamped and now officially supports multiple languages! A fresh UI design, clearer directory structure, and one-click language switching deliver a better reading and development experience.
134+
135+
👉 [Browse the New Documentation](http://docs.dbgpt.cn/docs/next/overview/)
136+
137+
## Other Improvements
138+
139+
- Add MiniMax Provider support ([#2989](https://github.com/eosphoros-ai/DB-GPT/pull/2989))
140+
- Fix React parser handling of vis-thinking blocks ([#2996](https://github.com/eosphoros-ai/DB-GPT/pull/2996))
141+
- README and documentation updates ([#2991](https://github.com/eosphoros-ai/DB-GPT/pull/2991))
142+
143+
## How to Upgrade
144+
145+
[Upgrade to v0.8.0](../upgrade/v0.8.0.md)
146+
147+
## Acknowledgements
148+
149+
### 🎉 New Contributors
150+
151+
V0.8.0 welcomes **2 new contributors**:
152+
153+
- @octo-patch
154+
- @LXW2019124
155+
156+
🔥🔥 Thank you to all our contributors for making this release possible!
157+
158+
@Aries-ckt, @Copilot, @LXW2019124, @chenliang15405, @copilot-swe-agent, @fangyinc and @octo-patch
159+
160+
## Reference
161+
162+
- [Quick Start](http://docs.dbgpt.cn/docs/overview/)
163+
- [Docker Quick Deploy](http://docs.dbgpt.cn/docs/next/installation/docker/)

docs/docs/upgrade/v0.8.0.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
# Upgrade To v0.8.0
2+
3+
## Overview
4+
5+
This guide walks you through upgrading from **v0.7.x** to **v0.8.0**.
6+
7+
- **SQLite users**: No database migration is required.
8+
- **MySQL users**: A database migration is required — see [Upgrade Database](#upgrade-database) below.
9+
10+
## Prepare
11+
12+
### Backup Your Database
13+
14+
:::warning
15+
To prevent data loss, **always back up your database** before performing an upgrade. Choose the backup method that matches your database type (e.g., `mysqldump` for MySQL, file copy for SQLite).
16+
:::
17+
18+
## Upgrade
19+
20+
### Step 1 — Stop DB-GPT Service
21+
22+
Stop the running DB-GPT service using the same method you used to start it.
23+
24+
### Step 2 — Upgrade Database
25+
26+
Execute the following SQL statements against your MySQL database to apply the v0.8.0 schema changes.
27+
28+
:::tip
29+
All upgrade SQL scripts are maintained in the repository under [`assets/schema/upgrade/`](https://github.com/eosphoros-ai/DB-GPT/tree/main/assets/schema/upgrade).
30+
:::
31+
32+
**New Tables**
33+
34+
| Table | Description |
35+
|-------|-------------|
36+
| `share_links` | Stores conversation share-link tokens, enabling users to share conversations via unique URLs. |
37+
38+
```sql
39+
USE dbgpt;
40+
41+
-- share_links: Store conversation share link tokens
42+
CREATE TABLE `share_links` (
43+
`id` int NOT NULL AUTO_INCREMENT COMMENT 'Primary key',
44+
`token` varchar(64) NOT NULL COMMENT 'Unique random share token',
45+
`conv_uid` varchar(255) NOT NULL COMMENT 'The conversation uid being shared',
46+
`created_by` varchar(255) DEFAULT NULL COMMENT 'User who created the share link',
47+
`gmt_created` TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'Creation time',
48+
PRIMARY KEY (`id`),
49+
UNIQUE KEY `uk_share_token` (`token`),
50+
KEY `ix_share_links_token` (`token`),
51+
KEY `ix_share_links_conv_uid` (`conv_uid`)
52+
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='Conversation share link table';
53+
```
54+
55+
### Step 3 — Install Dependencies
56+
57+
Install or update dependencies according to your installation method. If you installed from source using the default setup, run:
58+
59+
```bash
60+
uv sync --all-packages
61+
```
62+
63+
64+
### Step 4 — Start DB-GPT Service
65+
66+
Restart the DB-GPT service using your preferred start method. Verify that the service is running correctly and the new share-link feature is available.

0 commit comments

Comments
 (0)