Repolode
Enviar
basicmachines-co

basicmachines-co/basic-memory

Capa de memoria local que permite a asistentes de IA como Claude y Cursor leer y escribir notas como archivos Markdown mediante MCP.

Ver en GitHubSitio web
Estrellas
4,509
Forks
352
Issues abiertos
76
Último commit
hace 20 horas

¿Qué es?

Basic Memory proporciona memoria persistente a los asistentes de IA. El conocimiento se almacena como archivos Markdown en tu disco; cada nota es una entidad con observaciones (hechos organizados en categorías entre corchetes) y relaciones (wikilinks a otras notas). Tanto tú como tu cliente de IA pueden leer, escribir y buscar en los mismos archivos, y los cambios que hagas en Obsidian o en un editor también se reflejan para el asistente.

El proyecto ofrece sus herramientas mediante Model Context Protocol, por lo que funciona con Claude Desktop, Claude Code, Codex CLI, Cursor, VS Code y cualquier otro cliente compatible con MCP. De forma predeterminada, usa un índice local de SQLite, con Postgres como backend alternativo. La búsqueda combina texto completo y clasificación semántica por vectores; además, un reranker cross-encoder opcional puede refinar los resultados.

También se ofrece una versión alojada en la nube para sincronizar entre dispositivos y crear copias de seguridad, pero la instalación local cuenta con licencia AGPL-3.0 y funciona sin servidor.

Funciones clave

  • 01Almacena el conocimiento como archivos Markdown sin formato, con wikilinks y frontmatter.
  • 02Funciona con cualquier cliente MCP, incluidos Claude, Codex, Cursor y VS Code.
  • 03Permite búsquedas por palabras clave, semánticas por vectores e híbridas en las notas.
  • 04Ofrece reranking opcional con cross-encoder para los resultados vectoriales e híbridos.
  • 05Incluye una CLI para gestionar proyectos, comprobar el estado, importar datos y acceder a las herramientas.
  • 06Se ejecuta localmente con SQLite y ofrece la opción de usar Postgres como backend.

Casos de uso

  • Mantener disponibles las decisiones de arquitectura y el contexto de un proyecto entre distintas sesiones de chat con IA.
  • Crear una base de conocimiento personal que tanto tú como tu asistente de IA puedan editar.
  • Importar conversaciones anteriores de Claude o ChatGPT a notas con búsqueda.
  • Usar Obsidian para editar notas que también mantiene un asistente de IA.

Inicio rápido

  1. 1

    Instala Basic Memory con uv

    uv tool install basic-memory --prerelease=allow
  2. 2

    Añade el servidor de Basic Memory a la configuración de tu cliente de IA (ejemplo para Claude Desktop)

  3. 3

    Reinicia tu cliente de IA y empieza a usarlo

Antes de usarlo

  • La instalación local requiere Python gestionado mediante uv.
  • Tiene licencia AGPL-3.0, una licencia copyleft que exige compartir el código fuente modificado cuando se ofrece como servicio de red.
  • Depende de una versión preliminar de FastMCP, por lo que se requiere la opción --prerelease=allow; de lo contrario, se instalará una versión anterior.

En colecciones

Servidores MCP para Claude CodeHerramientas, skills y plugins para Claude CodeServidores MCPHerramientas de privacidad y local-firstAgentes personales de IA open sourceGeneradores de sitios estáticos y herramientas de documentación

Temas

#ai#mcp#markdown#knowledge-management#local-first#llm#personal-agent#obsidian#claude#knowlege-graph

Preguntas frecuentes

¿Qué es basic-memory?
Capa de memoria local que permite a asistentes de IA como Claude y Cursor leer y escribir notas como archivos Markdown mediante MCP. Basic Memory proporciona memoria persistente a los asistentes de IA. El conocimiento se almacena como archivos Markdown en tu disco; cada nota es una entidad con observaciones (hechos organizados en categorías entre corchetes) y relaciones (wikilinks a otras notas). Tanto tú como tu cliente de IA pueden leer, escribir y buscar en los mismos archivos, y los cambios que hagas en Obsidian o en un editor también se reflejan para el asistente.
¿basic-memory es gratuito? ¿Qué licencia tiene?
basic-memory es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿basic-memory sigue mantenido?
Mantenimiento activo. El último commit de basic-memory fue el 6 nov 2026.
¿Para qué puedo usar basic-memory?
Mantener disponibles las decisiones de arquitectura y el contexto de un proyecto entre distintas sesiones de chat con IA. Crear una base de conocimiento personal que tanto tú como tu asistente de IA puedan editar. Importar conversaciones anteriores de Claude o ChatGPT a notas con búsqueda. Usar Obsidian para editar notas que también mantiene un asistente de IA.
¿Cómo se instala basic-memory?
Instala Basic Memory con uv: uv tool install basic-memory --prerelease=allow Añade el servidor de Basic Memory a la configuración de tu cliente de IA (ejemplo para Claude Desktop) Reinicia tu cliente de IA y empieza a usarlo
¿Dónde consigo basic-memory?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/basicmachines-co/basic-memory

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados