dbridge

---

A unified database management server that acts as a bridge between client applications and various database engines, providing a consistent interface for database operations and schema exploration.

This project is a server application that tries to serve all the requriments for any UI applications similar to dbeaver that can be as a UI database client.

Table of Contents

• Installation
• Run the Server
• Development
• License

Installation

pip install dbridge

For optional database adapters:

pip install dbridge[mysql]
pip install dbridge[postgres]
pip install dbridge[snowflake]

Run the server

python -m dbridge.server.app

Development

Clone the repo and install dependencies with uv:

uv sync

Run the server:

uv run python -m dbridge.server.app

Run tests:

uv run --group test pytest

Type checking:

uv run --group types mypy src/dbridge tests

DB Connection

A Database connection accepts a custom connection config which depending on the db driver, you are flexible to use any form of config.

Features

• Supported DBs:
  • sqlite
  • duckdb
  • mysql
  • postgres
  • snowflake
• Get databases
• Get Schemas
• Get tables
• Get columns
• Run a sql file with multiple statements

TODOs

• Autocomplete and suggestion
• Edit tables and schemas

UIs

Here is a list of UI clients that are using this server to provide a dbridge user interface.

• dbridge.nvim a neovim plugin
• dbridge.tui a terminal user interface developed with Textual

License

dbridge is distributed under the terms of the MIT license.