Notes

OpenViking - Context Database para AI Agents

#ai-agents · #vector-database · #rag · #agent-memory

OpenViking: The Context Database for AI Agents

Input principal: Post do LinkedIn de João Victor Valério (@joao-victor-valerio) apresentando OpenViking, um banco de dados open-source desenvolvido por ByteDance/Volcengine para gerenciar contexto de agentes de IA. O projeto ganhou 26.000 stars no GitHub em seis meses.

A plataforma resolve o problema fundamental de gerenciamento de memória para agentes: em vez de fragmentar contexto entre código, bancos de dados vetoriais e arquivos isolados, OpenViking unifica tudo em um paradigma de sistema de arquivos sob o protocolo viking://, permitindo que agentes consultam memória com comandos determinísticos (ls, find, read) em vez de dependerem de busca vetorial opaca.

Acesse a fonte original

Problema que OpenViking resolve

Agentes de IA sofrem com apagão crônico de memória. Quando tarefas se estendem, o contexto é truncado. Memórias ficam presas no código, conhecimento em bancos vetoriais, habilidades isoladas — fragmentação total. OpenViking centraliza memória, recursos e skills em um banco de dados de contexto auto-evolutivo.

Arquitetura: Sistema de Arquivos Virtual (AGFS + Vector Index)

OpenViking introduz um banco de dados de contexto com uma arquitetura de dois níveis:

  • AGFS (Agent Global File System): armazenamento virtual sob URIs viking:// (análogo ao que um agente vê — diretórios, arquivos, metadados)
  • Vector Index (VikingDB): índice semântico paralelo que suporta busca por path (TYPE_PATH), não apenas texto plano

Cada arquivo tem um URI único:

viking://resources/projeto/docs/api.md
viking://user/preferences/
viking://agent/skills/research/

Carregamento Progressivo de Contexto (L0/L1/L2)

Cada conteúdo é processado em três camadas automaticamente:

  • L0 (~100 tokens): resumo de uma linha — “O que é isto, rapidamente?”
  • L1 (~2k tokens): visão geral estruturada — suficiente para planejar
  • L2 (conteúdo completo): carregado apenas quando necessário

Reduz 80–91% do consumo de tokens comparado a RAG tradicional.

Scopes Organizados

Contexto em quatro escopos de primeiro nível:

  • viking://resources/ — conhecimento: documentos, repositórios, páginas web
  • viking://user/ — memórias e preferências do usuário
  • viking://agent/ — skills (funções reutilizáveis) e memórias de tarefas
  • viking://session/ — histórico de conversas

Implementação e Deployment

Linguagem: Python 3.9+, Rust para CLI

Instalação:

pip install openviking
curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/crates/ov_cli/install.sh | bash

Servidores:

  • Docker: ghcr.io/volcengine/openviking:latest
  • Kubernetes: Helm charts em examples/k8s-helm/
  • Requer: modelo de embedding (OpenAI, Volcengine Doubao, Ollama local)

CLI:

ov ls viking://resources/
ov read viking://resources/projeto/docs/
ov find "busca semântica"
ov abstract viking://...  # L0
ov overview viking://...  # L1

REST API:

curl http://localhost:1933/api/v1/fs/ls?uri=viking:// \
  -H "X-API-Key: sua-chave"

Diferencial: Filesystem vs. RAG Tradicional

Flat Vector Storage OpenViking Hierarchy
Chunks dispersos Diretórios com URIs
Busca semântica opaca Busca semântica + estrutural
Context window inteiro Três camadas progressivas
Sem relação entre chunks Hierarquia preserva contexto
Token-pesado em RAG 80–91% redução de tokens

Casos de Uso

  • Memória persistente de agentes: Agentes guardam aprendizado de interações, extraem padrões, reusam contexto
  • Gerenciamento de RAG em escala: Documentos, repositórios, web pages organizados deterministically
  • Skill management: Funções reutilizáveis acessíveis via URIs, carregamento sob demanda
  • Session compression: Histórico automático de conversas, memórias extraídas de longo prazo

Ecossistema ByteDance

OpenViking é infrastructure layer do stack de agentes ByteDance:

  • OpenClaw — framework de agentes
  • OpenCode — agente de programação
  • VikingBot — connectors para Feishu, Telegram, Slack, DingTalk, WeChat

Licença

  • Server: AGPL-3.0
  • CLI: Apache 2.0
  • Open-core: comercialização possível via SaaS

Documentação e Comunidade

  • Website: https://openviking.ai/
  • GitHub: https://github.com/volcengine/OpenViking
  • Docs: https://docs.openviking.ai/
  • Demo ao vivo: Links em repositório
  • Comunidade: Lark Group, WeChat, Discord, X

Pesquisa Complementar

OpenViking: An Open-Source Context Database — MarkTechPost análise detalhada da arquitetura.

OpenViking on GitHub Trending — Projetos que usam OpenViking (SDKs Node.js, reimplementação Go, integrações).

Project Context For Big Projects — comparação com soluções de RAG tradicionais e análise de custo-benefício.

OpenViking: Inside the Context Database Architecture — deep dive técnico no design de AGFS/VikingDB e tiering.