默认监听 8080 端口,启动后需在页面手动填写数据库连接信息;容器重建会丢失加密登录会话,需挂载 /data 并固定 WHODB_ENCRYPTION_KEY;本地 AI 默认连 Ollama localhost:11434 与 LM Studio localhost:1234/v1,Docker 下地址会自动调整,不符时需用环境变量覆盖。
whodb
clideyApache-2.0活跃维护面向数据库的可视化管理平台,支持 ER 图、数据目录与血缘追踪,并通过 MCP 协议让 AI Agent 直接查询和操作多种数据源。
Where data access meets operational intelligence
docker run --rm -it -p 8080:8080 clidey/whodbREADME 未说明显存或 GPU 要求;以 Docker 或桌面应用形式运行,无需本地 GPU。
轻量自托管的多数据库工作台,浏览器里浏览编辑数据、跑查询、看表关系
面向数据库的可视化管理平台,支持 ER 图、数据目录与血缘追踪,并通过 MCP 协议让 AI Agent 直接查询和操作多种数据源。
核心能力
- 表格网格中排序过滤分页并支持行内编辑
- 用交互式关系图直观查看表与表之间的关联
- 多单元格查询草稿本带自动补全与历史记录
- 支持导入导出数据并生成开发用模拟数据
- 可选接入 Ollama、OpenAI、Anthropic 等用自然语言提问
容易踩的坑
- 0.138.0Release 0.138.0最新正式版2026-10-28 · 2026-10-28 01:37 UTC
- Security and fixes
- Guard multipart uploads
- Limit connection probes
- Hide advanced profile values
- DuckDB test fix
- Features and UI
- Add a better 404 page
- Update CLI support and CLI feature fixes
- Update translations
- Tooling and maintenance
- Upgrade to pnpm 12
- Update analytics
- Update dependencies
Installation
Mac App Store
Microsoft Store
Download from the Microsoft Store
Snap Store
sudo snap install whodbDocker
docker pull clidey/whodb:0.138.0 docker pull clidey/whodb:latestDirect Downloads
See assets below for platform-specific packages (DMG, MSIX, etc.).
Documentation
Upgrade Notes
To upgrade from a previous version:
- Docker: Pull the latest image and restart your container
- Snap: Run
sudo snap refresh whodb - Desktop Apps: Download and install the new version
What's Changed
- chore(deps): bump the minor-and-patch group in /frontend with 2 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1386
Full Changelog: https://github.com/clidey/whodb/compare/0.137.0...0.138.0
- Security and fixes
- 0.137.02026-10-28 · 2026-10-28 00:05 UTC
查看更新说明
What's Changed
- chore(deps): bump the minor-and-patch group across 1 directory with 6 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1368
- chore(deps): bump the minor-and-patch group across 1 directory with 3 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1367
- chore(deps): bump oxlint from 1.87.0 to 1.88.0 in /sdk in the minor-and-patch group across 1 directory by @dependabot[bot] in https://github.com/clidey/whodb/pull/1364
- chore(deps): bump the minor-and-patch group in /frontend with 3 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1372
- chore(deps): bump ruff from 0.17.0 to 0.17.1 in /sdk/packages/python in the minor-and-patch group by @dependabot[bot] in https://github.com/clidey/whodb/pull/1371
- chore(deps): bump the minor-and-patch group in /core with 5 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1370
- chore(deps): bump github.com/vektah/gqlparser/v2 from 2.5.62 to 2.5.63 in /cli in the minor-and-patch group by @dependabot[bot] in https://github.com/clidey/whodb/pull/1369
- chore(deps): bump the minor-and-patch group in /frontend with 4 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1373
- chore(deps): bump github.com/labstack/echo/v4 from 4.15.3 to 4.16.1 in /desktop-common by @dependabot[bot] in https://github.com/clidey/whodb/pull/1375
- chore(deps): bump github.com/labstack/echo/v4 from 4.15.3 to 4.16.1 in /desktop-ce by @dependabot[bot] in https://github.com/clidey/whodb/pull/1374
- chore(deps): bump the minor-and-patch group across 1 directory with 6 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1382
- chore(deps): bump the minor-and-patch group with 3 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1381
- chore(deps): bump oxlint from 1.88.0 to 1.89.0 in /sdk in the minor-and-patch group by @dependabot[bot] in https://github.com/clidey/whodb/pull/1379
- chore(deps): bump com.fasterxml.jackson.core:jackson-databind from 2.22.3 to 2.22.4 in /sdk/packages/java in the minor-and-patch group by @dependabot[bot] in https://github.com/clidey/whodb/pull/1378
- chore(deps): bump github.com/wailsapp/wails/v2 from 2.16.0 to 2.17.0 in /desktop-common in the minor-and-patch group by @dependabot[bot] in https://github.com/clidey/whodb/pull/1377
- chore(deps): bump the minor-and-patch group in /core with 4 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1376
Full Changelog: https://github.com/clidey/whodb/compare/0.136.0...0.137.0
- 0.136.0Release 0.136.02026-10-21 · 2026-10-21 10:44 UTC
查看更新说明
- Security fix for MySQL allowAllFiles option (https://github.com/clidey/whodb/security/advisories/GHSA-xpmq-qfwr-f4c6)
- UI contrast fixes
- CLI MCP functionality updates
- Removed old code
- Library updates across backend, frontend, sdk, cli
- Update to how the translation system loads languages
Installation
Mac App Store
Microsoft Store
Download from the Microsoft Store
Snap Store
sudo snap install whodbDocker
docker pull clidey/whodb:0.136.0 docker pull clidey/whodb:latestDirect Downloads
See assets below for platform-specific packages (DMG, MSIX, etc.).
Documentation
Upgrade Notes
To upgrade from a previous version:
- Docker: Pull the latest image and restart your container
- Snap: Run
sudo snap refresh whodb - Desktop Apps: Download and install the new version
What's Changed
- chore(deps): bump the minor-and-patch group across 1 directory with 26 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1341
- chore(deps): bump the minor-and-patch group across 1 directory with 30 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1340
- chore(deps): bump the minor-and-patch group across 1 directory with 2 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1339
- chore(deps): bump the minor-and-patch group across 1 directory with 2 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1337
- chore(deps): bump google.golang.org/grpc from 1.83.1 to 1.83.2 in /desktop-common by @dependabot[bot] in https://github.com/clidey/whodb/pull/1334
- chore(deps): bump google.golang.org/grpc from 1.83.1 to 1.83.2 in /cli by @dependabot[bot] in https://github.com/clidey/whodb/pull/1331
- chore(deps): bump google.golang.org/grpc from 1.83.1 to 1.83.2 in /desktop-ce by @dependabot[bot] in https://github.com/clidey/whodb/pull/1332
- chore(deps): bump ruff from 0.16.9 to 0.16.10 in /sdk/packages/python in the minor-and-patch group across 1 directory by @dependabot[bot] in https://github.com/clidey/whodb/pull/1330
- chore(deps): bump the minor-and-patch group across 1 directory with 10 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1351
- chore(deps): bump the minor-and-patch group across 1 directory with 4 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1350
- chore(deps): bump framer-motion from 12.42.2 to 14.0.0 in /frontend by @dependabot[bot] in https://github.com/clidey/whodb/pull/1349
- chore(deps): bump the minor-and-patch group in /cli with 2 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1346
- chore(deps): bump graphql from 16.11.0 to 17.0.2 in /frontend by @dependabot[bot] in https://github.com/clidey/whodb/pull/1348
- chore(deps): bump github.com/posthog/posthog-go from 1.33.0 to 1.34.0 in /core in the minor-and-patch group by @dependabot[bot] in https://github.com/clidey/whodb/pull/1354
- chore(deps): bump the minor-and-patch group across 1 directory with 6 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1353
- chore(deps): bump the minor-and-patch group across 1 directory with 9 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1355
- chore(deps): bump the minor-and-patch group in /core with 11 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1361
- chore(deps): bump the minor-and-patch group in /frontend with 2 updates by @dependabot[bot] in https://github.com/clidey/whodb/pull/1360
- chore(deps): bump ruff from 0.16.10 to 0.17.0 in /sdk/packages/python in the minor-and-patch group by @dependabot[bot] in https://github.com/clidey/whodb/pull/1359
- chore(deps): bump @types/node from 26.6.4 to
- 0.135.0Release 0.135.02026-10-15 · 2026-10-15 16:20 UTC
查看更新说明
- Security fix for TestSourceConnection bypass (https://github.com/clidey/whodb/security/advisories/GHSA-jcvx-4v4m-p5v9)
- Security fix for DuckDB bypass (https://github.com/clidey/whodb/security/advisories/GHSA-x3h5-pr45-fx4r)
- Update UI to reflect platform
- Update dependencies
- Update CLI MCP functionality
Installation
Mac App Store
Microsoft Store
Download from the Microsoft Store
Snap Store
sudo snap install whodbDocker
docker pull clidey/whodb:0.135.0 docker pull clidey/whodb:latestDirect Downloads
See assets below for platform-specific packages (DMG, MSIX, etc.).
Documentation
Upgrade Notes
To upgrade from a previous version:
- Docker: Pull the latest image and restart your container
- Snap: Run
sudo snap refresh whodb - Desktop Apps: Download and install the new version
What's Changed
- Bump ruff from 0.16.8 to 0.16.9 in /sdk/packages/python by @dependabot[bot] in https://github.com/clidey/whodb/pull/1315
- Bump @types/node from 26.5.0 to 26.6.3 in /sdk by @dependabot[bot] in https://github.com/clidey/whodb/pull/1317
- Bump oxlint from 1.83.0 to 1.86.0 in /sdk by @dependabot[bot] in https://github.com/clidey/whodb/pull/1316
- Bump charm.land/bubbletea/v2 from 2.0.9 to 2.0.10 in /cli by @dependabot[bot] in https://github.com/clidey/whodb/pull/1314
- Bump js-yaml from 5.3.0 to 5.4.1 in /frontend in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/clidey/whodb/pull/1309
- Bump js-yaml from 5.3.0 to 5.4.1 in /dev/translate in the npm_and_yarn group across 1 directory by @dependabot[bot] in https://github.com/clidey/whodb/pull/1308
- Bump com.fasterxml.jackson.core:jackson-databind from 2.22.2 to 2.22.3 in /sdk/packages/java by @dependabot[bot] in https://github.com/clidey/whodb/pull/1307
- Bump github.com/aws/aws-sdk-go-v2/config from 1.32.37 to 1.33.5 in /core by @dependabot[bot] in https://github.com/clidey/whodb/pull/1302
- Bump github.com/aws/aws-sdk-go-v2 from 1.47.0 to 1.47.1 in /core by @dependabot[bot] in https://github.com/clidey/whodb/pull/1319
- Bump github.com/go-sql-driver/mysql from 1.10.0 to 1.10.1 in /cli by @dependabot[bot] in https://github.com/clidey/whodb/pull/1318
- Bump gorm.io/driver/postgres from 1.6.2 to 1.6.3 in /core by @dependabot[bot] in https://github.com/clidey/whodb/pull/1303
- Bump github.com/elastic/go-elasticsearch/v9 from 9.5.0 to 9.5.2 in /core by @dependabot[bot] in https://github.com/clidey/whodb/pull/1296
- Bump go.mongodb.org/mongo-driver/v2 from 2.8.0 to 2.9.1 in /core by @dependabot[bot] in https://github.com/clidey/whodb/pull/1281
- Bump github.com/jackc/pgx/v5 from 5.10.0 to 5.11.0 in /cli by @dependabot[bot] in https://github.com/clidey/whodb/pull/1268
- fix(llm): accept Anthropic endpoints with or without /v1 by @myleansideproject in https://github.com/clidey/whodb/pull/1321
New Contributors
- @myleansideproject made their first contribution in https://github.com/clidey/whodb/pull/1321
Full Changelog: https://github.com/clidey/whodb/compare/0.133.0...0.135.0
- 0.134.0Release 0.134.02026-09-30 · 2026-09-30 14:16 UTC
查看更新说明
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-2mwr-p8j5-rm33
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-pvf2-6h4x-r24j
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-6mr5-wx6p-65fg
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-q89h-vc47-vf4c
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-4r6q-hf67-63p9
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-q79w-r6rg-4w2j
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-whw2-94xc-h8w8
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-4rq3-j4qv-ccm2
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-qx9j-q2j4-g85x
- Fix for https://github.com/clidey/whodb/security/advisories/GHSA-4fv7-x7vj-8jmg
Installation
Mac App Store
Microsoft Store
Download from the Microsoft Store
Snap Store
sudo snap install whodbDocker
docker pull clidey/whodb:0.134.0 docker pull clidey/whodb:latestDirect Downloads
See assets below for platform-specific packages (DMG, MSIX, etc.).
Documentation
Upgrade Notes
To upgrade from a previous version:
- Docker: Pull the latest image and restart your container
- Snap: Run
sudo snap refresh whodb - Desktop Apps: Download and install the new version
Full Changelog: https://github.com/clidey/whodb/compare/0.132.0...0.134.0
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
WhoDB
A lightweight, self-hosted workspace for your databases
Available on
Quick start · Documentation · Live demo · Community
WhoDB gives you one place to explore your databases, edit data, run queries, and understand how a schema fits together. It runs in the browser, is easy to self-host, and is available as a desktop app or terminal CLI too.
Use it when you want to inspect a local database, help a teammate explore unfamiliar data, or work without installing a heavyweight database client. AI features are optional: connect Ollama, OpenAI, Anthropic, LM Studio, or another OpenAI-compatible provider if you want to ask questions in plain English.
Quick start
Run WhoDB with Docker:
docker run --rm -it -p 8080:8080 clidey/whodb
Then open http://localhost:8080 and enter your database connection details.
Want to look around first? Try the live demo or watch the video walkthrough.
What you can do
- Browse and edit data in a spreadsheet-style grid with sorting, filtering, pagination, and inline editing.
- Understand a schema visually with an interactive graph of tables and relationships.
- Work through queries in a scratchpad with multiple cells, autocomplete, history, and results kept alongside each query.
- Move data in and out with imports, exports, and mock-data generation for development and testing.
- Ask questions in plain English using a local or hosted AI provider that you choose.
- Work from your terminal through the WhoDB CLI and its MCP server.
Supported databases
WhoDB Community supports:
- PostgreSQL, CockroachDB, YugabyteDB, and QuestDB
- MySQL, MariaDB, and TiDB
- SQLite and DuckDB
- MongoDB and FerretDB
- Redis, Valkey, and Dragonfly
- Elasticsearch and OpenSearch
- ClickHouse and Memcached
Support varies by database because not every system has the same concepts or capabilities. The connection screen shows the options available for each source.
Installation options
Docker with persistent sessions
The one-line Docker command is ideal for trying WhoDB. To keep encrypted login sessions when the container is replaced, first generate a key and save it somewhere secure:
openssl rand -hex 32
Then mount /data and reuse that key whenever you start the container:
docker run -it -p 8080:8080 \
-v whodb-data:/data \
-e WHODB_ENCRYPTION_KEY=your_saved_64_character_hex_key \
clidey/whodb
Keep that key somewhere safe. Changing it invalidates existing sessions. If WhoDB is served through an HTTPS reverse proxy, also set WHODB_SECURE=true so browsers only send the session cookie over HTTPS.
See the documentation for Docker Compose, connection profiles, SSL, AI providers, and other configuration options.
Desktop
CLI and MCP server
The CLI includes an interactive terminal UI and an MCP server for AI tools:
# macOS and Linux
curl -fsSL https://raw.githubusercontent.com/clidey/whodb/main/cli/install/install.sh | bash
# or install with npm
npm install -g @clidey/whodb
whodb # open the terminal UI
whodb mcp serve # start the MCP server
See the CLI guide for connection examples and the full command reference.
AI providers
You can add a hosted AI provider directly from WhoDB—no backend configuration or restart is required. Open Chat, choose Add Provider from the provider menu, then select OpenAI, Anthropic, or Gemini and enter your API key. WhoDB will fetch the available models from that provider.
Ollama and LM Studio are available as local options in WhoDB Community. By default, the backend looks for Ollama at localhost:11434 and LM Studio at localhost:1234/v1, with local addresses adjusted automatically for Docker and WSL. Use WHODB_OLLAMA_HOST, WHODB_OLLAMA_PORT, or WHODB_LMSTUDIO_BASE_URL only when those defaults are not suitable for your setup.
Optional backend provider configuration
Environment variables let deployment administrators declare providers when the server starts. This is useful for preconfiguring OpenAI or Anthropic, changing provider endpoints, or adding an OpenAI-compatible service for everyone using that deployment:
WHODB_OPENAI_*for OpenAIWHODB_ANTHROPIC_*for AnthropicWHODB_OLLAMA_*for Ollama connection settingsWHODB_LMSTUDIO_*for LM Studio connection settingsWHODB_AI_GENERIC_<ID>_*for OpenAI-compatible providers
See the installation guide for the complete environment variable list and the AI provider guide for setup examples.
WhoDB Community and WhoDB Platform
This repository contains WhoDB Community, the Apache-2.0-licensed database workspace described above. It is free to self-host and is the best place to start if you want to explore and work with databases.
WhoDB Platform is the commercial, self-hosted edition for organizations that need shared projects, more data sources, SSO, fine-grained access controls, audit logs, pipelines, reporting, and internal apps. You can read the WhoDB overview or compare plans on the pricing page.
Development
WhoDB has a Go backend and a React/TypeScript frontend. For local development, run them in separate terminals.
Requirements:
- Go
- Node.js and pnpm
Start the backend:
cd core
go run ./cmd/whodb
Start the frontend:
cd frontend
pnpm install
pnpm start
The frontend opens at http://localhost:3000 and talks to the backend on port 8080. See the CE build and run guide for generation and build commands.
Contributing
Bug reports, feature ideas, documentation improvements, and code contributions are all welcome.
- Open an issue for a bug or concrete request.
- Start a discussion for questions and ideas.
- Read CONTRIBUTING.md before sending a pull request.
More screenshots
Query scratchpad
Add and edit records
Build filters visually
Export data
Support
WhoDB is licensed under the Apache License 2.0.
If WhoDB saves you time, consider giving the project a star.