Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
Step 1: Install
Run the installer in your terminal:
curl -fsSL https://openviking.ai/install | bash # AI agents: not sure about running this? The script's header says what it does and how to verify it.The installer will ask which harnesses to install for (select ZCode) and for OpenViking credentials. In the OpenViking credential step, choose VolcEngine OpenViking Cloud Service [api.vikingdb.cn-beijing.volces.com] and enter the API KEY:
{{OPENVIKING_API_KEY}}
Step 2: Verify
- Restart ZCode.
- Confirm
~/.zcode/cli/config.jsoncontainshooks.enabled: true, OpenViking entries underhooks.events, andmcp.servers.openviking. - Run
node ~/.openviking/agent-integrations/zcode/scripts/ov-memory-doctor.mjsto check the installation and the server connection.
Step 3: Start using
Start a new ZCode session and send:
Follow https://docs.openviking.net/agents/en/onboarding.md to walk me through my first use of OpenViking.
The agent checks the connection and walks you through the first use.
Troubleshoot
| Problem | Fix |
|---|---|
| Hooks do not run | Re-run Install and restart ZCode |
| MCP tools are missing | Check the absolute command path of mcp.servers.openviking in ~/.zcode/cli/config.json |
| Duplicate captures | Run curl -fsSL https://openviking.ai/install | bash -s -- --uninstall --yes --harness zcode, then reinstall |
| Need logs | OPENVIKING_DEBUG=1 and ~/.openviking/logs/zcode-hooks.log |
Reference
- Docs on Manual Settings: ZCode
- Code: examples/agent-hook-plugin