# volcengine/openviking

> OpenViking is an open-source context database designed for AI Agents. It holds the memory, resources and skills an Agent needs and organizes them in a file system paradigm instead of flat vector storage. The core is written in Python, with a Rust command line tool and C++ extensions.

Source: https://github.com/volcengine/openviking
Indexed: commit 66622aa on 2026-06-14 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: Python
- Stars: 42,268 at index time
- License: AGPL-3.0
- Code health: 5.9/10, Fair
- Last commit: 2026-06-14

## Install

From the README: https://github.com/volcengine/openviking#quick-start

Install the OpenViking Python package from PyPI, which requires Python 3.10 or higher.
    pip install openviking --upgrade --force-reinstall

## How to use

Run the interactive setup wizard to configure local models through Ollama.
    openviking-server init

Check your setup, including the config file, Python version and provider connectivity.
    openviking-server doctor

Start the OpenViking server with the VikingBot agent enabled.
    openviking-server --with-bot

## How it works

The openviking directory holds the main Python package, which organizes and stores agent context. openviking/storage/viking_fs.py implements the storage layer that keeps context as files and directories. openviking/session/session.py handles conversation sessions, compressing content and extracting long-term memory from them. crates/ov_cli/src/main.rs is the entry point of the Rust CLI, which connects to a running server through its configured URL. bot/vikingbot/__main__.py starts VikingBot, an agent framework built on top of OpenViking, and it can run alongside the server.

- benchmark/RAG/run.py: entry point
- benchmark/locomo/claudecode/scripts/auto-capture.mjs: entry point
- bot/bridge/src/index.ts: entry point
- bot/bridge/src/server.ts: entry point
- bot/vikingbot/__main__.py: entry point
Modules: tests, openviking, third_party, bot, examples, docs, web-studio, benchmark. 2,522 files, 528,563 lines, 31,763 symbols.

## Code health

- Score: 5.9/10 (Fair)
- Rank: #220 of 4,000+ indexed repos
- Hotspots: crates/ov_cli/src/main.rs, examples/openclaw-plugin/index.ts, openviking/session/session.py, openviking/storage/viking_fs.py, examples/openclaw-plugin/context-engine.ts
- Lowest file: openviking/session/session.py
- Dead code: 289 findings

## Maintenance

- Last commit 2026-06-14
- bus factor 4

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/volcengine/openviking/security

## More

- Page: https://repowise.dev/repo/volcengine/openviking
- Ask this codebase: https://repowise.dev/repo/volcengine/openviking/chat
- Docs: https://repowise.dev/repo/volcengine/openviking/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/volcengine/openviking
