Zekra

機能

• 保持／想起 — 高密度ベクトルと多言語 BM25 を RRF で統合し、重要度の調整、再ランキング、1 ホップのエンティティ拡張を組み合わせたハイブリッド検索です。書き込み判断ステップ（ADD／UPDATE／INVALIDATE／NOOP）により、矛盾する事実を重複させずに更新します。ハード削除は行いません。forget はソフト無効化を行い、履歴は引き続き検索できます。
• 複数のブレイン — プロジェクトやチームごとに 1 つの名前空間を用意し、エージェントごとの権限とアクセストークン（cbt_…）をサーバー側で適用します。
• ナレッジグラフ — メモリから抽出したエンティティと型付きリレーションを扱い、トラバース／近傍／パス／オントロジーのクエリと、グラフの「スパイン」を提供します。
• データソース — コネクター（text、markdown、crawler、github、sql、webhook）が外部コンテンツを取得してチャンクに分割し、同じ書き込みパイプラインを通じて保持します。データソースをご覧ください。
• ブレインとのチャット — ブレイン独自の想起／検索／グラフ／保持機能をツールとして使用し、出典と監査可能なトレースを添えて回答するツール呼び出し型エージェントです。
• ナレッジギャップ、シークレット保管庫、アクティビティログ — すべてを管理できるウェブコンソールも備えています。
• 階層 — Redis L1 作業メモリキャッシュ、ホットな Postgres 階層、オブジェクトストアのコールド階層。

クイックスタート

ホスト版

app.zekra.dev で登録し、ブレインを作成してトークンを発行したら、エージェントを接続します。

curl -fsSL https://app.zekra.dev/install.sh | sh     # installs the `zekra` CLI
zekra auth login --token <cbt_…>
zekra mcp:install claude-code                        # or claude-desktop | codex | gemini | cursor

CLI は fadymondy/zekra-cli にあります。

Docker Compose でセルフホスト

要件：Compose v2 対応の Docker と、埋め込みモデルおよび再ランキングモデル用に約 6 GB のディスク容量が必要です。

git clone https://github.com/fadymondy/zekra.git && cd zekra
cp .env.selfhost.example .env.selfhost
# fill in POSTGRES_PASSWORD, AUTH_SECRET, ZEKRA_SECRETS_KEY and MFA_CHALLENGE_SECRET
# (generate each with: openssl rand -hex 32), and your email in ADMIN_EMAILS
docker compose -f docker-compose.selfhost.yml --env-file .env.selfhost up -d --build

http://localhost:3020 を開いて登録します。スタックでは、VectorChord を備えた Postgres 17、ワンショットのスキーマジョブ、Go API、Next.js コンソール、CPU 用 TEI サーバー 2 台（埋め込み用と 再ランキング用）が実行され、初回起動時に各モデルがダウンロードされます。次に Admin → Tokens でトークンを発行し、zekra auth login --url http://localhost:3020 --token cbt_… を実行します。

一般公開する環境では、手前に TLS リバースプロキシを配置し、APP_URL を設定してください。すべての設定については docs/self-hosting.md と DEPLOY.md で説明しています。

MCP ツール

MCP ツールには、memory_retain、memory_recall、memory_get、memory_forget、 memory_share、memory_edit、graph_*、memory_gaps、brain_*（list、grants、tokens、 chat）、secret_*、datasource_* が含まれます。完全なリファレンス：MCP サーバー · コントラクト：contracts/tools.md。

アーキテクチャ

  Claude Code · Codex · Cursor · your agents        web console · mobile · desktop · extension
          │ MCP (Streamable HTTP or stdio)                    │ REST / GraphQL / SSE
          └───────────────────────┬───────────────────────────┘
                 ┌────────────────▼─────────────────────────────────────┐
                 │ Go API (ToGO: plugins on a microkernel)               │
                 │  brain plugin: retain → write-decision (ADD/UPDATE/    │
                 │  INVALIDATE/NOOP) · recall: vectors + BM25 → RRF →    │
                 │  rerank → 1-hop graph · graph · data sources · chat   │
                 └──────┬──────────────────┬─────────────────┬───────────┘
                        │                  │                 │
           ┌────────────▼──────┐   ┌───────▼──────┐   ┌──────▼─────────┐
           │ Postgres + vchord │   │ TEI embed /  │   │ Redis L1 ·     │
           │ BM25 · partman    │   │ rerank       │   │ Cognee (opt.)  │
           └───────────────────┘   └──────────────┘   └────────────────┘

Zekra は、プラグインから構成されたToGOアプリです。

