clidey/whodb
Where data access meets operational intelligence
4,971 ★233 forksGoUpdated 1d ago
What you need to know
WhoDB is a lightweight, self-hosted workspace for your databases — browse and edit data in a spreadsheet grid, explore schemas visually, run queries in a scratchpad, and ask questions in plain English via optional AI providers; runs in the browser, as a desktop app, or as a terminal CLI with an MCP server.
Install
docker run --rm -it -p 8080:8080 clidey/whodb Desktop: macOS App Store, Windows Microsoft Store, or Snap CLI: curl -fsSL https://raw.githubusercontent.com/clidey/whodb/main/cli/install/install.sh | bash CLI via npm: npm install -g @clidey/whodb-cli
Usage
- •Open http://localhost:8080 and enter your database connection details
- •whodb-cli opens the terminal UI; whodb-cli mcp serve starts the MCP server for AI tools
- •Browse/filter/edit data, follow relationships through the schema graph, work through queries in the scratchpad
- •Open Chat → Add Provider to connect Ollama, OpenAI, Anthropic, or LM Studio and ask questions in plain English
Key features
- ✓Spreadsheet-style data grid with sorting, filtering, pagination, and inline editing
- ✓Interactive schema graph of tables and relationships; query scratchpad with multiple cells, autocomplete, and history
- ✓Imports, exports, and mock-data generation for development and testing
- ✓Plain-English AI Q&A via Ollama, LM Studio, OpenAI, Anthropic, or any OpenAI-compatible provider
- ✓Supports PostgreSQL, CockroachDB, YugabyteDB, QuestDB, MySQL, MariaDB, TiDB, SQLite, DuckDB, MongoDB, FerretDB, Redis, Valkey, Dragonfly, Elasticsearch, OpenSearch, ClickHouse, and Memcached
- ✓CLI with interactive terminal UI and an included MCP server
Best for
A lightweight, self-hosted alternative to heavyweight database clients for exploring and editing multiple databases from one browser or terminal workspace.
Caveats
- ⚠This repo is WhoDB Community (Apache-2.0, free to self-host); WhoDB Platform is the commercial edition with shared projects, SSO, audit logs, pipelines, and reporting
- ⚠Support varies by database since not every system has the same concepts
- ⚠Persistent encrypted login sessions require generating and mounting a WHODB_ENCRYPTION_KEY (changing it invalidates existing sessions)
Platforms: Windows · macOS · Linux · Web (browser)Clients: AI tools via the whodb-cli MCP server
Documentation ↗Reviewed 2026-08-07
Topics
ai-agentdata-catalogdata-governancedata-integrationdata-lineagedata-pipelinedata-platformdatabase-managementer-diagraminternal-toolsmcp-servermodel-context-protocolmysqloraclepostgresqlself-hostedsql-editorsqlservertext-to-sqlvisual-query-builder
- Stars
- 4,971★
- Forks
- 233
- Language
- Go
- License
- Apache-2.0
- Created
- 2024-06-11
- Last push
- 2026-08-06