Repolode
提交项目
volcengine

volcengine/OpenViking

面向 AI Agent 的开源上下文数据库，用一个可浏览、可编辑的文件系统统一管理知识、记忆和技能。

在 GitHub 查看官网
Star
41,697
Fork
3,407
未关闭 Issue
1,030
最近提交
14小时前

这是什么？

OpenViking 是面向 AI Agent 的上下文数据库。它不把记忆存成难以查看的向量，而是把知识、记忆和技能组织成 viking:// 下的虚拟文件系统，Agent 可以用 ls、tree、read、write、grep 等命令浏览，用户也能打开任意目录查看或修改 Agent 掌握的内容。

每个目录都会生成 L0 摘要和 L1 概览，Agent 可以先依据简短摘要判断相关性，再按需加载完整的 L2 内容。语义检索可以限定在某个项目或记忆子树内进行。会话提交后会被归档，其中提取的记忆以 Markdown 文件保存。

项目提供服务端、名为 ov 的命令行工具、Python、Go 和 TypeScript SDK 以及 HTTP API，并支持 Claude Code、Codex、Cursor、OpenCode 等编码 Agent，以及 LangChain 等框架。项目采用 AGPLv3 许可，可自行部署，也可使用火山引擎托管的服务。

核心功能

  • 01以 viking:// 路径的文件系统形式组织知识、记忆和技能。
  • 02为每个目录生成 L0 摘要和 L1 概览，便于 Agent 先筛选再读取。
  • 03语义检索可限定在目录子树内进行，而非全库向量池。
  • 04会话归档，提取出的记忆以可编辑的 Markdown 文件保存。
  • 05提供 ov 命令行工具、Python、Go、TypeScript SDK 和 HTTP API。

适用场景

  • 让编码 Agent 跨会话记住个人偏好和项目上下文。
  • 对项目文档和代码仓库做按目录范围限定的检索。
  • 让团队查看并修正 AI Agent 记住的内容。
  • 为基于 LangChain 或 MCP 的 Agent 提供共享的上下文存储。

快速上手

  1. 1

    使用 uv 安装 OpenViking 并运行配置向导以设置模型

    uv tool install openviking --upgrade && openviking-server init
  2. 2

    启动服务器并保持终端打开（服务器在前台运行）

  3. 3

    服务器运行后，使用 ov 命令行工具检查状态

    ov status

使用前须知

  • 采用 AGPL-3.0 许可证，这是一种 Copyleft 许可证，若将修改后的版本作为网络服务提供，需要公开修改后的源代码。
  • 自行部署需要模型服务商提供的嵌入模型和视觉语言模型（VLM），即需要 API 密钥或本地模型（如 Ollama）。
  • 代理记忆插件安装程序需要 macOS 或 Linux；Windows 用户需使用桌面应用。

收录于专题

AI 智能体长期记忆

标签

#agent-memory#context-database#rag#vector-search#llm-agents#knowledge-base#filesystem#agent-context#agent-plugins#agentic-rag

常见问题

OpenViking 是什么？
面向 AI Agent 的开源上下文数据库，用一个可浏览、可编辑的文件系统统一管理知识、记忆和技能。 OpenViking 是面向 AI Agent 的上下文数据库。它不把记忆存成难以查看的向量，而是把知识、记忆和技能组织成 viking:// 下的虚拟文件系统，Agent 可以用 ls、tree、read、write、grep 等命令浏览，用户也能打开任意目录查看或修改 Agent 掌握的内容。
OpenViking 可以免费使用吗？用的什么许可证？
OpenViking 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
OpenViking 还在维护吗？
活跃维护中。OpenViking 最近一次提交是在 2026年11月6日。
OpenViking 适合用来做什么？
让编码 Agent 跨会话记住个人偏好和项目上下文。 对项目文档和代码仓库做按目录范围限定的检索。 让团队查看并修正 AI Agent 记住的内容。 为基于 LangChain 或 MCP 的 Agent 提供共享的上下文存储。
OpenViking 怎么安装和运行？
使用 uv 安装 OpenViking 并运行配置向导以设置模型: uv tool install openviking --upgrade && openviking-server init 启动服务器并保持终端打开（服务器在前台运行） 服务器运行后，使用 ov 命令行工具检查状态: ov status
在哪里获取 OpenViking？
源代码和安装说明在 GitHub 上：https://github.com/volcengine/OpenViking

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目