O que é OpenViking?
OpenViking é um servidor que reúne tudo o que um agente sabe em um único sistema de arquivos virtual sob URIs viking://: recursos (documentos, repositórios, páginas web), memórias (preferências e experiência extraídas das conversas) e skills. Os agentes se movem por ele com ls, tree, read, grep e find, e cada diretório processado traz um resumo de uma linha (L0) e uma visão geral (L1) gerados por um modelo, para que o agente leia resumos antes de abrir os arquivos completos (L2). A busca pode ser limitada a uma subárvore em vez de um único conjunto plano de vetores.
Os agentes se conectam por um endpoint MCP servido na mesma porta da API REST, um instalador do plugin de memória para Claude Code, Codex, Cursor, TRAE e OpenCode, integrações nativas para OpenClaw, Hermes Agent e pi, adaptadores para LangChain e Microsoft Agent Framework, SDKs para Python, Go e TypeScript e a CLI ov. Ao confirmar uma sessão, a conversa é arquivada e as memórias extraídas são gravadas como arquivos Markdown que você pode abrir e editar.
O projeto vem da Volcano Engine (Volcengine), o negócio de nuvem da ByteDance. O servidor principal é AGPL-3.0; a Volcengine também vende um OpenViking Service hospedado e uma edição Self-Managed ativada por chave de licença, com implantação distribuída e suporte.
OpenViking vale a pena?
A melhor ideia do OpenViking é que a memória precisa ser inspecionável. Em vez de um banco de vetores consultado às cegas, ele guarda documentos, memórias extraídas e skills como arquivos sob caminhos viking://, cada diretório encabeçado por resumos escritos por um modelo, e os agentes o percorrem com comandos de sistema de arquivos. O repositório foi criado em janeiro de 2026 e tem cerca de 42.400 estrelas no GitHub, 3.511 forks e nove versões entre a v0.5.0, de 9 de outubro, e a v0.5.5, de 13 de novembro de 2026.
Os testes foram feitos pelo próprio fabricante. O README relata precisão em conversas longas no LoCoMo de 80 a 83% para OpenClaw, Hermes e Claude Code com OpenViking, contra 24 a 57% com a memória nativa deles, com tokens de entrada reduzidos de 34,3 a 91,0%, e sucesso em tarefas do tau2-bench 6,87 pontos maior em retail e 11,87 em airline. Esses testes usaram a versão 0.3.22 com Doubao 2.0 Pro e Doubao-embedding-vision-251215, ambos modelos da Volcengine, e nenhuma reprodução independente foi publicada.
Os modelos são escolha sua, mas não são de graça. Os embeddings usam por padrão um modelo GGUF local, bge-small-zh-v1.5, e o guia de configuração lista 13 provedores de embeddings, entre eles OpenAI, Azure, Gemini, Voyage, Jina, Ollama e LiteLLM. O modelo de visão e linguagem que escreve os resumos e extrai as memórias não tem padrão; o assistente de configuração oferece Volcengine, OpenAI, login do Codex, Kimi, GLM e Ollama, e os demais provedores passam pelo LiteLLM. Todos os exemplos completos da documentação usam modelos Doubao no endpoint de Pequim da Volcengine, então conte com adaptá-los. Cada importação e cada sessão confirmada custam chamadas de modelo.
Os padrões de segurança são sensatos em uma única máquina e exigem trabalho além dela. O servidor escuta em 127.0.0.1:1933 e, sem uma chave root definida, roda em modo dev, em que toda requisição é tratada como root; ele se recusa a iniciar assim em um endereço que não seja loopback. A imagem Docker se vincula a 0.0.0.0, então ali a chave root é obrigatória. Os modos API key, OIDC, LDAP e gateway confiável vêm embutidos, e o MCP suporta OAuth 2.1 para Claude.ai e ChatGPT. A criptografia em repouso vem desligada por padrão. Na v0.5.5, o perfil padrão do gateway de modelos passou a expor todas as ferramentas, incluindo oito que alteram dados, como write, forget e set_acl, a menos que você as liste em disabled_tools.
A licença decide a maioria das implantações. A AGPL-3.0 obriga você a oferecer o código-fonte aos usuários de rede de uma versão modificada que você hospede, o que importa se você alterar o servidor dentro de um produto. O README acrescenta que reescrever o projeto inteiro e republicá-lo, ou portar uma parte substancial para outra linguagem, exige permissão por escrito da Volcengine. Diante de Mem0 e Graphiti, ambos Apache-2.0, isso é um atrito real, e só as notas da v0.5.5 listam 13 itens de atualização e migração.
Onde ele se destaca
Um desenvolvedor que usa Claude Code e Codex nos mesmos repositórios
Fazer os dois agentes lembrarem minhas preferências e correções anteriores sem conta na nuvem
Rode openviking-server em localhost e depois o instalador via curl adiciona hooks e MCP a cada agente. As memórias ficam em Markdown sob viking://user/, então as erradas podem ser editadas ou apagadas. O software é gratuito; o modelo de extração é cobrado por sessão pelo provedor que você configurar.
Uma equipe de plataforma em uma empresa de 200 pessoas que está criando um assistente interno
Dar ao assistente busca delimitada na nossa documentação e memória por usuário
Implante a imagem Docker com chave root e OIDC, crie uma conta por equipe e chaves de usuário por pessoa e conecte o assistente à API REST ou ao SDK Python. Rodá-lo sem modificações como serviço separado é o padrão comum; alterar o servidor dentro de um produto hospedado traz as obrigações de código-fonte da AGPL.
Uma empresa chinesa de SaaS que já usa a Volcengine
Adicionar memória de longo prazo aos nossos agentes sem operar mais um banco de dados
O OpenViking Service hospedado da Volcengine roda o mesmo servidor em Pequim; os primeiros 50 arquivos são grátis, e planos e limites estão na documentação do serviço da Volcengine, não no repositório.
Antes de decidir
- Configuração
- `uv tool install openviking --upgrade && openviking-server init` (Python 3.10+ e uv), escolhendo um modelo de embeddings e um modelo de visão e linguagem; depois os agentes são conectados com `curl -fsSL https://openviking.ai/install | bash` (macOS ou Linux, Node.js 18+). A imagem Docker ghcr.io/volcengine/openviking e um template do Railway também são publicados.
- Integrações
- MCP via Streamable HTTP em /mcp na porta 1933, com proxy stdio; Claude Code, Codex, Cursor, TRAE, OpenCode, OpenClaw, Hermes Agent, pi, DeerFlow; adaptadores para LangChain/LangGraph e Microsoft Agent Framework; SDKs para Python, Go e TypeScript; API REST; CLI ov; Web Studio em /studio.
- Dados e privacidade
- Auto-hospedado por padrão: o conteúdo fica em um espaço de trabalho local (./data) sobre a camada de arquivos RAGFS mais um índice vetorial; pgvector, MySQL e Redis são opções para implantações compartilhadas. O texto é enviado aos provedores de embeddings e de visão e linguagem que você configurar. Criptografia em repouso e rastreamento com OpenTelemetry vêm desligados por padrão. O serviço hospedado roda na região de Pequim da Volcengine; hospedagem fora da China está prevista na BytePlus.
- Custo em escala
- Sem taxa de licença para o servidor AGPL. O custo contínuo são as chamadas de modelo: resumos para cada diretório importado e extração de memórias a cada sessão confirmada. Os preços do serviço hospedado e do Self-Managed não são publicados no repositório.
- Limites
- 1.541 issues e pull requests abertos; as notas da v0.5.5 listam 13 itens de atualização e migração, vários incompatíveis; o armazenamento vetorial embutido não suporta vários processos, então implantações compartilhadas precisam de um backend vetorial remoto.
O que é bom
- Memórias e documentos guardados como arquivos que você pode ler e editar
- Busca limitada por diretório, com resumos antes do conteúdo completo
- MCP, hooks, três SDKs e instaladores para a maioria dos agentes de código
- Funciona com modelos locais, OpenAI, Gemini e outros provedores
O que não é
- AGPL-3.0, mais uma cláusula do README que restringe reescritas e portes
- Exemplos e benchmarks construídos em torno dos modelos Doubao da Volcengine
- Sem autenticação e com acesso root no modo dev até que uma chave seja definida
- Mudanças incompatíveis de configuração entre versões menores
Ideal para
Equipes que querem memória de agente e busca em documentos que possam auditar arquivo por arquivo, e que aceitam a AGPL e um servidor que muda rápido.
Alternativas ao OpenViking
OpenViking: perguntas frequentes
- OpenViking vale a pena?
- OpenViking transforma a memória de um agente em algo que você pode abrir e ler, mas a licença AGPL, os padrões pensados para a Volcengine e as frequentes mudanças incompatíveis exigem mais de uma equipe do que Mem0 ou Graphiti. Damos nota 3.9 de 5.
- Quanto custa OpenViking?
- Código aberto sob AGPL-3.0, sem chave de ativação. Você paga as chamadas aos modelos de embeddings e de visão e linguagem. O OpenViking Service hospedado da Volcengine tem planos Personal e Enterprise, com os primeiros 50 arquivos grátis; os preços não estão no README. Edição Self-Managed por chave de licença, preço sob consulta.
- Quais são as desvantagens de OpenViking?
- AGPL-3.0, mais uma cláusula do README que restringe reescritas e portes; exemplos e benchmarks construídos em torno dos modelos Doubao da Volcengine; sem autenticação e com acesso root no modo dev até que uma chave seja definida; mudanças incompatíveis de configuração entre versões menores.
- Para quem OpenViking é indicado?
- Equipes que querem memória de agente e busca em documentos que possam auditar arquivo por arquivo, e que aceitam a AGPL e um servidor que muda rápido.
- Quanto custa OpenViking para uma equipe ou em produção?
- Sem taxa de licença para o servidor AGPL. O custo contínuo são as chamadas de modelo: resumos para cada diretório importado e extração de memórias a cada sessão confirmada. Os preços do serviço hospedado e do Self-Managed não são publicados no repositório.
- OpenViking é seguro para dados da empresa?
- Auto-hospedado por padrão: o conteúdo fica em um espaço de trabalho local (./data) sobre a camada de arquivos RAGFS mais um índice vetorial; pgvector, MySQL e Redis são opções para implantações compartilhadas. O texto é enviado aos provedores de embeddings e de visão e linguagem que você configurar. Criptografia em repouso e rastreamento com OpenTelemetry vêm desligados por padrão. O serviço hospedado roda na região de Pequim da Volcengine; hospedagem fora da China está prevista na BytePlus.
- Quais são as melhores alternativas ao OpenViking?
- As alternativas mais próximas que analisamos são Mem0, Graphiti, Cognee e claude-mem.
Respostas verificadas em 18 de nov. de 2026.