Skip to main content
Glama
README.md
# SecondBrain — вторая память для ваших нейросетей

Локальное приложение, которое собирает в одну базу на вашем компьютере:

- чаты **ChatGPT** и **Claude** (из официальной выгрузки);
- сессии **Codex** и **Claude Code** (подхватываются сами);
- заметки **Obsidian** или любую папку с `.md`;
- **почту** Gmail и Яндекс (только чтение, по паролю приложения);
- вложения: PDF, DOCX, XLSX, PPTX, txt, html, json. Их текст тоже ищется.

Любая нейросеть с поддержкой MCP (Claude Code, Codex, Cursor и другие) подключается к базе и сразу
знает ваш контекст: проекты, решения, договорённости, прошлые обсуждения. Вам не нужно каждый раз
рассказывать заново.

## Чем отличается от «просто RAG»

| | |
|---|---|
| **Поиск без нейросети** | BM25 и русская морфология (Snowball). Ответ за доли секунды, бесплатно, работает офлайн. |
| **Карточки с цитатами** | Недорогая модель пишет к каждой записи выжимку. Каждый факт в ней привязан к **дословной цитате** из оригинала с датой. Программа проверяет цитату, а пункт без подтверждения отбрасывает. |
| **Различает, кто что сказал** | Ваше решение, совет ассистента и отчёт ассистента «я сделал» хранятся раздельно. |
| **Оригиналы не меняются** | Каждая версия источника сохраняется. Карточка относится к конкретной версии. |
| **Всё у вас** | Одна база SQLite на вашем диске. Сервер слушает только `127.0.0.1`. Ключи и пароли из переписки маскируются в любой выдаче. |
| **Модель любая** | Подойдёт любой OpenAI-совместимый API: OpenAI, OpenRouter, прокси или локальная Ollama. Месячный потолок расходов задаётся в настройках. |

## Установка: отдайте её нейросети

Обычный чат в браузере программу не установит. Нужен **агент с доступом к компьютеру**: Claude Code,
вкладка Code в приложении Claude, Codex или Cursor.

1. Скачайте репозиторий (`Code → Download ZIP` или `git clone`) и распакуйте в удобную папку,
   например `Документы\SecondBrain`.
2. Откройте эту папку в агенте.
3. Напишите ему:

```text
Прочитай START_HERE.md и установи SecondBrain по шагам. После каждого шага показывай результат проверки.
```

Агент проверит Node.js и Python, прогонит 116 тестов и запустит проверку на демо-данных.
После этого он настроит автозапуск, подключит MCP и поможет добавить ваши источники.

Требования: **Windows 10/11**, **Node.js 24+**, **Python 3.10+**. На macOS и Linux ядро
(сервер, поиск, MCP) тоже работает, а агент адаптирует автозапуск по [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).

## Вручную, если хочется самому

```powershell
npm run setup        # пакеты для почты (необязательно)
npm test             # 116 тестов, все должны пройти
npm run check        # запуск на демо-данных во временной базе: должно быть «всё работает»
npm start            # сервер: http://127.0.0.1:8877
```

Импорт выгрузки ChatGPT или Claude:

```powershell
npm run import -- "C:\путь\к\распакованной\выгрузке"
```

Подключение к Claude Code и Codex:

```powershell
claude mcp add --transport http --scope user secondbrain http://127.0.0.1:8877/mcp
codex mcp add secondbrain --url http://127.0.0.1:8877/mcp
```

## Что внутри

```
README.md         вы здесь
START_HERE.md     пошаговая установка для нейросети, с проверкой каждого шага
AI_GUIDE.md       как нейросеть должна пользоваться базой (промпт и правила)
docs/             архитектура и устройство данных
app/              приложение: сервер, веб-панель, сборщики, обработка карточек
demo/             выдуманные чаты и заметка для проверки
store/            появится после первого запуска: ваша база (в git не попадает)
```

## Честно об ограничениях

- Автозапуск и скрипты рассчитаны на Windows.
- ChatGPT и claude.ai в браузере подключаются к базе только через публичный HTTPS-адрес с авторизацией.
  В этот репозиторий такой шлюз не входит. Локальные агенты (Claude Code, Codex, Cursor) работают сразу.
- Карточки пишет платная модель, если вы её подключите. Поиск и импорт бесплатны и без неё.
- Сбор чатов прямо из аккаунта (`app/cloud-collector`, `app/browser-extension`) экспериментальный и
  использует внутренние адреса сайтов. Надёжный путь — официальная выгрузка.

## Лицензия

MIT. Пользуйтесь, меняйте, делитесь.