Пропустите установку — попробуйте Basic Memory в облаке

Claude, Codex или Cursor подключаются за 30 секунд. Без Python, без JSON, без терминала. $15.00/мес. закреплено навсегда (12.50/мес. по годовой тарификации). 7-дневная бесплатная пробная версия — отменяйте в любой момент до дня 7, если это не для вас. Бета-цены — регистрируйтесь сейчас, и ваша ставка не поднимется. Пользователи OSS: код BMFOSS дополнительно даёт скидку 20% на 3 месяца.

Начать бесплатную пробную версию →

Basic Memory Teams теперь доступен!

Дайте вашей команде единое совместное облачное рабочее пространство. Знания больше не ограничиваются одним человеком — всё, что написал коллега, мгновенно доступно всем остальным и их искусственным интеллектам.

Редактируйте заметку совместно в реальном времени, передавайте работу между людьми и агентами, и создайте одну связанную базу знаний вместо разбросанных копий. Та же тарификация — начните с одного пользователя и при необходимости добавляйте больше.

---

Basic Memory

Ваш ИИ никогда не забудет снова.

Продолжайте там, где остановились — в Claude, Codex, Cursor, ChatGPT или любом клиенте, который поддерживает MCP. Ваши знания хранятся в виде файлов Markdown, которые и вы, и ваш ИИ можете читать, писать и искать.

• Локальная первоочередность. Простой текст на вашем диске. Навсегда.
• Двусторонняя работа. ИИ и люди пишут в одни и те же файлы; синхронизация держит их в синхроне.
• Настоящая графовая база знаний. Наблюдения и wikilinks накапливаются в контекст.
• Семантический поиск. Поиск заметок по смыслу, а не только по ключевым словам, с опциональной переклейкой кросс-кодировщиком для более качественных векторов и гибридных результатов.
• MCP-native. Работает с любым крупным клиентом ИИ и IDE.
• Прогрессивное обнаружение инструментов. Каждый инструмент помечен подсказками поведения (только для чтения, разрушительный, идемпотентный), чтобы агенты выбирали нужный инструмент по запросу — без излишнего контекста, пытаясь понять, что они делают.
• Облачное, по желанию. Синхронизация между устройствами по желанию — нигде не требуется.

Что выбрать

Выберите путь, который подходит именно вам. Оба варианта запускают один и тот же продукт на одной и той же Markdown-структуре.

☁️ Облако	💻 Локальная установка
30 секунд. Зарегистрируйтесь, подключите клиента AI, готово. Работает в любом браузере. Мобильное, веб, настольное. Синхронизация между устройствами встроена. Мы обеспечиваем хостинг, бэкапы, снимки.	2 минуты. Установите, настройте вашего AI-клиента, запустите. Бесплатно навсегда (AGPL-3.0). Все данные на вашем диске. Поддержка воздушной среды. Требуется Python via uv
Цена: $15.00/мес., закреплена на время подписки · 7-дневная пробная версия · отмена в любой момент	Цена: Бесплатно
Хранение: Мы размещаем (Tigris S3)	Хранение на вашем диске
Синхронизация между устройствами: встроена	Синхронизация вручную (Git, Syncthing и т. п.)
Мобильный доступ: Да (веб + приложение)	Нет
Воздушно-изолированная среда: Нет	Да
Ваши данные остаются вашими: Да — экспортируйте в любой момент	Да — уже на месте
Исходный код: AGPL-3.0	AGPL-3.0
Снимки и бэкапы: Встроено	Делайте сами

Оба пути используют один и тот же OSS-движок и одни и те же файлы Markdown. Нет привязки к одному варианту — переключайтесь в зависимости от ваших потребностей.

Совместимость с инструментами, которые вы уже используете

Клиент	Транспорт	Примечания
Облачное веб-приложение	https	Вход на basicmemory.com — без установки
Claude Desktop	stdio/https	macOS / Windows / Linux
Claude Code	stdio/https	claude mcp add
Codex	stdio/https	Кодирующий агент OpenAI
Cursor	stdio/https	.cursor/mcp.json
VS Code	stdio/https	Встроенная поддержка MCP
ChatGPT	https	Встроенные действия Custom GPT (поиск / получение)
Obsidian	—	Читает и пишет те же Markdown напрямую в граф
Любой MCP	stdio/https	Если поддерживает MCP, работает

