athena-public

Athena es un sistema de gestión de conocimiento personal (PKM) agéntico y local-first diseñado para ayudar a los usuarios a tomar mejores decisiones utilizando su propio contexto. Proporciona memoria persistente, razonamiento estructurado y agentes de IA gobernados que funcionan con cualquier proveedor de LLM, incluidos ChatGPT, Claude, Gemini y otros. ## Concepto Central Athena traslada la capa de memoria de plataformas alojadas en la nube a la máquina local del usuario. Todo el contexto (historial de sesiones, protocolos de decisión, preferencias personales y patrones aprendidos) se almacena como archivos Markdown planos en el disco del usuario. Estos archivos son totalmente legibles, editables y controlables por versiones mediante git. El modelo de IA utilizado es intercambiable; solo la capa de datos pertenece al usuario. ## Características Clave - **Memoria Persistente**: El contexto se acumula a lo largo de miles de sesiones. La sesión 500 recuerda patrones de la sesión 5. La memoria no se pierde entre cambios de modelo o proveedor. - **Almacenamiento Local-First**: Todos los datos viven como archivos Markdown en la máquina del usuario, no en la nube de ningún proveedor. Los usuarios pueden inspeccionar, editar y bifurcar su propio contexto en cualquier momento. - **Independiente del Modelo**: La misma memoria funciona con ChatGPT, Claude, Gemini, Grok y otros modelos. La memoria persiste; el modelo es simplemente quien esté de turno. - **Ventanas de Contexto Escalables**: Tres modos de arranque se adaptan a la complejidad de la tarea: chat ligero (~2K tokens), arranque completo (~10K tokens) y arranque profundo (~20K tokens). La mayor parte de la ventana de contexto permanece libre incluso después de miles de sesiones. - **Razonamiento Meta-Juego**: Athena aplica marcos de razonamiento estructurado que cuestionan si el usuario debería perseguir un objetivo determinado, en lugar de solo optimizar dentro de un marco asumido. - **Autonomía Gobernada**: Seis leyes constitucionales y cuatro niveles de capacidad definen una agencia acotada. La Ley #1 (Sin Ruina Irreversible) puede anular la preferencia del usuario en caminos que podrían terminar el juego permanentemente. - **RAG Híbrido**: Combina búsqueda semántica con recuperación por palabras clave y reordenamiento para un recuerdo preciso de la memoria. - **Tareas Programadas y Auto-RSI**: Admite operaciones recurrentes automatizadas y flujos de trabajo de mejora recursiva. ## Cómo Funciona Cada sesión sigue un ciclo con tres modos: - **Modo Ligero** (solo `/end`): Chat rápido y volcados de ideas sin carga completa de contexto. - **Modo de Arranque Completo** (`/start` → trabajo → `/end`): Inicialización completa del contexto para código, decisiones financieras, arquitectura y elecciones irreversibles. - **Modo de Arranque Profundo** (`/ultrastart` → trabajo → `/ultraend`): Contexto máximo para análisis complejo de múltiples dominios y tareas de razonamiento profundo. Con el tiempo, el sistema se vuelve más capaz mediante la acumulación: recuerdo básico en las sesiones 1–50, reconocimiento de patrones entre 50–200 y sincronización profunda más allá de 200 sesiones, donde el sistema anticipa marcos antes de que se enuncien. ## Configuración Athena funciona en macOS, Windows y Linux. La instalación requiere clonar el repositorio, opcionalmente crear un entorno virtual de Python y abrir la carpeta en un IDE habilitado para IA como Cursor, VS Code con Copilot, Claude Code, Antigravity o Gemini CLI. No se requieren claves API ni configuración de base de datos para comenzar. ## Filosofía de Arquitectura El espacio de trabajo contiene cientos de archivos Markdown pequeños en lugar de unos pocos documentos grandes. Este diseño permite carga JIT (justo a tiempo), recuperación quirúrgica por nombre de archivo o búsqueda semántica, cero acoplamiento entre dominios y diffs de git limpios, optimizando para consultas de agentes en lugar de lectura humana. El sistema se distingue de la memoria de plataforma (OpenAI, Google, Anthropic) al dar a los usuarios propiedad total, capacidad de inspección, portabilidad entre plataformas e historial de versiones completo, mientras permanece de código abierto bajo la licencia MIT.