# Agent Second Brain — полная инструкция по установке (v3.0)
**Персональный AI-ассистент с долговременной памятью**
Записывайте голосовые в Telegram — агент сам разберётся что с ними делать: сохранит мысли, обновит прогресс по целям, поставит себе напоминание и напишет вам, когда придёт время.
---
## Главное перед началом
| Параметр | Значение |
|----------|----------|
| **Время на настройку** | **2–3 часа тишины.** Не торопитесь — лучше один раз сделать правильно. |
| **Стоимость** | ~$25/мес (Claude Pro $20 + VPS $5) |
| **Приватность** | **Это ваш личный сервер. Никто, кроме вас, не имеет доступа к вашим мыслям и задачам.** |
> **Что изменилось в версии 3.0 (если коротко):**
> - Установка стала сильно проще: одна команда запускает скрипт, который сам ставит всё необходимое и сам задаёт вам вопросы.
> - Ключей нужно меньше: всего два (Telegram и Deepgram) плюс ваш Telegram ID.
> - Напоминания и расписания агент теперь делает сам — никаких внешних таск-менеджеров подключать не нужно.
> - Внутри теперь живёт одна постоянная сессия Claude Code — она работает на вашей обычной подписке Claude Pro/Max.
---
## Оглавление
- [Зачем это нужно](#зачем-это-нужно)
- [Как это работает](#как-это-работает)
- [Словарь терминов](#словарь-терминов)
- [Что понадобится](#что-понадобится)
- **Часть 1: Подготовка на компьютере** ⏱ 30–50 мин
- [1.1 Установите Git и VS Code](#11-установите-git-и-vs-code)
- [1.2 Создайте аккаунт на GitHub](#12-создайте-аккаунт-на-github)
- [1.3 Сделайте Fork проекта](#13-сделайте-fork-проекта)
- [1.4 Клонируйте Fork на компьютер](#14-клонируйте-fork-на-компьютер)
- [1.5 Заполните ваши цели](#15-заполните-ваши-цели)
- [1.6 Настройте профиль](#16-настройте-профиль)
- [1.7 Настройте систему под себя](#17-настройте-систему-под-себя)
- [1.8 Сохраните изменения в GitHub](#18-сохраните-изменения-в-github)
- **Часть 2: Получите ключи** ⏱ 10 мин
- [2.1 Telegram Bot Token](#21-telegram-bot-token)
- [2.2 Ваш Telegram ID](#22-ваш-telegram-id)
- [2.3 Deepgram API Key](#23-deepgram-api-key)
- **Часть 3: Настройка сервера** ⏱ 30–50 мин
- [3.1 Купите VPS и подключитесь](#31-купите-vps-и-подключитесь)
- [3.2 Создайте пользователя](#32-создайте-пользователя)
- [3.3 Запустите установку (одна команда)](#33-запустите-установку-одна-команда)
- [3.4 Авторизуйте Claude Code](#34-авторизуйте-claude-code)
- [Часть 4: Использование](#часть-4-использование)
- [Часть 5: Синхронизация](#часть-5-синхронизация)
- [Обновление с прошлых версий](#обновление-с-прошлых-версий)
- [Помощь](#помощь)
---
## Зачем это нужно
Это система управления мыслями, заметками и напоминаниями «на стероидах». Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни.
**Кидайте туда вообще всё:**
- Интересные посты из Telegram — пересылайте боту
- Скриншоты — отправляйте
- После встречи — надиктуйте голосом что было и какие решения
- Эмоции, мысли, идеи — всё записывайте
- Ссылки, цитаты, заметки — абсолютно всё
### Самое крутое — с ним можно просто разговаривать
Это **полноценный AI-агент**. В версии 3.0 не нужно нажимать никаких специальных кнопок — просто пишете или наговариваете боту что угодно, и он сам разберётся что делать.
**Примеры того, что можно попросить:**
| Запрос | Что сделает агент |
|--------|-------------------|
| «Найди ту идею про маркетинг, которую я записывал на прошлой неделе» | Найдёт в ваших заметках и покажет |
| «Что я делал вчера?» | Даст отчёт по вчерашним записям |
| «Напомни через час про звонок» | Поставит себе напоминание и напишет вам через час |
| «Каждое утро в 9 — сводка дня» | Создаст повторяющееся расписание и будет присылать сводку сам |
| «Обнови мои недельные цели» | Откроет файл целей и поможет обновить |
| «Что у меня в приоритетах на этой неделе?» | Прочитает ваши цели и ответит по делу |
| «Посоветуй, на чём сфокусироваться сегодня» | Проанализирует цели и записи, даст совет |
Вы общаетесь с ним как с настоящим ассистентом. Он сам найдёт нужные файлы, обновит структуру, поставит напоминание — всё автоматически. Никаких внешних таск-менеджеров: напоминания и расписания агент создаёт сам себе, встроенным планировщиком.
---
Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе — тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты.
**Про Claude Code — не бойтесь названия.** Да, он называется «Code», но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями — сохранять мысли, следить за целями, напоминать о важном. Он просто работает.
---
> **Если вы запутались на каком-то шаге**
>
> Не переживайте! Откройте [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) и напишите:
> «Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]. Вот ссылка: https://github.com/ВАШ_ЛОГИН/agent-second-brain»
>
> Он прочитает инструкцию и поможет вам пошагово.
---
## Как это работает
1. Вы отправляете голосовое/текст/фото в **Telegram**
2. **Бот на сервере** принимает сообщение (голос превращается в текст за секунды)
3. **Claude Code** — живая сессия агента — читает его и отвечает вам прямо в чат
4. Мысли и заметки сохраняются в **Obsidian**-хранилище, напоминания агент ставит себе сам
5. Вечером в 21:00 агент обрабатывает все записи за день и присылает отчёт в **Telegram**
6. Всё синхронизируется в **GitHub**
### Что значит «постоянная сессия» (и почему это важно)
В прошлых версиях бот на каждое сообщение запускал отдельную копию Claude — как если бы вы для каждого вопроса нанимали нового ассистента, объясняли ему всё с нуля, а потом увольняли.
В версии 3.0 на сервере живёт **одна постоянная, открытая сессия Claude Code** — тот же интерактивный Claude Code, который разработчики запускают у себя в терминале. Бот просто «печатает» ваши сообщения в это открытое окно и забирает ответы. Окно никогда не закрывается: его держит программа `tmux` (см. словарь ниже), а специальный сторож-процесс следит, чтобы сессия была живой, и перезапускает её, если что-то пошло не так.
**Почему это здорово:**
- Работает на обычной подписке **Claude Pro или Max** — это интерактивное использование Claude Code, полностью по правилам подписки. Никакой оплаты за каждый запрос.
- Агент помнит контекст разговора: можно сказать «а теперь добавь туда ещё один пункт» — и он поймёт, о чём речь.
- Напоминания срабатывают в отдельной, второй сессии — так сработавший будильник никогда не перебьёт ваш разговор с ботом.
---
## Словарь терминов
Если какие-то слова незнакомы — вот короткий словарь:
| Термин | Что это значит |
|--------|----------------|
| **VPS** | Удалённый мини-компьютер в интернете. Как ваш ПК, но работает 24/7 и находится в дата-центре |
| **SSH** | Способ подключиться к VPS через чёрное окно с текстом (терминал). Как удалённый рабочий стол, но текстом |
| **Token** | Секретный код для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать |
| **Repo** | Репозиторий — папка проекта на GitHub. Там хранятся все файлы и история изменений |
| **.env** | Файл с секретами и настройками. Лежит только на сервере, никуда не публикуется |
| **Fork** | Ваша личная копия проекта. Можете менять как хотите, оригинал не затронете |
| **Clone** | Скачать проект на компьютер. После этого можете открыть его в VS Code |
| **tmux** | Программа, которая держит окно с запущенным Claude Code открытым, даже когда вы отключились от сервера. Благодаря ей сессия агента живёт круглосуточно |
| **systemd** | Встроенный в Linux «менеджер автозапуска». Следит, чтобы бот стартовал при включении сервера и перезапускался при сбоях |
---
## Что понадобится
| Компонент | Зачем | Стоимость |
|-----------|-------|-----------|
| **Claude Pro/Max** | AI-агент, который обрабатывает ваши записи | $20/мес |
| **VPS-сервер** | Чтобы бот работал круглосуточно | ~$5/мес |
| **GitHub** | Хранение и синхронизация всех ваших записей | бесплатно |
| **Deepgram** | Превращение голосовых сообщений в текст | бесплатно ($200 на старт) |
**Итого: ~$25/мес**
Напоминания и расписания делает сам агент — отдельный таск-менеджер не нужен и не стоит ни копейки.
### Где взять VPS
Нужен сервер НЕ в России/Беларуси — там блокировка Claude по территории.
- [Contabo](https://contabo.com) — $4.96/мес, работает с белорусскими картами
- [OVH](https://ovhcloud.com) — $5/мес, тоже работает с белорусскими картами
---
# Часть 1: Подготовка на компьютере ⏱ 30–50 мин
### 1.1 Установите Git и VS Code
**Что это такое:**
- **Git** — программа для скачивания и синхронизации проектов
- **VS Code** — бесплатный редактор файлов (как Word, но для настроек и кода)
---
**Если у вас Windows:**
1. Откройте браузер и перейдите по ссылке: [git-scm.com/download/win](https://git-scm.com/download/win)
2. Скачивание начнётся автоматически. Дождитесь окончания.
3. Откройте папку «Загрузки» на вашем компьютере
4. Найдите скачанный файл (называется что-то вроде `Git-2.xx.x-64-bit.exe`)
5. Дважды щёлкните по нему мышкой
6. Если появится окно «Разрешить этому приложению вносить изменения?» — нажмите **Да**
7. Откроется окно установки. Нажимайте кнопку **Next** (Далее) внизу окна
8. Продолжайте нажимать **Next** до тех пор, пока не появится кнопка **Install** — нажмите её
9. Дождитесь завершения установки и нажмите **Finish**
Теперь установите VS Code:
1. Откройте браузер и перейдите по ссылке: [code.visualstudio.com](https://code.visualstudio.com/)
2. Нажмите большую синюю кнопку **Download for Windows**
3. Откройте папку «Загрузки»
4. Найдите скачанный файл (называется что-то вроде `VSCodeUserSetup-x64-1.xx.x.exe`)
5. Дважды щёлкните по нему
6. Если появится окно «Разрешить этому приложению?» — нажмите **Да**
7. Нажимайте **Next** до кнопки **Install**, затем нажмите **Install**
8. Дождитесь завершения и нажмите **Finish**
9. VS Code запустится автоматически. Если нет — найдите его в меню «Пуск»
---
**Если у вас Mac:**
1. Нажмите клавиши `Cmd + Пробел` одновременно (появится строка поиска)
2. Напечатайте слово `Terminal` и нажмите Enter
3. Откроется чёрное окно — это терминал
4. Напечатайте команду `git --version` и нажмите Enter
5. Если появится окно «Установить инструменты разработчика?» — нажмите кнопку **Установить**
6. Дождитесь завершения установки
Теперь установите VS Code:
1. Откройте браузер и перейдите по ссылке: [code.visualstudio.com](https://code.visualstudio.com/)
2. Нажмите большую кнопку **Download for Mac**
3. Откройте папку «Загрузки» (Downloads)
4. Найдите файл `VSCode-darwin-universal.zip`
5. Дважды щёлкните по нему — он распакуется в приложение
6. Перетащите появившийся значок **Visual Studio Code** в папку **Программы** (Applications)
7. Откройте папку «Программы» и дважды щёлкните на **Visual Studio Code**
---
**Как проверить, что всё установилось:**
После запуска VS Code вы увидите тёмное окно с надписью «Welcome». Это значит, что всё установлено правильно.
---
### 1.2 Создайте аккаунт на GitHub
**Что такое GitHub:**
GitHub — это сайт, где хранятся ваши файлы и записи. Как облачное хранилище, но для проектов.
**Как создать аккаунт:**
1. Откройте браузер и перейдите на сайт [github.com](https://github.com)
2. В правом верхнем углу найдите кнопку **Sign up** и нажмите её
3. Введите ваш email (электронную почту)
4. Придумайте пароль (запишите его, чтобы не забыть!)
5. Придумайте имя пользователя (логин) — это будет ваш адрес на GitHub
> **Важно:** Запомните или запишите ваш логин! Везде далее в инструкции, где написано `ВАШ_ЛОГИН`, вам нужно будет вписывать именно это имя.
6. Нажмите **Create account**
7. Пройдите проверку «Я не робот»
8. Откройте вашу почту и найдите письмо от GitHub
9. Нажмите на ссылку в письме для подтверждения
---
### 1.3 Сделайте Fork проекта
**Что такое Fork:**
Fork — это ваша личная копия проекта. Все ваши записи будут храниться только у вас.
**Как сделать Fork:**
1. Убедитесь, что вы вошли в свой аккаунт на GitHub (в правом верхнем углу должен быть ваш аватар)
2. Откройте в браузере ссылку на оригинальный проект: [github.com/smixs/agent-second-brain](https://github.com/smixs/agent-second-brain)
3. В правом верхнем углу страницы найдите кнопку **Fork** (она выглядит как значок вилки)
4. Нажмите на неё
5. Откроется новая страница с заголовком «Create a new fork»
6. Ничего не меняйте и нажмите зелёную кнопку **Create fork** внизу
7. Подождите несколько секунд — вас перенаправит на вашу копию проекта
Теперь у вас есть своя копия по адресу: `https://github.com/ВАШ_ЛОГИН/agent-second-brain`
> ⚠️ **ВАЖНО: Сделайте репозиторий приватным!**
>
> Ваш форк сейчас **публичный** — все ваши цели и записи будут видны всему интернету!
>
> **Как закрыть:**
> 1. Откройте ваш репозиторий на GitHub
> 2. **Settings** → прокрутите вниз до **Danger Zone**
> 3. Нажмите **Change visibility** → выберите **Private**
>
> Или создайте новый приватный репозиторий и скопируйте туда файлы.
> **Где посмотреть свой логин:**
> Нажмите на свой аватар в правом верхнем углу GitHub — там будет написано ваше имя пользователя.
---
### 1.4 Клонируйте Fork на компьютер
**Что значит «клонировать»:**
Это значит скачать проект с GitHub на ваш компьютер, чтобы вы могли редактировать файлы.
**Шаг 1: Откройте VS Code**
- На Windows: нажмите кнопку «Пуск» в левом нижнем углу экрана, напечатайте `VS Code`, нажмите Enter
- На Mac: нажмите `Cmd + Пробел`, напечатайте `VS Code`, нажмите Enter
**Шаг 2: Откройте командную панель**
- На Windows: нажмите одновременно три клавиши `Ctrl + Shift + P`
- На Mac: нажмите одновременно три клавиши `Cmd + Shift + P`
Сверху окна появится строка для ввода команд.
**Шаг 3: Введите команду клонирования**
1. В появившейся строке напечатайте `Git: Clone` и нажмите Enter
2. Появится строка «Provide repository URL» (введите адрес репозитория)
3. Напечатайте адрес вашего репозитория:
```
https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
```
> **Важно:** Замените `ВАШ_ЛОГИН` на ваш реальный логин GitHub!
> Например, если ваш логин `ivan_petrov`, введите:
> `https://github.com/ivan_petrov/agent-second-brain.git`
4. Нажмите Enter
5. Откроется окно выбора папки. Выберите папку «Документы» (Documents) и нажмите **Select as Repository Destination**
6. Дождитесь, пока проект скачается (появится индикатор загрузки)
7. Появится вопрос «Would you like to open?» — нажмите кнопку **Open**
**Что произошло:**
VS Code скачал проект на ваш компьютер и открыл его. Слева вы увидите список папок и файлов проекта.
> **Если случайно закрыли VS Code:**
> 1. Откройте VS Code снова
> 2. Нажмите меню **File** (Файл) в верхнем левом углу
> 3. Выберите **Open Folder** (Открыть папку)
> 4. Найдите папку `agent-second-brain` в папке «Документы»
> 5. Выберите её и нажмите **Open** (Открыть)
---
### 1.5 Заполните ваши цели
> **ЭТО САМЫЙ ВАЖНЫЙ ШАГ**
>
> Агент использует ваши цели, чтобы понимать, что для вас важно. Без целей он не сможет правильно расставлять приоритеты.
В левой части VS Code найдите папку `vault`, нажмите на стрелочку слева от неё, чтобы раскрыть. Внутри найдите папку `goals`. В ней лежат 4 файла:
- `0-vision-3y.md` — видение на 3 года
- `1-yearly-YYYY.md` — цели на год (переименуйте под текущий год, например `1-yearly-2026.md`)
- `2-monthly.md` — приоритеты на месяц
- `3-weekly.md` — фокус на неделю
**Как заполнить с помощью ChatGPT или Claude:**
1. В левой панели VS Code нажмите на файл `vault/goals/0-vision-3y.md`, чтобы открыть его
2. Нажмите `Ctrl+A` (на Mac: `Cmd+A`), чтобы выделить весь текст
3. Нажмите `Ctrl+C` (на Mac: `Cmd+C`), чтобы скопировать
4. Откройте в браузере [claude.ai](https://claude.ai) или [chat.openai.com](https://chat.openai.com)
5. Вставьте скопированный текст (нажмите `Ctrl+V` или `Cmd+V`)
6. Добавьте после текста:
```
Это шаблон моего 3-летнего видения. Помоги мне его заполнить.
Правила:
1. Задавай вопросы ПО ОДНОМУ
2. Жди мой ответ, потом задавай следующий
3. Копай глубже — если отвечаю размыто, уточняй
4. В конце сформируй заполненный документ в том же формате
Начни с первого вопроса о карьере.
```
7. Отправьте сообщение и отвечайте на вопросы
8. Когда получите готовый заполненный документ — скопируйте его
9. Вернитесь в VS Code
10. В файле `0-vision-3y.md` нажмите `Ctrl+A` (выделить всё), затем `Ctrl+V` (вставить)
11. **Обязательно сохраните файл:** нажмите `Ctrl+S` (на Mac: `Cmd+S`)
> **Важно:** Если на вкладке файла рядом с названием горит белый кружочек — файл не сохранён! Обязательно нажмите `Ctrl+S` / `Cmd+S`.
**Повторите для остальных файлов.**
Промпты для них:
**Для `1-yearly-YYYY.md`:**
```
Это шаблон годовых целей. На основе моего 3-летнего видения
помоги поставить цели на этот год. Задавай вопросы по одному.
```
**Для `2-monthly.md`:**
```
Какие 3 главных приоритета на этот месяц? Задавай вопросы по одному.
```
**Для `3-weekly.md`:**
```
Самое важное — секция "ONE Big Thing". Это одна главная задача на неделю.
Помоги определить её. Задавай вопросы.
```
> **Не забывайте сохранять каждый файл после изменений:** `Ctrl+S` / `Cmd+S`
---
### 1.6 Настройте профиль
Откройте файл с информацией о себе. Есть два способа:
**Быстрый способ:**
1. Нажмите `Ctrl+P` (на Mac: `Cmd+P`)
2. В появившейся строке напечатайте `about.md`
3. Нажмите Enter
**Или вручную:**
В левой панели VS Code раскройте папки по пути:
`vault` → `.claude` → `skills` → `dbrain-processor` → `references` → `about.md`
В этом файле замените информацию на свою:
- Ваше имя
- Чем занимаетесь
- Основные проекты
- Приоритеты
Это поможет агенту понимать контекст ваших записей.
**Сохраните файл:** `Ctrl+S` / `Cmd+S`
---
### 1.7 Настройте систему под себя
> **Важно:** Помимо `about.md`, в папке `vault/.claude/skills/dbrain-processor/references/` есть ещё несколько файлов, которые нужно настроить под себя.
**Какие файлы нужно обновить:**
| Файл | Что там настраивается |
|------|----------------------|
| `about.md` | Ваш профиль, цели, стиль работы |
| `classification.md` | Категории записей, имена клиентов/проектов |
| `business-context.md` | Контекст вашей работы: компания, рынок, роли |
| `contacts.md` | Люди, которых агент должен узнавать в записях |
В той же папке лежат `goals.md`, `links.md`, `rules.md` и `report-template.md` — загляните и в них, там тоже есть подсказки, что заменить.
> Может, у вас нет клиентов — вы работаете на производстве, в офисе, или фрилансер. Это нормально! Замените примеры на свои реалии: проекты, отделы, направления работы.
**Самый простой способ настроить:**
1. В левой панели VS Code найдите папку `vault/.claude/skills/dbrain-processor/`
2. Нажмите на неё правой кнопкой мыши
3. Выберите **Reveal in Finder** (Mac) или **Open in File Explorer** (Windows)
4. Заархивируйте эту папку в ZIP
5. Отправьте архив в [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) с текстом:
```
Это настройки моего AI-ассистента.
Задавай мне вопросы по одному, чтобы заполнить все файлы под меня.
Когда закончим — верни мне обновлённый ZIP-архив.
```
6. Ответьте на все вопросы
7. Скачайте готовый архив
8. Разархивируйте и положите файлы обратно в ту же папку, заменив старые
**Или вручную:**
Откройте каждый файл в папке `references/` и замените примеры `[Your ...]` на свою информацию. В каждом файле есть подсказки.
---
### 1.8 Сохраните изменения в GitHub
Теперь нужно отправить все ваши изменения обратно на GitHub.
1. В левой части VS Code найдите третью иконку сверху — она выглядит как разветвление (три точки, соединённые линиями). Нажмите на неё.
2. Вы увидите раздел **Source Control** со списком изменённых файлов
3. Над списком файлов есть поле для ввода сообщения «Message»
4. Напечатайте в нём: `Initial setup with my goals`
5. Нажмите кнопку **Commit** (галочка сверху)
6. Если появится вопрос «Stage all changes?» — нажмите **Yes**
7. Затем нажмите кнопку **Sync Changes** или **Publish Branch**
8. Если спросит логин — введите ваш логин и пароль от GitHub
Готово! Ваш проект с вашими целями теперь сохранён в вашем репозитории на GitHub.
---
### Контрольная точка: Часть 1 завершена
| Что проверить | Ожидаемый результат |
|---------------|---------------------|
| У вас есть свой репозиторий | Откройте `github.com/ВАШ_ЛОГИН/agent-second-brain` — видите свои файлы |
| На компьютере есть папка проекта | В VS Code слева видны папки `vault`, `src` и файлы |
| Цели заполнены | Откройте `vault/goals/` — там ваши цели, не шаблон |
| Изменения в GitHub | На сайте github.com видны ваши изменения |
---
# Часть 2: Получите ключи ⏱ 10 мин
**Что нужно собрать:**
Вам понадобятся всего **два секретных кода (токена) и одно число**. Соберите их заранее и сохраните в надёжное место — блокнот, заметки или менеджер паролей. Скрипт установки спросит их у вас на сервере.
| Что | Откуда взять | Как выглядит |
|-----|--------------|--------------|
| Telegram Bot Token | @BotFather в Telegram | `7123456789:AAH...` |
| Ваш Telegram ID | @userinfobot в Telegram | `123456789` |
| Deepgram API Key | console.deepgram.com | Длинная строка |
Это всё. Больше никаких ключей и сервисов — напоминания и задачи агент делает сам, без внешних таск-менеджеров.
---
### 2.1 Telegram Bot Token
1. Откройте приложение Telegram на телефоне или компьютере
2. В строке поиска напечатайте `@BotFather`
3. Откройте чат с BotFather (у него синяя галочка верификации)
4. Напечатайте и отправьте сообщение: `/newbot`
5. Бот спросит имя — напечатайте: `My Second Brain`
6. Бот спросит username — придумайте уникальное имя, которое заканчивается на `bot`
Например: `my_brain_777_bot` или `mysb_12345_bot`
7. После создания бот пришлёт вам длинный код — это и есть токен
8. **Скопируйте его сразу и сохраните!** Он выглядит примерно так: `7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx`
---
### 2.2 Ваш Telegram ID
1. В Telegram в строке поиска напечатайте `@userinfobot`
2. Откройте чат с этим ботом
3. Отправьте ему любое сообщение (например, «привет»)
4. Бот ответит информацией о вас. Найдите строку **Id:** и скопируйте число после неё
5. Это ваш Telegram ID, например: `123456789`
Этот номер нужен, чтобы бот отвечал **только вам** — и знал, кому слать ежедневные отчёты.
---
### 2.3 Deepgram API Key
1. Откройте в браузере сайт [console.deepgram.com](https://console.deepgram.com/)
2. Нажмите **Sign Up** и зарегистрируйтесь (можно через Google)
3. После входа в левом меню найдите **Settings** (Настройки)
4. Выберите **API Keys** (Ключи API)
5. Нажмите кнопку **Create API Key** (Создать ключ)
6. Придумайте любое название (например, `second-brain`)
7. **Важно:** Ключ показывается только один раз! Скопируйте его сразу и сохраните.
> **Предупреждение:** Если вы закроете окно, не скопировав ключ — он исчезнет навсегда и придётся создавать новый.
---
### Контрольная точка: Часть 2 завершена
| Что проверить | Ожидаемый результат |
|---------------|---------------------|
| Telegram Bot Token | Строка вида `7123456789:AAH...` |
| Ваш Telegram ID | Число вида `123456789` |
| Deepgram API Key | Длинная строка букв и цифр |
> **Сохраните все токены** в надёжное место. Они понадобятся при настройке сервера.
Заодно решите, какая у вас **таймзона** (например, `Europe/Moscow`, `Asia/Tashkent`, `Europe/Minsk`) — скрипт установки спросит и её. По этой таймзоне агент будет присылать вечерний отчёт и срабатывать напоминания.
---
# Часть 3: Настройка сервера ⏱ 30–50 мин
Хорошая новость: в версии 3.0 вам **не нужно вручную устанавливать** Python, Node.js и остальное. Всё это делает один скрипт. От вас — купить сервер, создать пользователя и запустить одну команду.
### 3.1 Купите VPS и подключитесь
**Шаг 1: Купите сервер**
1. Откройте сайт [Contabo](https://contabo.com/en/vps/) или [OVH](https://ovhcloud.com/en/vps/)
2. Выберите самый дешёвый тариф (хватит с запасом)
3. **Важно:** При выборе операционной системы выберите **Ubuntu 22.04** (или новее) — это база
4. Завершите покупку и оплату
5. На вашу почту придёт письмо с данными для входа: IP-адрес и пароль
**Шаг 2: Подключитесь к серверу**
На Windows:
1. Нажмите кнопку **Пуск** в левом нижнем углу
2. Напечатайте `cmd` и нажмите Enter
3. Откроется чёрное окно — это командная строка
На Mac:
1. Нажмите `Cmd + Пробел`
2. Напечатайте `Terminal` и нажмите Enter
В открывшемся окне напечатайте команду (замените `ВАШ_IP_АДРЕС` на IP из письма):
```bash
ssh root@ВАШ_IP_АДРЕС
```
Например: `ssh root@185.123.45.67`
Нажмите Enter.
Если спросит «Are you sure you want to continue?» — напечатайте `yes` и нажмите Enter.
> **Важно о пароле:**
> **Когда вы вводите пароль, в чёрном окне ничего не печатается — это нормально!** Это не зависание. Просто введите пароль из письма и нажмите Enter. Буквы не видно в целях безопасности.
---
### 3.2 Создайте пользователя
Работать под пользователем root небезопасно — и скрипт установки от root запускаться **откажется**. Создайте обычного пользователя.
Напечатайте эти команды **по одной**, нажимая Enter после каждой:
```bash
adduser myuser
```
Система попросит придумать пароль — придумайте и запомните его. На остальные вопросы просто нажимайте Enter.
```bash
usermod -aG sudo myuser
```
```bash
su - myuser
```
Теперь вы работаете под пользователем `myuser`.
---
### 3.3 Запустите установку (одна команда)
Вся установка — одна команда. Скопируйте, вставьте в терминал и нажмите Enter (замените `ВАШ_ЛОГИН` на ваш логин GitHub):
```bash
curl -fsSL https://raw.githubusercontent.com/ВАШ_ЛОГИН/agent-second-brain/main/bootstrap.sh | bash
```
Дальше скрипт ведёт вас за руку. Под капотом работает цепочка из трёх скриптов — знать это не обязательно, но полезно понимать, что происходит на экране:
1. **bootstrap.sh** — та самая команда выше. Скачивает установщик и запускает его.
2. **setup.sh** — интерактивный опросник. Он:
- установит всё необходимое сам: git, tmux, uv, Node.js, Claude Code
- спросит ваш **логин GitHub** и скачает ваш форк в `~/projects/agent-second-brain`
- спросит **токены** по одному: Telegram Bot Token, ваш Telegram ID, Deepgram API Key (и сразу проверит, что формат правильный)
- спросит вашу **таймзону** (например, `Europe/Moscow`; если просто нажать Enter — будет UTC)
- предложит настроить **доступ к GitHub** для автосинхронизации записей (понадобится Personal Access Token — скрипт подскажет, где его взять)
- попросит **авторизовать Claude Code** — про это следующий шаг, он важный
3. **upgrade.sh** — финальный аккорд, запускается автоматически. Ставит Python-зависимости, команду `dbrain`, сервисы автозапуска (systemd), запускает бота и проводит первый health check — самопроверку, что всё живо.
Отвечайте на вопросы скрипта и не пугайтесь бегущих строк — это нормально.
> **Если команда не сработала**, выполните то же самое вручную:
>
> ```bash
> cd ~
> git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
> cd agent-second-brain
> bash setup.sh
> ```
---
### 3.4 Авторизуйте Claude Code
В какой-то момент скрипт остановится и скажет: **Claude Code is not logged in** — нужно войти в ваш аккаунт Claude (тот самый, где подписка Pro или Max). Без этого мозг агента не запустится.
Скрипт попросит сделать вход в **отдельном терминале**. Вот как:
1. **Не закрывая** окно с установкой, откройте **второе окно терминала** (на Mac: `Cmd+N` в Терминале; на Windows: запустите `cmd` ещё раз)
2. Во втором окне подключитесь к серверу под вашим пользователем:
```bash
ssh myuser@ВАШ_IP_АДРЕС
```
3. Запустите Claude:
```bash
claude
```
4. Claude предложит войти и покажет **ссылку**. Скопируйте её и откройте в браузере на вашем компьютере
5. Войдите в аккаунт Anthropic (выбирайте вход через подписку Claude Pro/Max, не API) и подтвердите доступ
6. Вернитесь во второе окно терминала — Claude подтвердит вход. Выйдите из него (наберите `/exit` или нажмите `Ctrl+C` дважды)
7. Вернитесь в **первое** окно с установкой и нажмите Enter — скрипт проверит вход и продолжит сам
После этого установка дойдёт до конца и покажет рамку **SETUP COMPLETE!** — значит, бот уже запущен.
---
### Контрольная точка: Часть 3 завершена
| Что проверить | Как проверить |
|---------------|---------------|
| Установка завершилась | На экране рамка `SETUP COMPLETE!` |
| Бот отвечает на /start | В Telegram найдите вашего бота, отправьте `/start` — видны кнопки меню |
| Голосовые распознаются | Отправьте голосовое — бот ответит по делу |
| Всё живо | На сервере выполните `dbrain status` — бот и сторож активны, «мозг: жив» |
| Работает после перезагрузки | Перезагрузите сервер (`sudo reboot`), подождите пару минут — бот снова отвечает |
Попробуйте сразу: напишите боту **«напомни через 10 минут размяться»** — и проверьте, что через 10 минут он напишет вам сам. Это лучший тест, что всё работает.
---
# Часть 4: Использование
### Кнопки бота
```
┌──────────────────────────────────────────┐
│ [📊 Статус] [⚙️ Обработать] [❓ Помощь] │
└──────────────────────────────────────────┘
```
| Кнопка | Что делает |
|--------|------------|
| 📊 Статус | Показывает сколько записей сегодня |
| ⚙️ Обработать | Запускает обработку всех записей прямо сейчас |
| ❓ Помощь | Показывает справку |
А где кнопка «Запрос»? Она больше не нужна: **любое** ваше сообщение — это и есть запрос. Просто пишите или наговаривайте боту, что хотите.
---
### Что можно отправлять
**Голосовые** — основной способ:
- «Надо написать Пете по проекту»
- «Идея: сделать лендинг с калькулятором»
**Текст** — ссылки, цитаты, быстрые мысли, вопросы агенту
**Фото и картинки** — скриншоты, фото досок: агент сохранит файл и сам прочитает, что на нём
**Файлы, видео, кружочки** — всё сохраняется в хранилище
**Пересланные посты** — из других чатов и каналов (агент запомнит и откуда)
**Альбомы** — несколько фото одним сообщением, агент обработает их вместе
---
### Напоминания и расписания — главная суперсила
Агент сам управляет своим расписанием. Никаких внешних приложений — говорите обычным языком:
- «Напомни через час про звонок» → напишет вам через час
- «Напомни завтра в 15:00 про презентацию» → разовое напоминание
- «Каждое утро в 9 — сводка дня» → повторяющееся расписание
- «Каждый будний день в 18:30 проверяй мою папку входящих» → регулярная проверка (и молчит, если нового ничего нет)
- «Покажи мои напоминания» / «Удали напоминание про зарядку» → управление списком
Напоминания срабатывают в отдельной сессии, поэтому будильник никогда не перебьёт ваш разговор с ботом.
---
### Разговор с контекстом
Сессия агента постоянная — он помнит, о чём вы только что говорили:
> **Вы:** что я писал про маркетинговый проект на той неделе?
>
> **Бот:** *находит и показывает записи*
>
> **Вы:** вторую идею оформи как заметку проекта с следующими шагами
>
> **Бот:** *создаёт заметку, связывает с другими*
>
> **Вы:** добавь туда ещё пункт про презентацию
>
> **Бот:** *обновляет ту же заметку*
Полезные команды в чате:
| Команда | Что делает |
|---------|------------|
| `/status` | Статус системы |
| `/process` | Запустить обработку записей |
| `/new` | Начать разговор с чистого листа (записи в файлах не трогает) |
| `/compact` | Сжать контекст разговора, если он стал слишком длинным |
| `/help` | Справка |
---
### Что происходит само, без вас
- **Каждый вечер в 21:00** (по вашей таймзоне) агент обрабатывает все записи за день: классифицирует, раскладывает по папкам, обновляет карточки — и присылает **отчёт в Telegram**: что произошло, что сделано, что висит.
- **Каждое утро в 08:00** проходит самопроверка (доктор): агент убеждается, что все системы живы, и чинит себя, если нужно.
- **Память забывает, как настоящая.** За память отвечает движок **autograph** — он использует кривую забывания Эббингауза: информация со временем «остывает», если вы к ней не возвращаетесь. Пять уровней — от «всегда в контексте» (текущие проекты, цели) до «почти забыто» (старый архив, который иногда случайно всплывает и даёт неожиданные идеи). Тот же движок следит за здоровьем хранилища: оценивает его по 100-балльной шкале, чинит сломанные ссылки, находит заметки-сироты и строит карты содержания (MOC). Движок живёт в отдельном репозитории — [github.com/smixs/autograph](https://github.com/smixs/autograph) — и работает на любом Obsidian-хранилище.
Вы не занимаетесь обслуживанием. Этим занимается агент.
---
# Часть 5: Синхронизация
Ваши записи хранятся в папке `vault/`. Есть несколько способов их просматривать:
### Способ 1: Obsidian (рекомендуем)
**Что такое Obsidian:**
Это бесплатное приложение для просмотра заметок с красивыми связями между ними. Вы сможете видеть все свои мысли, заметки и цели в удобном интерфейсе.
**На компьютере:**
1. Откройте браузер и перейдите на [obsidian.md](https://obsidian.md)
2. Скачайте приложение для вашей системы и установите его
3. Откройте Obsidian
4. Нажмите **Open folder as vault**
5. Найдите папку `agent-second-brain` (там, куда вы скачивали проект в Части 1)
6. Внутри неё выберите папку `vault`
7. Нажмите **Open**
Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе. Чтобы подтянуть свежие записи с сервера — откройте папку проекта в VS Code и нажмите **Sync Changes** (или выполните `git pull`).
**На iPhone/iPad:**
1. На компьютере переместите папку `vault` в iCloud Drive
2. На iPhone скачайте Obsidian из App Store
3. В приложении «Файлы» найдите папку `vault` в iCloud
4. В Obsidian нажмите «Open folder as vault» → выберите эту папку
**На Android:**
1. Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal)
2. Подключите ваш GitHub репозиторий
3. Все заметки будут синхронизироваться автоматически
---
### Способ 2: GitHub напрямую
Все файлы хранятся в вашем репозитории на GitHub по адресу:
```
https://github.com/ВАШ_ЛОГИН/agent-second-brain
```
Вы можете:
- Просматривать заметки прямо на сайте
- Редактировать файлы через веб-интерфейс
- Скачивать обновления командой `git pull`
---
### Способ 3: Просто спросите бота
Самый простой способ — спросить напрямую в Telegram:
- «Что я записал вчера?»
- «Покажи мои цели на неделю»
- «Какие напоминания у меня стоят?»
- «Найди заметку про [тема]»
Бот найдёт и покажет всё что нужно прямо в Telegram.
---
# Обновление с прошлых версий
Уже пользуетесь Agent Second Brain первой или второй версии? Переход на v3.0 — это **одна команда**.
Подключитесь к серверу и выполните:
```bash
cd ~/projects/agent-second-brain
git pull
bash upgrade.sh
```
> Если у вас проект лежит в другой папке (например, прямо в `~/agent-second-brain`) — перейдите в неё: `cd ~/agent-second-brain`.
Скрипт сам:
- установит tmux и обновит зависимости
- подтянет свежий код
- **мигрирует старые сервисы** со старых имён `d-brain-*` на новые `dbrain-*` (старые отключит и удалит)
- установит команду `dbrain`
- запустит постоянную сессию и проведёт health check
Скрипт **идемпотентный** — это значит, что его безопасно запускать сколько угодно раз. Что-то пошло не так? Просто запустите `bash upgrade.sh` ещё раз.
> **Из .env можно удалить устаревшие строки** от старых версий (например, ключи внешних таск-менеджеров) — v3.0 их игнорирует. А встроенный навык `migrate-doctor` умеет диагностировать и чинить поломанные обновления: запустите на сервере `claude` и напишите «проверь моё обновление».
---
# Помощь
### Команда `dbrain` — ваш пульт управления
После установки на сервере доступна команда `dbrain` — простая обёртка над всеми проверками:
```bash
dbrain status # всё ли живо: бот, сторож, мозг
dbrain logs # последние логи бота
dbrain restart # перезапустить сервисы (мозг при этом выживает)
dbrain doctor # полный осмотр с диагнозом
dbrain attach # подключиться к живой сессии мозга и посмотреть, что он делает
dbrain clear # очистить память текущего разговора (файлы не трогает)
dbrain login # войти в Claude заново, если слетела авторизация
```
> **`dbrain attach` — это окно в голову агента.** Вы увидите ту самую живую сессию Claude Code, в которую бот печатает ваши сообщения. Посмотрели — выходите комбинацией `Ctrl+B`, затем `D` (именно отпустив Ctrl+B перед D). **Не закрывайте окно крестиком и не жмите Ctrl+C** — сессия должна остаться жить.
---
### Если что-то пошло не так
Самый простой способ решить проблему — запустить программу `claude` прямо в чёрном окне сервера.
1. Подключитесь к серверу (как в Части 3)
2. Перейдите в папку проекта:
```bash
cd ~/projects/agent-second-brain
```
3. Запустите Claude:
```bash
claude
```
4. Напишите ему:
```
Я настраиваю бота, у меня возникла ошибка: [опишите что случилось]
Что мне сделать?
```
Claude прочитает файлы проекта и поможет решить проблему.
---
### Частые проблемы
**Бот не отвечает в Telegram:**
Проверьте, работает ли он. Подключитесь к серверу и выполните:
```bash
dbrain status
```
Бот и сторож должны быть `active`, мозг — «жив». Если нет:
```bash
dbrain repair
```
**Голосовые не распознаются:**
Проверьте, правильно ли вы ввели ключ Deepgram при настройке:
```bash
cat ~/projects/agent-second-brain/.env | grep DEEPGRAM
```
Поправить можно прямо в файле: `nano ~/projects/agent-second-brain/.env`, затем `dbrain restart`.
**Claude не работает / агент молчит:**
Скорее всего, слетела авторизация. Войдите заново:
```bash
dbrain login
```
Откройте ссылку на телефоне или ноутбуке, подтвердите и вставьте код обратно в терминал.
**Хочется посмотреть логи:**
```bash
dbrain logs
# или в реальном времени:
journalctl --user -u dbrain-bot -f
```
---
Технические детали (для продвинутых)
### Архитектура v3.0
```
Telegram → Deepgram → постоянная сессия Claude Code (tmux) → Obsidian vault → отчёт в Telegram
```
Бот не запускает новый процесс Claude на каждое сообщение. Он держит одну долгоживущую **интерактивную** сессию Claude Code в tmux-окне и программно печатает в неё промпты. Это интерактивное использование — оно остаётся на вашей подписке Claude Pro/Max, без пооперационной оплаты. Сторож (watchdog) и ежедневный доктор следят за здоровьем сессии и перезапускают её при сбоях. Запланированные задания (напоминания) выполняются во второй, изолированной сессии.
### Сервисы
Всё работает на **пользовательских** systemd-юнитах (`systemctl --user`, без root):
| Юнит | Что делает |
|------|-----------|
| `dbrain-bot.service` | Telegram-бот + постоянная сессия мозга |
| `dbrain-watchdog.service` | Сторож: следит за здоровьем и чинит |
| `dbrain-process.timer` | Ежедневная обработка записей в 21:00 |
| `dbrain-doctor.timer` | Ежедневная самопроверка в 08:00 |
Чтобы сервисы работали без вашего входа на сервер и стартовали при перезагрузке, скрипт установки включает linger (`loginctl enable-linger`).
### Полезные команды
```bash
# Статус всего
dbrain status
systemctl --user status 'dbrain-*'
# Логи бота
journalctl --user -u dbrain-bot -f # в реальном времени
journalctl --user -u dbrain-bot -n 100 # последние 100 строк
# Перезапустить бота (сессия мозга выживает — KillMode=process)
systemctl --user restart dbrain-bot
# Остановить / запустить
systemctl --user stop dbrain-bot
systemctl --user start dbrain-bot
# Таймеры
systemctl --user list-timers
# Запустить обработку вручную
cd ~/projects/agent-second-brain
./scripts/process.sh
# Обновить код и сервисы (идемпотентно)
cd ~/projects/agent-second-brain
bash upgrade.sh
```
### Файл .env
Все настройки в `~/projects/agent-second-brain/.env` (создаётся скриптом установки, права 600):
```bash
TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx
DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
VAULT_PATH=./vault
ALLOWED_USER_IDS=[123456789]
TZ=Europe/Moscow
```
> В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки! Первый ID в списке получает отчёты и оповещения о здоровье системы.
Опционально: `CLAUDE_MODEL=sonnet` — переключить сессию на Sonnet, если упираетесь в недельные лимиты подписки; `CRON_ENABLED=false` — выключить планировщик напоминаний.
### MCP-серверы
Система поддерживает **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам. Хотите, чтобы агент умел работать с вашей почтой, календарём или заметками в других сервисах — подключите соответствующий MCP-сервер.
Как подключить: положите файл `mcp-config.json` в корень проекта (`~/projects/agent-second-brain/mcp-config.json`) — сессия подхватит его при следующем старте (он передаётся в Claude Code через `--mcp-config`). После добавления перезапустите: `dbrain restart`.
Примеры серверов:
| Сервис | MCP-сервер | Что можно делать |
|--------|------------|------------------|
| **Google Workspace** | [google_workspace_mcp](https://github.com/taylorwilsdon/google_workspace_mcp) | Gmail, Calendar, Drive |
| **Notion** | [notion-mcp-server](https://github.com/makenotion/notion-mcp-server) | Страницы, базы данных |
| **GitHub** | [github-mcp-server](https://github.com/github/github-mcp-server) | Issues, PR, репозитории |
Полный список: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)
### Навыки агента
| Навык | Что делает |
|-------|-----------|
| **dbrain-processor** | Классифицирует записи, раскладывает заметки |
| **autograph** | Память и здоровье хранилища: забывание по Эббингаузу, граф связей, MOC ([отдельный репозиторий](https://github.com/smixs/autograph)) |
| **cron** | Агент сам управляет своим расписанием: напоминания, интервалы, cron-выражения — из обычного языка |
| **migrate-doctor** | Диагностирует и чинит поломанные обновления со старых версий |
### Если сервисы не установились
Не редактируйте юниты руками — все сервисы ставит и чинит один идемпотентный скрипт:
```bash
cd ~/projects/agent-second-brain
bash upgrade.sh
```
Он переустановит юниты `dbrain-*`, перезапустит сервисы и проведёт health check. Безопасно запускать повторно.
---
Инструкция для Claude Code (читает Claude, не вы)
### Команды с sudo
Claude Code не может выполнять команды с `sudo` — они требуют ввода пароля.
Когда нужно выполнить команду с sudo, попроси пользователя:
```
Мне нужно выполнить команду с sudo, но я не могу ввести пароль.
Пожалуйста, сделайте следующее:
1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T)
2. Подключитесь к серверу:
ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС
3. Выполните эту команду:
sudo [КОМАНДА]
4. Введите пароль когда попросят
5. Вернитесь ко мне и скажите что готово
```
### Ручные шаги настройки
**Клонирование репозитория:**
```bash
cd ~
mkdir -p projects
cd projects
git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git
cd agent-second-brain
uv sync
```
**Создание .env:**
```bash
nano .env
```
Содержимое:
```bash
TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx
DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
VAULT_PATH=./vault
ALLOWED_USER_IDS=[123456789]
TZ=UTC
```
> В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки!
**Тестовый запуск:**
```bash
uv run python -m d_brain
```
**Установка сервисов и постоянной сессии:**
```bash
bash upgrade.sh
```
НЕ создавай systemd-юниты вручную и НЕ используй системные (root) юниты — все сервисы ставятся как `systemctl --user` юниты скриптом `upgrade.sh`. НЕ запускай Claude в headless-режиме для обработки сообщений — обработка идёт через постоянную интерактивную сессию в tmux, это инвариант архитектуры v3.0 (проверяется скриптом `scripts/check-no-claude-p.sh`).
**Настройка Git push:**
```bash
git config user.name "My Bot"
git config user.email "your@email.com"
```
Создай Personal Access Token на GitHub: Settings → Developer settings → Personal access tokens → Fine-grained tokens → токен только на репозиторий agent-second-brain с правом Contents: Read and write
```bash
chmod 600 .git/config
git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git
```