dbx README

The project's README from github.com/t8y2/dbx. As one markdown file: README.md.

90+ databases in 20 MB. Desktop, Docker, CLI, built-in AI assistant, and MCP Server.

DBX screenshot

Join QQ Group Join WeChat Group Join Discord

t8y2%2Fdbx | Trendshift Featured|HelloGitHub DBX - Lightweight open-source database manager built with Rust | Product Hunt

1Panel Partner CNB MCP Toplist

English | 前往中文版本

❤️ Sponsors

RainYun RainYun is a cloud service provider offering cloud servers, physical servers, game hosting, and developer-friendly infrastructure services. Visit RainYun
TrustAsia TrustAsia provides cloud-based code signing service for DBX, enabling trusted software through automated CI/CD builds. Visit TrustAsia
Jalapeño Cloud Jalapeño Cloud is an AI infrastructure and token compute platform, with an exclusive DBX entry offering free credits and top-up bonuses. Visit Jalapeño Cloud
AstraFlow UCloud is the first public cloud provider listed on China's STAR Market, with 28 global regions for cloud hosting, databases, and CDN; its AstraFlow platform offers one-click access to 200+ mainstream LLMs. Visit UCloud
HuaLongAI HuaLongAI is a model API relay built for heavy AI developers, offering 100% official-source Codex and Claude models with transparent token-level billing, enterprise contracts, and invoicing. Visit HuaLongAI
Atlas Cloud Atlas Cloud gives developers one unified API for 400+ AI models across chat, image, video, and audio. Visit Atlas Cloud
Qiniu Cloud Qiniu Cloud provides DBX with object storage, CDN, and other cloud infrastructure resources. Visit Qiniu Cloud

🤝 Partners

1Panel 1Panel is a modern open-source Linux server management panel and lightweight AI management platform, offering an intuitive web interface for one-stop management of AI agents, local LLMs, websites, databases, containers, files, and more. Visit 1Panel
Easysearch Easysearch is an enterprise-grade distributed search engine compatible with Elasticsearch APIs, combining full-text, vector, geospatial search, real-time analytics, and AI capabilities in one platform. Visit Easysearch

Why DBX?

🪶 20 MB, zero runtime bloat

No Java JRE. No Python venv. No bundled Chromium. DBX ships as a single small binary — download, install, connect. DBeaver needs Java; TablePlus is Freemium. DBX runs everywhere with nothing extra.

🤖 AI that lives in your editor

Highlight a table, describe what you want, get SQL back — no copy-paste between tools. Works with Claude, OpenAI, or local models via Ollama. Built-in safety checks review AI-generated SQL before it runs.

🔌 MCP: your databases, AI-ready

DBX speaks the Model Context Protocol. Claude Code, Cursor, Windsurf, and other AI coding agents can query your databases through connections you already set up. One config, everywhere.

🌐 Desktop + Docker + Web

Native app on macOS, Windows, and Linux. Self-host via Docker for team access. Web version for browser-only environments. Same feature set. Same connections.

Features

90+ Databases, One Tool

MySQL, PostgreSQL, SQLite, Cloudflare D1, Redis, MongoDB, DuckDB, ClickHouse, SQL Server, Oracle, Elasticsearch, Easysearch, Meilisearch, Qdrant, Milvus, Weaviate, MariaDB, TiDB, OceanBase, openGauss, GaussDB, KWDB, KingbaseES, Vastbase, GoldenDB, Doris, SelectDB, StarRocks, Manticore Search, Redshift, DM, TDengine, XuguDB, CockroachDB, Access, HighGo, UXDB, Dolt, and more. Agent-based profiles extend DBX to H2, Snowflake, Trino, PrestoSQL, Hive, DB2, Informix, Neo4j, Cassandra, BigQuery, Cloud Spanner, Kylin, SunDB, JDBCX, and custom JDBC connections. New native and agent-driven drivers also cover Databricks, SAP HANA, Teradata, Vertica, Firebird, Exasol, YashanDB, GBase 8a/8s, Databend, RQLite, Turso, InfluxDB, QuestDB, IoTDB, etcd, ZooKeeper, Nacos, Consul KV, IRIS, and more. Message queue admin is also available for Pulsar, Kafka, and RocketMQ. All in a single ~20 MB app. No bundled Chromium.

Query Editor

