Your agent is brilliant and has the memory of a goldfish. The convention you corrected yesterday needs correcting again today, and your AGENTS.md is now longer than the agent is willing to read. OpenViking is a context database built for exactly this. The test below shows how much it can help you.
Twelve questions, about three minutes. You'll get a wrangler-type card, a five-axis profile with a fit score, and a straight answer on whether open source, the managed service or a private deployment suits you best. Rather not click through? Hand our prompt to your own AI and let it interview you instead.
Take the test
No right answers. Pick what's true today, not what's on the roadmap.
Let your own AI weigh in
The quiz scores your answers with fixed rules. To bring your actual project into the verdict, hand either prompt below to the AI you use, ideally a coding agent that can read your repository.
- Let the AI interview me: no quiz needed. The AI looks at your project, then asks you questions one at a time.
- With my quiz result: fills itself in once you finish the quiz. Use it for a second opinion.
No quiz needed. The AI looks at your project first (read-only, if it can see one), then asks you questions one at a time, and ends with a fit score and an edition verdict.
Help me decide whether I (or the project in front of you) should adopt OpenViking, and which way to run it. Judge independently from the facts; if I don't need it, say so. Step 1: if you can read the current project, start with a read-only pass. Do not install anything or modify any file; for configuration, look only at environment variable names and never print a secret's value. - Agent instruction files: AGENTS.md, CLAUDE.md, .cursor/rules and similar. Note their length and, if git log is available, how often they change. - Home-grown memory or retrieval: vector stores (chromadb, faiss, pgvector, qdrant, milvus…), embedding calls, LangChain / LangGraph, summarization or "memory" modules. - Signs of multiple agents or users: orchestration frameworks, several agent configs, code that isolates data per user or tenant. - How and where it deploys: Dockerfile, docker-compose, Kubernetes / Helm, cloud provider config. - Where models come from: OpenAI, Anthropic, Volcengine Ark, local models or an internal gateway. If you can't read a project, skip this step. Step 2: ask me questions, one at a time, at most 8, only about what the project can't tell you. At minimum find out: how much background I re-explain in each new session; how much material there is and where it lives; who shares the context; whether data may sit on a public cloud; whether users and servers are in mainland China or elsewhere; who runs infrastructure; where models come from; and how I'd expect to pay. Public facts about OpenViking (rely only on these and on public sources you can verify; do not invent prices, SLAs or certifications): - OpenViking is an open-source context database for AI agents, built by Volcengine's Viking team. It puts resources (knowledge), memories and skills into one filesystem organized by viking:// paths, which agents browse with ls, tree, read and grep. - Tiered loading: summaries first (L0 about 256 characters, L1 about 4k), full content on demand; search can be scoped to a directory. - Memories are extracted asynchronously after a session is committed and stored as readable Markdown. - Supported clients include Claude Code, Codex, Cursor, TRAE, OpenCode, OpenClaw, Hermes Agent, LangChain / LangGraph and any MCP client. Every integration needs a running OpenViking server, self-hosted or managed. - Where it is not the right tool: vector search you already have that works well (the official FAQ says the same); stateless one-shot calls; needing a fact recallable from long-term memory the moment it is said (memories are processed in the background). Four ways to run it: 1. Open source (self-hosted): AGPLv3, free, no activation key. Includes multi-tenancy (account / user, ROOT / ADMIN / USER roles), ACLs, encryption at rest, OAuth 2.1 for MCP, and Prometheus / OpenTelemetry observability. Runs as a single node, or as replicas you assemble yourself (needs a remote vector backend); no automatic failover. Bring your own models: embedding defaults to a built-in local model with no key; summaries and memory extraction need a VLM (Volcengine Ark, OpenAI-compatible APIs, Ollama, litellm and more). Install with uv tool install openviking, Docker or Helm. 2. Managed · Personal (OpenViking Context on Volcengine): fully managed, no deployment, upgrades or model hosting, same code core as open source; single user; the first 50 files in each Personal library are free, then hourly pay-as-you-go; Agent Plan credits apply. 3. Managed · Enterprise (OpenViking Context on Volcengine): many users, multiple isolated data spaces, dedicated resources that scale up automatically with file count; billed hourly from the moment a library is created; Agent Plan credits apply. Both managed plans require a real-name-verified Volcengine account and at least one Ark credential (Agent Plan, Coding Plan or your own inference endpoint); models are fixed to the Doubao family. The service runs in Volcengine's Beijing region (cn-beijing) and stores data on Volcengine; it is available outside mainland China (review cross-border latency and data-compliance requirements). Overseas-region hosting on BytePlus is coming soon. Commercial SLA and professional on-call support. Current prices: https://docs.volcengine.com/docs/84313/2485124 4. Private deployment: runs in your own cloud account / VPC (BYOC) or offline, adds distributed deployment and official support, activated by a license key; Kubernetes-based and needs an ops team. Apply through a form; once the team confirms, a package link and a trial license are emailed. Pricing and support are tailored to the deployment; contact the team for a quote. Offline sites bring their own model services and plan license renewal. - For licensing or compliance questions (including AGPL), ask the team; do not offer a legal interpretation. Step 3: once you have the answers, reply in English with this structure: 1. Evidence: what you found and what I told you (file paths for anything from the project). 2. Verdict: a 0–100 fit score and one sentence of reasoning. 3. Edition: rate Open source, Managed · Personal, Managed · Enterprise and Private deployment as high / medium / low / not a fit, with reasons; check data residency, model source and region separately. 4. Integration plan: if yes, which material belongs in resources, which in memories and which in skills, which client or SDK to connect, and the first three steps. 5. What would flip the verdict, and what you can't determine. Don't guess prices, SLAs or certifications.
Ten kinds of agent wrangler
Every result lands on one of these. Once you finish the quiz, yours is marked.
“I am its external hard drive.”
“Below line 300 lie the laws of a lost civilization.”
“Recall is excellent. What it recalls is not.”
“Everything is here. Nobody can find any of it.”
“Ctrl+C, Ctrl+V: my orchestration framework.”
“Each one is clever. Put them together and they fight.”
“Every tenant’s memories stay behind their own door.”
“Let’s take this offline. Literally.”
“If I can build it, I won’t buy it. My time is free, apparently.”
“Ask, answer, gone. No baggage.”
Open source, managed or private
Open source and the managed service share one code core. The editions differ in who deploys and operates it, where the data lives, and how you pay. The managed service runs on Volcengine in two plans, Personal and Enterprise.
Free and full-featured. You run it and pick the models.
- For
- Individuals and teams who want full control and are happy to run it.
- Ops
- You deploy and upgrade it; a single node, or replicas you assemble yourself.
- Models
- Bring your own: embedding defaults to a built-in local model with no key; summaries and memory extraction need a VLM (Volcengine Ark, OpenAI-compatible APIs, Ollama, litellm).
- Data lives
- Wherever you deploy it.
- Cost
- Free (AGPLv3). The real costs are servers, model usage and maintenance time.
One user, no ops: sign up and connect your agent.
- For
- Individual developers, personal assistants, single agents.
- Ops
- No deployment, upgrades or model hosting on your side.
- Models
- Runs on the Doubao model family, nothing to deploy; just link one Ark credential (Agent Plan, Coding Plan or your own inference endpoint).
- Data lives
- Volcengine's Beijing region (cn-beijing), also available to users outside mainland China; hosting in overseas regions on BytePlus is coming soon.
- Cost
- The first 50 files in each Personal library are free, then hourly pay-as-you-go from a low starting price; Agent Plan credits apply.
Many people and agents, strict isolation, no ops team to spare.
- For
- Teams, enterprise apps, multi-agent systems and many end users.
- Ops
- Nothing to deploy or upgrade; dedicated resources that scale up automatically with your file count.
- Models
- Runs on the Doubao model family, nothing to deploy; just link one Ark credential (Agent Plan, Coding Plan or your own inference endpoint).
- Data lives
- Volcengine's Beijing region (cn-beijing), also available to users outside mainland China; hosting in overseas regions on BytePlus is coming soon.
- Cost
- Billed hourly from the moment a library is created; Agent Plan credits apply.
Data stays in your own environment, with official support.
- For
- Organizations whose data must stay in their own cloud account, VPC or data center.
- Ops
- Runs on your own Kubernetes, operated by your team, with distributed deployment and official support.
- Models
- Volcengine Ark or your own model services; offline sites bring their own models.
- Data lives
- Your own cloud account, VPC or offline site.
- Cost
- Tailored to your deployment and support needs; contact the team for a quote.
For current managed-service prices, see the Volcengine pricing page.
When you don't need it
- Your current vector search or RAG already works well: keep using it.
- Your app is stateless or every call is one-shot: there is nothing to remember.
- You need what was just said to be recallable from long-term memory a second later: OpenViking extracts memories asynchronously after a session is committed, so that part belongs in the session context.
The quiz deliberately lowers the score for the first two; the first is also what the official FAQ advises.
How the scoring works
Fit comes mostly from two things: how forgetful your agents are, and how much material they need and how scattered it is. Team size and control requirements add a little on top. One-shot tasks, or vector search that already works, pull the score down; below 30, the verdict is that you don’t need it yet.
Region, ops, model source and budget never touch the fit score; they only decide which edition we recommend. If data must stay in your own cloud account or data center, or external model APIs are banned, the pick comes from Open source or Private deployment; if several people share the context or you run a fleet of agents, the managed pick is Managed · Enterprise.
When the top two are less than 5 points apart, a managed plan beats Open source, because the setup and ops time you save is usually worth more than the bill, unless running infrastructure is your idea of fun; Private deployment beats the other option when you have SREs or a platform team. If you answered that you wouldn’t pay, Open source always ranks above Managed · Enterprise and Private deployment.
Next steps
Whatever kind of wrangler you turned out to be, the fastest test is two weeks on a real project.
- Want to run it yourself: read the quickstart, or hand the setup guide straight to your agent. By hand, start with
uv tool install openviking --upgrade && openviking-server init; the wizard sets up your models. - Rather not run servers: start the managed service, where each Personal library's first 50 files are free; teams can go straight to Enterprise.
- Data can't leave the building: request a private-deployment trial; once the team confirms, the package and a trial license arrive by email.
- Still unsure: ask us on GitHub or Discord, or ask VikingBot in the corner of this page. It has read the docs so you don't have to.