Официальные пакеты агентов

Этот репозиторий — канонический дом Basic Memory для нативных агентов на хосте. Основной пакет Python, плагин Claude Code, общие навыки, плагин Hermes и плагин OpenClaw поставляются из одного исходника.

• Выполнить полный обзор поверхностей можно из корня репозитория:

just package-check

• Локальные пакет-задачи доступны и для конкретного хоста:

just package-check-claude-code
just package-check-skills
just package-check-hermes
just package-check-openclaw

Claude Code плагин

Плагин Claude Code — мост между рабочей памятью Claude и Basic Memory — сессии запуска, контрольные точки перед сжатием, настраиваемый стиль вывода захвата и команды /basic-memory:bm-setup · :remember · :share · :status.

Сначала подключите сервер MCP Basic Memory — см. Connect your AI client. Хуки плагина и навыки обращаются к нему, поэтому это обязательное prerequisite. Затем добавьте marketplace и установите:

claude plugin marketplace add basicmachines-co/basic-memory \
  --sparse .claude-plugin plugins/claude-code
claude plugin install basic-memory@basicmachines-co

Источник: plugins/claude-code.

Общие навыки

Фреймворк-агностичные файлы SKILL.md находятся в skills/. Если ваша Skills CLI поддерживает источники поддиректорий репозитория:

npx skills add basicmachines-co/basic-memory/skills

Если ваша установленная Skills CLI не может загрузить этот источник, обновите CLI или скопируйте директории memory-* из skills/ в директорию навыков вашего агента.

Hermes

Hermes сохраняет нативную форму плагина в integrations/hermes:

hermes plugins install basicmachines-co/basic-memory --path integrations/hermes

Если ваша сборка Hermes не поддерживает поддиректоры, используйте окончательную устаревшую указательную подпись

basicmachines-co/hermes-basic-memory до того, как появится поддержка хоста.

OpenClaw

OpenClaw остаётся пакетно-нативным и публикуется из

integrations/openclaw:

openclaw plugins install @basicmemory/openclaw-basic-memory

Подхватите там, где остановились

https://github.com/user-attachments/assets/a55d8238-8dd0-454a-be4c-8860dbbd0ddc

Подключите вашего AI-клиента

Если вы выбрали путь через Облако, веб-приложение проведёт вас через настройку подключения клиента. Ниже приведены фрагменты для локальной установки.

Claude Desktop

Измените файл конфигурации: ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["basic-memory", "mcp"]
    }
  }
}

Перезапустите Claude Desktop. Заметки будут храниться по умолчанию в ~/basic-memory.

Claude Code, Codex CLI, Cursor, VS Code, ChatGPT, Obsidian

Claude Code

claude mcp add basic-memory -- uvx basic-memory mcp

Для полного моста памяти — сессии строения, контрольные точки перед сжатием и

команды /basic-memory:* — также установите Claude Code плагин поверх этого.

Codex CLI

Добавьте в ~/.codex/config.toml:

[mcp_servers.basic-memory]
command = "uvx"
args = ["basic-memory", "mcp"]

Codex может сохранить своё поведение утверждения MCP по умолчанию, или вы можете заранее одобрять доступные Basic Memory инструменты, добавив настройку для сервера в ту же таблицу:

[mcp_servers.basic-memory]
command = "uvx"
args = ["basic-memory", "mcp"]
default_tools_approval_mode = "approve"

Это не выключает утверждения Codex глобально и не расширяет, какие проекты Basic Memory сервер может получить доступ. Codex всё ещё требует одобрения для инструментов с пометкой разрушительности, включая записи Basic Memory, редактирование и удаление. Если вы установили плагин Codex для Basic Memory, используйте его конфигурацию на уровне плагина.

Cursor

Добавьте в .cursor/mcp.json (проект) или ~/.cursor/mcp.json (глобально):

{
  "mcpServers": {
    "basic-memory": {
      "command": "uvx",
      "args": ["basic-memory", "mcp"]
    }
  }
}

VS Code

Добавьте в настройки пользователя (JSON):

{
  "mcp": {
    "servers": {
      "basic-memory": {
        "command": "uvx",
        "args": ["basic-memory", "mcp"]
      }
    }
  }
}

