OpenViking 是一个可自托管的开源上下文数据库,将 Agent 记忆、知识 RAG 和技能统一为可检视的虚拟文件系统,通过 viking:// URI 访问。
项目概览
它把 Agent 记忆从黑盒向量存储变为可检视、可编辑的虚拟文件系统,并提供 ov CLI、Python/Go/TypeScript SDK 与 HTTP API,可为 Claude Code、Codex、Cursor 等编码工具安装跨会话记忆插件。
项目类型
AI Agent · RAG 与知识库
应用场景
知识问答 · 编程开发
部署方式
查看项目说明
License
AGPL-3.0
适合谁
希望检视和编辑 Agent 记忆内容、而非接受黑盒向量存储的开发者和 AI 工程师。
使用 Claude Code、Codex、Cursor 等编码工具并需要跨会话记忆的开发者。
核心能力
openviking 包提供 ov CLI(add-resource、ls、tree、find、grep 等命令),以及 Python、Go、TypeScript SDK 和 HTTP API,供自定义集成使用。
安装器为 Claude Code、Codex、Cursor、TRAE、OpenCode 等工具添加跨会话记忆,并自动检测已安装的工具。
限制与风险
桌面应用为 Beta 版本,仅支持 macOS 和 Windows x64。
插件安装器需要 macOS 或 Linux;Windows 用户需使用桌面应用。
禁止整体改写后重新开源;对实质性代码的翻译需要火山引擎书面授权,采用前需评估许可证条款。
如何开始
先安装 uv 和 Python 3.10+,执行 uv tool install openviking --upgrade && openviking-server init;然后运行 ov add-resource https://github.com/volcengine/OpenViking,再用 ov find "what is openviking" 验证效果。
核验依据
GitHub 项目简介: Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
README: Most agent memory is a black box: text goes in, embeddings come out, and nobody can see what was actually stored. OpenViking organizes context as a virtual filesystem under `vikin…
README: Search a directory, not the whole index.** Scope semantic search to a project or memory subtree instead of scanning a flat vector pool.
README: The `openviking` package includes the `ov` CLI. With the server running, import a repository and search it:
README: Build your own integration with the [Python](sdk/python/README.md), [Go](sdk/go/README.md), or [TypeScript](sdk/typescript/README.md) SDK, or the [HTTP API](https://docs.openvikin…