| # 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 Var | Default | Description | | |
| |---------|---------|-------------| | |
| | `OPENVIKING_ENDPOINT` | `http://127.0.0.1:1933` | Server URL | | |
| | `OPENVIKING_API_KEY` | (none) | API key (optional) | | |
| ## Tools | |
| | Tool | Description | | |
| |------|-------------| | |
| | `viking_search` | Semantic search with fast/deep/auto modes | | |
| | `viking_read` | Read content at a viking:// URI (abstract/overview/full) | | |
| | `viking_browse` | Filesystem-style navigation (list/tree/stat) | | |
| | `viking_remember` | Store a fact for extraction on session commit | | |
| | `viking_add_resource` | Ingest URLs/docs into the knowledge base | | |