Repolode
Enviar
winstonkoh87

winstonkoh87/Athena-Public

Uma camada local de memória e decisão para agentes de IA, que armazena contexto em arquivos Markdown e JSONL sob seu controle e funciona com vários IDEs e LLMs.

Ver no GitHubSite
Estrelas
620
Forks
84
Issues abertas
0
Último commit
há 9 horas

O que é?

Athena mantém a memória do assistente de IA, a estruturação dos problemas e os registros de decisões no seu próprio disco, em arquivos Markdown e JSONL simples. Assim, o contexto continua disponível quando você troca de modelo ou editor. O projeto é instalado como pacote Python e disponibiliza suas funções por meio de dois servidores MCP: um para recuperação e governança e outro para consultas analíticas baseadas em DuckDB.

O projeto abrange várias áreas: busca híbrida que combina resultados de busca textual BM25 e pgvector com reranking por cross-encoder ONNX; um registro de estruturação de problemas com pré-registro de hipóteses e pontuação de calibração de Brier; e uma etapa de avaliação de decisões que calcula valor econômico esperado, dimensionamento de um terço de Kelly, probabilidade de ruína e resultados de Monte Carlo, com comprovantes SHA-256. Os hooks também bloqueiam determinados comandos destrutivos do shell e procuram segredos.

Athena funciona com Claude Code, Antigravity, Cursor, Gemini CLI, VS Code, Kilo Code e Roo Code por meio de arquivos de configuração específicos para cada IDE. O README inclui uma tabela que separa os recursos garantidos pelo código daqueles que dependem de prompts e informa Hit@5 de 0,569 na própria gold set de recuperação.

Recursos principais

  • 01Armazena memória e contexto em arquivos Markdown e JSONL simples no disco local.
  • 02Recuperação híbrida que combina busca textual BM25, pgvector e reranking por cross-encoder ONNX.
  • 03Registro de estruturação de problemas com hipóteses falsificáveis e pontuação de calibração de Brier.
  • 04Avaliação quantitativa de decisões para EEV, um terço de Kelly, ruína, MCDA e Monte Carlo, com comprovantes SHA-256.
  • 05Servidores MCP para recuperar memórias e consultar arquivos CSV, JSON e Parquet com DuckDB.
  • 06Hooks que bloqueiam determinados comandos destrutivos e procuram segredos.

Casos de uso

  • Manter consistente o contexto de um projeto para um assistente de programação com IA ao alternar entre Claude Code, Cursor ou Gemini CLI.
  • Registrar e revisar decisões estruturadas com premissas e critérios de refutação explícitos.
  • Consultar grandes conjuntos de dados CSV ou Parquet por meio de um agente LLM sem carregá-los na janela de contexto.
  • Adicionar hooks locais de governança às sessões de agentes de IA.

Início rápido

  1. 1

    Clone o repositório e acesse-o

    git clone https://github.com/winstonkoh87/Athena-Public.git && cd Athena-Public
  2. 2

    Crie e ative um ambiente virtual Python

    python3 -m venv .venv && source .venv/bin/activate
  3. 3

    Instale o pacote leve

    pip install -e ".[local]"
  4. 4

    Inicialize o Athena para sua IDE e execute a verificação de integridade

    athena init --ide claude && athena doctor

Antes de usar

  • As evidências sobre personalização de longo prazo vêm do uso de um único autor (N=1), não de um estudo com vários usuários.
  • Em IDEs sem hooks de ciclo de vida, algumas proteções contra bajulação ficam apenas a critério do agente.
  • A qualidade da recuperação é modesta: o Hit@5 estrito é de 0,569 no conjunto de referência do autor.
  • A instalação completa requer serviços de nuvem opcionais, como o Supabase para sincronização.

Em coleções

Memória de longo prazo para agentes de IAFrameworks e apps de agentes de IA open sourceServidores MCPFerramentas de privacidade e local-first

Tópicos

#ai-agents#memory#local-first#rag#mcp#llm#knowledge-management#semantic-search#ai#ai-assistant

Perguntas frequentes

O que é Athena-Public?
Uma camada local de memória e decisão para agentes de IA, que armazena contexto em arquivos Markdown e JSONL sob seu controle e funciona com vários IDEs e LLMs. Athena mantém a memória do assistente de IA, a estruturação dos problemas e os registros de decisões no seu próprio disco, em arquivos Markdown e JSONL simples. Assim, o contexto continua disponível quando você troca de modelo ou editor. O projeto é instalado como pacote Python e disponibiliza suas funções por meio de dois servidores MCP: um para recuperação e governança e outro para consultas analíticas baseadas em DuckDB.
Athena-Public é gratuito? Qual é a licença?
Athena-Public é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Athena-Public ainda é mantido?
Manutenção ativa. O último commit de Athena-Public foi em 6 de nov. de 2026.
Para que posso usar Athena-Public?
Manter consistente o contexto de um projeto para um assistente de programação com IA ao alternar entre Claude Code, Cursor ou Gemini CLI. Registrar e revisar decisões estruturadas com premissas e critérios de refutação explícitos. Consultar grandes conjuntos de dados CSV ou Parquet por meio de um agente LLM sem carregá-los na janela de contexto. Adicionar hooks locais de governança às sessões de agentes de IA.
Como instalar Athena-Public?
Clone o repositório e acesse-o: git clone https://github.com/winstonkoh87/Athena-Public.git && cd Athena-Public Crie e ative um ambiente virtual Python: python3 -m venv .venv && source .venv/bin/activate Instale o pacote leve: pip install -e ".[local]" Inicialize o Athena para sua IDE e execute a verificação de integridade: athena init --ide claude && athena doctor
Onde consigo Athena-Public?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/winstonkoh87/Athena-Public

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados