OpenViking ### OpenViking: AIエージェントのためのコンテキストデータベース [English](README.md) / [中文](README_CN.md) / 日本語 Webサイト · ライブデモ · GitHub · Issues · ドキュメント [![](https://img.shields.io/github/v/release/volcengine/OpenViking?color=369eff\&labelColor=black\&logo=github\&style=flat-square)](https://github.com/volcengine/OpenViking/releases) [![](https://img.shields.io/github/stars/volcengine/OpenViking?labelColor\&style=flat-square\&color=ffcb47)](https://github.com/volcengine/OpenViking) [![](https://img.shields.io/github/issues/volcengine/OpenViking?labelColor=black\&style=flat-square\&color=ff80eb)](https://github.com/volcengine/OpenViking/issues) [![](https://img.shields.io/github/contributors/volcengine/OpenViking?color=c4f042\&labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/graphs/contributors) [![](https://img.shields.io/badge/license-AGPLv3-white?labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/blob/main/LICENSE) [![](https://img.shields.io/github/last-commit/volcengine/OpenViking?color=c4f042\&labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/commits/main) 👋 コミュニティに参加しよう 📱 Larkグループ · WeChat · Discord · X volcengine%2FOpenViking | Trendshift
*** ## OpenVikingとは OpenVikingは、AIエージェントのためのオープンソースのコンテキストデータベースです。メモリ、リソース、スキルを `viking://` プロトコル配下の1つの仮想ファイルシステムとして保存するため、エージェントはブラックボックスのベクトルストアに問い合わせる代わりに、`ls`、`tree`、`find` で自分のコンテキストを閲覧できます。コンテンツは L0（abstract）、L1（overview）、L2（details）の3階層に処理され、必要に応じてロードされます。すべての検索は、観察してデバッグできる軌跡を残します。詳しい紹介はこちら: [Getting started](https://docs.openviking.ai/en/getting-started/01-introduction)。 [![OpenViking Studio playground](docs/images/studio-playground.png)](https://openviking.ai/studio) *[OpenViking Studio](https://openviking.ai/studio) のプレイグラウンド — インストール不要でブラウザから試せるライブデモです。* ## OpenVikingを選ぶ理由 - **すべてのコンテキストを1つのファイルシステムに。** メモリ、リソース、スキルにはそれぞれ `viking://` URI が与えられます。エージェントは、ファイルを扱う開発者のように、コンテキストを決定論的に特定・操作できます。→ [Viking URI](https://docs.openviking.ai/en/concepts/04-viking-uri) · [Context types](https://docs.openviking.ai/en/concepts/02-context-types) - **階層型ローディングで token 消費を削減。** すべてのエントリは書き込み時に L0（abstract）、L1（overview）、L2（details）へ処理され、タスクが必要とする深さまでだけロードされます。→ [Context layers](https://docs.openviking.ai/en/concepts/03-context-layers) - **ディレクトリ再帰検索。** ベクトル検索でまず最高スコアのディレクトリを特定し、そこから層ごとに掘り下げるため、結果は周辺のコンテキストを保ったまま返ってきます。→ [Retrieval](https://docs.openviking.ai/en/concepts/07-retrieval) - **観察可能な検索。** 各クエリはディレクトリ閲覧の軌跡を保存します。結果がおかしいときは、どのパスがその結果を生んだのかを正確に確認できます。→ [Retrieval](https://docs.openviking.ai/en/concepts/07-retrieval) - **セッションはメモリになる。** セッションのコミット後、OpenVikingはユーザーの好みとエージェントの経験を非同期に抽出し、長期メモリとして保存します。→ [Session](https://docs.openviking.ai/en/concepts/08-session) 各要素がどう組み合わさるか: [Architecture](https://docs.openviking.ai/en/concepts/01-architecture)。設計思想: [The Database Paradigm for Context Engineering](https://blog.openviking.ai/post/openviking-context-database/)。 ``` viking:// ├── resources/ # リソース: プロジェクトドキュメント、リポジトリ、Webページなど │ └── my_project/ │ ├── docs/ │ │ ├── api/ │ │ └── tutorials/ │ └── src/ └── user/ └── {user_id}/ ├── memories/ │ └── preferences/ │ ├── writing_style │ └── coding_habits ├── resources/ │ └── private_project/ ├── skills/ │ ├── search_code │ └── analyze_data └── peers/ └── web-visitor-alice/ ``` 3つのローディング階層: - **L0（Abstract）**: 迅速な関連性チェックのための一文の要約。 - **L1（Overview）**: 計画立案のためのコア情報と使用シナリオ。 - **L2（Details）**: 完全なオリジナルデータ。必要な場合にのみ読み込まれます。 各ディレクトリが自身の L0/L1 レイヤーを持つため、ファイル全体を読む前に関連性を判断できます: ``` viking://resources/my_project/ ├── .abstract # L0: 〜100 tokens - 迅速な関連性チェック ├── .overview # L1: 〜2k tokens - 構造とキーポイント └── docs/ ├── .abstract ├── .overview └── api/ ├── auth.md # L2: 完全なコンテンツ、オンデマンドでロード └── endpoints.md ``` ## 実証データ OpenViking 0.3.22 は、長い会話でのユーザーメモリ（LoCoMo）と複数ターンのエージェントタスク（tau2-bench）で評価されています。ナレッジベースQAを含む完全な結果と実験設定は[ベンチマークレポート](https://blog.openviking.ai/post/openviking-benchmark-results/)を、再現用スクリプトは [./benchmark](./benchmark) を参照してください。 Benchmark results. LoCoMo accuracy: OpenClaw 24.20% native vs 82.08% with OpenViking; Hermes 33.38% vs 82.86%; Claude Code 57.21% vs 80.32%. tau2-bench task success: Retail 70.94% vs 77.81%; Airline 54.38% vs 66.25%. - **ユーザーメモリ（LoCoMo）**: OpenViking を接続すると、3つのエージェント統合すべてで精度が 80–83% に達します（ネイティブメモリでは 24–57%）。同時に入力 token は 34.3–91.0%、クエリレイテンシは 58.45–66.10% 削減されます。 - **エージェント経験（tau2-bench)**: 経験メモリにより、タスク成功率は同一 LLM（メモリなし）比で Retail +6.87pp、Airline +11.87pp 向上します。 ## クイックスタート > 💡 **まず動くところを見たい方へ**: [OpenViking Studio](https://openviking.ai/studio) をお試しください。コンテキストプレイグラウンド、セマンティック検索、マルチエージェント Hub を備えたライブホスト版インスタンスで、インストールは不要です。 Python 3.10 以上が必要です。 ```bash pip install openviking --upgrade openviking-server init # 対話式ウィザード: プロバイダー、モデル、ov.conf openviking-server doctor # セットアップを検証 openviking-server # 起動 ``` または、サーバーをバックグラウンドで実行します: ```bash nohup openviking-server > /data/log/openviking.log 2>&1 & ``` `init` はプロバイダー設定を対話的に進め、`~/.openviking/ov.conf` を書き出します。Volcengine、OpenAI、Codex OAuth、Kimi、GLM、ローカルの Ollama をサポートし、Ollama についてはランタイムの検出とインストール、ハードウェアに適したモデルの取得も行えます。`doctor` は、サーバーを起動せずに設定ファイル、Python バージョン、プロバイダーへの接続性、ディスク容量をチェックします。 手動で書く `ov.conf` テンプレート、プロバイダーごとの設定例、環境変数、Windows でのセットアップ、CLI/クライアント設定は、[Configuration guide](https://docs.openviking.ai/en/guides/01-configuration) と [Quick start docs](https://docs.openviking.ai/en/getting-started/02-quickstart) にあります。 サーバーが起動したら: ```bash ov status ov add-resource https://github.com/volcengine/OpenViking # --wait ov ls viking://resources/ ov tree viking://resources/volcengine -L 2 # --wait を付けない場合は、セマンティック処理の完了までしばらく待ちます ov find "what is openviking" ov grep "openviking" --uri viking://resources/volcengine/OpenViking/docs/en ``` 既存インデックスの再構築: `ov reindex --mode vectors_only` はベクトルのみ更新します。`--mode semantic_and_vectors` はセマンティック生成物（`.abstract.md`、`.overview.md`）を再生成してからベクトルを更新し、`--mode prune_orphans` はソースファイルが存在しないベクトルレコードを削除します（`--dry-run` でプレビュー可能）。`semantic` や `full` というモードエイリアスはありません。 クライアント設定は `ov config` で対話的に初期化できます。複数のサーバーを運用する場合は `ov config switch` で切り替えます。 Rust CLI は `npm i -g @openviking/cli` でインストールできます。ソースからのビルドは `cargo install --git https://github.com/volcengine/OpenViking ov_cli` を使います — [CLI setup](https://docs.openviking.ai/en/getting-started/05-cli-setup) を参照してください。公式 Docker イメージもあります。[Deployment guide](https://docs.openviking.ai/en/guides/03-deployment) を参照してください。 ## エージェントと組み合わせて使う 統合機能は、OpenViking の recall をエージェントのコンテキストに注入し、セッションメモリを自動的にコミットします: - [Claude Code](https://docs.openviking.ai/en/agent-integrations/02-claude-code) - [Codex](https://docs.openviking.ai/en/agent-integrations/04-codex) - [OpenClaw](https://docs.openviking.ai/en/agent-integrations/03-openclaw) - [Hermes](https://docs.openviking.ai/en/agent-integrations/05-hermes) - [Cursor](https://docs.openviking.ai/en/agent-integrations/12-cursor) - [Trae](https://docs.openviking.ai/en/agent-integrations/13-trae) - [OpenCode](https://docs.openviking.ai/en/agent-integrations/10-opencode) - [pi](https://docs.openviking.ai/en/agent-integrations/11-pi) - [Agent Plugins 1.0](https://docs.openviking.ai/en/agent-integrations/15-agent-plugins) - [MCP クライアント](https://docs.openviking.ai/en/agent-integrations/06-mcp-clients) - [LangChain / LangGraph](https://docs.openviking.ai/en/agent-integrations/07-langchain-langgraph) 各エージェントのセットアップ手順: [Agent integrations overview](https://docs.openviking.ai/en/agent-integrations/01-overview)。 ## OpenViking Helper（Beta） OpenViking Helper はデスクトップコンソールで、現在 macOS と Windows x64 向けの Beta 版として提供しています: - **ローカルエージェント設定の可視化**: OpenViking CLI、Claude Code、Codex、Cursor、Trae、OpenCode を検出し、対応する plugin、MCP、Hook、CLI 統合を設定します。 - **セッショントレースの確認**: Claude Code、Codex、Trae のセッションを解析し、OpenViking の recall、プロンプト注入、MCP 呼び出し、capture、commit の各イベントを表示します。 - **ローカルメモリとスキルの管理**: ローカルの memory / rule ファイルと `SKILL.md` スキルを確認し、OpenViking に同期します。 ダウンロード: - [macOS Apple Silicon (arm64)](https://lf3-cdn-tos.bytegoofy.com/obj/tron-demo/7654844610543360265/420238785/0.0.19/darwin-arm64/openviking-helper-0.0.19-arm64.dmg) - [macOS Intel (x64)](https://lf3-cdn-tos.bytegoofy.com/obj/tron-demo/7654844610543360265/420238785/0.0.19/darwin-x64/openviking-helper-0.0.19-x64.dmg) - [Windows (x64)](https://lf3-cdn-tos.bytegoofy.com/obj/tron-demo/7654844610543360265/420238785/0.0.19/win32-x64/openviking-helper-0.0.19-x64.exe) ## VikingBot VikingBot は、OpenViking 上に構築された AI エージェントフレームワークです: ```bash pip install "openviking[bot]" openviking-server --with-bot ov chat # 別のターミナルで実行 ``` 公式 Docker イメージには VikingBot が同梱されており、サーバーとコンソール UI とともにデフォルトで起動します。詳細: [VikingBot guide](https://docs.openviking.ai/en/guides/17-vikingbot)。 ## 本番環境へのデプロイ 本番環境では、OpenViking をスタンドアロンの HTTP サービスとして実行してください — [Server deployment](https://docs.openviking.ai/en/getting-started/03-quickstart-server) と [Deployment guide](https://docs.openviking.ai/en/guides/03-deployment) を参照してください。 ## 商用版 **オープンソース版が機能制限されることはありません。** 本リポジトリの OpenViking は AGPLv3 で完全にオープンソースです。機能ロックなし、アカウント登録なし、アクティベーションコードなしで、上記の[本番環境へのデプロイ](#本番環境へのデプロイ)に従って自分で本番運用できます。今後もそれは変わりません。 以下の 2 つの版が解決するのは「誰が運用し、どこで動かすか」であって、「使えるかどうか」ではありません。
マネージド SaaS 版

