volcengine /OpenViking

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

★ 42,264⑂ 3,493👁 111⑃ 5,771● 1,808▤ 118
PythonAGPL-3.0Created 2026-01-05openviking.ai
More from this author
Download: v0.5.5v0.5.5 ↓0.5.52026-11-13
+31
Daily
+420
Weekly
42,264
stars
3,493
forks
111
watchers
5,771
prs
1,808
issues
118
releases

README

The Context Database for AI Agents

English / 中文 / 日本語

Website · Live Demo · GitHub · Issues · Docs · Blog


  
  
  
  
  
  



  



   Lark ·
   WeChat ·
   Discord ·
   X








 What is OpenViking

OpenViking is an open-source context database for AI agents — one filesystem for everything an agent knows: knowledge, memory, and skills.

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 viking:// instead. Agents navigate it like files — ls, tree, read, write, grep — and you can open any directory to inspect and edit what your agent knows. Every directory carries a generated summary, so agents can scan summaries first and decide what to read.


  
    
    
  


Try OpenViking Studio in your browser, no installation required. Self-host Web Studio.

 Why OpenViking

- One filesystem for knowledge, memory, and skills. Resources hold documents and code; memories retain user preferences and experience; skills define how to perform tasks — not just extracted facts, but the full context, each with a viking:// URI for browsing and retrieval. → Viking URI · Context types
- Search a directory, not the whole index. Scope semantic search to a project or memory subtree instead of scanning a flat vector pool. find runs a query directly; search plans retrieval from session context. → Retrieval
- Read the summary before the source. Generated directory abstracts (L0) and overviews (L1) let agents judge relevance before opening full content (L2). → Context layers
- Sessions become files you can read. Committing a session archives the conversation and extracts memories as Markdown you can inspect, edit, and merge. With VikingBot enabled, ov compile organizes source material into a wiki, knowledge graph, or report. → Sessions · Context compilation

Architecture · Design rationale


viking://
├── resources/               Resources: project docs, repos, web pages, etc.
│   └── 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/


The three loading tiers:

- L0 (Abstract): a one-sentence summary for quick relevance checks.
- L1 (Overview): core information and usage scenarios for planning.
- L2 (Details): the full original data, read only when needed.

Semantically processed directories carry L0/L1 summaries, so agents can judge relevance before reading full files:


viking://resources/my_project/
├── .abstract.md            L0: quick relevance check
├── .overview.md            L1: structure and key points
└── docs/
    ├── .abstract.md
    ├── .overvi

Top issues

Discussions

Latest release

v0.5.5 v0.5.5 2026-11-13
中文

 主要更新

- PostgreSQL 部署选项:新增 pgvector 向量后端(storage.vectordb.backend: "pgvector",支持精确检索和 HNSW 检索,需要安装 openviking[pgvector])和 PostgreSQL PathLock(storage.agfs.pathlock.provider: "postgres")。多进程、多主机部署不依赖 Redis,也可以共享向量数据和路径锁租约。7516、7481
- 多节点协调:新增 storage.agfs.coordination(memory / sqlite / cache),统一负责 Watch 选主和语义任务版本;只有已持久化的工作才会取代旧任务,按 key 的状态保留一天后过期。7466
- 快照路径历史索引:snapshot/log?paths=... 改用派生索引查找改动过指定路径的提交,默认为 SQLite,多实例部署可选 MySQL,设为 none 则保持原来的扫描方式。快照提交、文件内容和 API 响应都不变。7505
- Gateway Context Profile:新增 recall_peer_scope(all / actor),可把召回限制在当前 peer;新增 capture_memory_types,限制 capture 抽取的记忆类型;c

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON