openviking

OpenViking: The Context Database for AI Agents

Website · Live Demo · GitHub · Issues · Docs

👋 Join our Community

What is OpenViking

OpenViking is an open-source context database for AI agents. It stores memories, resources, and skills as one virtual filesystem under the viking:// protocol, so an agent browses its own context with ls, tree, and find instead of querying a black-box vector store. Content is processed into three tiers — L0 abstract, L1 overview, L2 details — and loaded on demand. Every retrieval leaves a trajectory you can watch and debug. Full introduction: Getting started.

The OpenViking Studio playground — a live demo you can open in the browser, no installation required.

Why OpenViking

One filesystem for all context. Memories, resources, and skills each get a viking:// URI. Agents locate and manipulate context deterministically, like a developer working with files. → Viking URI · Context types
Tiered loading cuts token spend. Every entry is processed into L0 (abstract), L1 (overview), and L2 (details) on write, then loaded only as deep as the task requires. → Context layers
Directory recursive retrieval. Vector search first locates the highest-scoring directory, then drills down layer by layer, so results arrive with their surrounding context intact. → Retrieval
Observable retrieval. Each query preserves its directory-browsing trajectory. When a result looks wrong, you can see exactly which path produced it. → Retrieval
Sessions become memory. After a session commits, OpenViking asynchronously extracts user preferences and agent experience into long-term memory. → Session

How the pieces fit together: Architecture. The thinking behind the design: The Database Paradigm for Context Engineering.

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.

Each directory carries its own L0/L1 layers, so relevance can be judged before any full file is read:

viking://resources/my_project/
├── .abstract               # L0: ~100 tokens - quick relevance check
├── .overview               # L1: ~2k tokens - structure and key points
└── docs/
    ├── .abstract
    ├── .overview
    └── api/
        ├── auth.md         # L2: full content, loaded on demand
        └── endpoints.md

Proof it works

OpenViking 0.3.22 has been evaluated on long-conversation user memory (LoCoMo) and multi-turn agent tasks (tau2-bench). Full results and setup details, including knowledge-base QA, are in the benchmark report; reproduction scripts live in ./benchmark.

Benchmark results. LoCoMo accuracy: OpenClaw 24.20% native vs 82.08% with OpenViking; Hermes 33.38% vs 82.86%; Claude Code 57.21% vs 80.32%. tau2-bench task success: Retail 70.94% vs 77.81%; Airline 54.38% vs 66.25%.

User memory (LoCoMo): with OpenViking, all three agent integrations land at 80–83% accuracy — up from 24–57% on their native memory — while input tokens drop by 34.3–91.0% and query latency by 58.45–66.10%.
Agent experience (tau2-bench): experience memory lifts task success by +6.87pp (retail) and +11.87pp (airline) over the same LLM without memory.

Quick start

💡 Want to see it in action first? Try OpenViking Studio — a live hosted instance with a context playground, semantic search, and a multi-agent hub. No installation required.

Requires Python 3.10 or higher.

pip install openviking --upgrade
openviking-server init      # interactive wizard: providers, models, ov.conf
openviking-server doctor    # validate setup
openviking-server           # start (background: nohup openviking-server > openviking.log 2>&1 &)

init walks you through provider setup and writes ~/.openviking/ov.conf. It supports Volcengine, OpenAI, Codex OAuth, Kimi, GLM, and local Ollama — for Ollama it can detect and install the runtime and pull models suited to your hardware. doctor checks the config file, Python version, provider connectivity, and disk space without a running server. Manual ov.conf templates, per-provider examples, environment variables, and Windows setup: Configuration guide · Quick start docs.

The install already includes the ov client CLI. With the server running:

ov status
ov add-resource https://github.com/volcengine/OpenViking # --wait
ov ls viking://resources/
ov tree viking://resources/volcengine -L 2
# wait some time for semantic processing if not --wait
ov find "what is openviking"
ov grep "openviking" --uri viking://resources/volcengine/OpenViking/docs/en

Next steps:

