Repository avatar
Databases
v0.6.2
active

platypus-db

io.github.platypus-labs/platypus-db

Your PlatypusDB database connections for AI agents, with the access you give each one.

Documentation

PlatypusDB

A fast, small SQL client for people who work with many databases.

Latest release Downloads License: AGPL-3.0-or-later Platforms: Windows, macOS, Linux

English · Italiano

PlatypusDB™ is a desktop SQL client for developers, DBAs and analysts who work with several databases in a day. One small app runs queries, browses and edits data, designs tables, explains slow statements and documents schemas, and keeps production connections clearly apart from the others. A Rust core with a Tauri 2 + React interface: an installer of about 20 MB, a window ready in under a second, and a results grid that scrolls through millions of rows.

A million rows opened from the navigator, scrolled and sorted from the header

Why PlatypusDB

  • Light. A 20 MB installer on Windows and a 30 MB download on Linux, against 122 MB for DBeaver, 346 MB for Beekeeper Studio and about 1 GB for DataGrip; a window in under a second.
  • Safe with production. Connection types color the window frame, risky statements ask first, production opens in manual commit, and every save of edited rows leaves an undo script.
  • Many databases, one app. PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, ClickHouse, SQLite, DuckDB, MongoDB, Redis, Elasticsearch, Cassandra, Snowflake, BigQuery and more, with the same editor and grid.
  • Ready for agents. Claude Code, Codex, Cursor and other MCP clients use your saved connections with the access you give each one, and their changes wait for your OK.
  • Open source. AGPL-3.0, no account, no telemetry.

Install

Download the installer for your system from the releases page: .exe/.msi for Windows, .dmg for macOS, .AppImage/.deb/.rpm for Linux. The app updates itself.

  1. Open PlatypusDB and click New connection, or paste a connection URL (postgres://…, mysql://…, a JDBC URL or an ADO.NET string).
  2. No database at hand? Try the sample database on the welcome screen: a SQLite field survey of platypuses, with linked tables, a view and saved scripts.
  3. Press Ctrl+K for the command palette: every action, connection and table is a few letters away.

Portable copy: put the executable in a folder with an empty data folder beside it. Connections, settings, history and scripts then live in data, and the folder can move to another machine or a USB stick (more).

The user guide goes on from here, task by task: getting started, connecting, queries, safety, troubleshooting.

Databases

PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, ClickHouse, SQLite, DuckDB, libSQL, MongoDB, Redis, Elasticsearch, Cassandra, Snowflake, BigQuery, Databricks, Trino, IBM Db2, ODBC and the databases that speak the PostgreSQL protocol. How each one connects, its oldest supported version and what works on it are in the databases guide.

Features

Write SQLEdit data safely
A JOIN completed from the foreign key, run and drawn as a chartCells changed and a row added, the SQL previewed, then saved
Find slow stepsBrowse the data
Explain analyze with the heatmap and an index suggestionThe data viewer sorted from its header, with the value panel
Design tablesFind anything
Designing a tableThe command palette

Connections over SSH, proxies and cloud sign-in; a SQL editor with completion; a data viewer and editor; charts and notebooks; table design, ER diagrams and schema comparison; query plans; server activity; import, export and transfer; projects and seven languages. Every feature, area by area: docs/user/FEATURES.md. Task by task: the user guide. Keyboard shortcuts: docs/user/SHORTCUTS.md.

Agents (MCP) and the CLI

Claude Code, Codex, Cursor and other MCP clients can use your saved connections, with the access you give each one: none, read only (the default) or read and write. A change an agent wants to run opens a dialog in the app first. Setup, tools, limits and the platypus CLI: docs/user/AGENTS.md.

Performance

PlatypusDB 0.6.0 on Windows 11 (Ryzen 7 9700X, 32 GB):

PlatypusDB 0.6.0
Start, until the window has finished drawing0.7 s (0.8 s the first time)
Memory at rest, the app and its web view170 MB
A million rows from SQLitefirst page in 0.3 s, the rest 0.3 s later; the window never stalls
Windows installer20 MiB

Next to DBeaver on the same machine, both started five times without a connection, DBeaver on a profile already set up:

PlatypusDB 0.6.1DBeaver CE 26.2.3
Start, until the window has finished drawing0.7 s5.2 s
Memory at rest170 MB488 MB

Next to other SQL clients, by the size of their official Linux downloads:

PlatypusDB 0.6.0DBeaver CE 26.2.3DataGrip 2026.2.6TablePlus 2.2.0Beekeeper Studio 6.2.0
RuntimeRust and the system's web viewJava, JRE bundledJava, JetBrains Runtime bundledNative (GTK)Electron
Download30 MiB (.deb)122 MiB1,047 MiB60 MiB346 MiB
On disk68 MiB, plus the system's WebKitGTK206 MiBnot published180 MiB1,105 MiB
LicenseAGPL-3.0Apache 2.0ProprietaryProprietaryGPLv3

How each number is taken, the scale tests and the Linux measurements: docs/dev/BENCHMARKS.md.

Development

Build, test, project layout and the dev databases: docs/dev/DEVELOPMENT.md. What comes next is in docs/dev/ROADMAP.md (in Italian); every document is listed in docs/README.md, and the changes of each release in CHANGELOG.md.

Contributing

Bug reports, ideas and pull requests are welcome: open an issue first for anything larger than a small fix. CONTRIBUTING.md explains how to build, test and submit a change. Everyone taking part follows the Code of Conduct.

Security

Please report vulnerabilities privately, not in a public issue: see SECURITY.md.

License

PlatypusDB is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). You can use, study, change and share it freely; if you distribute it, or run a changed version as a service for others, you must release your source code under the same license. Third-party code and assets keep their own licenses: see THIRD-PARTY-NOTICES.md.

The name and the logo are not part of that license. PlatypusDB™ and the PlatypusDB logo are trademarks of the PlatypusDB maintainers: as AGPL section 7(e) allows, no rights are granted under trademark law, and the logo and icon files listed in NOTICE are © 2026 PlatypusDB maintainers, all rights reserved. You can name the project, link to it and redistribute the official builds unchanged; a fork must ship under its own name and icons. The details are in TRADEMARKS.md.

MCPB
https://github.com/platypus-labs/platypus-db/releases/download/v0.6.2/platypus-db-0.6.2-windows-x64.mcpb
Install Command
# mcpb: https://github.com/platypus-labs/platypus-db/releases/download/v0.6.2/platypus-db-0.6.2-windows-x64.mcpb