部分	場所	役割
brain	plugins/brain（モジュール github.com/togo-framework/brain）	記憶器官：スキーマ、保持／想起、グラフ、コネクター、チャット、REST
brain-tei	plugins/brain-tei	TEI 経由の埋め込み＋再ランク付け（Qwen3-Embedding-0.6B、bge-reranker-v2-m3）
brain-cognee	plugins/brain-cognee	エンティティ／グラフ抽出エンジン（Cognee）
cache-redis	plugins/cache-redis	L1 キャッシュ
harness	cmd/api、cmd/migrate、internal/、web/	アプリ本体：API サーバー、マイグレーション、React コンソール
zekra-mcp	cmd/zekra-mcp	stdio MCP サーバー — REST API の薄いアダプター
zekractl	cmd/zekractl	運用 CLI：DB の検査、スキーマ／BM25 の適用、BM25 のスモークテスト、グラフのミラーリング

設計：「SPEC.md」 · 決定事項：「contracts/internal/decisions.md」 · デプロイ：「DEPLOY.md」。

ToGO を基盤とする

Zekra は ToGO（GitHub）上に構築されています。ToGO は、Laravel スタイルの CLI を備えた Go + sqlc + Atlas + GraphQL/OpenAPI + Next.js 向けのオープンソース、API ファーストのフレームワークです。カーネルは小規模で、それ以外はすべてプラグインです。Zekra が使用するコンポーネントは次のとおりです。

ToGO のコンポーネント	Zekra での役割
カーネル	設定、フック／イベントバス、プラグインレジストリ、サーバーのブートストラップ
CLI	togo generate（sqlc → gqlgen → Atlas → OpenAPI）、togo serve、togo install
auth	サインイン、JWT セッション、ロール、API トークン。MFA、パスキー、OAuth は auth プラグインファミリーが提供します
db-postgres	brain スキーマの下層で使われる Postgres ドライバー
queue · cache · storage · mail	データ取り込みジョブ、キャッシュ、メディア、トランザクションメール
プラグインモデル	記憶器官そのものが ToGO プラグインとして提供されます：brain、brain-tei、brain-cognee、cache-redis

自分のアプリにも同じ基盤を使いたい場合は、go install github.com/togo-framework/cli@latest && togo new myapp を実行し、ToGO のドキュメントを読んで、プラグインマーケットプレイスをご覧ください。

ケーススタディを読む： Go の MCP サーバー：Zekra が ToGO プラグイン上に構築される仕組み。

ドキュメント

完全なドキュメントは https://zekra.dev/en/docs にあります（ソース：docs/）。

• 概要とクイックスタート
• MCP サーバー：ツールリファレンスとクライアントのセットアップ
• CLI：zekra コマンドと Claude Code プラグイン
• REST API：エンドポイント、エラー、イベント、TypeScript クライアント
• データソース · キャプチャーフック · セキュリティ · セルフホスティング

コントリビューション

バグ報告、ドキュメント、コードのコントリビューションを歓迎します。まず CONTRIBUTING.mdをご覧ください。セットアップ、規約、DCO サインオフについて説明しています。次に good first issueを探してください。 AI コーディングエージェントは、AGENTS.mdから始めてください。

翻訳

Zekra は Hosted Weblate で翻訳されています。ぜひ、あなたの言語への翻訳にご協力ください： https://hosted.weblate.org/projects/zekra/。翻訳の仕組みについては、CONTRIBUTING.mdをご覧ください。

コミュニティ

• Discord：チームやほかのユーザーとチャットできます
• GitHub Discussions：質問、アイデア、作品の紹介
• Issues：バグ報告や機能リクエスト
• セキュリティに関する報告：SECURITY.mdをご覧ください

行動規範を遵守してください。

スポンサー

Zekra は、このアプリ群全体を支えるオープンソースの Go + React フレームワークである**ToGO**を基盤に構築されています。Zekra を支援する最善の方法は、ToGO のスポンサーになることです。すべてのスポンサー支援は、フレームワークとそれを基盤に構築されたアプリに活用されます。

ToGO のスポンサーになる →

ライセンス

Copyright (C) 2026 Fady Mondy. Zekra は、GNU Affero General Public License v3.0（AGPL-3.0-only）の下でライセンスされたフリーソフトウェアです。改変したバージョンをネットワークサービスとして運用する場合、そのソースコードをユーザーに提供する必要があります。サードパーティのコンポーネントには、それぞれのライセンスが適用されます。

商用ライセンスも利用できます： AGPL の義務が適用されないライセンスについては、[email protected]までお問い合わせください。

同じ作者によるその他のオープンソースプロジェクト

• TomatoPHP：Laravel 向けのオープンソース FilamentPHP プラグインを 60 個以上提供
• Laravilt：Inertia を使用して Vue 3 または React 19 で表示する Laravel 管理パネル
• ToGO：プラグインマーケットプレイスを備えた、Go + React アプリ向けの Laravel 風ワークフロー

Fady Mondyが開発しました。