OrkMind | Memória para sistemas agênticos

Uma fonte de verdade para o sistema inteiro

Orquestrador, sub-agentes, sessões, documentos e integrações compartilham identidades estáveis. O conhecimento sobrevive à sessão sem perder fonte ou permissão.

OrkMind company brain

Orquestrador

Coordena o trabalho com contexto citável do Company Brain e devolve fases, decisões, claims e artefatos à memória empresarial.

Lê contexto autorizado, devolve evidências

23 coleções para organizar memória. Tipos continuam tipos.

Coleção é uma organização transversal da memória, não a ontologia do portfólio. Produto, Projeto e Iniciativa têm identidade e relações no Company Brain; uma memória pode usar as coleções homônimas sem duplicá-los. Toque em uma coleção para ver o que ela guarda.

A mesma consulta devolve o mesmo contexto

Oito dimensões de tags cobrem os eixos de contexto de um sistema multiagente. O casamento é exato, sem ranking probabilístico: regra mandatória que casa com as tags sempre chega ao agente.

skill Habilidade
Que capacidade está em jogo: deploy, testes, git, auth.
agent Agente
Qual runtime ou agente usa a memória.
domain Domínio
Área técnica: backend, frontend, infra, segurança.
project Projeto
A qual projeto a memória pertence.
situation Situação
O momento de uso: debugging, review, refatoração.
person Pessoa
Quem é citado ou relevante na memória.
audience Audiência
Quem pode ler a entrada. É controle de acesso.
editors Editores
Quem pode alterar a entrada. Também é acesso.

Simulador com um conjunto de exemplo de 8 memórias. Selecione tags e veja o casamento exato:

orkmind search --tags '{"skill": ["deploy"]}'

O caminho de um recall determinístico

Detectar o contexto

A consulta nasce das tags explícitas ou dos detectores de contexto: palavras-chave e caminhos de arquivo.
Casar exato

As tags casam por igualdade, dimensão a dimensão. Nada de score: casou, entrou.
Garantir as regras

Entradas mandatórias que casam furam qualquer fila. Governança chega sempre ao agente.
Respeitar o orçamento

O contexto cabe em um orçamento de tokens: prioridade critical primeiro, camadas E1, E2 e E3 conforme couber.
Injetar o contexto

O mesmo bloco, na mesma ordem, para a mesma consulta. Reprodutível de ponta a ponta.

Um Company Brain, duas superfícies

O core em Python governa identidade, histórico e acesso. A interface web transforma o mesmo conhecimento em trabalho cotidiano para pessoas.

OrkMind core

A base que governa

Biblioteca Python com PostgreSQL e pgvector. Publicada no PyPI, licenciada Apache 2.0.

Governança acima do backend
Proteção de entradas, ACL e ordenação constitucional valem em qualquer backend, sem exceção.
Histórico e escrita concorrente
Versões append-only e compare-and-swap impedem que uma edição obsoleta vença em silêncio.
Criptografia seletiva
AES-256-GCM em repouso para coleções sensíveis como contatos, arquivos e docs.
Anti-injection
Detecção em 5 categorias: entrada suspeita fica retida e fora da injeção automática.
Snapshots globais
Commit, diff e restore da árvore de memória inteira, com embeddings preservados.
Proveniência e receipts
Fonte, revisão e recibos permitem readback, reconciliação e rollback sem fabricar sucesso.

$ orkmind add --collection rule \
    --content "Nunca usar rm -rf em produção" \
    --tags '{"skill": ["deploy"]}' --mandatory
memória gravada: coleção rule, mandatória

$ orkmind search --tags '{"skill": ["deploy"]}'
1. [rule] Nunca usar rm -rf em produção
   mandatória, prioridade critical

$ orkmind store info
backend ativo: pgvector
capacidades completas, nenhum aviso

OrkMind Web

O conhecimento que se usa

A Biblioteca em /knowledge reúne o conhecimento autorizado sem copiá-lo: tipos ontológicos, coleções de memória e fontes aparecem como dimensões separadas. Agentes e pessoas veem o mesmo estado autorizado; a execução de ciclos acontece exclusivamente nos hosts de agentes.

