Локальный индексатор Markdown-заметок: учитывает папки, теги и ссылки, чтобы Claude Code или Codex могли искать в них по смыслу.
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
Установите Basic Memory с помощью uv
uv tool install basic-memory --prerelease=allow - 2
Добавьте сервер Basic Memory в конфигурацию AI-клиента (пример для Claude Desktop)
- 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 обновляется ежедневно.
Похожие проекты
Стартовое хранилище, руководство, навыки и скрипты для AI-агента, который создаёт и поддерживает связанную базу знаний в Markdown в Claude Code и Obsidian.
Локальный слой памяти и принятия решений для AI-агентов: хранит контекст в принадлежащих вам файлах Markdown и JSONL и работает с разными IDE и LLM.
MCP-сервер, который позволяет AI-ассистентам читать, искать, дополнять и удалять заметки в хранилище Obsidian через плагин Local REST API.
Aiden — автономный движок с открытым исходным кодом, который планирует многоэтапные задачи, работает с файлами, терминалом, браузером, приложениями и API, а затем проверяет результат.
Постоянная память для Claude Code, Codex и других AI-агентов в виде обычных Markdown-файлов в хранилище Obsidian.