☁️ マネージド SaaS 版

Volcano Engine 上で公式にホスティングされ、構築も運用も不要です。

  • Personal — 個人開発者向け。最大 50 ファイルまで無料トライアル、VikingDB によりローカルハードウェアを超えてスケールします。
  • Enterprise — チーム向けのマルチユーザー管理、権限管理、エンタープライズ SLA とサポート。

オープンソース版のユーザーは移行ツールでそのまま移行できます。

→ Volcano Engine 製品ページ · ドキュメント

中国以外の地域向けグローバルホスティングは BytePlus で提供予定です。

 プライベートデプロイ版

🏢 プライベートデプロイ版

自社環境内で動作し、データは外部に出ません。

  • オンライン — 自社のクラウドアカウント / VPC にデプロイ。BYOC 対応、更新とライセンス取得のため外部接続あり。
  • オフライン — 外部接続のない完全な閉域環境向け。規制産業に対応します。

オープンソース版に加えて分散デプロイと公式サポートを提供し、アクティベーションコードで有効化します。

→ プライベートデプロイのお問い合わせ
> オープンソース版を自分で動かしたいだけですか？問題ありません。誰にも連絡する必要はなく、[クイックスタート](#クイックスタート)へどうぞ。 ## 研究 OpenViking は、VikingMem 論文に記載されたコア機能の一部をオープンソースとして公開しています: > **VikingMem: A Memory Base Management System for Stateful LLM-based Applications** > Jiajie Fu, Junwen Chen, Mengzhao Wang, Aoxiang He, Maojia Sheng, Xiangyu Ke, Yifan Zhu, and Yunjun Gao. > arXiv:2605.29640, 2026. Accepted by VLDB 2026. > 📄 [arXiv で論文を読む](https://arxiv.org/abs/2605.29640) ## パートナープロジェクト OpenViking は、コンテキストデータエコシステムを構築するために他のオープンソースプロジェクトとのコラボレーションを歓迎します。確認済みのパートナーは以下の通りです: - [deer-flow](https://github.com/bytedance/deer-flow) - オープンソースの長時間 SuperAgent フレームワーク - [NoKV](https://github.com/NoKV-Lab/NoKV) - AI ネイティブの分散ファイルシステム - [loopx](https://github.com/huangruiteng/loopx) - 軽量なループエンジニアリング状態カーネル - [Hermes Agent](https://github.com/NousResearch/hermes-agent) - あなたと共に成長するエージェント パートナーリストへの参加に興味がありますか？コミュニティに issue を提出して申請してください。 ## コミュニティとコントリビューション OpenViking はまだ初期段階にあり、作るべきものが数多く残っています。 - **ドキュメント**: [docs.openviking.ai](https://docs.openviking.ai/) · [FAQ](https://docs.openviking.ai/en/faq/faq) - **ブログ**: [blog.openviking.ai](https://blog.openviking.ai/) - **チーム**: [About us](https://docs.openviking.ai/en/about/01-about-us) - **チャット**: 📱 [Larkグループ](https://docs.openviking.ai/en/about/01-about-us#lark-group) · 💬 [WeChat](https://docs.openviking.ai/en/about/01-about-us#wechat-group) · 🎮 [Discord](https://discord.com/invite/eHvx8E9XF3) · 🐦 [X](https://x.com/openvikingai) - **コントリビュート**: バグ修正も新機能も歓迎します — [CONTRIBUTING_JA.md](CONTRIBUTING_JA.md) を参照してください ## セキュリティとプライバシー このプロジェクトはセキュリティを重視しています。 脆弱性の報告方法とサポート対象バージョンについては、[SECURITY.md](SECURITY.md) を参照してください ## ライセンス OpenViking プロジェクトは、コンポーネントごとに異なるライセンスを使用しています: - **メインプロジェクト**: AGPLv3 - 詳細は [LICENSE](./LICENSE) ファイルを参照してください - **crates/ov\_cli**: Apache 2.0 - 詳細は [LICENSE](./crates/LICENSE) を参照してください - **examples**: Apache 2.0 - 詳細は [LICENSE](./examples/LICENSE) を参照してください - **third\_party**: 各サードパーティプロジェクトの元のライセンス