Repolode
basicmachines-co

basicmachines-co/basic-memory

Локальный слой памяти: AI-ассистенты, например Claude и Cursor, могут читать и записывать заметки в обычных Markdown-файлах через MCP.

Звёзды
4,509
Форки
352
Открытые issues
76
Последний коммит
8 часов назад

Что это?

Basic Memory добавляет AI-ассистентам постоянную память. Знания хранятся в Markdown-файлах на вашем диске: каждая заметка представляет собой сущность с наблюдениями (фактами в квадратных скобках с указанием категории) и связями (wikilinks на другие заметки). Вы и ваш AI-клиент можете читать, записывать и искать в одних и тех же файлах, а изменения, внесённые в Obsidian или редакторе, становятся видны и ассистенту.

Инструменты проекта доступны через Model Context Protocol, поэтому он работает с Claude Desktop, Claude Code, Codex CLI, Cursor, VS Code и любым другим MCP-совместимым клиентом. По умолчанию используется локальный индекс SQLite, а в качестве альтернативы доступен Postgres. Поиск сочетает полнотекстовое ранжирование и семантическое ранжирование по векторам; при желании результаты можно уточнить с помощью cross-encoder reranker.

Также доступна облачная версия с синхронизацией между устройствами и резервным копированием, но локальная версия распространяется по лицензии AGPL-3.0 и работает без сервера.

Ключевые возможности

  • 01Хранит знания в обычных Markdown-файлах с wikilinks и frontmatter.
  • 02Работает с любым MCP-клиентом, включая Claude, Codex, Cursor и VS Code.
  • 03Поддерживает поиск по ключевым словам, семантический векторный и гибридный поиск по заметкам.
  • 04Предусмотрено дополнительное ранжирование cross-encoder для результатов векторного и гибридного поиска.
  • 05Включает CLI для управления проектом, проверки состояния, импорта и доступа к инструментам.
  • 06Работает локально на SQLite; также можно использовать Postgres.

Сценарии использования

  • Сохранять решения по архитектуре и контекст проекта между сессиями общения с AI.
  • Создать личную базу знаний, которую могут редактировать и вы, и ваш AI-ассистент.
  • Импортировать прошлые диалоги из Claude или ChatGPT в заметки с возможностью поиска.
  • Использовать Obsidian для редактирования заметок, которые также ведёт AI-ассистент.

Быстрый старт

  1. 1

    Установите Basic Memory с помощью uv

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

    Добавьте сервер Basic Memory в конфигурацию AI-клиента (пример для Claude Desktop)

  3. 3

    Перезапустите AI-клиент и начните работу

Что важно знать

  • Для локальной установки требуется Python, управляемый через uv.
  • Лицензия AGPL-3.0 — лицензия с копилефтом, которая требует предоставлять исходный код изменений при использовании в качестве сетевого сервиса.
  • Зависит от предварительной версии FastMCP, поэтому требуется флаг --prerelease=allow. Иначе будет установлена более старая версия.

В подборках

Темы

Частые вопросы

Что такое basic-memory?
Локальный слой памяти: AI-ассистенты, например Claude и Cursor, могут читать и записывать заметки в обычных Markdown-файлах через MCP. Basic Memory добавляет AI-ассистентам постоянную память. Знания хранятся в Markdown-файлах на вашем диске: каждая заметка представляет собой сущность с наблюдениями (фактами в квадратных скобках с указанием категории) и связями (wikilinks на другие заметки). Вы и ваш AI-клиент можете читать, записывать и искать в одних и тех же файлах, а изменения, внесённые в Obsidian или редакторе, становятся видны и ассистенту.
basic-memory можно использовать бесплатно? Какая у него лицензия?
basic-memory распространяется с открытым исходным кодом под лицензией AGPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
basic-memory всё ещё поддерживается?
Активно поддерживается. Последний коммит в basic-memory — 6 нояб. 2026 г..
Для чего можно использовать basic-memory?
Сохранять решения по архитектуре и контекст проекта между сессиями общения с AI. Создать личную базу знаний, которую могут редактировать и вы, и ваш AI-ассистент. Импортировать прошлые диалоги из Claude или ChatGPT в заметки с возможностью поиска. Использовать Obsidian для редактирования заметок, которые также ведёт AI-ассистент.
Как установить basic-memory?
Установите Basic Memory с помощью uv: uv tool install basic-memory --prerelease=allow Добавьте сервер Basic Memory в конфигурацию AI-клиента (пример для Claude Desktop) Перезапустите AI-клиент и начните работу
Где скачать basic-memory?
Исходный код и инструкции по установке — на GitHub: https://github.com/basicmachines-co/basic-memory

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Aiden — автономный движок с открытым исходным кодом, который планирует многоэтапные задачи, работает с файлами, терминалом, браузером, приложениями и API, а затем проверяет результат.

874+9 за неделю150TypeScriptAGPL-3.0Активно поддерживаетсяОбновлён 18 дней назад