Лицензия: AGPL v3 PyPI-версия Питон 3.12+ Тесты Рафф значок кузнеца

Базовая память

Name: basic-memory
Author: basicmachines-co

Базовая память позволяет вам создавать устойчивые знания посредством естественных разговоров с Большими языковыми моделями (LLM), такими как Клод, сохраняя все в простых файлах Markdown на вашем компьютере. Он использует протокол контекста модели (MCP), чтобы любой совместимый LLM мог читать и записывать в вашу локальную базу знаний.

Сайт: https://basicmachines.co
Документация: https://memory.basicmachines.co

Продолжайте разговор с того места, где вы остановились.

Помощники на основе искусственного интеллекта могут загружать контекст из локальных файлов в новый разговор
Заметки сохраняются локально в виде файлов Markdown в режиме реального времени.
Не требуется никаких знаний проекта или специальных подсказок.

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

Related MCP server: memento-mcp

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

# Install with uv (recommended) uv tool install basic-memory # Configure Claude Desktop (edit ~/Library/Application Support/Claude/claude_desktop_config.json) # Add this to your config: { "mcpServers": { "basic-memory": { "command": "uvx", "args": [ "basic-memory", "mcp" ] } } } # Now in Claude Desktop, you can: # - Write notes with "Create a note about coffee brewing methods" # - Read notes with "What do I know about pour over coffee?" # - Search with "Find information about Ethiopian beans"

Вы можете просмотреть общий контекст через файлы в ~/basic-memory (расположение каталога по умолчанию).

Альтернативная установка через кузницу

Вы можете использовать Smithery для автоматической настройки базовой памяти для Claude Desktop:

npx -y @smithery/cli install @basicmachines-co/basic-memory --client claude

Это устанавливает и настраивает базовую память без необходимости ручного редактирования файла конфигурации Claude Desktop. Сервер Smithery размещает компонент сервера MCP, в то время как ваши данные остаются локально сохраненными в виде файлов Markdown.

Глама.ай

Почему базовая память?

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

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

Базовая память решает эти проблемы с помощью простого подхода: структурированные файлы Markdown, которые могут читать и писать как люди, так и LLM. Ключевые преимущества:

Локально: все знания хранятся в файлах, которые вы контролируете
Двунаправленный: и вы, и LLM читаете и пишете в одни и те же файлы
Структурированный, но простой: использует знакомый Markdown с семантическими шаблонами
Проходимый граф знаний: LLM могут отслеживать связи между темами
Стандартные форматы: Работает с существующими редакторами, такими как Obsidian.
Облегченная инфраструктура: только локальные файлы, индексированные в локальной базе данных SQLite.

С помощью базовой памяти вы можете:

Ведите беседы, которые основываются на предыдущих знаниях
Создавайте структурированные заметки во время естественных разговоров
Общайтесь с магистрами права, которые помнят, о чем вы уже говорили ранее
Семантически перемещайтесь по графу знаний
Держите все локально и под своим контролем
Используйте знакомые инструменты, такие как Obsidian, для просмотра и редактирования заметок
Создайте личную базу знаний, которая будет расти со временем

Как это работает на практике

Допустим, вы изучаете методы заваривания кофе и хотите закрепить свои знания. Вот как это работает:

Начните с обычного чата:

I've been experimenting with different coffee brewing methods. Key things I've learned: - Pour over gives more clarity in flavor than French press - Water temperature is critical - around 205°F seems best - Freshly ground beans make a huge difference

...продолжить разговор.

Попросите магистра права помочь структурировать эти знания:

"Let's write a note about coffee brewing methods."

LLM создает новый файл Markdown в вашей системе (который вы можете мгновенно увидеть в Obsidian или вашем редакторе):

--- title: Coffee Brewing Methods permalink: coffee-brewing-methods tags: - coffee - brewing --- # Coffee Brewing Methods ## Observations - [method] Pour over provides more clarity and highlights subtle flavors - [technique] Water temperature at 205°F (96°C) extracts optimal compounds - [principle] Freshly ground beans preserve aromatics and flavor ## Relations - relates_to [[Coffee Bean Origins]] - requires [[Proper Grinding Technique]] - affects [[Flavor Extraction]]

Заметка содержит семантическое содержание и ссылки на другие темы с помощью простого форматирования Markdown.

Вы видите этот файл на своем компьютере в режиме реального времени в текущем каталоге проекта (по умолчанию ~/$HOME/basic-memory ).

Синхронизация в реальном времени включена по умолчанию в версии v0.12.0.

В чате с LLM вы можете упомянуть тему:

Look at `coffee-brewing-methods` for context about pour over coffee

LLM теперь может создавать богатый контекст из графа знаний. Например:

