mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-06-21 10:22:18 +00:00
2dace37f6b
Support linking, copying, and creating ovcli.conf during OpenViking memory setup. Make setup cancellation write nothing and cover OpenViking/Hindsight picker cancellation paths.
47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# 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"
|
|
```
|
|
|
|
The setup can link to an existing `~/.openviking/ovcli.conf`, copy its current
|
|
connection values into Hermes, or create a minimal `ovcli.conf` when one does
|
|
not exist.
|
|
|
|
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) |
|
|
| `OPENVIKING_ACCOUNT` | (none) | Tenant account override |
|
|
| `OPENVIKING_USER` | (none) | Tenant user override |
|
|
| `OPENVIKING_AGENT` | `hermes` | Tenant agent namespace |
|
|
|
|
## 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 |
|