Biblioteca governada
Documentos, memórias e entidades convivem sem apagar a diferença entre tipo, coleção e origem.
Grafo interativo
As conexões da memória renderizadas em WebGL, com filtros por coleção e data.
Camadas E1, E2 e E3
Da essência ao conteúdo completo, o detalhe cresce só quando você pede.
PWA instalável
A memória do sistema no bolso, com cache offline.
Workspace de conhecimento
Escrever, localizar, investigar e decidir sobre o estado autorizado do Company Brain.

OrkMind Web em tema escuro: lista de memórias com coleções, camadas E3 e tags de domínio — Telas reais do OrkMind Web no tema escuro

OrkMind Web em tema escuro: detalhe de uma memória com markdown estruturado, código e metadados — Telas reais do OrkMind Web no tema escuro

Dados para agentes, dados para humanos

Alguns dados de um sistema agêntico são para agentes lerem. Outros são para seres humanos. Cada metade do OrkMind serve a um dos dois, sem atrapalhar o outro.

Para agentes

Servidor MCP com 7 tools para runtimes de agentes
Provider de memória plugável no orquestrador
API idempotente com fila local: escrita nunca se perde
Contexto da factory com identidade e evidência

Para humanos

Escrever e revisar documentos persistentes
Localizar entidades, decisões e referências
Investigar relações sem furar permissões
Examinar produtos, projetos e iniciativas como conhecimento

coleções tipadas: 23
dimensões de contexto: 11
hosts com contrato comum: 4
identidade por registro: 1

Governança acima do adaptador

Da chamada do runtime ao disco, cada camada tem um dever só. É por isso que as garantias valem em qualquer backend.

runtimes

Quem consome

Claude Code
Codex
Hermes
OpenClaw
OrkMind Web

Quatro hosts e o workspace usam contratos oficiais; a identidade vem do transporte autenticado.

integrações

Como chega

Servidor MCP com 7 tools
Provider de memória
API idempotente
Company Brain B1

Adaptadores permanecem finos: regras de identidade, ACL, captura e consulta ficam nos núcleos.

semântica

Onde decide

Casamento exato de tags
Detectores de contexto
Orçamento de tokens
Camadas E1, E2, E3
Rerank RRF opcional
prod → proj → init

A SemanticLayer resolve o que entra no contexto: exato por padrão, semântico como aditivo.

governança

O que protege

Proteção de entradas
ACL por tags de acesso
Versionamento append-only
Ordenação constitucional
CAS e referências fixadas

A GovernedStore mora acima do adaptador: nenhum backend consegue afrouxar as garantias.

persistência

Onde vive

PostgreSQL + pgvector
memory (testes)
qdrant (opcional)
receipts + outbox

Persistência real inclui histórico, readback e reconciliação; fixture e fallback não fingem produção.

Do pip install ao primeiro recall

Cinco comandos separam um sistema esquecido de uma memória governada. Tudo aqui é real e roda hoje.

Instalar

O core vem do PyPI. Python 3.11 ou mais novo.

pip install orkmind

Configurar

Aponte para o PostgreSQL com pgvector, por variável ou por ~/.orkmind/config.toml.

export ORKMIND_DATABASE_URL="postgresql://<usuario>:<senha>@localhost:5432/orkmind"

Gravar e buscar

A CLI cobre o ciclo inteiro: gravar, listar, buscar por tags e inspecionar o store.

orkmind add --collection rule \
  --content "Nunca usar rm -rf em produção" \
  --tags '{"skill": ["deploy"]}' --mandatory

orkmind search --tags '{"skill": ["deploy"]}'

Plugar no runtime

No Claude Code, o servidor MCP expõe a memória como tools.

{
  "mcpServers": {
    "orkmind": {
      "command": "python",
      "args": ["-m", "orkmind.mcp"],
      "env": {
        "ORKMIND_DATABASE_URL": "postgresql://..."
      }
    }
  }
}

Abrir para humanos

O OrkMind Web sobe com Docker e serve a interface de navegação da memória. O repositório abre em breve.

git clone https://github.com/orkastery/orkmind-web
cd orkmind-web && docker compose up --build

Fale com quem faz o OrkMind

Dúvida técnica, proposta de uso ou vontade de contribuir: escreva. A resposta vem de gente, não de fila.

maestro@orkastery.com