ChatGPT

Basic Memory предоставляет инструменты совместимого с OpenAI search и fetch для действий Custom GPT. См. руководство по интеграции с ChatGPT.

Obsidian

Без настройки. Укажите Obsidian путь к ~/basic-memory (или к вашей папке проекта) — те же wikilinks, frontmatter и Markdown, которые пишет ваш AI, появятся в представлении графа. Редактируйте обе стороны — синхронизация сделает остальное.

Попробуйте запрос:

"Create a note about our project architecture decisions."
"Find information about JWT auth in my notes."
"What have I been working on this week?"

Что нового

• Автоматические обновления. Basic Memory поддерживает обновления для uv tool и установок Homebrew; bm update инициирует ручную проверку.

• Семантический поиск векторами. Поиск заметок по смыслу, а не только по ключевым словам. Гибридный полнотекстовый + векторный ранжиринг с использованием FastEmbed на SQLite или Postgres.

• Опциональный повторный ранжирователь поиска. Пересчитывает релевантность самых сильных кандидатов локальным кросс-энкодером FastEmbed или провайдером на базе LiteLLM.

• Схема базы знаний. Выводит структуру базы знаний и сравнивает её — с помощью schema_infer, schema_validate, schema_diff.

• Маршрутизация через облако per-project. Маршрутизация отдельных проектов через облако через API-key.

• Умнее редактирование. edit_note автоматически создаёт заметки, когда они отсутствуют; write_note защищает от непреднамеренного перезаписывания.

• Расширенные результаты поиска. Включается текст найденного фрагмента, чтобы контекст был доступен LLM, а не только совпадения.

• FastMCP 3.0 + аннотации инструментов. Каждый инструмент снабжен подсказками поведения MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), чтобы агенты постепенно открывали возможности во время выполнения, не гадать и не тратить токены.

• CLI-реформа. Вывод --json для скриптов, команды, учитывающие рабочее пространство, и панель проекта, вдохновлённая htop.

Полный CHANGELOG для v0.18 → v0.20.

Опциональный cross-encoder reranking

Повторная оценка добавляет второй этап релевантности после векторного или гибридного извлечения. Включается по умолчанию локальным поставщиком FastEmbed, иначе — через конфигурацию.

export BASIC_MEMORY_SEMANTIC_SEARCH_ENABLED=true
export BASIC_MEMORY_RERANKER_ENABLED=true

По умолчанию используется локальная модель jinaai/jina-reranker-v1-tiny-en. Чтобы использовать размещённый reranker через LiteLLM:

export BASIC_MEMORY_SEMANTIC_SEARCH_ENABLED=true
export BASIC_MEMORY_RERANKER_ENABLED=true
export BASIC_MEMORY_RERANKER_PROVIDER=litellm
export BASIC_MEMORY_RERANKER_MODEL=cohere/rerank-v3.5
export COHERE_API_KEY=...

Функционал быстро обрывается при неверной конфигурации и не возвращается к порядку выборки, если выбранный провайдер не работает. См. руководство по семантическому поиску для настройки провайдера, всех настроек, параметризации, пагинации и поведения при сбое.

Зачем Basic Memory

Большинство диалогов с LLM эфемерны. Вы задаёте вопрос, получаете ответ — и всё забывается. Обходные решения имеют ограничения:

• Чат-история сохраняет диалоги, но не структурированные знания.
• RAG позволяет LLM запрашивать ваши документы, но не записывает обратно.
• Векторные БД требуют сложной инфраструктуры и обычно находятся в чужом облаке.
• Графы знаний требуют специализированного инструментария для поддержки.

Basic Memory выбирает более простой путь: структурированные файлы Markdown, которые читают и записывают люди и LLM.

• Все знания остаются в обычных файлах под вашим контролем.
• Обе стороны читают и записывают в одни и те же файлы.
• Знакомый Markdown с семантическими паттернами — без освоения нового формата.
• Прослеживаемый граф, по которому LLM может идти по ссылкам.
• Работает с редакторами, которые вы уже используете (Obsidian, VS Code, любой).
• Просто файлы плюс локальный индекс SQLite. Серверы не требуются.

Как это работает

Вы общаетесь о кофе:

Я экспериментирую с методами заваривания. Pour over даёт более яркую нотку, чем French press; вода при 205°F кажется оптимальной; молотый кофе — особый эффект.

Попросите ИИ зафиксировать это:

"Сделай заметку о методах заваривания кофе."

В директории вашего проекта появляется файл Markdown в реальном времени:

---
title: Coffee Brewing Methods
permalink: coffee-brewing-methods
tags: [coffee, brewing]
---

# Coffee Brewing Methods

## Observations
- [method] Pour over highlights subtle flavors over body
- [technique] Water at 205°F (96°C) extracts optimal compounds
- [principle] Freshly ground beans preserve aromatics

## Relations
- relates_to [[Chocolate Desserts]]
- requires [[Proper Grinding Technique]]
- affects [[Flavor Extraction]]

На следующей сессии ИИ продолжит работу, опираясь на связь и развивая тему, например про эфиопские зёрна и кофемолки. Вы будете видеть те же файлы в Obsidian или вашем редакторе. Редактируйте их вручную — искусственный интеллект увидит ваши изменения.

Двусторонний поток: люди редактируют Markdown, LLM пишет/читает через MCP, синхронизация сохраняет согласованность, источник правды всегда ваши файлы.

Формат Markdown

Каждый файл — это Entity. У Entity есть Observations (факты о нём) и Relations (связи с другими сущностями). Это вся грамматика.

Frontmatter

type: note permalink: tags: [optional, list]

Observations

Факты об объекте. Категории в [brackets], теги с #, необязательный контекст в скобках.

- [method] Pour over highlights subtle flavors
- [tip] Grind medium-fine for V60 #brewing
- [fact] Lighter roasts contain more caffeine than dark
- [resource] James Hoffmann's V60 technique on YouTube
- [question] How does temperature affect compound extraction?

Relations

Wiki-стиль ссылки, образующие граф. Односложные типы связей или фразы из нескольких слов.

- pairs_well_with [[Chocolate Desserts]]
- grown_in [[Ethiopia]]
- requires [[Burr Grinder]]
- "pairs well with" [[Dark Chocolate]]

Простые - [[Target]] и текстовые заметки - Worth checking out [[Target]] индексируются как links_to. Полное руководство — в

docs.

MCP инструменты

Basic Memory предоставляет эти инструменты любому MCP-клиенту. Каждый инструмент снабжён подсказками MCP поведения (read-only, destructive, idempotent, open-world), чтобы агенты выбирали нужный инструмент без проб и ошибок:

• Контент: write_note, read_note, edit_note, move_note, delete_note, read_content, view_note
• Поиск и обнаружение: search_notes, recent_activity, list_directory
• Знание и граф: build_context (переходит по URL memory://)
• Проекты: list_memory_projects, list_workspaces, create_memory_project, delete_project
• Схема: schema_infer, schema_validate, schema_diff
• Совместимость и диагностика: search, fetch, basic_memory_diagnostics

Все MCP-инструменты по умолчанию возвращают текстовый вывод; задавайте output_format="json" для структурированных ответов. Полный справочник инструментов — в

docs.

Основы CLI

DB-цепочка консоли basic-memory tool edit-note ... # CLI-доступ к MCP-инструментам basic-memory update # проверка наличия обновлений и их установка

Импорт

basic-memory import claude conversations basic-memory import chatgpt basic-memory import memory-json

Проекты

basic-memory project list basic-memory project add research ~/research basic-memory project set-cloud research # маршрутизировать через облако basic-memory project set-local research # вернуть локально

Конфигурация

basic-memory config list # все настройки, активные значения, переопределения окружения basic-memory config set cli_output_style plain # валидируется по модели конфигурации basic-memory config unset cli_output_style # вернуть по умолчанию

Здоровье и обслуживание

basic-memory status basic-memory doctor # проверка соответствия файлов и БД basic-memory tool edit-note ... # CLI-доступ к MCP-инструментам basic-memory update # проверить наличие обновлений и установить их

Импорт

basic-memory import claude conversations basic-memory import chatgpt basic-memory import memory-json

Флаги маршрутизации (`--local` / `--cloud`) принудительно устанавливают цель в смешанном режиме. Полный CLI-руководство доступно в

[docs](https://docs.basicmemory.com/reference/cli-reference?utm_source=github&utm_medium=referral&utm_campaign=readme).

## Автообновления

Установки CLI по умолчанию проверяют обновления каждые 24 часа и устанавливают их скрыто (чтобы MCP-сервер продолжал отвечать).

- Поддерживаемые источники установки: `uv tool`, Homebrew
- Пропущено для `uvx` (эпемеральный рантайм, управляемый uv)
- Ручное обновление: `bm update` (проверка + применение) либо `bm update --check` (только проверка)

Отключить в `~/.basic-memory/config.json`:

{ "auto_update": false }

## Телеметрия

Минимальные, анонимные события для понимания конверсии CLI к облаку.

**Что собираем:** показы промо-объявлений облака, попытки входа в облако и результаты, события отказа от промо.

**Что не собираем:** содержимое файлов, названия заметок, данные базы знаний, PII, IP-адреса, по-командно или по-инструменту трекинг.

События отправляются в наш экземпляр Umami Cloud (open-source, конфиденциальность) на фоновой нити — это не блокирует работу CLI.

Отказаться можно так:

export BASIC_MEMORY_NO_PROMOS=1

Это отключает промо и всю телеметрию.

## Логирование

Basic Memory использует [Loguru](https://github.com/Delgan/loguru). Значения по умолчанию зависят от входной точки:

| Точка входа | По умолчанию | Зачем |
| --- | --- | --- |
| Команды CLI | Только файл | Не мешает выводу команды |
| MCP-сервер | Только файл | Stdout не должен портить JSON-RPC |
| API-сервер | Файл (локальный) или stdout (облако) | Докер/облако используют stdout |

Лог-файл: `~/.basic-memory/basic-memory.log` (крутящийся по 10MB, хранение 10 дней)

### Переменные окружения

| Переменная | По умолчанию | Описание |
| --- | --- | --- |
| BASIC_MEMORY_LOG_LEVEL | INFO | DEBUG / INFO / WARNING / ERROR |
| BASIC_MEMORY_CLOUD_MODE | false | Логи API в stdout с структурированным контекстом |
| BASIC_MEMORY_FORCE_LOCAL | false | Принудительная маршрутизация локального API |
| BASIC_MEMORY_FORCE_CLOUD | false | Принудительная маршрутизация облака API |
| BASIC_MEMORY_EXPLICIT_ROUTING | false | Отметить выбор маршрута как явный |
| BASIC_MEMORY_ENV | dev | Установить в test для тестового режима (только stderr) |
| BASIC_MEMORY_NO_PROMOS | false | Отключить облачные промо и телеметрию |
| BASIC_MEMORY_IMPORT_UPLOAD_MAX_BYTES | 104857600 | Максимальный размер загрузок импорта |

BASIC_MEMORY_LOG_LEVEL=DEBUG basic-memory reindex tail -f ~/.basic-memory/basic-memory.log

## Разработка

Basic Memory поддерживает SQLite (по умолчанию, быстро, без Docker) и Postgres

(через testcontainers — Docker нужен).

 DB-цепь проверки консистентности
just package-check    # проверки пакетов Claude Code, skills, Hermes, OpenClaw
just lint
just typecheck        # Pyright (основной)
just typecheck-ty     # ty (дополнительный)
just format
just check            # Все проверки качества
just migration "msg"  # Новая миграция Alembic

just install          # Установка с зависимостями для разработки
just test-sqlite      # Все тесты, SQLite
just test-postgres    # Все тесты, Postgres (testcontainers)
just test             # Обе реализации
just fast-check       # исправления/форматирование/типизация + затронутые тесты
just doctor           # Проверка соответствия файла и БД (временная настройка)
just package-check    # Проверки пакетов Claude Code, skills, Hermes, OpenClaw
just lint
just typecheck        # Pyright (основной)
just typecheck-ty     # ty (дополнительный)
just format
just check            # Все проверки качества
just migration "msg"  # Новая миграция

Тесты помечены маркерами pytest: windows, benchmark, smoke. Подробности — в

justfile — полный список.

Приём вкрутую — вкладки CONTRIBUTING.md приветствуют ваши вклад и идеи.

Лицензия

AGPL-3.0.

Star History

Сделано с любовью командами Basic Machines.