{ "markdown": "
\n\n# \"\" WhoDB\n\n[![MCP Toplist](https://mcptoplist.com/badge/glama%2Fclidey%2Fwhodb.svg)](https://mcptoplist.com/server/glama%2Fclidey%2Fwhodb)\n\n### A lightweight, self-hosted workspace for your databases\n\n[![Release workflow](https://img.shields.io/github/actions/workflow/status/clidey/whodb/release-ce.yml?branch=main)](https://github.com/clidey/whodb/actions/workflows/release-ce.yml)\n[![Release version](https://img.shields.io/github/v/release/clidey/whodb)](https://github.com/clidey/whodb/releases)\n![Release date](https://img.shields.io/github/release-date/clidey/whodb)\n![Total downloads](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/clidey/whodb/main/badges/downloads.json)\n![Docker size](https://img.shields.io/docker/image-size/clidey/whodb/latest)\n\n![Commits per month](https://img.shields.io/github/commit-activity/m/clidey/whodb)\n![Last commit](https://img.shields.io/github/last-commit/clidey/whodb)\n![Contributors](https://img.shields.io/github/contributors/clidey/whodb)\n![Closed issues](https://img.shields.io/github/issues-closed/clidey/whodb)\n![Closed PRs](https://img.shields.io/github/issues-pr-closed/clidey/whodb)\n\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/clidey/whodb/blob/main/LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/clidey/whodb?style=social)](https://github.com/clidey/whodb/stargazers)\n![Go](https://img.shields.io/badge/language-Go-00ADD8?logo=go&logoColor=white)\n![TypeScript](https://img.shields.io/badge/language-TypeScript-3178c6?logo=typescript&logoColor=white)\n\n## Available on\n\n[![Docker](https://img.shields.io/badge/Docker-available-brightgreen)](https://hub.docker.com/r/clidey/whodb)\n[![Windows](https://img.shields.io/badge/Windows-available-brightgreen)](https://apps.microsoft.com/detail/9pftx5bv4ds6)\n[![macOS](https://img.shields.io/badge/macOS-available-brightgreen)](https://apps.apple.com/app/whodb/id6754566536)\n[![Snap](https://img.shields.io/badge/Snap-available-brightgreen)](https://snapcraft.io/whodb)\n[![CLI](https://img.shields.io/badge/CLI-available-brightgreen)](https://github.com/clidey/whodb/blob/main/cli/README.md)\n\n[Quick start](https://github.com/clidey/whodb/blob/main/README.md#quick-start) · [Documentation](https://docs.whodb.com/) · [Live demo](https://demo.whodb.com/) · [Community](https://github.com/clidey/whodb/discussions)\n\n
\n\n

\n \"WhoDB\n

\n\nWhoDB 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.\n\nUse 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.\n\n## Quick start\n\nRun WhoDB with Docker:\n\n```bash\ndocker run --rm -it -p 8080:8080 clidey/whodb\n```\n\nThen open [http://localhost:8080](http://localhost:8080) and enter your database connection details.\n\nWant to look around first? Try the [live demo](https://demo.whodb.com/) or watch the [video walkthrough](https://youtu.be/hnAQcYYzcLo).\n\n## What you can do\n\n- **Browse and edit data** in a spreadsheet-style grid with sorting, filtering, pagination, and inline editing.\n- **Understand a schema visually** with an interactive graph of tables and relationships.\n- **Work through queries in a scratchpad** with multiple cells, autocomplete, history, and results kept alongside each query.\n- **Move data in and out** with imports, exports, and mock-data generation for development and testing.\n- **Ask questions in plain English** using a local or hosted AI provider that you choose.\n- **Work from your terminal** through the WhoDB CLI and its MCP server.\n\n\n\n\n\n\n\n\n\n\n
\n \"Browsing\n\n \"Exploring\n
Browse, filter, and edit dataFollow relationships through the schema graph
\n\n### Supported databases\n\nWhoDB Community supports:\n\n- PostgreSQL, CockroachDB, YugabyteDB, and QuestDB\n- MySQL, MariaDB, and TiDB\n- SQLite and DuckDB\n- MongoDB and FerretDB\n- Redis, Valkey, and Dragonfly\n- Elasticsearch and OpenSearch\n- ClickHouse and Memcached\n\nSupport varies by database because not every system has the same concepts or capabilities. The connection screen shows the options available for each source.\n\n## Installation options\n\n### Docker with persistent sessions\n\nThe 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:\n\n```bash\nopenssl rand -hex 32\n```\n\nThen mount `/data` and reuse that key whenever you start the container:\n\n```bash\ndocker run -it -p 8080:8080 \\\n -v whodb-data:/data \\\n -e WHODB_ENCRYPTION_KEY=your_saved_64_character_hex_key \\\n clidey/whodb\n```\n\nKeep 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.\n\nSee the [documentation](https://docs.whodb.com/) for Docker Compose, connection profiles, SSL, AI providers, and other configuration options.\n\n### Desktop\n\n- [macOS](https://apps.apple.com/app/whodb/id6754566536)\n- [Windows](https://apps.microsoft.com/detail/9pftx5bv4ds6)\n- [Snap](https://snapcraft.io/whodb)\n\n### CLI and MCP server\n\nThe CLI includes an interactive terminal UI and an MCP server for AI tools:\n\n```bash\n# macOS and Linux\ncurl -fsSL https://raw.githubusercontent.com/clidey/whodb/main/cli/install/install.sh | bash\n\n# or install with npm\nnpm install -g @clidey/whodb\n```\n\n\n```bash\nwhodb # open the terminal UI\nwhodb mcp serve # start the MCP server\n```\n\nSee the [CLI guide](https://github.com/clidey/whodb/blob/main/cli/README.md) for connection examples and the full command reference.\n\n## AI providers\n\nYou 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.\n\nOllama 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.\n\n### Optional backend provider configuration\n\nEnvironment 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:\n\n- `WHODB_OPENAI_*` for OpenAI\n- `WHODB_ANTHROPIC_*` for Anthropic\n- `WHODB_OLLAMA_*` for Ollama connection settings\n- `WHODB_LMSTUDIO_*` for LM Studio connection settings\n- `WHODB_AI_GENERIC__*` for OpenAI-compatible providers\n\nSee the [installation guide](https://github.com/clidey/whodb/blob/main/docs/installation.mdx#ai-providers) for the complete environment variable list and the [AI provider guide](https://github.com/clidey/whodb/blob/main/docs/ai/setup-providers.mdx) for setup examples.\n\n## WhoDB Community and WhoDB Platform\n\nThis 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.\n\n**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](https://whodb.com/) or compare plans on the [pricing page](https://whodb.com/pricing/).\n\n## Development\n\nWhoDB has a Go backend and a React/TypeScript frontend. For local development, run them in separate terminals.\n\nRequirements:\n\n- Go\n- Node.js and pnpm\n\nStart the backend:\n\n```bash\ncd core\ngo run ./cmd/whodb\n```\n\nStart the frontend:\n\n```bash\ncd frontend\npnpm install\npnpm start\n```\n\nThe frontend opens at [http://localhost:3000](http://localhost:3000) and talks to the backend on port `8080`. See the [CE build and run guide](https://github.com/clidey/whodb/blob/main/.agents/docs/build-and-run.md) for generation and build commands.\n\n## Contributing\n\nBug reports, feature ideas, documentation improvements, and code contributions are all welcome.\n\n- [Open an issue](https://github.com/clidey/whodb/issues) for a bug or concrete request.\n- [Start a discussion](https://github.com/clidey/whodb/discussions) for questions and ideas.\n- Read [CONTRIBUTING.md](https://github.com/clidey/whodb/blob/main/CONTRIBUTING.md) before sending a pull request.\n\n## More screenshots\n\n
\nSee WhoDB in action\n\n### Query scratchpad\n\n\"Writing\n\n### Add and edit records\n\n\"Adding\n\n### Build filters visually\n\n\"Building\n\n### Export data\n\n\"Exporting\n\n
\n\n## Support\n\n- [Documentation](https://docs.whodb.com/)\n- [GitHub Issues](https://github.com/clidey/whodb/issues)\n- [support@clidey.com](mailto:support@clidey.com)\n\nWhoDB is licensed under the [Apache License 2.0](https://github.com/clidey/whodb/blob/main/LICENSE).\n\n
\n\nIf WhoDB saves you time, consider [giving the project a star](https://github.com/clidey/whodb/stargazers).\n\n
\n", "bytes": 10980, "sha": "af171b5a89df8b35c8cbef7a72c529c00503c8ff23fb3a3bd99fb3236c5fc464", "repo_slug": "clidey/whodb", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/plg_clidey_whodb_whodb_d495deb0/readme" }