tabularis README

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

tabularis

Tabularis is an open-source desktop SQL workspace for PostgreSQL, MySQL/MariaDB, SQLite and 15+ more databases like DuckDB, ClickHouse, Redis and Firestore.
Its built-in MCP server lets Claude, Cursor and Devin (formerly Windsurf) read your schema and run queries in the same app you already use.

README: English | Italiano | Español | 中文 | Français | Deutsch | 日本語 | Русский | Tagalog | 한국어 | Português (Brasil)

Build & Release Discord Gitster

Vercel OSS Program

Snap Store Flatpak (Flatpark) AUR WinGet

Tabularis

Download

winget install Debba.Tabularis                                   # Windows
brew install --cask tabularis  # macOS
sudo snap install tabularis                                      # Linux

Or grab an installer directly:

Windows macOS (Apple Silicon) macOS (Intel) Linux AppImage Linux .deb Linux .rpm

The app UI is available in English, Italian, Spanish, Chinese (Simplified), French, German, Japanese, Russian, Tagalog and Portuguese (Brazilian).

Discord: Join our Discord server to talk with the maintainers, share feedback, and get help from the community.

Table of Contents

Why tabularis?

tabularis DBeaver CE TablePlus Beekeeper Studio
License Apache 2.0, free Apache 2.0, free (Pro is paid) Commercial GPLv3 (paid editions)
SQL notebooks (SQL + Markdown cells, cross-cell variables, charts) ✅ ❌ ❌ ❌
Built-in MCP server for AI agents ✅ ❌ ❌ ❌
Plugins in any language (JSON-RPC over stdio) ✅ Java/Eclipse plugins JavaScript plugins ❌
AI text-to-SQL with local models (Ollama) ✅ Cloud-based AI assistant ❌ ❌
Visual EXPLAIN with interactive plan graphs ✅ ✅ ❌ ❌
Databases out of the box 3 built-in + 16 official plugins 100+ 20+ ~10

Comparison as of June 2026; features in other tools may have changed since. If you need dozens of drivers, use DBeaver. Tabularis focuses on doing a few databases well.

Database support

PostgreSQL, MySQL/MariaDB and SQLite ship built in. Everything else is a plugin. Current coverage, mirroring the driver & plugin coverage on the website:

ClickHouse (shipped), Cloudflare D1 (shipped), DM / Dameng (shipped), DuckDB (shipped), DynamoDB (shipped), Elasticsearch (shipped), Firestore (shipped), IBM Db2 (shipped), IBM Informix (shipped), MongoDB (shipped), Redis (shipped, in Go and Rust), CSV Folder (shipped), Google Sheets (shipped), HackerNews (shipped), Google BigQuery (claimed), LibSQL / Turso (claimed), Meilisearch (claimed), Oracle (claimed), SQL Server (claimed), Amazon Redshift (scoped), CockroachDB (scoped), TiDB (scoped), Snowflake (coming soon), Cassandra (open), Etcd (open), Firebird (open), ScyllaDB (open), SQL Anywhere (open), SurrealDB (open), Trino / Presto (open).

Shipped drivers are installable from the plugin registry. Everything else is on the bounty board: claim one, sponsor one, or request a database. The SQL Server driver is in active development in its own repository, tabularis-sqlserver-plugin.

Installation

Windows

winget install Debba.Tabularis

Direct Download

Download the installer from the Releases page and run it:

tabularis_x.x.x_x64-setup.exe

Follow the on-screen instructions to complete the installation.

macOS

brew install --cask tabularis

Homebrew

Direct Download

Builds from v0.13.1 onward are signed and notarized by Apple, so they open without any extra steps.

The notes below only apply to older releases (before v0.13.1) downloaded directly:

Linux (Snap)

sudo snap install tabularis

Snap Store

Linux (Flatpak)

flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
flatpak install flatpark dev.tabularis.Tabularis

Flatpak (Flatpark)

Linux (AppImage)

Download the .AppImage file from the Releases page, make it executable and run it:

chmod +x tabularis_x.x.x_amd64.AppImage
./tabularis_x.x.x_amd64.AppImage

Arch Linux (AUR)

yay -S tabularis-bin

Updates

Tabularis checks for updates automatically on startup and notifies you when a new version is available. You can also download the latest version directly from the Releases page.

Discord

Join our Discord server to talk with the maintainers, share feedback, suggest features, or get help from the community.

Changelog

Features

Connection Management

Full reference on tabularis.dev →

Database Explorer

Full reference on tabularis.dev →

SQL Editor

Full reference on tabularis.dev →

SQL Notebooks

Full reference on tabularis.dev →

Keyboard Shortcuts

Full reference on tabularis.dev →

Visual Query Builder

Full reference on tabularis.dev →

Visual EXPLAIN

Full reference on tabularis.dev →

Data Grid

Full reference on tabularis.dev →

Plugin System

Full reference on tabularis.dev →

Tabularis is hackable with an external plugin system. Plugins are standalone executables that communicate with the app over JSON-RPC 2.0 via stdin/stdout, and can be written in any language.

Logging

Configuration Storage

Full reference on tabularis.dev →

Configuration is stored in ~/.config/tabularis/ (Linux), ~/Library/Application Support/tabularis/ (macOS), or %APPDATA%\tabularis\ (Windows): connection profiles, saved queries, app settings (config.json), custom themes, and per-connection editor preferences. You can move this folder from **Settings > Storage** (or with the TABULARIS_DATA_DIR environment variable), for example to an iCloud Drive or Dropbox folder to sync connections across machines; installed plugins always stay local. Tabs and queries are restored when you reopen a connection. The wiki covers the full file layout and every config.json option, including custom AI model overrides.

AI Features (Optional)

Full reference on tabularis.dev →

Optional Text-to-SQL and query explanation powered by OpenAI, Anthropic, MiniMax, OpenRouter, Ollama (local models, no API key, full privacy), and any OpenAI-compatible API (Groq, Perplexity, Azure OpenAI, LocalAI, ...). Model lists are fetched from your provider and cached locally; custom models can be configured per provider.

MCP Server: AI Agent Integration

Full reference on tabularis.dev →

Tabularis includes a built-in MCP (Model Context Protocol) server that lets AI agents read your database schema and execute queries directly from their chat interface.

tabularis --mcp

One-click setup for Claude Desktop, Cursor, and Windsurf: open Settings → MCP Server Integration, click Install Config next to your client, and restart it. Manual configuration is covered in the wiki.

Available tools

Once connected, your AI agent can:

Tool Description
list_connections List all saved database connections
list_databases List all databases available for a connection
list_tables List tables in a connection (with optional schema filter)
describe_table Get full schema: columns, indexes, foreign keys
run_query Execute any SQL query and return results

Example prompts

"Show me all tables in my production database and describe the orders table"

"Write and run a query to find the top 10 customers by total order value this month"

"Check if there are any missing indexes on the users table"

Tech Stack

Development

Setup

pnpm install
pnpm tauri dev

Build

pnpm tauri build

Roadmap

tabularis (TabularisDB/tabularis)

Searching Database…

这是什么?Tabularis 是一款开源的桌面 SQL 工作台,支持 PostgreSQL、MySQL/MariaDB、SQLite,以及 DuckDB、ClickHouse、Redis、Firestore 等 15 种以上的数据库。
这是独立的应用,还是我要加到项目里的库?它是一款独立的桌面应用,基于 Tauri 构建(后端用 Rust,前端用 React/TypeScript),不是可以导入代码中的库。
使用 AI 功能需要 API 密钥吗?不需要。AI 文本转 SQL 是可选功能,可以通过 Ollama 完全在本地运行,无需 API 密钥;如果你更喜欢云端服务,也支持 OpenAI、Anthropic 或 OpenRouter。
到底哪些数据库是内置的,哪些还在计划中?只内置了 PostgreSQL、MySQL/MariaDB 和 SQLite。其他数据库,比如 SQL Server、BigQuery 和 Snowflake,都通过插件提供。这些插件有的已经发布,有的已有人认领,有的已确定范围,还有的仅标记为「开放」,等待有人来开发。
我的连接信息和查询数据存放在哪里?所有数据都保存在你电脑上的一个配置文件夹中(密码可选择保存到系统钥匙串)。你可以把该文件夹移到 iCloud 或 Dropbox 中以实现同步,但已安装的插件始终保存在本地。
内置的 MCP 服务器如何与 Claude、Cursor 等智能体配合使用?Tabularis 内置了一个 MCP 服务器,让 AI 智能体可以在它们自己的聊天界面中读取数据库结构并运行查询。在 Settings > MCP Server Integration 中,可以一键配置 Claude Desktop、Cursor 和 Windsurf,提供的工具包括 listtables、describetable 和 runquery。
Tabularis 与 DBeaver 或 TablePlus 有什么不同?与 DBeaver 那样提供 100 多种驱动不同,Tabularis 专注于少数几种数据库并把它们做好。它还提供了其他工具缺少的功能:可以混合 SQL 与 Markdown 单元格的 SQL 笔记本、供 AI 智能体使用的内置 MCP 服务器,以及一个插件系统,插件可以用任何语言编写,并通过基于 stdio 的 JSON-RPC 通信。
我能否把自己的数据库驱动写成插件?可以。插件是独立的可执行程序,通过 stdin/stdout 使用 JSON-RPC 2.0 通信,可以用任何语言编写。开发者指南(plugins/PLUGINGUIDE.md)说明了如何构建插件。
SQL 笔记本是什么?各个单元格之间如何互动?笔记本将 SQL 和 Markdown 单元格结合在一起,并以内联方式显示结果和图表。你可以使用 {{cellN}} 语法把另一个单元格的结果当作表来引用,运行时会展开为 CTE,此外还支持全局的 @paramName 参数。
What are similar projects?TablePro, dbx, tusk, beekeeper-studio, GoNavi, Chat2DB, chartdb, navop
Size
162 MB
Stars
5.2K
Age
8mo
Commits · 90 Days