_OpenSource Web4 agent & app starter kit_

# Память, которая хранит то, что вы ей сказали

Скажите главному агенту «запомни» в Telegram или в терминале: фразу, фото, PDF или голосовое. Через месяцы спросите «напомни о…» — и ответ вернётся с датой, источником и тем, насколько память уверена. Всё это остаётся на вашем компьютере.

[Начать](#turn-on)
[Подключить свой элемент](#connect)

## Как работает память

#### Вы говорите «запомни»

Своими словами и на любом языке, а если хотите — с фото, документом или голосовым.

#### Ваш главный агент

Понимает, чего вы хотите, а не ищет точное слово, и передаёт слова и файл памяти.

#### Память

Описывает файл словами, превращает голосовое в текст, разбирает фразу на факты и хранит их в вашем узле.

#### «Напомни о…»

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

Пока на компьютере свободно больше 1 ГБ, память включена всегда. Когда меньше, главный агент включает её на задачу и выключает после. Если в её календаре ждёт напоминание, она остаётся включённой.

## Включён, засыпает только при нехватке памяти

Элемент запускается вместе с узлом. Когда свободной памяти меньше 0,5 ГБ, узел может его усыпить; первый вызов или запись календаря будят его за секунды, а при 1 ГБ свободной памяти он возвращается сам.

## Что меняется для вас

| Без неё | С глубокой памятью |
| --- | --- |
| Заметки, фото и голосовые разбросаны по приложениям | Вы отправляете их одному боту, и узел хранит их вместе |
| Поиск находит только точные слова, которые вы набрали | Она находит по смыслу, на любом языке |
| Фото — это файл без слов | Фото описано словами, и его находят по тому, что на нём |
| Непонятно, откуда взялся ответ | В каждом ответе есть дата, источник и то, насколько память уверена |
| Ваши заметки лежат на чужом сервере | Они остаются на вашем компьютере, внутри вашего узла |
| Напоминание живёт в одном приложении, а то, о чём оно, — в другом | Скажите «напомни мне завтра в 9…», и память сохранит фразу и поставит запись в свой календарь |

## Чья это память

## undefined

**Главный агент узла** — Читает все пространства: что было сказано через каждый элемент узла.

- **Элемент мамы** — Только своё: что она рассказала, её файлы и ответы ей.
- **Элемент сына** — Только своё: его уроки и его вопросы.
- **Ваш сайт** — Только своё: что было сказано через него.

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

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

Главный агент пишет в своё пространство и читает все ключом данных узла. Всё, что вы сохранили до появления пространств, осталось у него.

Очистка журнала стирает журнал того элемента, который попросил. Журнал элемента главный агент стирает, только назвав этот элемент.

Хранилища за памятью тоже разделяют элементы по их собственным ключам. Компьютер и его диск ваши, и от вас на нём ничего не скрыто.

## Напомнит в нужную минуту

Скажите главному агенту «напомни мне завтра в 9 позвонить маме» или «через неделю напомни про день рождения брата». Дату он посчитает сам. Фраза сохранится как обычно, а в календарь памяти ляжет запись.

В эту минуту часы памяти сами присылают слова в ваш главный чат с пометкой «⏰ Напоминание». Модель в этом не участвует, токены не тратятся.

- Повтор: один раз, каждый день, по будням, раз в неделю, раз в месяц или раз в год.
- В ответ агент назовёт дату словами, а запись появится в меню узла: «Глубокая память → Крон события».
- Неверное или уже прошедшее время отклоняется, и фраза без своего напоминания не сохраняется.
- Если в эту минуту компьютер выключен, напоминание не придёт, а календарь покажет пропущенный запуск.

```
Вы: напомни мне завтра в 9
позвонить маме

Агент: Напомню: пятница,
6 ноября 2026 г. в 09:00 —
«позвонить маме».
Запись — в календаре памяти.

Пятница, 09:00, главный чат:
⏰ Напоминание · Глубокая память
позвонить маме
```

## Что память делает с каждым видом файлов

| Что вы отправляете | Что делает память |
| --- | --- |
| Фото или картинку | Описывает словами и хранит картинку вместе с описанием |
| PDF | Читает целиком и хранит с описанием, поэтому его находят по содержанию |
| Голосовое | Превращает в текст и разбирает как обычную фразу |
| Видео | Разбирает кадры и звук, если на компьютере есть программа ffmpeg |
| Документы и код | Читает как текст; код никогда не запускается |
| Текст длиннее 2000 слов | Хранит целиком как вещь, не разбирая на факты |

## Как с ней говорить

Не нужно заполнять формы и учить меню. Вы говорите с главным агентом так же, как с человеком, и он понимает, когда речь о памяти.

- «запомни…», «запиши», «сохрани», «не забудь» — память сохраняет.
- «напомни о…», «что я говорил про…» — память отвечает тем, что вы сказали раньше.
- «напомни мне завтра в 9…», «каждый понедельник напоминай…» — память ставит напоминание в свой календарь.
- Фото, документ или голосовое с парой слов — хранятся вместе и находятся вместе.

## Начать в три шага

1. Добавьте свой ключ OpenAI в настройках ядра. По нему память ищет по смыслу, слышит голосовые и разбирает фразы на факты.
2. Подключите в ядре Telegram-бота главного агента, чтобы говорить с ним с телефона.
3. Скажите ему «запомни…». Это всё.

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

## Подключите свой элемент

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

```
// В серверном коде вашего элемента, на этом компьютере: порт даёт узел, ключ у вашего элемента свой
const base = `http://127.0.0.1:${port}`
const headers = { 'content-type': 'application/json', 'X-Element-Key': process.env.ELEMENT_KEY }
// без from: ваш ключ и есть ваше пространство
await fetch(`${base}/v1/remember`, { method: 'POST', headers, body: JSON.stringify({ text: 'такси из аэропорта стоило 40 евро' }) })
const answer = await fetch(`${base}/v1/recall`, { method: 'POST', headers, body: JSON.stringify({ text: 'сколько стоило такси?' }) }).then((r) => r.json())
// → { ok: true, text, objects, certainty, answer_id, … }
```

В ответе есть текст, найденные вещи, уверенность памяти и `answer_id`. По нему элемент может оставить отзыв об ответе через `POST /v1/feedback`, а весь договор отдаёт `GET /v1/contract`.

## Что под капотом

| Часть | Что делает |
| --- | --- |
| Элемент data | Хранит каждую фразу строкой в базе данных узла |
| Элемент vectors | Находит сказанное по смыслу |
| Элемент graph | Хранит факты и связи между ними в отдельном пространстве |
| Элемент storage | Хранит фото, документы и записи |
| OpenAI `gpt-6-luna` | Разбирает фразу на факты и описывает картинки и PDF — за доли цента |
| OpenAI `whisper-1` | Превращает голосовые в текст |
| Ваш узел | Держит память включённой, пока свободно больше 1 ГБ; когда меньше, главный агент включает её на задачу |

## Свой строитель в комплекте

Каждый элемент узла приходит со своим агентом Claude Code и может получить свой Telegram-бот. Нужно что-то поменять в этом элементе — напишите его боту с телефона, и агент обновит логику или дизайн.

Агент работает только в папке своего элемента и не читает весь узел, поэтому каждая правка стоит меньше токенов. Платит за неё ваша подписка Claude Code.

- Бот элемента подключается в ядре, на его странице «Telegram».
- Агент возвращает коммит; вы смотрите его в «Предпросмотре» и принимаете или отклоняете.
- За компьютером терминал агента — в ядре, в разделе «Сборка» этого элемента.

## Открытый код

Сделано Fractera для протокола [Lagrix](https://lagrix.dev) и для любого web2-проекта, которому нужна память. Лицензия MIT, код — [github.com/Fractera/fractera-memory-starter](https://github.com/Fractera/fractera-memory-starter).

## Вопросы и ответы

**Что ей можно отправить?**
Фразу, фото, PDF или голосовое, на любом языке, через главного агента в Telegram или в терминале.

**Как понять, откуда взялся ответ?**
В каждом ответе есть дата, источник и то, насколько память уверена.

**Работает ли она, когда компьютер занят?**
Когда свободно меньше 1 ГБ, главный агент включает её на задачу и выключает после; ожидающее напоминание держит её включённой.

**Можно ли делать резервные копии?**
Да. Элемент готов к тому, что его агент-программист настроит резервное копирование по расписанию или вручную: скажите об этом агенту элемента в Telegram или в терминале. Сам по себе он копий не делает.