Client configuration (ov config), standalone CLI installs (npm / cargo), and advanced usage such as index rebuilding: CLI setup
Docker and production deployment: Deployment guide

Use it with your agent

Integrations inject OpenViking recall into your agent's context and auto-commit session memory:

Setup instructions for each agent: Agent integrations overview.

OpenViking Helper (Beta)

OpenViking Helper is a desktop console, currently in beta for macOS and Windows x64:

Visual local agent setup: detects OpenViking CLI, Claude Code, Codex, Cursor, Trae, and OpenCode, then configures supported plugin, MCP, Hook, and CLI integrations.
Session trace inspection: parses Claude Code, Codex, and Trae sessions to show OpenViking recall, prompt injection, MCP calls, capture, and commit events.
Local memory and skill management: views local memory / rule files and SKILL.md skills, then syncs them to OpenViking.

Download:

VikingBot

VikingBot is an AI agent framework built on top of OpenViking:

pip install "openviking[bot]"
openviking-server --with-bot
ov chat   # in another terminal

The official Docker image bundles VikingBot and starts it by default alongside the server and console UI. Details: VikingBot guide.

Deploy in production

For production, run OpenViking as a standalone HTTP service — see Server deployment and the Deployment guide.

Prefer not to operate it yourself? OpenViking Personal is officially hosted and ready to use, scales far beyond local hardware with VikingDB, and includes a free trial for up to 50 files; existing open-source users can move over with the migration tool. → openviking.ai

Managed Services

Volcano Engine (China Region)

Officially hosted on Volcano Engine, available in China.

Product page: www.volcengine.com/product/openviking-service
Documentation: docs.volcengine.com/docs/84313/2374478

Coming Soon

Global hosting service on BytePlus (for regions outside China)
Private distributed enterprise edition (deployed via activation code, supports BYOC)

Research

OpenViking open-sources a subset of the core capabilities described in the VikingMem paper:

VikingMem: A Memory Base Management System for Stateful LLM-based Applications Jiajie Fu, Junwen Chen, Mengzhao Wang, Aoxiang He, Maojia Sheng, Xiangyu Ke, Yifan Zhu, and Yunjun Gao. arXiv:2605.29640, 2026. Accepted by VLDB 2026. 📄 Read the paper on arXiv

Partner Projects

OpenViking welcomes collaboration with other open-source projects to build the context data ecosystem. Our confirmed partners include:

deer-flow - Open-source long-horizon SuperAgent harness
NoKV - AI native distributed file system
loopx - Lightweight loop engineering state kernel
Hermes Agent - The agent that grows with you

Interested in joining our partner list? Please submit an issue to our community to apply.

Community & contributing

OpenViking is still in its early stages, and there is plenty left to build.

Docs: docs.openviking.ai · FAQ
Blog: blog.openviking.ai
Team: About us
Chat: 📱 Lark Group · 💬 WeChat · 🎮 Discord · 🐦 X
Contribute: bug fixes and new features are both welcome — see CONTRIBUTING.md

Security and privacy

This project takes security seriously. For vulnerability reporting and supported versions, see SECURITY.md

License

The OpenViking project uses different licenses for different components:

Main Project: AGPLv3 - see the LICENSE file for details
crates/ov_cli: Apache 2.0 - see the LICENSE for details
examples: Apache 2.0 - see the LICENSE for details
third_party: Respective original licenses of third-party projects

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openviking-0.4.13.tar.gz (59.8 MB view details)

Uploaded Aug 6, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

openviking-0.4.13-cp310-abi3-win_amd64.whl (27.0 MB view details)

Uploaded Aug 6, 2026 CPython 3.10+Windows x86-64

openviking-0.4.13-cp310-abi3-manylinux_2_31_x86_64.whl (24.5 MB view details)

Uploaded Aug 6, 2026 CPython 3.10+manylinux: glibc 2.31+ x86-64

openviking-0.4.13-cp310-abi3-manylinux_2_31_aarch64.whl (21.9 MB view details)

Uploaded Aug 6, 2026 CPython 3.10+manylinux: glibc 2.31+ ARM64

openviking-0.4.13-cp310-abi3-macosx_15_0_x86_64.whl (23.3 MB view details)

Uploaded Aug 6, 2026 CPython 3.10+macOS 15.0+ x86-64

openviking-0.4.13-cp310-abi3-macosx_14_0_arm64.whl (20.7 MB view details)

Uploaded Aug 6, 2026 CPython 3.10+macOS 14.0+ ARM64

File details

Details for the file openviking-0.4.13.tar.gz.

File metadata

Download URL: openviking-0.4.13.tar.gz
Upload date: Aug 6, 2026
Size: 59.8 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openviking-0.4.13.tar.gz
Algorithm	Hash digest
SHA256	`9ac470cd09787f4c6dc03bd54fcf5e69478202d6c33a959041bd3551db902ccb`
MD5	`0f6f4843b15161887d941e2377c97547`
BLAKE2b-256	`1f213a23751b97fcb6e20168cbc13eb0bb8f691828a42f8489710f3a6527f956`

See more details on using hashes here.

Provenance

The following attestation bundles were made for openviking-0.4.13.tar.gz:

Publisher: release.yml on volcengine/OpenViking

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: openviking-0.4.13.tar.gz
- Subject digest: 9ac470cd09787f4c6dc03bd54fcf5e69478202d6c33a959041bd3551db902ccb
- Sigstore transparency entry: 2360100178
- Sigstore integration time: Aug 6, 2026
Source repository:
- Permalink: volcengine/OpenViking@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Branch / Tag: refs/tags/v0.4.13
- Owner: https://github.com/volcengine
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Trigger Event: release

File details

Details for the file openviking-0.4.13-cp310-abi3-win_amd64.whl.

File metadata

Download URL: openviking-0.4.13-cp310-abi3-win_amd64.whl
Upload date: Aug 6, 2026
Size: 27.0 MB
Tags: CPython 3.10+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openviking-0.4.13-cp310-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`d6549e602d1ec868a66a65724232cf573a69aab1bfc64207af1173ba539c779d`
MD5	`9526f1d7e676e298bdcb8df8c25acbd6`
BLAKE2b-256	`6a4ff5d2bc0711e858c035d089532c9eb43662ebc74df4d1e760c1ba738bd685`

See more details on using hashes here.

Provenance

The following attestation bundles were made for openviking-0.4.13-cp310-abi3-win_amd64.whl:

Publisher: release.yml on volcengine/OpenViking

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: openviking-0.4.13-cp310-abi3-win_amd64.whl
- Subject digest: d6549e602d1ec868a66a65724232cf573a69aab1bfc64207af1173ba539c779d
- Sigstore transparency entry: 2360100623
- Sigstore integration time: Aug 6, 2026
Source repository:
- Permalink: volcengine/OpenViking@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Branch / Tag: refs/tags/v0.4.13
- Owner: https://github.com/volcengine
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Trigger Event: release

File details

Details for the file openviking-0.4.13-cp310-abi3-manylinux_2_31_x86_64.whl.

File metadata

Download URL: openviking-0.4.13-cp310-abi3-manylinux_2_31_x86_64.whl
Upload date: Aug 6, 2026
Size: 24.5 MB
Tags: CPython 3.10+, manylinux: glibc 2.31+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openviking-0.4.13-cp310-abi3-manylinux_2_31_x86_64.whl
Algorithm	Hash digest
SHA256	`2638497359cb23851781e3f161b1b5edcf5a2636d3c4a4d569852d30617282fa`
MD5	`2ac665e4f75180d2ea95a774908fb669`
BLAKE2b-256	`0985e7648868e0d1adcbb26632640e98cf7f2bf4994df9e49d4147410e6ff9f5`

See more details on using hashes here.

Provenance

The following attestation bundles were made for openviking-0.4.13-cp310-abi3-manylinux_2_31_x86_64.whl:

