afair

Cada IA que usas recuerda una versión diferente de ti. Lo que una aprende desaparece cuando abres la siguiente, así que repites las mismas decisiones, relaciones, preferencias e historia al comienzo de otra sesión.

afair les da una bóveda compartida. Se conecta a través del Model Context Protocol (MCP), de modo que la misma memoria está disponible en Claude, tu agente de codificación y lo que sea que uses a continuación.

Una memoria en crecimiento normalmente se convierte en otra cosa que mantener. afair elimina ese trabajo. Los agentes en segundo plano leen lo que tus herramientas registran, descubren qué va junto, mantienen actualizada la comprensión útil y dejan que el ruido antiguo se desvanezca de la atención. La estructura sigue tu vida en lugar de una plantilla fija. No la archivas, etiquetas ni seleccionas.

El resultado sigue siendo visible. Puedes leer lo que afair cree, rastrearlo hasta la fuente y corregirlo cuando no te entienda bien. Las correcciones pasan a formar parte del historial en lugar de reemplazarlo silenciosamente.

Lo que entra es tu vida entera: tu trabajo, las personas que amas y las cosas personales que preferirías que una IA simplemente supiera.

Los datos son de solo añadidura y tuyos. afair es de código abierto y de un solo inquilino, y puedes exportarlo todo cuando quieras. El nombre es una abreviatura de «as far as I remember», la muletilla que está diseñado para hacer innecesaria.

Dos formas de usarlo

Ejecútalo tú mismo. Este repositorio es todo, AGPLv3. Alójalo en tu propia máquina o servidor y serás dueño de cada capa de principio a fin. Es gratis, para siempre. La guía de inicio rápido está abajo.

O deja que afair.ai lo ejecute por ti. El alojamiento gestionado, con tu propia instancia aislada en la UE, copias de seguridad, exportación y actualizaciones gestionadas por nosotros, estará disponible pronto. Únete a la lista de acceso anticipado en afair.ai.

El mismo código en ambos casos. El producto alojado es un despliegue de este repositorio, no un fork propietario separado.

Related MCP server: Hippocampus

Los tres comandos

afair expone exactamente tres herramientas, y están congeladas para siempre:

• remember guarda algo duradero: una decisión, una persona importante, una fecha que no puedes perderte, una preferencia.

• recall recupera lo que es relevante para el momento.

• observe registra lo que acaba de hacer la IA, para que la bóveda se mantenga al día.

Una vez que le des a tu IA el breve fragmento de configuración, ella los llama por su cuenta. Nada llega a la bóveda a menos que una llamada lo ponga allí.

Ejecútalo tú mismo

Requiere Python 3.12+ y uv.

uv sync
cp .env.example .env
# add ANTHROPIC_API_KEY, or a key for any other provider (the model is yours to pick)
uv run python -m afair

El servidor se levanta en http://127.0.0.1:8765. Apunta un cliente CLI o de escritorio (Claude Code, Codex, Cursor, GitHub Copilot) hacia él, conéctalo y listo. Los clientes web que se ejecutan en la nube (Claude.ai, ChatGPT) necesitan en cambio un despliegue HTTPS público y una configuración rápida de OAuth, cubiertos en docs/self-hosting.md. Cada variable de entorno está documentada en línea en .env.example; las guías de conexión por cliente se encuentran en docs/clients. afair es personal por defecto; una bóveda puede en cambio pertenecer a una sola organización (una instancia, un equipo) mediante dos variables de entorno (ver docs/self-hosting.md).

Instálalo con tu agente de codificación

¿Ya estás en Claude Code, Codex u otro agente de codificación? Dale el prompt siguiente y él mismo se configura: clonar, dependencias, configuración y el cableado de MCP, y luego demuestra el viaje de ida y vuelta.

Configura afair (el servidor de memoria MCP de código abierto en https://github.com/afairai/afair) en esta máquina y conecta esta herramienta a él. Clónalo, ejecuta uv sync, copia .env.example a .env, y pídeme una clave API de proveedor de LLM para ponerla allí. Luego ejecuta uv run python scripts/install_clients.py para conectar mis clientes MCP y añadir el fragmento de instrucción de afair. Dime el comando para iniciar el servidor (uv run python -m afair) y cómo mantenerlo en funcionamiento. Una vez que esté arriba, recuerda un dato de prueba y recupéralo para demostrar que funciona. Sigue docs/self-hosting.md y docs/clients/; pon mi clave API solo en .env, en ningún otro sitio.

Eso se ejecuta localmente y sirve a clientes CLI y de escritorio de forma inmediata. Para llegar a los clientes web (Claude.ai, ChatGPT), sigue las notas de despliegue público en docs/self-hosting.md.

Enseña a tu IA a usarlo

Conectar el servidor es la mitad; la otra mitad es hacer que tu IA use las herramientas por sí sola. Pega el breve fragmento de instrucción en las instrucciones persistentes del cliente (CLAUDE.md, AGENTS.md, instrucciones personalizadas o .cursorrules), y recordará el contexto al inicio de una conversación, guardará lo duradero y observará lo que hace, sin que tengas que pedírselo cada vez. El mismo fragmento funciona para todos los clientes. Para Claude Code, Codex y Cursor, scripts/install_clients.py escribe tanto la configuración de conexión como el fragmento por ti; para GitHub Copilot escribe la configuración de conexión e imprime el único fragmento por repositorio (Copilot lee las instrucciones por espacio de trabajo).

Compatible con

Claude Code, Claude.ai, ChatGPT, Codex CLI, Cursor, Windsurf, Copilot y cualquier otra cosa que hable MCP sobre Streamable HTTP.

Arquitectura

Cuatro capas, una única fuente de verdad:

• Sustrato. SQLite de solo añadidura con FTS5 y sqlite-vec, direccionado por contenido. El registro nunca se reescribe.

• Interpretación. Vistas versionadas construidas sobre el sustrato. Regéneralas sin tocar ni un solo evento almacenado.

• Superficie MCP. Versionada y aditiva. Una firma que se ha publicado sigue funcionando.

• Agentes. Los trabajadores en segundo plano extraen evidencia, descubren qué va junto y mantienen síntesis vivas con citas. Los nombres y límites de los clústeres pueden cambiar a medida que cambia la evidencia. El usuario nunca define una categoría.

El diseño completo y los ocho invariantes que lo mantienen unido se encuentran en VISION.md. Empieza allí si quieres saber el porqué.

Documentación

Contribuciones

Las pull requests son bienvenidas. Lee CONTRIBUTING.md para la configuración, las comprobaciones que deben pasar y los invariantes que un cambio no puede romper. ¿Has encontrado un problema de seguridad? Consulta SECURITY.md e infórmalo en privado.

Licencia

afair se publica bajo la GNU Affero General Public License v3.0 (LICENSE). Puedes autoalojarlo, bifurcarlo y modificarlo libremente. Si ejecutas una versión modificada como servicio de red para otros, publicas tus cambios bajo la misma licencia. La oferta alojada en afair.ai es un despliegue de este código, no un fork propietario separado.

En una línea: gratis de usar, gratis de autoalojar, comparte si lo ejecutas como servicio para otros.

Hecho en Alemania

Construido en Alemania. Las instancias alojadas se ejecutan en la UE, bajo la jurisdicción de la UE.