xoai/sage-wiki:README に基づく導入ガイド
README、メタデータ、ライセンスに基づく xoai/sage-wiki の導入と確認ガイドです。
プロジェクトの範囲
xoai/sage-wiki の README はプロジェクトを「sage-wiki is a graph memory and knowledge base that AI agents and humans build and query together. Drop in documents; an LLM compiler turns them into an interlinked wiki with a knowledge graph.」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「sage-wiki」には次の説明があります。sage-wiki is a graph memory and knowledge base that AI agents and humans build and query together. Drop in documents; an LLM compiler turns them into an interlinked wiki with a knowledge graph , agents query it through MCP, humans browse。これは範囲の説明であり、本番検証の結果ではありません。
向いている用途
README の「sage-wiki」にある内容から、用途が合うかを先に判断できます。Built for agents and humans. 19 MCP tools plus generated skill files teach agents when to search, capture, and compile; humans get Obsidian-native markdown, a TUI, and a web UI over the same data.。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。Graph memory with citations. Ask relational questions through wikigraphquery , answers are grounded only in serialized graph edges; with the evidenced graph enabled, each citation carries its source document and confidence.。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。
動作の考え方
動作の説明は「Knowledge graph & graph memory」など複数の箇所に分かれています。確認できる情報は次の通りです。Vector search retrieves passages that look like the query. A graph also records how things relate, so a question needing two or three hops is answered by traversal instead of hoping one chunk happens to contain the whole chain.。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。
インストールと初回起動
初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 # CLI only (no web UI) go install github.com/xoai/sage-wiki/cmd/sage-wiki@latest # With web UI (requires Node.js for building frontend assets) git clone https://github.com/xoai/sage-wiki.git && cd sage-wiki cd web && npm install && npm run build && cd .. go build -tags webui -o sage-wiki ./cmd/sage-wiki/ 実行可能なコマンドがない場合は手順を作らず、「From personal vault to company knowledge graph」で依存関係、待受ポート、初回設定を確認します。