Omega Memory

OMEGA

Memória entre modelos para agentes de IA. Local-first. Funciona com Claude, GPT, Gemini, Cursor, Claw Code e qualquer cliente MCP. O cérebro do seu agente não deveria viver no servidor de outra pessoa, nem ficar preso a um único provedor.

O Problema

Agentes de codificação com IA são stateless. Cada nova sessão começa do zero. As "soluções" ou prendem você a um único provedor de modelo ou enviam o contexto do seu código para a nuvem deles.

• Perda de contexto. Agentes esquecem toda decisão, preferência e escolha arquitetural entre sessões. Desenvolvedores gastam de 10 a 30 minutos por sessão reexplicando contexto que já havia sido estabelecido.
• Erros repetidos. Sem aprender com sessões passadas, agentes cometem os mesmos erros repetidamente. Eles não lembram o que funcionou, o que falhou ou por que uma abordagem específica foi escolhida.
• Memória em nuvem = banco de dados de outra pessoa. Serviços como Mem0 exigem chaves de API e enviam seus dados para os servidores deles. Quando mudam os preços, são adquiridos ou saem do ar, a inteligência acumulada do seu agente desaparece.
• Aprisionamento ao fornecedor. A Memory Tool da Anthropic só funciona com Claude. A memória da OpenAI só funciona com GPT. Troque de modelo, perca sua memória.

OMEGA resolve isso. Memória, coordenação e aprendizado que rodam inteiramente na sua máquina. Funciona com todos os principais LLMs e agentes de codificação. Sem nuvem. Sem chaves de API. Sem aprisionamento ao fornecedor.

Instalação Rápida

pip install omega-memory[server]    # Full install (memory + MCP server)
omega setup                         # Downloads model, registers MCP, installs hooks
omega doctor                        # Verify everything works

Claude Desktop

pip install omega-memory[server]
omega setup --client claude-desktop

Isso registra OMEGA como um servidor MCP na configuração do Claude Desktop. Reinicie o Claude Desktop para ativar.

Cursor, Claw Code, Windsurf, Cline, Codex

pip install omega-memory[server]
omega setup --client cursor      # or: claw-code, windsurf, cline, codex

pip install omega-memory    # Core only, no MCP server process

from omega import store, query, remember

store("Always use TypeScript strict mode", "user_preference")
results = query("TypeScript preferences")

omega setup --hooks-only    # Auto-capture + memory surfacing, no MCP server (~600MB RAM saved)

A partir do Código-Fonte

git clone https://github.com/omega-memory/omega.git
cd omega
pip install -e ".[server,dev]"
omega setup

omega setup irá:

1. Criar o diretório ~/.omega/
2. Baixar o modelo de embeddings ONNX (~90 MB) para ~/.cache/omega/models/
3. Registrar omega-memory como servidor MCP (Claude Code detectado automaticamente, ou especifique --client)
4. Instalar hooks de sessão em ~/.claude/settings.json
5. Adicionar um bloco OMEGA a ~/.claude/CLAUDE.md

Guia Rápido de 60 Segundos

OMEGA funciona por linguagem natural — sem chamadas de API, sem configuração. Basta conversar com o Claude.

1. Diga ao Claude para lembrar de algo:

"Lembre que o sistema de autenticação usa tokens JWT, não cookies de sessão"

Claude armazena isso como uma memória permanente com embeddings semânticos.

2. Feche a sessão. Abra uma nova.

3. Pergunte sobre isso:

"O que eu decidi sobre autenticação?"

OMEGA traz a memória relevante automaticamente:

Found 1 relevant memory:
  [decision] "The auth system uses JWT tokens, not session cookies"
  Stored 2 days ago | accessed 3 times

É isso. As memórias persistem entre sessões, acumulam-se ao longo do tempo e são exibidas automaticamente quando relevantes — mesmo que você não pergunte explicitamente.

Principais Recursos

• Memória e Aprendizado — Armazena decisões, lições, padrões de erro e preferências com busca semântica. Claude lembra o que importa sem você reexplicar tudo a cada sessão. 25 ferramentas de memória, incluindo compactação, consolidação, linha do tempo, travessia de grafo e virtualização de contexto (checkpoint/resume).

• Coordenação Multi-Agente (omega-pro) — Bloqueio de arquivos e branches, gerenciamento de sessões, filas de tarefas com dependências, transmissão de intenções e mensagens entre agentes. 29 ferramentas de coordenação que impedem agentes de sobrescrever o trabalho uns dos outros.

• Roteamento Inteligente de LLM (omega-pro) — Classifica tarefas e roteia para o modelo ideal. Codificação → Claude Sonnet. Edição rápida → Llama 8b a 1/60 do custo. Contexto de 1M de tokens → Gemini Flash. 5 provedores, 4 modos de prioridade, classificação de intenção em menos de 2ms.

• Base de Conhecimento (omega-pro) — Ingira PDFs, markdown, páginas web e arquivos de texto em uma base de conhecimento pesquisável com chunking semântico.

• Registro de Entidades (omega-pro) — Memória corporativa multi-entidade com relacionamentos, hierarquias e memórias/perfis/documentos com escopo por entidade.

• Perfil Seguro (omega-pro) — Armazenamento de dados pessoais criptografado com AES-256 e integração com o Keychain do macOS.

Como OMEGA se Compara

A Memory Tool da Anthropic armazena dados no lado do cliente, mas exige chamadas de API do Claude para todas as operações de memória. OMEGA roda inteiramente no dispositivo, incluindo embeddings (ONNX).

Anthropic Memory é para Anthropic. OMEGA é para todos.

Arquitetura

     Claude Code  ·  Cursor  ·  Claw Code  ·  Any MCP Client
               │         │         │              │
               └─────────┴─────┬───┴──────────────┘
                               │ stdio/MCP
               ┌───────────────▼─────────────┐
               │   OMEGA MCP Server   │
               │   25 core tools      │
               └──┬──────────────────┘
                  │
         ┌────────▼──────────────┐
         │ Core Memory Engine    │
         │ (semantic search,     │
         │  embeddings, graphs)  │
         └─────┬─────────────────┘
               │
               ▼
         ┌──────────────────────────────────────┐
         │         omega.db (SQLite)             │
         │  memories | edges | embeddings        │
         └──────────────────────────────────────┘

Banco de dados único, handlers modulares. Módulos opcionais (coordenação, roteador, entidade, conhecimento, perfil) estão disponíveis via omega-pro e se registram no mesmo processo do servidor. Sem daemons separados, sem microsserviços.

Referência de Ferramentas MCP

OMEGA roda como um servidor MCP dentro do Claude Code. O pacote principal fornece 25 ferramentas de memória. omega-pro adiciona ferramentas de coordenação, roteamento, entidade, conhecimento e perfil.

Memória (25 ferramentas)

Ferramentas adicionais com omega-pro

CLI

Solução de Problemas

omega doctor mostra FAIL na importação:

• Garanta pip install -e ".[server]" a partir da raiz do repositório
• Verifique se python3 -c "import omega" funciona

O servidor MCP falha ao iniciar:

• Execute pip install omega-memory[server] (o extra [server] inclui o pacote MCP)

Servidor MCP não registrado:

claude mcp add omega-memory -- python3 -m omega.server.mcp_server

Hooks não disparando:

• Verifique se ~/.claude/settings.json tem entradas de hooks OMEGA
• Verifique ~/.omega/hooks.log para erros

Desenvolvimento

pip install -e ".[server,dev]"
pytest tests/                # 2198+ tests
ruff check src/              # Lint

Desinstalação

claude mcp remove omega-memory
rm -rf ~/.omega ~/.cache/omega
pip uninstall omega-memory

Remova manualmente as entradas OMEGA de ~/.claude/settings.json e o bloco <!-- OMEGA:BEGIN --> de ~/.claude/CLAUDE.md.

Contribuindo

• Guia de Contribuição
• Política de Segurança
• Changelog
• Reportar um Bug

Licença

Apache-2.0. Veja LICENSE.