LocalKeep

Tú decides qué recuerda Claude sobre ti. LocalKeep es una línea de tiempo personal que tú curas—bancos titulados, fechados y editables en tu máquina—luego Claude los consulta vía MCP en lugar de inventar memoria en la nube no editable.

GitHub
2
Prueba este MCPPatrocinado

Documentación

LocalKeep

LocalKeep es para cualquiera que quiera una capa de memoria cronológica para chatbots donde ellos controlen directamente qué recuerda el modelo sobre ellos. En lugar de obligarte a depender de una memoria en la nube de caja negra que el modelo inventa a tu alrededor y que ni siquiera puedes editar, LocalKeep te permite seleccionar bancos de memoria titulados, fechados y editables directamente en tu propia máquina, donde escribes las entradas y las gestionas localmente a través de una interfaz Hub en localhost. Cuando una conversación requiere tu contexto previo, Claude consulta tus datos locales a través de un conector seguro y nativo del Protocolo de Contexto de Modelo (MCP).

Por qué usar LocalKeep

Las aplicaciones de chat con IA son excelentes para sonar como si te recordaran, pero les cuesta recordar la exacta cosa que te importa: qué pasó, en qué fecha, ¿sobre quién? Las funciones de memoria para consumidores tienden a carecer de la capacidad para un razonamiento temporal real, aplanando tu historial en un resumen suave y genérico en lugar de entender que el Evento A desencadenó el Evento B hace tres meses, lo que hace que su razonamiento falle cuando necesitas algo específico: un evento de vida, un arco de investigación, una decisión que registraste hace meses. Peor aún, la memoria de IA para consumidores es una caja negra: no decides qué elige recordar el modelo sobre ti, cómo interpreta tu vida, o cuándo inventa contexto a tu alrededor.

LocalKeep corrige ambos defectos estructurales a la vez al reemplazar las líneas de tiempo frágiles e inventadas por el modelo con una fuente cronológica rígida de tu verdad, todo mientras te da a ti control editorial absoluto. Tú decides exactamente qué se le permite saber a la IA sobre ti. Tú escribes las entradas, anclas las fechas y las mantienes locales en tu propia máquina. Claude simplemente actúa como el motor de búsqueda a través de MCP cuando una conversación requiere tu contexto previo. LocalKeep une la brecha entre el registro personal estructurado y la recuperación inteligente de IA, asegurando que tu contexto sea seleccionado por ti, no alucinado por un LLM.

Para quién es

  • Cualquiera frustrado porque la memoria del chat no puede recuperar de manera confiable hechos fechados o entender líneas de tiempo
  • Personas que ya mantienen diarios personales meticulosos, registros de trabajo o archivos de investigación. En lugar de conformarte con un resumen genérico de una aplicación de chat, puedes inyectar tus exactas palabras y datos históricos en el prompt como una fuente de verdad inquebrantable.
  • Usuarios que confían en Claude por su capacidad de razonamiento, pero exigen que su base de datos de contexto fundamental permanezca almacenada localmente bajo su propio techo. (Nota: Consultar memorias a través de MCP aún envía los fragmentos de texto recuperados a Anthropic durante la sesión).

Qué es (y qué no es)

  • Es: Una interfaz Hub local ligera y personalizable para gestionar tus bancos de memoria fechados, junto con un servidor MCP que Claude Desktop puede llamar.
  • No es: Una aplicación de chat independiente, una API de memoria alojada en la nube, o una utilidad en segundo plano que extrae silenciosamente tus conversaciones personales.

La filosofía estética

La interfaz Hub adopta intencionalmente un homenaje retro inspirado en Windows 95/MS Paint con características personalizables para asegurar que LocalKeep se sienta como una herramienta profundamente personal en lugar de un panel rígido e impersonal. Al poner elementos de interfaz ajustables al alcance de tus dedos, la interfaz señala que estás entrando en un taller íntimo y sin conexión para tu mente: un espacio que puedes moldear y reconfigurar para que se sienta completamente tuyo.

Instalar

pip install localkeep
# or: uv tool install localkeep

Luego:

localkeep-hub          # http://127.0.0.1:8000

En Claude Desktop, registra el servidor MCP (claude_desktop_config.json):

{
  "mcpServers": {
    "localkeep": {
      "command": "localkeep-mcp",
      "args": []
    }
  }
}

Si la GUI no puede encontrar localkeep-mcp en tu PATH, usa la ruta absoluta de which localkeep-mcp (el panel de Conexión del Hub te la copia).

Las memorias se guardan por defecto en ~/.localkeep/localkeep.db cuando se instalan vía pip. Anula con LOCALKEEP_DATA_DIR o LOCALKEEP_DB_PATH.

Usar LocalKeep automáticamente (importante)

Claude no llamará de manera confiable a las herramientas MCP a menos que también configures Preferencias personales:

  1. Claude Desktop → Configuración → Perfil → Preferencias personales
  2. Pega las instrucciones de LocalKeep (Hub → Conectar → Copiar instrucciones, o consulta src/localkeep/assets/claude-personal-preferences.txt)
  3. Sal de Claude por completo y vuelve a abrirlo
  4. Cuando LocalKeep pida ejecutar una herramienta, haz clic en Aprobar siempre

Desarrollar desde el código fuente

git clone https://github.com/zuneracodes/localkeep
cd localkeep
uv sync --group dev
uv run localkeep-hub                     # http://127.0.0.1:8000
# optional live reload:
LOCALKEEP_HUB_RELOAD=1 uv run localkeep-hub

Desde un checkout del código fuente, la base de datos vive en data/localkeep.db (ignorada por git).

Pruebas

Estas verifican rápidamente el Hub, la recuperación y las herramientas MCP para que una instalación nueva aún almacene y recuerde memorias fechadas como lo haría un usuario real.

uv sync --group dev
uv run pytest

Las pruebas comienzan con una base de datos vacía y crean memorias a través de envíos de formularios del Hub (misma ruta que un usuario nuevo).

Privacidad

El almacenamiento es local. Los bancos y las memorias viven en la ruta de base de datos que elijas (~/.localkeep/ para instalaciones pip, o data/localkeep.db en un checkout). No hay nube de LocalKeep y nada se extrae automáticamente del chat. Los colores del tema permanecen en el localStorage del navegador. Refrescar la página del Hub o reiniciar localkeep-hub no elimina tus bancos; solo eliminar el archivo de base de datos lo hace.

La recuperación pasa por Claude. El Hub y la base de datos permanecen en tu máquina, pero cuando Claude llama a una herramienta MCP de LocalKeep, las memorias coincidentes se devuelven a ese chat y Anthropic las procesa como cualquier otro resultado de herramienta. LocalKeep no envía toda tu base de datos a la nube, solo lo que esa búsqueda devuelve para la pregunta en cuestión.

Contribuir

Los informes de errores y las solicitudes de extracción son bienvenidos a través de GitHub Issues. Por favor, ejecuta uv run pytest antes de abrir una PR.

Licencia

MIT — consulta LICENSE.