Whodb

WhoDBを使えば、データベースの調査、データの編集、クエリの実行、スキーマの構成の把握を、ひとつの場所で行えます。ブラウザー上で動作し、簡単にセルフホストできるほか、デスクトップアプリやターミナルのCLIとしても利用できます。

ローカルデータベースを確認したいとき、チームメイトが不慣れなデータを調べるのを手伝いたいとき、または高機能なデータベースクライアントをインストールせずに作業したいときに便利です。AI機能は任意です。自然な英語で質問したい場合は、Ollama、OpenAI、Anthropic、LM Studio、またはその他のOpenAI互換プロバイダーに接続できます。

クイックスタート

DockerでWhoDBを実行します。

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

次に、http://localhost:8080を開き、データベースの接続情報を入力します。

まずは試してみたいですか？ライブデモを試すか、動画の手順をご覧ください。

できること

• データの閲覧と編集：並べ替え、フィルタリング、ページネーション、インライン編集に対応したスプレッドシート形式のグリッドで操作できます。
• スキーマを視覚的に把握：テーブルとリレーションシップをインタラクティブなグラフで確認できます。
• スクラッチパッドでクエリを作成：複数のセル、オートコンプリート、履歴に対応し、各クエリの横に結果を保持できます。
• データのインポートとエクスポート：インポート、エクスポート、開発やテスト用のモックデータ生成を利用できます。
• 平易な英語で質問：選択したローカルまたはホスト型の AI プロバイダーを使って質問できます。
• ターミナルから操作：WhoDB CLI とその MCP サーバーを利用できます。

データの閲覧、フィルタリング、編集	スキーマグラフでリレーションシップをたどる

対応データベース

WhoDB Community は以下に対応しています。

• PostgreSQL、CockroachDB、YugabyteDB、QuestDB
• MySQL、MariaDB、TiDB
• SQLite、DuckDB
• MongoDB、FerretDB
• Redis、Valkey、Dragonfly
• Elasticsearch、OpenSearch
• ClickHouse、Memcached

すべてのシステムで概念や機能が同じではないため、データベースによって対応状況は異なります。接続画面には、各データソースで利用できるオプションが表示されます。

インストール方法

セッションを永続化する Docker

WhoDB を試すには、1 行の Docker コマンドが最適です。コンテナーを置き換えても暗号化されたログインセッションを保持するには、まずキーを生成して安全な場所に保存します。

openssl rand -hex 32

次に /data をマウントし、コンテナーを起動するたびに同じキーを使います。

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

このキーは安全な場所に保管してください。キーを変更すると、既存のセッションは無効になります。WhoDB を HTTPS リバースプロキシ経由で配信する場合は、ブラウザーがセッション Cookie を HTTPS 経由でのみ送信するように、WHODB_SECURE=true も設定してください。

Docker Compose、接続プロファイル、SSL、AI プロバイダー、その他の設定オプションについては、ドキュメントをご覧ください。

デスクトップ

• macOS
• Windows
• Snap

CLI と MCP サーバー

CLI にはインタラクティブなターミナル UI と、AI ツール向けの MCP サーバーが含まれています。

# 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

接続例とコマンドの完全なリファレンスについては、CLI ガイドをご覧ください。

AI プロバイダー

バックエンドの設定や再起動を行わずに、WhoDB からホスト型 AI プロバイダーを直接追加できます。Chat を開き、プロバイダーメニューから Add Provider を選択し、OpenAI、Anthropic、Gemini のいずれかを選んで API キーを入力します。WhoDB がそのプロバイダーから利用可能なモデルを取得します。

WhoDB Community では、ローカルの選択肢として Ollama と LM Studio を利用できます。デフォルトでは、バックエンドは Ollama を localhost:11434、LM Studio を localhost:1234/v1 で検索し、Docker と WSL ではローカルアドレスが自動的に調整されます。これらのデフォルト値が環境に適さない場合に限り、WHODB_OLLAMA_HOST、WHODB_OLLAMA_PORT、または WHODB_LMSTUDIO_BASE_URL を使用してください。

オプションのバックエンドプロバイダー設定

環境変数を使うと、デプロイを管理する管理者はサーバーの起動時にプロバイダーを宣言できます。OpenAI や Anthropic を事前設定したり、プロバイダーのエンドポイントを変更したり、そのデプロイを利用する全員のために OpenAI 互換サービスを追加したりする場合に便利です。

• OpenAI 用の WHODB_OPENAI_*
• Anthropic 用の WHODB_ANTHROPIC_*
• Ollama 接続設定用の WHODB_OLLAMA_*
• LM Studio 接続設定用の WHODB_LMSTUDIO_*
• OpenAI 互換プロバイダー用の WHODB_AI_GENERIC_<ID>_*

環境変数の完全な一覧についてはインストールガイドを、設定例についてはAI プロバイダーガイドを参照してください。

WhoDB Community と WhoDB Platform

このリポジトリには、上記で説明した Apache-2.0 ライセンスのデータベースワークスペース、WhoDB Community が含まれています。無料でセルフホストでき、データベースを詳しく調べて操作したい方に最適です。

WhoDB Platform は、共有プロジェクト、より多くのデータソース、SSO、きめ細かなアクセス制御、監査ログ、パイプライン、レポート、社内アプリを必要とする組織向けの商用セルフホスト版です。WhoDB の概要を読むか、料金ページでプランを比較できます。

開発

WhoDB は Go バックエンドと React/TypeScript フロントエンドで構成されています。ローカルで開発する場合は、別々のターミナルで実行してください。

必要なもの：

• Go
• Node.js と pnpm

バックエンドを起動します：

cd core
go run ./cmd/whodb

フロントエンドを起動します：

cd frontend
pnpm install
pnpm start

フロントエンドは http://localhost:3000 で開き、ポート 8080 でバックエンドと通信します。生成コマンドとビルドコマンドについては、CE のビルドと実行ガイドを参照してください。

コントリビューション

バグ報告、機能のアイデア、ドキュメントの改善、コードのコントリビューションを歓迎します。

• バグや具体的な要望については、Issue を作成してください。
• 質問やアイデアについては、ディスカッションを開始してください。
• プルリクエストを送る前に、CONTRIBUTING.mdをお読みください。

その他のスクリーンショット

WhoDB の操作画面を見る

クエリ用スクラッチパッド

レコードの追加と編集

フィルターを視覚的に作成

データのエクスポート

サポート

• ドキュメント
• GitHub Issues
• [email protected]

WhoDB は Apache License 2.0 のもとでライセンスされています。