volcengine/OpenViking
A database that lets AI agents browse their own memory and files like a file system
OpenViking is an open-source context database that unifies an AI agent's memories, resources, and skills under one virtual filesystem addressed as viking://. It pre-processes every entry into three loading tiers - a one-sentence abstract, an overview, and full details - and loads only as much as a task needs, cutting token usage. Reported benchmarks show large gains in accuracy and latency compared to agents' native memory.
What it does
- Memories, documents, and skills are each given a viking:// address so agents can browse and search them with familiar commands like ls, tree, and find instead of querying an opaque vector store
- On write, content is processed into L0 (a roughly 100-token one-sentence abstract), L1 (a roughly 2k-token overview), and L2 (full original content); retrieval first locates the best-matching directory via vector search, then drills down layer by layer
- Every retrieval keeps a record of the directory-browsing path it took, so a wrong result can be traced back to exactly how it was produced
- After a session ends, OpenViking asynchronously extracts user preferences and agent experience into long-term memory
- On the LoCoMo long-conversation memory benchmark, adding OpenViking raised accuracy for OpenClaw, Hermes, and Claude Code from 24-57% (native memory) to 80-83%, while cutting input tokens by 34.3-91.0%; on tau2-bench multi-turn agent tasks, task success rose by 6.87 percentage points (retail) and 11.87 points (airline) over the same LLM without memory
Why it matters
When AI agents handle long histories and large document sets, re-reading everything or relying on opaque vector search drives up cost and errors; OpenViking makes context retrieval predictable and debuggable, like working with files. It plugs directly into tools like Claude Code, Cursor, and LangChain, so it can be tried in real agent workflows right away.
Terms in this repo
- viking:// protocol · the addressing scheme OpenViking uses for memories, resources, and skills, treated like file paths
- L0/L1/L2 · three loading tiers - one-line abstract, overview, full details - loaded only as deep as needed
- LoCoMo · a benchmark measuring how well a system retains user memory across long conversations
- tau2-bench · a benchmark measuring an agent's success rate on multi-turn conversational tasks
- VikingBot · an AI agent framework built on top of OpenViking
Repository description (English)
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- Alishahryar1/free-claude-codeA local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
- NousResearch/hermes-agentNous Research's Hermes is an AI agent that gets smarter the more you use it
- virgiliojr94/book-to-skillA tool that turns technical book PDFs into on-demand reference skills for AI coding agents
- VoltAgent/awesome-agent-skillsA single hub collecting over 1000 'how-to' manuals that make AI coding assistants act like experts
- anthropics/claude-plugins-communityA shared shelf where anyone's Claude add-ons get listed for install