目次

OpenVikingは、AIエージェントの知識、会話から得た記憶、スキルをひとつの仮想ファイルシステムにまとめるオープンソースのコンテキストデータベースだ。保存した内容をviking://のURIで探して読み書きでき、手元のエージェントとつなげて使える。

要点#

  • 知識、ユーザーの記憶、タスクの手順をviking://以下に整理する。
  • ディレクトリ単位の検索や要約で、必要な情報を段階的に読み込める。
  • サーバーはPython 3.10以上とuv、埋め込みモデル、VLMを用意して自分で立てられる。
  • Claude Code、Codex、Cursorなどにはメモリプラグインを導入できる。
  • 認証を設定せずにサーバーを外部公開するのは避ける。

OpenVikingで何ができる?#

OpenVikingでは、プロジェクト資料などをresources、ユーザーの好みや経験をmemories、作業手順をskillsとして管理する。それぞれにURIが付くので、エージェントは保存先をたどり、内容を読んだり検索したりできる。

一般的なベクトル検索のように、情報を登録して検索結果だけを見る仕組みとは違い、ディレクトリを開いて保存内容を確認・編集できるのが特徴だ。セッションをコミットすると、会話をアーカイブし、そこから抽出した記憶をMarkdownとして見直せる。

要約から原文へ進む#

ディレクトリには、内容を段階別に示す要約を持たせられる。L0は一文の概要、L1は構成や用途、L2は原文などの詳しい内容だ。まず概要で関連性を確かめ、必要なファイルだけ開く流れを作れる。

検索も保存先の構造を使う。たとえばプロジェクトやユーザー記憶の特定範囲に絞って探せるため、関係の薄い情報まで含む大きな検索対象を毎回見渡す必要がない。CLIではov lsやov treeで中身を確認し、ov findで意味検索、ov grepで文字列検索を行える。

サーバーを用意する#

自分でサーバーを動かす場合、必要なのはuv、Python 3.10以上、対応するモデルプロバイダーとモデルだ。初期設定ウィザードでモデルを設定し、サーバーを起動する。

setup.sh
uv tool install openviking --upgrade
openviking-server init

ウィザードはVolcengine、OpenAI、Codex OAuth、Kimi、GLM、ローカルのOllamaに対応している。設定は~/.openviking/ov.confに書き込まれ、サーバーはフォアグラウンドで動く。すでにサーバーがある場合は、CLIやエージェントの接続設定に進めばいい。

検索を試す#

サーバーを起動したら、まずリポジトリをリソースとして追加する。登録処理はタスクとして進むので、返されたIDで完了状況を確認してから検索する。

example.sh
ov status
ov add-resource https://github.com/volcengine/OpenViking
ov task status TASK_ID
ov ls viking://resources/
ov find "what is openviking"

TASK_IDは追加時に表示されたIDに置き換える。ov findの結果には、該当するコンテキストのURIが含まれる。必要な情報はそのURIからたどれる。Python、Go、TypeScriptのSDKやHTTP APIを使えば、独自のアプリにも接続できる。

エージェント連携と注意点#

対応エージェントには、メモリプラグインをインストーラーで導入できる。Claude Code、Codex、Cursorなどが対象だ。初回起動後、エージェントに好みを覚えさせ、別のセッションで思い出せるか試す。記憶の処理には時間がかかることがあるため、すぐに検索結果へ出ない場合もある。

セルフホスト版はAGPLv3で提供される。外部から接続するなら認証を設定し、アカウントやユーザー分離、必要に応じたリソースACLも確認したい。ベンチマークでは、OpenViking 0.3.22を使ったLoCoMoやtau2-benchの結果が公開されているが、モデルや評価条件によって結果は変わる。導入先のデータとモデルで確かめよう。

次の一歩#

まずはOpenVikingのGitHubリポジトリで現在のセットアップ手順を確認し、サーバーを立てる環境と使うモデルを決めよう。そのあと小さなリポジトリをひとつ登録して、ov findで探したい情報が見つかるか試す。

出典: https://github.com/volcengine/OpenViking

目次