Solitaire: Camada de Identidade de Código Aberto para Agentes de IA Construída com Claude Code

Solitaire é um projeto de código aberto que fornece uma camada de identidade para agentes de IA, desenvolvido principalmente usando Claude Code como ambiente de desenvolvimento. Diferente de ferramentas de memória de agentes que focam em recordação, o Solitaire aborda como os agentes trabalham com usuários ao longo do tempo, visando ir além do que o criador descreve como "um estranho inteligente com um caderno melhor".

Principais Recursos e Arquitetura

O sistema está em produção desde fevereiro, com a versão atual moldada por mais de 600 sessões e mais de 15.700 entradas em uso real. As principais decisões arquitetônicas surgiram da observação de modos de falha e da correção de problemas reais:

• Arquitetura de servidor MCP e sistema de hooks projetados em torno de como o Claude Code lida com chamadas de ferramentas e estado de sessão
• Ponderação de recuperação que se ajusta com base no que realmente se mostrou útil na prática
• Estrutura de inicialização e compilação de persona refinadas através do uso em produção
• Grafo de conhecimento autocorretivo com detecção de contradições, reavaliação de confiança e religação de entidades
• Contexto de inicialização em camadas para que os agentes cheguem informados, não em branco

Sistema de Identidade e Comportamento

O sistema de identidade do Solitaire evolui através da interação real, não por configuração estática:

• Traços de disposição (calor, assertividade, convicção, observância) são compilados a partir de padrões de interação e evoluem entre sessões
• A persona e a identidade comportamental se desenvolvem a partir do uso real, não da edição de arquivos de configuração
• Resíduos de sessão carregam como o trabalho foi sentido, não apenas o que foi discutido
• Novos usuários recebem uma integração guiada que constrói o parceiro através da conversa - escolha um nome, descreva necessidades, e o sistema monta a persona a partir das respostas (sem YAML necessário)

Design Local-First

A abordagem local-first é não negociável no design:

• Todos os armazenamentos são SQLite + JSONL no seu diretório de trabalho
• Zero requisições de rede do motor principal
• Sem dependência de nuvem, sem telemetria, sem chamadas de API externas para operações de memória
• Backups automáticos rotativos sem configuração necessária
• Seus dados permanecem na sua máquina

Instalação e Compatibilidade

Instale via pip install solitaire-ai (nota: não install solitaire, que é um pacote não relacionado). O projeto é construído para Claude Code primeiro, mas suporta outras plataformas de agentes. É agnóstico de memória - funciona com camadas de memória existentes ou fornece uma se necessário.

Licença e Disponibilidade

Livre e de código aberto sob AGPL-3.0, com licenciamento comercial disponível para incorporação proprietária. Disponível no PyPI e no MCP Registry. Dois artigos de pesquisa do trabalho longitudinal estão atualmente em revisão.