Publisher: release.yml on volcengine/OpenViking

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: openviking-0.4.13-cp310-abi3-manylinux_2_31_x86_64.whl
- Subject digest: 2638497359cb23851781e3f161b1b5edcf5a2636d3c4a4d569852d30617282fa
- Sigstore transparency entry: 2360100439
- Sigstore integration time: Aug 6, 2026
Source repository:
- Permalink: volcengine/OpenViking@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Branch / Tag: refs/tags/v0.4.13
- Owner: https://github.com/volcengine
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Trigger Event: release

File details

Details for the file openviking-0.4.13-cp310-abi3-manylinux_2_31_aarch64.whl.

File metadata

Download URL: openviking-0.4.13-cp310-abi3-manylinux_2_31_aarch64.whl
Upload date: Aug 6, 2026
Size: 21.9 MB
Tags: CPython 3.10+, manylinux: glibc 2.31+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openviking-0.4.13-cp310-abi3-manylinux_2_31_aarch64.whl
Algorithm	Hash digest
SHA256	`edfc47bc4f58f3df4c6fa51b5f354e7058e8875d53196e8ee3de17c5115d9553`
MD5	`83aa548063dfcca4d6b7f1d7e0a62135`
BLAKE2b-256	`36811012fd14be7ad28ef0a4034ff37c0e54977d57325d2a50c2c05eb676c0e4`

See more details on using hashes here.

Provenance

The following attestation bundles were made for openviking-0.4.13-cp310-abi3-manylinux_2_31_aarch64.whl:

Publisher: release.yml on volcengine/OpenViking

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: openviking-0.4.13-cp310-abi3-manylinux_2_31_aarch64.whl
- Subject digest: edfc47bc4f58f3df4c6fa51b5f354e7058e8875d53196e8ee3de17c5115d9553
- Sigstore transparency entry: 2360100518
- Sigstore integration time: Aug 6, 2026
Source repository:
- Permalink: volcengine/OpenViking@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Branch / Tag: refs/tags/v0.4.13
- Owner: https://github.com/volcengine
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Trigger Event: release

File details

Details for the file openviking-0.4.13-cp310-abi3-macosx_15_0_x86_64.whl.

File metadata

Download URL: openviking-0.4.13-cp310-abi3-macosx_15_0_x86_64.whl
Upload date: Aug 6, 2026
Size: 23.3 MB
Tags: CPython 3.10+, macOS 15.0+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openviking-0.4.13-cp310-abi3-macosx_15_0_x86_64.whl
Algorithm	Hash digest
SHA256	`a7e6990bb318d2f234a7465f5a12a2db9bb7e5c98ebed38e49fd367656414987`
MD5	`dc60d7c6aacb219b9eb5aa8b0c4594a5`
BLAKE2b-256	`451b253cc155be449de68fddc3c3d6ede1d1115c244bc20293926ff510a71552`

See more details on using hashes here.

Provenance

The following attestation bundles were made for openviking-0.4.13-cp310-abi3-macosx_15_0_x86_64.whl:

Publisher: release.yml on volcengine/OpenViking

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: openviking-0.4.13-cp310-abi3-macosx_15_0_x86_64.whl
- Subject digest: a7e6990bb318d2f234a7465f5a12a2db9bb7e5c98ebed38e49fd367656414987
- Sigstore transparency entry: 2360100370
- Sigstore integration time: Aug 6, 2026
Source repository:
- Permalink: volcengine/OpenViking@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Branch / Tag: refs/tags/v0.4.13
- Owner: https://github.com/volcengine
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Trigger Event: release

File details

Details for the file openviking-0.4.13-cp310-abi3-macosx_14_0_arm64.whl.

File metadata

Download URL: openviking-0.4.13-cp310-abi3-macosx_14_0_arm64.whl
Upload date: Aug 6, 2026
Size: 20.7 MB
Tags: CPython 3.10+, macOS 14.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for openviking-0.4.13-cp310-abi3-macosx_14_0_arm64.whl
Algorithm	Hash digest
SHA256	`5d051933841aad78b7896634c272c605e9f9577443f1c14047985b1e4dfeed40`
MD5	`f9602aaa366afb67ebf24cd1ea98ecba`
BLAKE2b-256	`08cad13936293ab489c5842490fc8380a09b313ee9253bcec6c5d33ab4d933cf`

