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)

database-management
Searching Database…

27.1K ·GitHub
What is this?A lightweight ~20 MB cross-platform database client covering 90+ databases — MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server and more — with a built-in AI assistant and an MCP server.
Is it a desktop app, or does it run in a browser too?It's a native desktop app on macOS, Windows, and Linux, plus a web version for browser-only environments. You can also self-host it via Docker so a team shares connections, and a CLI is included.
How do I get it running?Download the single small binary, install it, and connect to a database — that's the whole process. There's no runtime to set up and no build step for end users.
Do I need to install Java or anything else first?No. There is no Java JRE, no Python venv, and no bundled Chromium — unlike DBeaver, which requires Java. Node 22.13+ and pnpm are only needed if you build it from source.
How does it compare to DBeaver or TablePlus?DBeaver needs Java and TablePlus is freemium, while DBX is a single ~20 MB binary that runs with nothing extra. If you're switching over, it can import connection profiles from DBeaver or Navicat.
Do the AI features send my queries to the cloud?Only to the AI provider you pick — Claude, OpenAI, or any OpenAI-compatible endpoint. You can point it at local models via Ollama to keep everything on your machine, and config export/import is encrypted.
Which databases can it connect to?90+ out of the box: MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server, Oracle, Elasticsearch, MariaDB, TiDB, CockroachDB, plus Chinese databases like Dameng, OceanBase, and KingbaseES. Agent-based profiles extend it to Snowflake, Trino, Hive, BigQuery, and custom JDBC connections, with specialized browsers for Redis and MongoDB.
What can the built-in AI assistant actually do?Describe what you want in plain language and it writes the SQL; it can also explain, optimize, and fix queries, and generated SQL goes through built-in safety checks before it runs. It works with Claude, OpenAI, local models, or any OpenAI-compatible endpoint.
What is the MCP server for?It lets AI coding agents like Claude Code, Cursor, and Windsurf query your databases directly, reusing the connections you already configured in DBX — one config works everywhere.
Can I edit data inline, and what formats can I export to?Yes — the data grid supports inline editing with an SQL preview before saving, plus filters, sorting, and full-text search. Results export or copy as CSV, JSON, Markdown, XLSX, or INSERT statements; you can import CSV and Excel, drag-and-drop Parquet/CSV/JSON files for instant preview via DuckDB, and destructive operations ask for confirmation.
Creator
t8y2
Size
266.3 MB
Stars
27.1K
Age
5mo
Commits · 90 Days