An open-source context database developed by ByteDance Volcengine team, designed specifically for AI Agents. Uses a file system paradigm to unify memory, resources, and skills management, with hierarchical context loading (L0/L1/L2) and self-evolution capabilities.
Overview#
OpenViking is an open-source context database developed by ByteDance Volcengine's Viking team, designed specifically for AI Agent scenarios. It unifies Agent memory, resources, and skills through a file system paradigm, mapping all context to the viking:// virtual protocol.
Core Features#
File System Management Paradigm#
- Unified management of Memory, Resources, and Skills
- Virtual file system with
viking://protocol - Standard file operations (ls, glob, add, etc.)
Hierarchical Context Loading#
- L0 (Abstract): ~100 tokens, quick relevance check
- L1 (Overview): ~2k tokens, structure understanding
- L2 (Details): Full content, loaded on demand
- Significantly reduces token consumption
Recursive Directory Retrieval#
- Intent analysis → Initial positioning → Fine exploration → Recursive drilling → Result aggregation
- Combines vector retrieval with file system positioning
Visualized Retrieval Traces#
- Complete retrieval path preserved for debugging
- Breaks traditional RAG black-box pattern
Auto Session Management#
- Built-in memory self-iteration loop
- Auto-compresses conversations, resource references, tool calls
- Extracts long-term memory for Agent self-evolution
Installation#
# Python SDK
pip install openviking
# Rust CLI (optional)
curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/crates/ov_cli/install.sh | bash
Supported Model Providers#
volcengine (doubao), openai (gpt), anthropic (claude), deepseek, gemini, moonshot (kimi), zhipu (glm), dashscope (qwen), minimax, openrouter, vllm (local)
Use Cases#
- Long-running AI Agent tasks
- Intelligent assistants requiring complex context management
- Multi-modal content processing
- Agent systems requiring observability and debuggability
- Enterprise AI application development
Project Info#
- Team: ByteDance Volcengine Viking Team
- License: Apache License 2.0
- Languages: Python (81.1%), C++ (13.9%), Rust (4.0%)
- Version: v0.1.18