Back to Hermes Agent

OpenViking Memory Provider

plugins/memory/openviking/README.md

2026.6.51.2 KB
Original Source

OpenViking Memory Provider

Context database by Volcengine (ByteDance) with filesystem-style knowledge hierarchy, tiered retrieval, and automatic memory extraction.

Requirements

  • pip install openviking
  • OpenViking server running (openviking-server)
  • Embedding + VLM model configured in ~/.openviking/ov.conf

Setup

bash
hermes memory setup    # select "openviking"

Or manually:

bash
hermes config set memory.provider openviking
echo "OPENVIKING_ENDPOINT=http://localhost:1933" >> ~/.hermes/.env

Config

All config via environment variables in .env:

Env VarDefaultDescription
OPENVIKING_ENDPOINThttp://127.0.0.1:1933Server URL
OPENVIKING_API_KEY(none)API key (optional)

Tools

ToolDescription
viking_searchSemantic search with fast/deep/auto modes
viking_readRead content at a viking:// URI (abstract/overview/full)
viking_browseFilesystem-style navigation (list/tree/stat)
viking_rememberStore a fact for extraction on session commit
viking_add_resourceIngest URLs/docs into the knowledge base