WhoDB

A lightweight, self-hosted workspace for your databases, with browsing, editing, querying, and AI-powered natural language interactions.

Source repo
clidey/whodb
Stars
★ 5k
Last updated
today
License
Apache-2.0
Primary language
Go

At a glance

How it runs
Self-hosted serviceDesktop appCLI
Works with
Universal · cross-platform
Cost
Free tier plus a paid hosted plan
Setup effort
Low · running in minutes
You'll need
DockerShell / CLINetwork accessLocal filesystem
Typical use
A database administrator quickly inspects a local or remote database's schema and rows without installing a heavy client.
Not a fit if
  • Teams needing SSO, audit logs, and fine-grained access controls
  • Users who want a fully offline setup with no external AI provider
  • Anyone working with very large datasets in the browser data grid

What does this agent do, and when should you use it?

WhoDB is a self-hosted database workspace available as a web app, desktop application, and CLI. It supports a wide range of databases including PostgreSQL, MySQL, SQLite, MongoDB, Redis, and more. Key features include a spreadsheet-style data grid for browsing and editing rows, an interactive schema graph, a multi-cell query scratchpad, import/export and mock data generation. Optional AI integration via providers like Ollama, OpenAI, and Anthropic allows users to ask questions in plain English. WhoDB also offers a CLI and MCP server for terminal-based access and AI tool integration. The community edition is Apache-2.0 licensed, with a commercial WhoDB Platform for organizations.

WhoDB provides an end-to-end workflow for database interaction. Users connect via browser, desktop, or CLI, then browse, filter, sort, and edit rows in a data grid. The schema graph visualizes table relationships. The scratchpad allows writing and executing SQL queries with autocomplete and history. Users can import/export data and generate mock data for development. The chat interface allows connecting to AI providers (OpenAI, Anthropic, Ollama, LM Studio) to ask natural language questions about the data. The backend is Go, frontend is React/TypeScript, and deployment via Docker is supported with environment variables for encryption keys and AI provider configuration.

  1. A database administrator quickly inspects a local or remote database's schema and rows without installing a heavy client.
  2. A developer generates mock data or imports/exports data to assist with development and testing.
  3. A data analyst asks natural language questions and gets query results without writing SQL.
  4. A new team member explores an unfamiliar database through the schema graph to understand relationships.
  5. A sysadmin runs queries and manages databases on a headless server using the CLI or MCP server.
  6. An organization evaluates WhoDB Platform for shared projects, SSO, audit logs, and other enterprise features.

How do you install or deploy this agent?

Run with Docker:

docker run --rm -it -p 8080:8080 clidey/whodb

To persist sessions, first generate an encryption key:

openssl rand -hex 32

Then mount /data and set the environment variable:

docker run -it -p 8080:8080 \
  -v whodb-data:/data \
  -e WHODB_ENCRYPTION_KEY=your_saved_64_character_hex_key \
  clidey/whodb

Alternatively, install the desktop app (macOS/Windows/Snap) or the CLI.

How do you use this agent?

After starting, open http://localhost:8080 in your browser and enter your database connection details. You can browse and edit data in the grid, explore the schema graph, and write queries in the scratchpad. To enable AI, open Chat, click 'Add Provider', and enter an API key for OpenAI/Anthropic, or run local Ollama/LM Studio. For CLI, run whodb-cli to open the terminal UI, or whodb-cli mcp serve to start the MCP server.

What are this agent's strengths and limitations?

Pros
  • Supports a broad range of databases including PostgreSQL, MySQL, SQLite, MongoDB, and Redis, covering common use cases.
  • Visual schema graph and data grid editing lower the barrier to database interaction.
  • Flexible AI integration with multiple providers and no backend configuration required for hosted providers.
  • Multiple deployment options: self-hosted Docker, desktop apps, and CLI, suitable for various environments.
  • MCP server enables integration with AI tools for automation.
Limitations
  • Community edition features may vary per database; advanced features like SSO and audit logs are only in the paid Platform.
  • AI features depend on external providers (Ollama, OpenAI, etc.), requiring network access or local services.
  • The browser-based data grid may struggle with very large datasets.
  • Configuring custom AI providers via environment variables may be intimidating for non-technical users.

How does this agent compare with similar options?

