| 1 | <div align="center"> |
| 2 | |
| 3 | # <img src="https://raw.githubusercontent.com/clidey/whodb/main/docs/logo/logo.svg" width="30px" height="auto" alt="" /> WhoDB |
| 4 | |
| 5 | ### A lightweight, self-hosted workspace for your databases |
| 6 | |
| 7 | [](https://github.com/clidey/whodb/actions/workflows/release-ce.yml) |
| 8 | [](https://github.com/clidey/whodb/releases) |
| 9 |  |
| 10 |  |
| 11 |  |
| 12 | |
| 13 |  |
| 14 |  |
| 15 |  |
| 16 |  |
| 17 |  |
| 18 | |
| 19 | [](https://github.com/clidey/whodb/blob/main/LICENSE) |
| 20 | [](https://github.com/clidey/whodb/stargazers) |
| 21 |  |
| 22 |  |
| 23 | |
| 24 | ## Available on |
| 25 | |
| 26 | [](https://hub.docker.com/r/clidey/whodb) |
| 27 | [](https://apps.microsoft.com/detail/9pftx5bv4ds6) |
| 28 | [](https://apps.apple.com/app/whodb/id6754566536) |
| 29 | [](https://snapcraft.io/whodb) |
| 30 | [](https://github.com/clidey/whodb/blob/main/cli/README.md) |
| 31 | |
| 32 | [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) |
| 33 | |
| 34 | </div> |
| 35 | |
| 36 | <p align="center"> |
| 37 | <img src="https://raw.githubusercontent.com/clidey/whodb/main/docs/images/06-storage-unit-list-with-sidebar.png" alt="WhoDB showing a database table" width="100%" /> |
| 38 | </p> |
| 39 | |
| 40 | 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. |
| 41 | |
| 42 | 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. |
| 43 | |
| 44 | ## Quick start |
| 45 | |
| 46 | Run WhoDB with Docker: |
| 47 | |
| 48 | ```bash |
| 49 | docker run --rm -it -p 8080:8080 clidey/whodb |
| 50 | ``` |
| 51 | |
| 52 | Then open [http://localhost:8080](http://localhost:8080) and enter your database connection details. |
| 53 | |
| 54 | Want to look around first? Try the [live demo](https://demo.whodb.com/) or watch the [video walkthrough](https://youtu.be/hnAQcYYzcLo). |
| 55 | |
| 56 | ## What you can do |
| 57 | |
| 58 | - **Browse and edit data** in a spreadsheet-style grid with sorting, filtering, pagination, and inline editing. |
| 59 | - **Understand a schema visually** with an interactive graph of tables and relationships. |
| 60 | - **Work through queries in a scratchpad** with multiple cells, autocomplete, history, and results kept alongside each query. |
| 61 | - **Move data in and out** with imports, exports, and mock-data generation for development and testing. |
| 62 | - **Ask questions in plain English** using a local or hosted AI provider th |