Following relation 'relates_to [[Coffee Bean Origins]]': - Found information about Ethiopian Yirgacheffe - Notes on Colombian beans' nutty profile - Altitude effects on bean characteristics Following relation 'requires [[Proper Grinding Technique]]': - Burr vs. blade grinder comparisons - Grind size recommendations for different methods - Impact of consistent particle size on extraction

Каждый связанный документ может привести к более глубокому контексту, создавая богатое семантическое понимание вашей базы знаний.

Это создает двусторонний поток, где:

Люди пишут и редактируют файлы Markdown
LLM читают и пишут через протокол MCP
Синхронизация обеспечивает единообразие всего
Все знания сохраняются в локальных файлах.

Техническая реализация

Под капотом базовая память:

Сохраняет все в файлах Markdown
Использует базу данных SQLite для поиска и индексации
Извлекает семантическое значение из простых шаблонов Markdown
- Файлы становятся объектами Entity
- Каждая Entity может иметь Observations или факты, связанные с ней.
- Relations связывают сущности вместе, формируя граф знаний.
Поддерживает локальный график знаний, полученный из файлов
Обеспечивает двунаправленную синхронизацию между файлами и графом знаний.
Реализует протокол контекста модели (MCP) для интеграции ИИ
Предоставляет инструменты, которые позволяют помощникам на основе искусственного интеллекта перемещаться по графу знаний и манипулировать им
Использует URL-адреса memory:// для ссылки на сущности в инструментах и диалогах.

Формат файла — просто Markdown с простой разметкой:

Каждый файл Markdown имеет:

Frontmatter

title: <Entity title> type: <The type of Entity> (e.g. note) permalink: <a uri slug> - <optional metadata> (such as tags)

Наблюдения

Наблюдения — это факты о теме. Их можно добавить, создав список Markdown со специальным форматом, который может ссылаться на category , tags с использованием символа «#» и необязательный context .

Формат Markdown для наблюдений:

- [category] content #tag (optional context)

Примеры наблюдений:

- [method] Pour over extracts more floral notes than French press - [tip] Grind size should be medium-fine for pour over #brewing - [preference] Ethiopian beans have bright, fruity flavors (especially from Yirgacheffe) - [fact] Lighter roasts generally contain more caffeine than dark roasts - [experiment] Tried 1:15 coffee-to-water ratio with good results - [resource] James Hoffman's V60 technique on YouTube is excellent - [question] Does water temperature affect extraction of different compounds differently? - [note] My favorite local shop uses a 30-second bloom time

Отношения

Отношения — это ссылки на другие темы. Они определяют, как сущности соединяются в графе знаний.

Формат разметки:

- relation_type [[WikiLink]] (optional context)

Примеры отношений:

- pairs_well_with [[Chocolate Desserts]] - grown_in [[Ethiopia]] - contrasts_with [[Tea Brewing Methods]] - requires [[Burr Grinder]] - improves_with [[Fresh Beans]] - relates_to [[Morning Routine]] - inspired_by [[Japanese Coffee Culture]] - documented_in [[Coffee Journal]]

Использование с VS Code

Для установки в один клик нажмите одну из кнопок установки ниже...

Установка с UV в VS Code Установка с UV в VS Code Insiders

Вы можете использовать Basic Memory с VS Code для легкого извлечения и сохранения информации во время кодирования. Нажмите кнопки установки выше для настройки в один клик или следуйте инструкциям по ручной установке ниже.

Ручная установка

Добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open User Settings (JSON) .

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

При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.

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

Использование с Claude Desktop

Базовая память построена с использованием протокола MCP (Model Context Protocol) и работает с настольным приложением Claude ( https://claude.ai/ ):

Настройте Claude Desktop для использования базовой памяти:

Отредактируйте файл конфигурации MCP (обычно он находится в ~/Library/Application Support/Claude/claude_desktop_config.json для OS X):

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

Если вы хотите использовать определенный проект (см. Несколько проектов ), обновите конфигурацию Claude Desktop:

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

Синхронизируйте свои знания:

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

В Claude Desktop магистр права теперь может использовать следующие инструменты:

write_note(title, content, folder, tags) - Create or update notes read_note(identifier, page, page_size) - Read notes by title or permalink build_context(url, depth, timeframe) - Navigate knowledge graph via memory:// URLs search_notes(query, page, page_size) - Search across your knowledge base recent_activity(type, depth, timeframe) - Find recently updated information canvas(nodes, edges, title, folder) - Generate knowledge visualizations

Примеры подсказок для пробы:

"Create a note about our project architecture decisions" "Find information about JWT authentication in my notes" "Create a canvas visualization of my project components" "Read my notes on the authentication system" "What have I been working on in the past week?"

Дополнительная информация

Более подробную информацию смотрите в документации , в том числе:

Лицензия

АГПЛ-3.0

Вклады приветствуются. См. руководство по вкладам для получения информации о настройке проекта локально и подаче PR.

История Звезды

Создано с ♥️ компанией Basic Machines

basic-memory