See more details on using hashes here.

Provenance

The following attestation bundles were made for openviking-0.4.13-cp310-abi3-macosx_14_0_arm64.whl:

Publisher: release.yml on volcengine/OpenViking

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: openviking-0.4.13-cp310-abi3-macosx_14_0_arm64.whl
- Subject digest: 5d051933841aad78b7896634c272c605e9f9577443f1c14047985b1e4dfeed40
- Sigstore transparency entry: 2360100286
- Sigstore integration time: Aug 6, 2026
Source repository:
- Permalink: volcengine/OpenViking@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Branch / Tag: refs/tags/v0.4.13
- Owner: https://github.com/volcengine
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@03bd469417c029a2d990d9b8eeda1c4d0c00d061
- Trigger Event: release

Release history Release notifications | RSS feed

This release

0.4.13

Aug 6, 2026

0.4.12

Aug 3, 2026

0.4.11

Jul 23, 2026

0.4.10

Jul 16, 2026

0.4.9

Jul 13, 2026

0.4.8

Jul 8, 2026

0.4.7

Jul 2, 2026

0.4.6

Jun 29, 2026

0.4.5

Jun 24, 2026

0.4.3

Jun 18, 2026

0.4.2

Jun 17, 2026

0.4.1

Jun 16, 2026

0.3.24

Jun 5, 2026

0.3.23

Jun 3, 2026

0.3.22

May 29, 2026

0.3.21

May 27, 2026

0.3.20

May 25, 2026

0.3.19

May 22, 2026

0.3.18

May 22, 2026

0.3.17

May 15, 2026

0.3.16

May 9, 2026

0.3.15 yanked

May 9, 2026

Reason this release was yanked:

retrieval score is incorrect

0.3.14

Apr 30, 2026

0.3.13

Apr 29, 2026

0.3.12

Apr 24, 2026

0.3.11

Apr 24, 2026

0.3.10

Apr 23, 2026

0.3.9

Apr 18, 2026

0.3.8

Apr 15, 2026

0.3.6 yanked

Apr 14, 2026

Reason this release was yanked:

deps failed

0.3.6.dev45 pre-release

Apr 15, 2026

0.3.6.dev42 pre-release

Apr 15, 2026

0.3.5

Apr 10, 2026

0.3.4

Apr 9, 2026

0.3.4.dev44 pre-release

Apr 8, 2026

0.3.3

Apr 3, 2026

0.3.2

Apr 1, 2026

0.3.1

Mar 31, 2026

0.2.16.dev9 pre-release

Mar 31, 2026

0.2.15 yanked

Mar 30, 2026

0.2.14.dev4 pre-release

Mar 26, 2026

0.2.13

Mar 26, 2026

0.2.13.dev4 pre-release

Mar 26, 2026

0.2.13.dev2 pre-release

Mar 26, 2026

0.2.12

Mar 25, 2026

0.2.12.dev1 pre-release

Mar 25, 2026

0.2.11

Mar 25, 2026

0.2.10

Mar 24, 2026

0.2.10.dev50 pre-release

Mar 23, 2026

0.2.10.dev45 pre-release

Mar 23, 2026

0.2.6

Mar 11, 2026

0.2.5

Mar 6, 2026

0.2.3

Mar 3, 2026

0.2.1

Feb 28, 2026

0.1.18

Feb 23, 2026

0.1.17

Feb 14, 2026

openviking 0.4.13

OpenViking: The Context Database for AI Agents

What is OpenViking

Why OpenViking

Proof it works

Quick start

Use it with your agent

OpenViking Helper (Beta)

VikingBot

Deploy in production

Managed Services

Volcano Engine (China Region)

Coming Soon

Research

Partner Projects

Community & contributing

Security and privacy

License

Project links

Key dates

4 maintainers

Credits

GitHub Statistics

License expression

Requires

Provides Extra

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed