Datus-agent

终端里用 AI 写 SQL，查数快一步

开源 unknown 行业应用

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1846

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类行业应用

开发团队Datus-ai

所属国家

官网地址https://datus.ai

GitHubhttps://github.com/Datus-ai/Datus-agent

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言Python

技术栈/模型

GitHub 星标★ 1846

30天Star增速

HF 下载量

上线时间2025-07-04 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-12

浏览次数0

项目介绍

Datus-agent 是一个面向现代数据栈的命令行 SQL 客户端，定位为数据工程领域的 AI 原生工具。它把传统 CLI 查询体验与 AI 上下文工程结合起来，让开发者能在终端里直接编写、执行 SQL，并借助大模型理解表结构、生成查询、解释结果。项目解决的核心问题是：数据工程师日常在多个数据库、数据仓库和 BI 工具之间切换，缺乏一个统一、可编程、可被 AI 增强的入口。Datus-agent 通过 CLI 提供轻量交互，同时把 schema、血缘、指标等元数据组织成 AI 可用的上下文，使自然语言转 SQL、查询优化、数据探索更准确。它适合喜欢终端工作流、又希望引入 AI 辅助的数据团队，可作为传统 SQL 客户端与 AI 数据助手之间的桥梁。

Star 增长趋势

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

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Linux x86_64/aarch64（glibc 2.28+）或 Apple Silicon macOS
手动 pip 安装需 Python 3.12+
可访问 GitHub raw 与 PyPI 的网络环境
一个可用的大模型服务，用于 /model 配置

安装与启动步骤

1一键脚本安装

官方推荐方式，在支持的平台直接执行安装脚本，安装完成后需新开一个 shell 才能使用。
```
curl -fsSL https://raw.githubusercontent.com/datus-ai/datus-agent/main/install.sh | sh
```
2手动 pip 安装

不想用脚本时可通过 PyPI 安装，要求 Python 3.12+ 且平台为上方支持的系统。
```
pip install datus-agent
```
3用 uv 加速安装

pip 解析 litellm 依赖时可能回溯数分钟（0.3.9 及以下版本受影响），改用 uv 可秒级完成。
```
pip install uv && uv pip install datus-agent --system
```
4启动 datus

新开 shell 后直接输入 datus 进入交互式 CLI，后续斜杠命令都在此会话内执行。
```
datus
```
5配置大模型

在 datus 交互界面中执行 /model，按提示填写并选择要使用的 LLM 服务。
```
/model
```
6添加数据源

在交互界面执行 /datasource，添加需要查询的数据库或数据仓库连接。
```
/datasource
```
7扫描当前项目

可选步骤，执行 /init 扫描当前项目，为 AI 补充可用的上下文信息。
```
/init
```

关键配置

配置项	必填	说明	示例
`agent.yml`	是	全局主配置文件，存放 Datus-agent 的主要设置	`agent.yml`
`.datus/config.yml`	否	项目级覆盖配置，可指定当前使用的模型与默认数据源	`.datus/config.yml`

如何确认成功

新开 shell 后执行 datus 能进入交互界面，且可正常执行 /model、/datasource 等斜杠命令即表示安装成功。

常见问题

Q：pip install datus-agent 卡住很久怎么办？

A：这是 pip 在 litellm 各版本间回溯依赖（0.3.9 及以下版本受影响）。改用 uv：pip install uv && uv pip install datus-agent --system，几秒即可解析完成。

Q：支持 Windows 吗？

A：README 仅列出 Linux x86_64/aarch64（glibc 2.28+）与 Apple Silicon macOS 两类平台，Windows 未在支持范围内。

Q：配置应该写在哪里？

A：配置分两级：全局 agent.yml 保存主设置，项目内的 .datus/config.yml 用于覆盖，例如指定当前激活的模型和默认数据源。

Q：安装完为什么提示找不到 datus 命令？

A：一键脚本安装后需要新开一个 shell，让 PATH 更新生效，再运行 datus。

注意事项

一键安装脚本执行后必须新开 shell 才能使用 datus 命令。
手动安装要求 Python 3.12+，并运行在 README 列出的受支持平台上。
更多安装方式与完整流程见官方 Quickstart 与端到端教程文档。

核心亮点

CLI 原生体验，适合终端重度用户，无需切换 GUI 工具
把数据库 schema 和元数据作为 AI 上下文，提升自然语言转 SQL 的准确度
Python 实现，便于二次开发和接入现有数据栈

不足之处

项目较新，生态集成和稳定性仍需时间验证
AI 功能依赖外部模型服务，离线或私有化场景需额外配置

适用场景

数据工程师在终端快速探索陌生数据库的表结构和字段含义
分析师用自然语言描述需求，由 AI 生成并执行 SQL 查询
团队把 Datus-agent 接入现有数据平台，作为 AI 辅助查询的统一入口

替代项目

harlequin、sqlglot

上一篇：Agentic-Bug-Hunter

下一篇：dex-trade-agent-kit