Registry / llm-agents / openviking

openviking

JSON →
library0.4.2pypypi✓ verified 79d ago

An Agent-native context database built by Volcengine. Current version 0.3.12, with active weekly releases. It provides memory, retrieval, RAG, and plugin systems for building AI agents, with support for various LLM/VLM providers and VikingDB integration.

pip install openviking
INSTALL
IMPORT
SIG · OPENVIKING
O
openviking
llm-agentspythonv0.4.2
Install
67.1s avg
Import
Disk
1031MB
Pass rate
4/ 10
Env Coverage4 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.4.2 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
glibc
py 3.10
✕ build_error
✓ 73.8s
py 3.11
✕ build_error
✓ 66.5s
py 3.12
✕ build_error
✓ 62.3s
py 3.13
✕ build_error
✓ 65.9s
py 3.9
✕ build_error
✕ build_error
1031MB installed
● package 1031MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

VikingMemory
from openviking import get_binding_client
from openviking.memory import VikingMemory

Initializes OpenViking client, stores and retrieves a simple memory.

import os from openviking import OpenViking def main(): # Initialize client (requires a VikingDB instance and API key) vk = OpenViking( host=os.environ.get('VIKING_HOST', 'http://localhost:8080'), api_key=os.environ.get('VIKING_API_KEY', 'your-api-key-here') ) # Store a memory memory_id = "my-first-memory" vk.memory.store( memory_id=memory_id, content="Hello, OpenViking! This is a test memory.", metadata={"type": "greeting"} ) print(f"Stored memory: {memory_id}") # Retrieve the memory result = vk.memory.retrieve(memory_id=memory_id) print(f"Retrieved content: {result.content}") if __name__ == "__main__": main()
Debug
Known issues
breakingMemory V1 is deprecated since v0.3.8. Memory V2 uses YAML-based templates and requires migration of existing memory definitions.
fix
Update memory configs to use V2 template format; see migration guide at https://github.com/volcengine/OpenViking/wiki/Memory-V2-Migration
affects: >=0.3.8
gotchaOpenViking requires Python >=3.10. Trying to install on older versions will fail.
fix
Ensure your Python version is 3.10 or higher: python --version
affects: all
deprecatedThe `openviking.OpenClaw` plugin system is being replaced by `openviking.plugins` module. OpenClaw remains functional but will be removed in a future version.
fix
Use `from openviking.plugins import PluginManager` instead.
affects: >=0.3.3
Upgrade
Version history
0.4.2latest on PyPI · released Jun 17, 2026
Audit
Dependencies
python-dotenvoptionalRequired for loading .env files in quickstart examples
Agent activity
75 hits · last 30 days
node
70
OpenAI (training)
1
Resources
openviking — pip install openviking · libregistry