MemoryGraph

Ваш агент обнаружил релевантное воспоминание. MemoryGraph подсказывает ему, остаётся ли это воспоминание истинным.

MemoryGraph — это локально-ориентированный уровень фиксации свидетельств и пересмотра убеждений для AI-агентов. Он сохраняет исходные наблюдения, представляет утверждения в виде временного графа и объясняет, почему утверждение является актуальным, историческим или оспариваемым.

Статус MVP

Детерминированный MVP уже работает. Авторитетная архитектура начинается с 00-architecture-index.md; реализованное ядро покрывает:

• Неизменяемые исходные наблюдения.

• Типизированные узлы сущностей и атомарные рёбра утверждений с точными фрагментами свидетельств.

• Битемпоральные запросы актуальных и исторических убеждений.

• Явное подтверждение, противоречие и атомарное вытеснение.

• Команды recall, history и explain.

• Жёсткую изоляцию банков и журнал событий мутаций в режиме только добавление.

• Провайдер-агностический валидатор dream-предложений с гейтами достоверности, водяных знаков, версий утверждений, идемпотентности, уверенности, оспаривания и ревью.

• Устойчивые dream-запуски, задачи, предложения, элементы ревью, аренды, водяные знаки событий и atomарные коммиты предложений.

• Детерминированного провайдера метаданных, который прогоняет полный dream-цикл без отправки исходных данных внешней модели.

• Фикстуры MemoryRotBench, бейзлайны, оценку поиска и интеграцию с движком.

• Гибридный поиск FTS/векторный с локальным бейзлайном без зависимостей и заменяемым эмбеддером.

• Карантин на этапе поиска для недоверенного контента, похожего на инструкции.

• Dream-воркеры с восстановлением после сбоев, арендами, продлением heartbeat, повторными попытками и безопасным повторным запуском без дублирующей обработки.

• OpenAI-совместимый провайдер структурированного вывода, который может только предлагать кандидатов.

• STDIO MCP-сервер с пятью инструментами: recall, record, explain, correct и forget.

• Импорт Codex JSONL с разрешения пользователя и установщик Codex в рамках проекта.

• Детерминированную Obsidian-совместимую Markdown-проекцию для ревью.

• Первоклассные процедурные эпизоды для ограниченного повторного использования успешных и неудачных попыток кодирования.

• Воспроизводимые адаптеры бенчмарков без памяти, на Markdown, BM25, плоском контексте и внешние/Graphify.

• Кроссплатформенный CI, проверку пакета и применимую на практике диагностику doctor.

Реальный движок в настоящее время проходит все 12 публичных запросов MemoryRotBench и все семь производственных хаос-контрактов. Тестовый набор репозитория насчитывает 196 успешных тестов на этой контрольной точке. В первой публичной матрице с отпечатками самые сильные простые бейзлайны дают 7/12, тогда как MemoryGraph дает 12/12.

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

uv sync
uv run memorygraph init --database /tmp/memorygraph.db
uv run memorygraph doctor --database /tmp/memorygraph.db
uv run memorygraph bank create personal:founder --database /tmp/memorygraph.db
uv run memorygraph dogfood bootstrap --database /tmp/memorygraph.db
uv run memorygraph predicate define works_at \
  --bank personal:founder --cardinality one --volatility volatile \
  --database /tmp/memorygraph.db

Зафиксируйте свидетелство, а затем превратите его в утворяazaние:

OBSERVATION_ID=$(uv run memorygraph observe "Abrar works at Acme." \
  --bank personal:founder --source-key event:acme \
  --database /tmp/memorygraph.db)

CLAIM_ID=$(uv run memorygraph claim assert Abrar works_at Acme \
  --bank personal:founder --observation "$OBSERVATION_ID" \
  --database /tmp/memorygraph.db)

Python API также экспонирует confirm_claim, contradict_claim, supersede_claim, recall, history и explain для оبيعraeмых. приложений.

Запишите попытку написания кода, чтобы будущие агенты могли использовать успeшнуy стратегию или избежать известного провала — без претензии на универсальную применимость:

memorygraph record-attempt "Run migrations before starting the worker" \
  --bank project:my-app --source-key attempt:migrate-worker \
  --task "start durable worker" --outcome success \
  --applicability-json '{"database":"sqlite"}'

Запуск dream-цикла

Встроенный провайдер читает типизированных кандидатов из metadata.memorygraph, предлагает изменения графа, проверяет свидетельства и временные предусловия, а затем коммитит подходящие предложения одной транзакцией. Модельные провайдеры реализуют тот же протокол «только кандидаты» и никогда не получают прямой путь записи в базу данных.

PYTHONPATH=src:. uv run python examples/run_dream_cycle.py \
  --database /tmp/memorygraph-dream.db

uv run memorygraph dream status RUN_ID \
  --bank personal:founder --database /tmp/memorygraph-dream.db

uv run memorygraph dream reviews \
  --bank personal:founder --database /tmp/memorygraph-dream.db

uv run memorygraph dream rollback RUN_ID \
  --bank personal:founder --database /tmp/memorygraph-dream.db

Для импорта через CLI передайте конверт кандидата с помощью observe --metadata-file FILE.json, затем запустите memorygraph dream run --bank BANK. Режим --mode dry_run валидирует и сохраняет предложения, но не потребляет наблюдение и не меняет утверждения.

Для устойчивого выполнения поставьте работу в очередь и запустите воркер отдельно:

uv run memorygraph dream queue \
  --bank personal:founder --database /tmp/memorygraph-dream.db

uv run memorygraph dream worker \
  --bank personal:founder --database /tmp/memorygraph-dream.db

Чтобы использовать OpenAI-совместимый Responses-эндпоинт, задайте сконфигурированную переменную ключа и передайте модель и в очередь, и воркеру. Вывод провайдера разбирается как строгие структурированные данные и по-прежнему прохо дит через те же детерминированные гейты по свидетять о коммитам.

export OPENAI_API_KEY=...
uv run memorygraph dream queue --bank personal:founder \
  --provider-model YOUR_MODEL --database /tmp/memorygraph-dream.db
uv run memorygraph dream worker --bank personal:founder \
  --provider-model YOUR_MODEL --database /tmp/memorygraph-dream.db

Подключение Codex

Устtabobвite пaket,инициализируйте займов банк и добавьте MCP-конфигурацию scoping для проекта:

uv run memorygraph init
uv run memorygraph bank create project:my-app
uv run memorygraph install-codex --project .
uv run memorygraph probe-codex --project .

Installer создаёт or исправляет block [mcp_servers.memorygraph] in .codex/config.toml, указуя его на STDIO—мodul memorygraph.mcp текущего Python-окружения, and наstrаветает Codex, to request confirmated on write. Он не изменяет global config Codex. Пять MCP-operations require yavнy indication bank.

probe-сodex проверяет конфигурация проекta и pulsates live жизненный cycle MCP-сubints.cell. Use --projecо--database if you want theprobe to condition the target проектный database instead of temporary one-shot Bд.

Импort содержимого сессии — по явно выражentный побору. Каждая JSONL-запись should contain bank, session_id, turn_id, role, content and approved; non-appro-d records default skip:

memorygraph ingest-codex approved-session.jsonl

Dogfood Alpha

Official offline matrix is six variants:

PYTHONPATH=src:. uv run python examples/run_dogfood_fixture_matrix.py

For real a project, first запуск operating contract:

uv run memorygraph dogfood bootstrap \
  --database .memorygraph/memory.db \
  --bank project:my-app \
  --workspace my-app

Нatrix фикстур запускает такие groupings:

• no_memory

• markdown

• memorygraph_graph_only

• memorygraph_gated_dream

• memorygraph_always_dream

• graphify_compatible

Она измеряет прохождение/провал задач, точность полезных выводов, утечку запрещённых или устаревших данных, повтoryщие ошибки, задержку, оценку токen, вызовы инструmentоv, retries, полey estimirovannoy costy, и нагрузокy на dream-review. Results are recorded in benchmarks/reports/dogfood-offline-mvp.json и в журнал только-добавление benchmarks/ reps/ dogfood-offline-mvp.jsonl. Тasks pass/fail follow aligned wiтh promise; backlog review remains visible.

Current results of офлайн-фикстур on 2026-08-22:

• memorygraph_always_dream: 3/3

• memorygraph_graph_only: 1/3

• memorygraph_gated_dream: 1/3

• graphify_compatible: 1/3

• markdown: 1/3, s протечкой забр presumptuous fragment

graphify_compatible is a protocol open that lets the rice.retriever to compete on the same manifest, timeframes, and score contract. This is not a request that this repo has already done jomb x live Comparison.

Emotional review? in Obsidian

Create Markdown vault with current claims, exact source, relations, and Dream form object:

memorygraph project-obsidian --bank project:my-app \
  --output .memorygraph/obsidian

Маркdown is vremenный and преtенzion. SQLITE-observations i event-only is accurate; edits to notes "raw" Never Could.

Export

Почему граф?

Граф даёт агентам компوزируемую структуру: сущности — узлы, а утверждения вида AbrarThe contents of --works_at--> Stripe — typed gra. MemoryGrare does not essence can careful. "Edge". , edge.

uv sync --extra dev
uv run pytest
uv run ruff check .
PYTHONPATH=src:. python examples/run_memoryrotbench_memorygraph.py
PYTHONPATH=src:. python examples/run_memoryrotbench_chaos_memorygraph.py
python examples/run_memoryrotbench_baseline_matrix.py
PYTHONPATH=src:. uv run python examples/run_dogfood_fixture_matrix.py

Ожидаемyes: 12/12 по открытым retrieval cases 7/7 по cha-a. Matrix appending immutable, coinherent via benchmarks/reports/public-baseline-matrix.jsonl. Use --graphify-command, чтобы целюранична к внешнему Google adaptor with the same بvisible corpus and estimate contract.

Следующий продукт-уровень

Следующий условний останется real-prove: live Fog marketing * sessions, честное Graphify comparison, and a real design-partner usage on واقع۲ coding work. Отслеживаются и репортируются остатки удаления along the remain ID; краhниваю anything cannot be clear safely without rewrite history, мы его всплываем — не скрываем. Формировщик дел still allows a safety belt that every provider and worker must pass through.

License Apache-2.0.