CodeMirror 6 with SQL syntax highlighting, metadata-aware autocomplete, Cmd+Enter execution, selected SQL execution, SQL formatting, diagnostics, and 9 editor themes. Persistent query history, saved SQL snippets, tab restore, and SQL file execution keep repeat work close at hand.

AI SQL Assistant

Describe what you want in plain language — get SQL back. DBX can explain queries, optimize SQL, fix errors, and run AI-generated SQL through built-in safety checks. Works with Claude, OpenAI, local models, or any OpenAI-compatible endpoint.

Data Grid

Virtual-scrolled table that handles large result sets. Inline editing, SQL preview before save, WHERE / ORDER BY controls, DataGrip-style filters, LIKE / NOT LIKE context filters, sorting, full-text search, pagination, column resize, auto-fit, row numbers, zebra stripes, and full cell details. Export or copy as CSV, JSON, Markdown, XLSX, or INSERT statements.

Schema Tools

Data Operations

Specialized Browsers

Safety & Connectivity

SSH tunnel (key & password) · database and AI proxy settings · auto-reconnect on connection loss · confirmation dialogs for destructive operations · encrypted config export/import · color-coded connections · driver store and optional JDBC plugin

Polished UI

Dark mode with native title bar sync · 9 editor themes

dbx (t8y2/dbx)

Searching Database…

27.1K ·GitHub
这是什么?一款轻量的跨平台数据库客户端,大小约 20 MB,支持 90 多种数据库——包括 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server 等——内置 AI 助手和 MCP 服务器。
它是桌面应用,还是也能在浏览器里用?它在 macOS、Windows 和 Linux 上都是原生桌面应用,另外还有网页版,适合只能用浏览器的环境。你也可以用 Docker 自托管,让团队共享连接,还附带一个 CLI。
怎么把它跑起来?下载一个小小的可执行文件,安装,连接数据库——整个流程就这么多。没有需要配置的运行环境,最终用户也不用做任何构建。
我需要先装 Java 或其他东西吗?不用。它不需要 Java JRE,不需要 Python 虚拟环境,也不捆绑 Chromium——这点和需要 Java 的 DBeaver 不一样。只有从源码构建时才需要 Node 22.13+ 和 pnpm。
和 DBeaver 或 TablePlus 比怎么样?DBeaver 需要 Java,TablePlus 是免费加付费模式,而 DBX 是一个约 20 MB 的单一可执行文件,不需要任何额外依赖就能运行。如果你要从别家换过来,它可以从 DBeaver 或 Navicat 导入连接配置。
AI 功能会把我的查询发送到云端吗?只会发给你自己选择的 AI 提供商——Claude、OpenAI 或任何兼容 OpenAI 的接口。你也可以通过 Ollama 指向本地模型,让所有数据都留在自己电脑上;配置的导出和导入都是加密的。
它能连接哪些数据库?开箱即用支持 90 多种:MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、Oracle、Elasticsearch、MariaDB、TiDB、CockroachDB,以及达梦、OceanBase、人大金仓(KingbaseES)等国产数据库。通过基于 Agent 的连接配置,还能扩展到 Snowflake、Trino、Hive、BigQuery 和自定义 JDBC 连接,并为 Redis 和 MongoDB 提供专用的浏览器界面。
内置的 AI 助手到底能做什么?你用大白话描述想要什么,它就会写出对应的 SQL;它还能解释、优化和修复查询,生成的 SQL 在执行前会经过内置的安全检查。它可以配合 Claude、OpenAI、本地模型或任何兼容 OpenAI 的接口使用。
MCP 服务器是干什么用的?它让 Claude Code、Cursor、Windsurf 这类 AI 编程助手能直接查询你的数据库,并且复用你在 DBX 里已经配置好的连接——一份配置到处可用。
我能直接在表格里编辑数据吗?能导出成哪些格式?可以——数据表格支持直接编辑,保存前会先预览对应的 SQL,另外还有筛选、排序和全文搜索功能。查询结果可以导出或复制为 CSV、JSON、Markdown、XLSX 或 INSERT 语句;还能导入 CSV 和 Excel,把 Parquet/CSV/JSON 文件拖进来就能通过 DuckDB 立即预览;危险操作会先要求确认。
Creator
t8y2
Size
266.3 MB
Stars
27.1K
Age
5mo
Commits · 90 Days