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 и ещё более 15 баз данных, например DuckDB, ClickHouse, Redis и Firestore.
Это самостоятельное приложение или библиотека, которую я добавляю в проект?Это самостоятельное десктопное приложение, созданное на Tauri (бэкенд на Rust, фронтенд на React/TypeScript), а не библиотека, которую импортируют в код.
Нужен ли мне API-ключ, чтобы пользоваться функциями ИИ?Нет, преобразование текста в SQL с помощью ИИ необязательно и может работать полностью локально через Ollama без API-ключа; облачные провайдеры, такие как OpenAI, Anthropic или OpenRouter, тоже поддерживаются, если вы предпочитаете их.
Какие базы данных уже поддерживаются, а какие ещё в планах?Встроены только PostgreSQL, MySQL/MariaDB и SQLite; всё остальное, например SQL Server, BigQuery и Snowflake, реализуется плагинами, которые либо уже выпущены, либо заявлены, либо запланированы, либо просто открыты для того, кто захочет их создать.
Куда попадают мои данные подключений и запросов?Всё хранится локально в папке конфигурации на вашем компьютере (а пароли — при желании в системной связке ключей Keychain); эту папку можно перенести, чтобы синхронизировать её через iCloud или Dropbox, но установленные плагины всегда остаются локальными.
Как встроенный MCP-сервер работает с Claude, Cursor и похожими агентами?Tabularis включает MCP-сервер, который позволяет ИИ-агентам читать структуру вашей базы и выполнять запросы прямо из их собственного чата; в разделе Settings > MCP Server Integration настройка для Claude Desktop, Cursor и Windsurf выполняется в один клик, а инструменты называются listtables, describetable и runquery.
Чем Tabularis отличается от DBeaver или TablePlus?Вместо более чем 100 драйверов, как у DBeaver, Tabularis делает ставку на несколько баз данных, но делает их хорошо, и добавляет возможности, которых нет у этих инструментов: SQL-блокноты, где SQL- и Markdown-ячейки работают вместе, встроенный MCP-сервер для ИИ-агентов и систему плагинов, которые можно писать на любом языке через JSON-RPC поверх stdio.
Можно ли написать собственный драйвер базы данных в виде плагина?Да, плагины — это самостоятельные исполняемые файлы, которые обмениваются данными по JSON-RPC 2.0 через stdin/stdout и могут быть написаны на любом языке; руководство разработчика (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