OpenViking

项目简介

OpenViking 是面向 AI 智能体的开源上下文数据库，把知识、记忆与技能作为 viking:// 下的虚拟文件系统统一组织起来。智能体可以像浏览文件一样浏览、检索和读取上下文，目录带有生成的摘要并支持分层访问。它可接入常见的智能体框架，并提供基准测试结果，显示长期记忆准确率与 token 效率的提升。

核心功能

• 用一条文件系统统一管理知识、记忆与技能：资源、用户记忆和技能各自拥有 viking:// URI，便于浏览与检索。
• 支持以目录为范围的语义搜索，在项目或记忆子树内执行查询，而不必扫描扁平的向量索引。
• 上下文分为 L0 摘要、L1 概览与 L2 完整详情三层，智能体可以先判断相关性再读取原始内容。
• 会话提交后成为可查看的 Markdown 文件；启用 VikingBot 后，ov compile 可将素材整理为 wiki、知识图谱或报告。
• 已集成 Claude Code、Codex、Cursor、OpenClaw、Hermes、OpenCode 以及 MCP 客户端等智能体框架。
• 基准测试显示，各智能体框架的长期记忆准确率可达 80% 以上，输入 token 相比基线最多减少 63%。

适用场景

• 通过 hooks、插件或 MCP 为 Claude Code、Codex、Cursor 等编程智能体提供跨会话记忆。
• 把项目文档与 GitHub 仓库中的知识组织为可浏览、可检索的目录，用于检索增强生成。
• 在接入 OpenClaw、Hermes、Claude Code 等框架时提升长期记忆准确率并降低输入 token 开销。
• 借助 Python、Go、TypeScript SDK 与 HTTP API 构建自定义智能体集成。

快速开始

• 使用 pip install openviking --upgrade 安装。
• 运行 openviking-server init 配置提供方与模型。
• 运行 openviking-server doctor 检查配置与连通性。
• 使用 openviking-server 启动服务。
• 通过 ov CLI 添加资源、执行检索并查看上下文，常用命令包括 ov add-resource、ov find 与 ov grep。

部署与要求

• 需要 Python 3.10+，并需要可访问的嵌入模型与 VLM，云端或本地均可。
• 开源服务器以 AGPLv3 运行，无需激活密钥；在 localhost 之外暴露前应先配置身份验证。
• 提供 Docker 与部署指南；桌面应用为 beta 版，支持 macOS 与 Windows x64。
• 服务器支持账号与用户隔离，以及可选的资源 ACL。

采用前须知

• 许可证：AGPL-3.0。在使用、修改或分发项目前，请确认其具体条款。