WhoDB can be seen as an alternative to traditional database clients like TablePlus or DBeaver, or internal tool builders like Retool, but with a lighter footprint and a focus on self-hosting and AI integration.

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
WhoDB This agent 51 · Major gaps Self-hosted serviceFreemium ★ 5k today Go —
Tabularis: Open-Source Desktop SQL Workspace 47 · Major gaps Desktop appFree + model costs ★ 5.2k today TypeScript ChatGPT · Codex · Claude Code · Claude.ai
Nocturne Memory: Long-Term Memory Server for MCP Agents 56 · Major gaps MCP serverFree ★ 1.4k 26d ago Python —
WrenAI GenBI 53 · Major gaps CLIFreemium ★ 18k today Python Codex · Claude Code

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
51/ 100 5-point scale 2.6 / 5
This review covers the source as of Aug 11, 2026. The project has shipped 11 stable release(s) since, which have not been re-reviewed. The score and verdict describe the reviewed version only. Recent releases ↓
Trust 11/29
Reliability 8/14
Adaptability 10/18
Convention 10/18
Effectiveness 9/13
Verifiability 3/8
Why each dimension lost points
Trust11 / 29 · 1.9/5

Evidence: README mentions encrypted sessions and WHODB_ENCRYPTION_KEY, indicating some sensitive data handling; CI workflows use step-security/harden-runner to restrict network egress, showing least-privilege awareness; but no user confirmation mechanism, data flow transparency, rollback mechanism, or clear source attribution found. Deductions: missing user confirmation, data flow transparency, rollback, and source attribution evidence.

Reliability8 / 14 · 2.9/5

Evidence: README and CI workflows are consistent, described features align with code structure; dependencies managed via go.mod and package.json, but no dependency availability guarantee; failure messages not clearly documented. Deductions: unclear failure messages, dependency availability unverified.

Adaptability10 / 18 · 2.8/5

Evidence: README clearly identifies target users (database developers, team collaboration) and multiple usage scenarios (local, desktop, CLI); supports many databases with capability boundaries explained; but trigger precision (e.g., AI feature triggers) not detailed; environment fit (Docker, desktop, CLI) documented. Deductions: insufficient trigger precision.

Convention10 / 18 · 2.8/5

Evidence: README well-structured with quick start, installation options, AI provider configuration; install notes detailed; naming stable (WhoDB); examples and FAQ links present; known limitations not explicitly listed; license is Apache-2.0; versioning and changelog not reflected in files; maintenance responsibility has support email and contribution guide. Deductions: missing known limitations and version/changelog.

Effectiveness9 / 13 · 3.5/5

Evidence: High output usability (multiple interfaces and CLI); clear marginal value (one-stop database management); reasonable cost-benefit (open-source free). Deductions: no specific performance or cost data to support.

Verifiability3 / 8 · 1.9/5

Evidence: README claims align with code structure, but no traceable verification methods; cross-source corroboration insufficient (only README and CI); facts and inferences not clearly separated. Deductions: lack of traceability and cross-source verification.

Risks and how to mitigate them
  • Not found in source: rollback or recovery pathBack up first, or work on a git branch or snapshot, so its changes can be undone.
  • No user confirmation mechanism found; confirm before sensitive operations.
  • Data flow transparency insufficient; review network requests and data handling.
  • No rollback mechanism; backup data before operations.
  • Dependency security not fully verified; check for vulnerabilities.
Evidence confidence: Low Reviewed Aug 11, 2026 Reviewed revision ed5b49b71e40 New commits since this review; the score may not cover them
See the full review method →

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. 0.135.0 Release 0.135.0
    Release notes excerpt
    * 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 [Download from the Apple Store](https://apps.apple.com/app/whodb/id6754566536) Microsoft Store [Download from the Microsoft Store](https://apps.microsoft.com/detail/9pftx5bv4ds6) Snap Store ```bash sudo snap install whodb ``` …
    View on GitHub ↗
  2. 0.134.0 Release 0.134.0
    Release notes excerpt
    * 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 …
    View on GitHub ↗
  3. 0.133.0 Release 0.133.0

FAQ

Is the community edition completely free?
Yes, the community edition is licensed under Apache 2.0 and free to self-host. The Platform edition is a commercial product with additional features.
How are sessions secured?
You need to set the WHODB_ENCRYPTION_KEY environment variable and mount /data to persist encrypted sessions. If served through HTTPS, set WHODB_SECURE=true so cookies are only sent over HTTPS.
Do I need extra configuration for AI?
No backend configuration is needed. You can add hosted providers like OpenAI or Anthropic directly from the chat interface. Local Ollama and LM Studio are auto-detected.
Which databases are supported?
PostgreSQL, MySQL, SQLite, MongoDB, Redis, and more. Support level varies by database.
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents