An always-on second brain you talk to. Voice notes in Telegram → typed, linked knowledge in your Obsidian vault. Runs 24/7 on the Claude subscription you already have.
Python ai-agentsai-automationclaudeclaude-codeebbinghausknowledge-graphllmmemory-systemobsidianpersonal-assistantpkmproductivitypythonsecond-braintelegram-botvoice-assistant
docs: обновить README
smixs31833393b3bb
diff --git a/README.md b/README.mdindex b7895c5..58c2d5d 100644--- a/README.md+++ b/README.md@@ -2,51 +2,15 @@-**Персональный AI-ассистент с долговременной памятью**-Записывайте голосовые в Telegram — агент сам разберётся что с ними делать: создаст задачи, сохранит мысли, обновит прогресс по целям.-------## Что это и зачем--Вы отправляете боту всё подряд: голосовые заметки, скриншоты, пересланные сообщения, ссылки. Бот сохраняет это в один файл за день.+Записывайте голосовые в Telegram - агент сам разберётся что с ними делать: создаст задачи, сохранит мысли, обновит прогресс по целям.-Вечером (по расписанию или вручную) запускается Claude — он читает ваши записи и:-- Создаёт задачи в Todoist (с приоритетами и датами)-- Сохраняет ценные мысли в Obsidian (идеи, выводы, инсайты)-- Связывает новые записи с вашими целями-- Присылает отчёт в Telegram: что сделал, что предстоит--В конце недели — автоматический дайджест: прогресс по целям, что получилось, что нет.<img width="1052" height="2068" alt="Telegram_27_December_2025_3NllRAwD" src="https://github.com/user-attachments/assets/f97d7037-5c51-4672-bee8-53af9c6b6423" />----## Как это выглядит--```-Вы в течение дня:-┌────────────────────────────────────┐-│ 🎤 "Надо обсудить проект с Лёшей" │-│ 📷 [скриншот ошибки] │-│ 💬 "Идея для лендинга: ..." │-│ ↪️ [переслал чат с клиентом] │-└────────────────────────────────────┘- ↓-Claude вечером:-┌────────────────────────────────────┐-│ ✅ Создано 3 задачи в Todoist │-│ 📝 Сохранена идея: лендинг │-│ 🎯 Связь с целью: Запуск продукта │-│ 📊 Прогресс недели: 65% │-└────────────────────────────────────┘-```-------## Архитектура+## Как это работает```┌──────────────┐@@ -70,81 +34,148 @@ Claude вечером:(отчёт обратно)```-**Как это работает:**1. Вы отправляете голосовое/текст/фото в **Telegram**2. **Бот на VPS** сохраняет всё в файл-3. **Claude Code** (агент) анализирует записи+3. **Claude Code** анализирует записи4. Создаёт задачи в **Todoist**, сохраняет мысли в **Obsidian**5. Отправляет отчёт обратно в **Telegram**-6. Всё синхронизируется в **GitHub** (backup)+6. Всё синхронизируется в **GitHub**----## Требования--### Обязательно+## Что понадобится| Компонент | Зачем | Стоимость ||-----------|-------|-----------|-| **Claude Max/Pro** | AI-агент для обработки записей | от $20/мес |-| **VPS-сервер** | Хостинг бота 24/7 | от $4/мес |-| **GitHub** | Бесплатный backup и синхронизация | бесплатно |+| **Claude Pro/Max** | AI-агент | $20/мес |+| **VPS-сервер** | Бот работает 24/7 | ~$5/мес |+| **GitHub** | Backup и синхронизация | бесплатно || **Deepgram** | Транскрипция голосовых | бесплатно ($200 на старт) |+| **Todoist** | Задачи в одном месте | бесплатно / $4/мес Pro |-### Рекомендуется+**Итого: ~$25/мес**-| Компонент | Зачем | Стоимость |-|-----------|-------|-----------|-| **Todoist** | Управление задачами | бесплатно / $4/мес Pro |-| **Obsidian** | Просмотр заметок на компе | бесплатно |+### Где брать VPS-### Важные замечания+Нужен сервер НЕ в РФ/РБ - там блокировка Claude по территории.-**Claude:** Минимальная подписка за $20/мес — достаточно. Это сильно лучше ChatGPT для работы.+- [Contabo](https://contabo.com) - $4.96/мес, работает с белорусскими картами+- [OVH](https://ovhcloud.com) - $5/мес, тоже работает с белорусскими картами-**VPS:** Нужен сервер НЕ в РФ/РБ (блокировка Claude по территории). Рекомендую:-- [Contabo](https://contabo.com) — $4.96/мес, работает с белорусскими картами-- [OVH](https://ovhcloud.com) — $5/мес, тоже работает с белорусскими картами+---++# 🔥 БЫСТРЫЙ СТАРТ++## Самое важное - установите Claude Code на сервер-**Deepgram:** $200 на счёт при регистрации. Хватает на ~500 часов голосовых сообщений.+Как только вы это сделаете - Claude Code сам поможет вам настроить всё остальное. Серьёзно. Скидываете ему ссылку на эту инструкцию, и он всё делает за вас.----# Часть 1: Подготовка на компьютере+### Шаг 1: Купите VPS и подключитесь-Сначала настраиваем проект локально, потом переносим на сервер.+1. Купите VPS на [Contabo](https://contabo.com/en/vps/) или [OVH](https://ovhcloud.com/en/vps/)+2. Выберите Ubuntu 22.04+3. Получите на почту IP-адрес и пароль-## 1.1 Установка Git и VS Code+<img width="2514" height="1962" alt="Arc_27_December_2025_XNzzknIo" src="https://github.com/user-attachments/assets/9cd54275-199a-418c-9881-6be3aee471f5" />-### Windows+<img width="2176" height="1454" alt="Spark Desktop_27_December_2025_sltZRiMZ" src="https://github.com/user-attachments/assets/7dceb211-90af-4d78-abb0-cec19a0abbdd" />-1. Скачайте [Git для Windows](https://git-scm.com/download/win)-2. Установите, оставив все настройки по умолчанию-3. Скачайте [VS Code](https://code.visualstudio.com/)-4. Установите+4. Откройте терминал и подключитесь:++```bash+ssh root@ВАШ_IP_АДРЕС+```-### Mac+<img width="1450" height="810" alt="Ghostty_27_December_2025_OwCbt58A" src="https://github.com/user-attachments/assets/92b32f25-b6df-4d25-aac9-7733079cfac7" />-1. Откройте Terminal (`Cmd + Пробел` → наберите "Terminal")-2. Введите `git --version`-3. Если не установлен — система предложит установить Xcode Command Line Tools, соглашайтесь-4. Скачайте [VS Code](https://code.visualstudio.com/)+----<img width="1564" height="248" alt="Ghostty_27_December_2025_vPEZpgCt" src="https://github.com/user-attachments/assets/121bb943-ecf1-4827-93f4-ef59221bb49b" />+### Шаг 2: Установите базовые инструменты++Копируйте команды по одной:++```bash+# Обновление системы+sudo apt update && sudo apt upgrade -y++# Базовые инструменты+sudo apt install -y git curl wget build-essential++# Node.js 20+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -+sudo apt install -y nodejs+```++---++### Шаг 3: Установите Claude Code++```bash+npm install -g @anthropic-ai/claude-code+```+----### Linux+### Шаг 4: Авторизуйтесь в Claude```bash-sudo apt install git-# VS Code: https://code.visualstudio.com/+claude auth login```+Следуйте инструкциям: откроется ссылка → авторизуйтесь в браузере → скопируйте код → вставьте в терминал.++<img width="1578" height="994" alt="Ghostty_27_December_2025_gAcpHg2c" src="https://github.com/user-attachments/assets/cfb74cc5-66af-4c19-9a5c-05ef4f454194" />+----## 1.2 Создание аккаунта на GitHub+### Шаг 5: Запустите Claude Code и скиньте ему эту инструкцию++```bash+claude+```++Когда откроется - напишите:++```+Следуй этой инструкции и помоги мне полностью развернуть и настроить систему:+https://github.com/smixs/agent-second-brain++Я уже установил Claude Code и авторизовался. Продолжи с того места,+где нужно установить Python, uv, клонировать репозиторий и настроить бота.+```++**Всё.** Claude Code прочитает эту инструкцию, поймёт структуру проекта и проведёт вас через все шаги. Он видит все файлы, может сам устанавливать пакеты, редактировать конфиги, запускать команды.++Если что-то пойдёт не так - просто опишите проблему. Он разберётся.++---++# 📖 ПОЛНАЯ ИНСТРУКЦИЯ (для тех, кто хочет вручную)++Если предпочитаете делать всё сами - вот пошаговая инструкция.++---++## Часть 1: Подготовка на компьютере++### 1.1 Установите Git и VS Code++**Windows:**+1. Скачайте [Git для Windows](https://git-scm.com/download/win) - установите+2. Скачайте [VS Code](https://code.visualstudio.com/) - установите++**Mac:**+1. Откройте Terminal (`Cmd + Пробел` → "Terminal")+2. Введите `git --version` - если не установлен, система предложит установить+3. Скачайте [VS Code](https://code.visualstudio.com/)++<img width="1564" height="248" alt="Ghostty_27_December_2025_vPEZpgCt" src="https://github.com/user-attachments/assets/121bb943-ecf1-4827-93f4-ef59221bb49b" />++----Если у вас ещё нет аккаунта:+### 1.2 Создайте аккаунт на GitHub1. Зайдите на [github.com](https://github.com)2. Нажмите "Sign up"@@ -153,78 +184,61 @@ sudo apt install git<img width="3022" height="2080" alt="Arc_27_December_2025_bAQJJGoP" src="https://github.com/user-attachments/assets/c09c12d8-23ee-4a2c-800e-aab564453ecd" />-----## 1.3 Fork проекта (создание своей копии)+### 1.3 Сделайте Fork проекта-Fork — это ваша личная копия проекта. Все ваши записи будут храниться у вас.+Fork - это ваша личная копия. Все записи будут храниться у вас.-1. Откройте оригинальный репозиторий: [github.com/smixs/agent-second-brain](https://github.com/smixs/agent-second-brain)+1. Откройте: [github.com/smixs/agent-second-brain](https://github.com/smixs/agent-second-brain)2. Нажмите кнопку **Fork** (правый верхний угол)3. Выберите свой аккаунт4. Нажмите "Create fork"<img width="2750" height="1164" alt="Arc_27_December_2025_Uw5hbtiu" src="https://github.com/user-attachments/assets/c4cd5d39-f690-456b-892d-615c36460dba" />-Теперь у вас есть своя копия: `https://github.com/ВАШ_ЛОГИН/agent-second-brain`----## 1.4 Клонирование вашего fork на компьютер+### 1.4 Клонируйте Fork на компьютер1. Откройте VS Code-2. Нажмите `Ctrl+Shift+P` (Windows/Linux) или `Cmd+Shift+P` (Mac)-3. Введите "Git: Clone" и выберите эту команду-4. Вставьте URL **вашего fork** (не оригинала!):+2. `Ctrl+Shift+P` (Win/Linux) или `Cmd+Shift+P` (Mac)+3. Введите "Git: Clone"+4. Вставьте URL **вашего fork**:```https://github.com/ВАШ_ЛОГИН/agent-second-brain.git```5. Выберите папку (например, Documents)-6. Нажмите "Open" когда спросит--Если спросит логин — введите свой GitHub логин и пароль (или Personal Access Token, если включена двухфакторка).--Теперь у вас открыт проект в VS Code.+6. Нажмите "Open"<img width="1924" height="1554" alt="Code_27_December_2025_mBvxd2PN" src="https://github.com/user-attachments/assets/cb65c71c-8229-4caa-b958-9c636f952c72" />-----## 1.5 Заполнение ваших целей (самый важный шаг!)+### 1.5 Заполните ваши цели-Бот использует ваши цели для приоритизации задач. Без целей он не будет понимать, что для вас важно.+> ⚠️ **ЭТО САМЫЙ ВАЖНЫЙ ШАГ**+>+> Бот использует ваши цели для приоритизации задач. Без целей он не понимает, что для вас важно.-В папке `vault/goals/` лежат 4 файла-шаблона:-- `0-vision-3y.md` — видение на 3 года-- `1-yearly-2025.md` — цели на год-- `2-monthly.md` — приоритеты на месяц-- `3-weekly.md` — фокус на неделю+В папке `vault/goals/` лежат 4 файла:+- `0-vision-3y.md` - видение на 3 года+- `1-yearly-2025.md` - цели на год+- `2-monthly.md` - приоритеты на месяц+- `3-weekly.md` - фокус на неделю-**Заполнять будем с помощью ChatGPT или Claude** — так проще и глубже.+**Заполняем с помощью ChatGPT или Claude:**-### Шаг 1: Откройте первый файл--1. В левой панели VS Code найдите папку `vault`-2. Раскройте её (нажмите на стрелочку)-3. Раскройте папку `goals`-4. Нажмите на файл `0-vision-3y.md`+1. В VS Code откройте файл `vault/goals/0-vision-3y.md`<img width="2422" height="2078" alt="Code_27_December_2025_iTpZrkVd" src="https://github.com/user-attachments/assets/cd30d883-c430-4282-9fb6-3fc88edf1002" />--### Шаг 2: Скопируйте содержимое--1. Нажмите `Ctrl+A` (Windows/Linux) или `Cmd+A` (Mac) — выделить всё-2. Нажмите `Ctrl+C` (Windows/Linux) или `Cmd+C` (Mac) — скопировать--### Шаг 3: Откройте ChatGPT или Claude--1. Зайдите на [chat.openai.com](https://chat.openai.com) или [claude.ai](https://claude.ai)-2. Вставьте скопированный текст-3. После текста добавьте этот промпт:+2. Выделите всё: `Ctrl+A` / `Cmd+A`+3. Скопируйте: `Ctrl+C` / `Cmd+C`+4. Откройте [claude.ai](https://claude.ai) или [chat.openai.com](https://chat.openai.com)+5. Вставьте текст и добавьте промпт:```Это шаблон моего 3-летнего видения. Помоги мне его заполнить.@@ -232,126 +246,79 @@ Fork — это ваша личная копия проекта. Все вашиПравила:1. Задавай вопросы ПО ОДНОМУ2. Жди мой ответ, потом задавай следующий-3. Копай глубже — если отвечаю размыто, уточняй+3. Копай глубже - если отвечаю размыто, уточняй4. В конце сформируй заполненный документ в том же формате-Начни с первого вопроса о карьере и бизнесе.+Начни с первого вопроса о карьере.```-4. Отправьте сообщение+6. Ответьте на все вопросы+7. Когда получите результат - скопируйте его+8. Вернитесь в VS Code+9. Выделите всё в файле: `Ctrl+A` / `Cmd+A`+10. Вставьте: `Ctrl+V` / `Cmd+V`+11. **Сохраните:** `Ctrl+S` / `Cmd+S`-### Шаг 4: Ответьте на все вопросы+Повторите для остальных файлов. Промпты для них:-ChatGPT будет задавать вопросы по одному:-- Где вы хотите быть через 3 года в карьере?-- Какой доход вам нужен?-- Какое здоровье и энергия?-- Какие отношения?-- И так далее...--Отвечайте честно. Это ваш личный документ.--### Шаг 5: Скопируйте результат обратно--Когда ChatGPT выдаст заполненный документ:--1. Выделите весь текст результата-2. Скопируйте его (`Ctrl+C` / `Cmd+C`)-3. Вернитесь в VS Code-4. Выделите всё в файле (`Ctrl+A` / `Cmd+A`)-5. Вставьте новый текст (`Ctrl+V` / `Cmd+V`)-6. **Сохраните файл:** `Ctrl+S` (Windows/Linux) или `Cmd+S` (Mac)---### Шаг 6: Повторите для остальных файлов--Повторите шаги 1-5 для каждого файла:--**Для `1-yearly-2025.md`** — добавьте промпт:+**Для `1-yearly-2025.md`:**```Это шаблон годовых целей. На основе моего 3-летнего видения-(которое мы только что заполнили) помоги поставить цели на 2025 год.--Задавай вопросы по одному. Для каждой цели определи:-- Чёткий измеримый результат-- Первый конкретный шаг+помоги поставить цели на 2025 год. Задавай вопросы по одному.```-**Для `2-monthly.md`** — добавьте промпт:+**Для `2-monthly.md`:**```-Это шаблон месячных приоритетов. Исходя из годовых целей,-какие 3 главных приоритета на этот месяц?--Задавай вопросы по одному.+Какие 3 главных приоритета на этот месяц? Задавай вопросы по одному.```-**Для `3-weekly.md`** — добавьте промпт:+**Для `3-weekly.md`:**```-Это шаблон недельного плана. Самое важное — секция "ONE Big Thing".-Это одна главная задача на неделю. Если сделаю только её — неделя успешна.--Помоги определить ONE Big Thing на эту неделю. Задавай вопросы.+Самое важное - секция "ONE Big Thing". Это одна главная задача на неделю.+Помоги определить её. Задавай вопросы.```-**Не забывайте сохранять каждый файл после изменений: `Ctrl+S` / `Cmd+S`**+> ⚠️ **Не забывайте сохранять:** `Ctrl+S` / `Cmd+S` после каждого файла!----# Часть 2: Получение токенов+## Часть 2: Получите токены-Перед настройкой сервера соберите все нужные ключи. Сохраните их в надёжное место.+Соберите все ключи заранее. Сохраните в надёжное место.-## 2.1 Telegram Bot Token+### 2.1 Telegram Bot Token1. Откройте Telegram-2. Найдите бота `@BotFather`-3. Отправьте `/newbot` или запстите миниапп и создайте нового бота-4. Введите имя бота: `My Second Brain` (любое)-5. Введите username: `my_brain_777_bot` (должен заканчиваться на `bot`, должен быть уникальным)-6. Скопируйте токен:- ```- 7123456789:AAHdN8J2K4m5N6o7P8q9R0s1T2u3V4w5X6y- ```+2. Найдите `@BotFather`+3. Отправьте `/newbot`+4. Введите имя: `My Second Brain`+5. Введите username: `my_brain_777_bot` (уникальный, заканчивается на `bot`)+6. Скопируйте токен<img width="808" height="1296" alt="Telegram_27_December_2025_QyxHhZBg" src="https://github.com/user-attachments/assets/712f661c-c63a-4c67-82b0-dc40c2e66317" />--**Сохраните токен!**-----## 2.2 Ваш Telegram ID+### 2.2 Ваш Telegram ID-Бот будет отвечать только вам. Для этого нужен ваш ID.--1. Найдите бота `@userinfobot` в Telegram+1. Найдите `@userinfobot` в Telegram2. Отправьте любое сообщение3. Скопируйте свой ID: `123456789`-**Сохраните ID!**-----## 2.3 Deepgram API Key--Deepgram транскрибирует голосовые сообщения. При регистрации дают $200 — хватает надолго.+### 2.3 Deepgram API Key1. Зайдите на [console.deepgram.com](https://console.deepgram.com/)-2. Зарегистрируйтесь (можно через Google)-3. Перейдите в Settings → API Keys-4. Нажмите "Create API Key"-5. Скопируйте ключ (показывается только один раз!)+2. Зарегистрируйтесь+3. Settings → API Keys → Create API Key+4. Скопируйте ключ (показывается один раз!)<img width="1700" height="1338" alt="Arc_27_December_2025_yTuxiFSA" src="https://github.com/user-attachments/assets/76d51155-7506-45f4-97b3-e4965496b266" />--**Сохраните ключ!**-----## 2.4 Todoist API Token (опционально)--Если хотите, чтобы бот создавал задачи в Todoist:+### 2.4 Todoist API Token1. Зайдите на [todoist.com](https://todoist.com)2. Settings → Integrations → Developer@@ -359,178 +326,94 @@ Deepgram транскрибирует голосовые сообщения. П<img width="1976" height="1840" alt="Arc_27_December_2025_FlpSkZgR" src="https://github.com/user-attachments/assets/eb676e25-1633-44e4-b90e-6d066a3b46d2" />-**Без Todoist** бот всё равно будет работать — просто не будет создавать задачи автоматически.-----## 2.5 Итоговый чек-лист токенов+### 2.5 Чек-листПеред следующим шагом убедитесь, что у вас есть:-- [ ] Telegram Bot Token: `7123456789:AAH...`-- [ ] Ваш Telegram ID: `123456789`-- [ ] Deepgram API Key: `abc123def456...`-- [ ] Todoist API Token: `abc123def456...`+- [ ] Telegram Bot Token+- [ ] Ваш Telegram ID+- [ ] Deepgram API Key+- [ ] Todoist API Token----# Часть 3: Настройка VPS--Теперь переносим проект на сервер, чтобы бот работал 24/7.--## 3.1 Покупка VPS--**Contabo (рекомендую):**-1. Зайдите на [contabo.com](https://contabo.com/en/vps/)-2. Выберите "Cloud VPS S" ($4.96/мес)-3. Region: любой кроме Russia-4. ОС: Ubuntu 22.04-5. Оплатите картой (работает с белорусскими картами)-6. Получите на почту: IP-адрес и пароль root+## Часть 3: Настройка VPS-<img width="2514" height="1962" alt="Arc_27_December_2025_XNzzknIo" src="https://github.com/user-attachments/assets/9cd54275-199a-418c-9881-6be3aee471f5" />--<img width="2212" height="1752" alt="Arc_27_December_2025_a5D7KnnM" src="https://github.com/user-attachments/assets/660f629c-05ec-4a6a-a34b-53b430bd7b84" />--<img width="2176" height="1454" alt="Spark Desktop_27_December_2025_sltZRiMZ" src="https://github.com/user-attachments/assets/7dceb211-90af-4d78-abb0-cec19a0abbdd" />+### 3.1 Создайте пользователя--**Альтернатива — OVH:**-- [OVH Starter](https://ovhcloud.com/en/vps/) — $5/мес, тоже работает с белорусскими картами--------## 3.2 Подключение к серверу--### Windows--1. Скачайте [Windows Terminal](https://apps.microsoft.com/detail/9n0dx20hk701) из Microsoft Store-2. Или используйте PowerShell-3. Введите:-```bash-ssh root@ВАШ_IP_АДРЕС-```--### Mac/Linux--Откройте Terminal и введите:-```bash-ssh root@ВАШ_IP_АДРЕС-```--**Первое подключение:** спросит про fingerprint — напишите `yes`.-**Пароль:** вводите пароль из письма (символы не отображаются — это нормально).--<img width="1450" height="810" alt="Ghostty_27_December_2025_OwCbt58A" src="https://github.com/user-attachments/assets/92b32f25-b6df-4d25-aac9-7733079cfac7" />--------## 3.3 Создание пользователя--Работать под root небезопасно. Создадим обычного пользователя:+Работать под root небезопасно:```bash-# Создаём пользователя (запомните пароль!)adduser myuser--# Даём права sudousermod -aG sudo myuser--# Переключаемся на нового пользователяsu - myuser```<img width="1516" height="1220" alt="Ghostty_27_December_2025_4iOcEzsO" src="https://github.com/user-attachments/assets/d8e0823a-18ae-4b07-a68b-ff555a18943f" />-----## 3.4 Установка необходимого ПО--Копируйте и вставляйте эти команды по одной. Каждый блок — отдельное действие.+### 3.2 Установите всё необходимое-### Обновление системы```bash+# Обновлениеsudo apt update && sudo apt upgrade -y-```-### Базовые инструменты-```bash+# Инструментыsudo apt install -y git curl wget build-essential-```-### Python 3.12-```bash+# Python 3.12sudo apt install -y software-properties-commonsudo add-apt-repository -y ppa:deadsnakes/ppasudo apt updatesudo apt install -y python3.12 python3.12-venv python3.12-dev-```-### uv (быстрый менеджер пакетов Python)-```bash+# uv (менеджер пакетов Python)curl -LsSf https://astral.sh/uv/install.sh | shsource ~/.bashrc-```-### Node.js 20-```bash+# Node.js 20curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -sudo apt install -y nodejs-```-### Claude CLI-```bash+# Claude CLInpm install -g @anthropic-ai/claude-code-```-### Авторизация в Claude-```bash+# Авторизацияclaude auth login```-Следуйте инструкциям: откроется ссылка → авторизуйтесь в браузере → скопируйте код → вставьте в терминал.--<img width="1578" height="994" alt="Ghostty_27_December_2025_gAcpHg2c" src="https://github.com/user-attachments/assets/cfb74cc5-66af-4c19-9a5c-05ef4f454194" />---### Настройка MCP Todoist+----MCP Todoist позволяет Claude создавать задачи в вашем Todoist. Установка:+### 3.3 Проверьте MCP Todoist```bash-# Проверьте, что npx работаетnpx -y @doist/todoist-ai --help```-Если команда выполнилась без ошибок — всё готово. MCP сервер запускается автоматически при обработке записей.--**Важно:** Todoist API Token нужно добавить в файл `.env` (сделаем позже в шаге 3.6).--Подробнее о MCP Todoist: [github.com/Doist/todoist-ai](https://github.com/Doist/todoist-ai)+Если выполнилось без ошибок - всё ок. Подробнее: [github.com/Doist/todoist-ai](https://github.com/Doist/todoist-ai)----## 3.5 Клонирование вашего fork+### 3.4 Клонируйте ваш Fork```bashcd ~mkdir -p projectscd projects-# Замените ВАШ_ЛОГИН на ваш логин GitHub!-git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git dbrain-cd dbrain+# Замените ВАШ_ЛОГИН!+git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git+cd agent-second-brain-# Установка зависимостейuv sync```----## 3.6 Создание файла .env+### 3.5 Создайте файл .env```bashnano .env@@ -541,42 +424,39 @@ nano .env```bashTELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxDEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-TODOIST_API_KEY=+TODOIST_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxVAULT_PATH=./vaultALLOWED_USER_IDS=[123456789]```-**Сохранение:** `Ctrl+O` → `Enter` → `Ctrl+X`+> ⚠️ **ВАЖНО:** В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки `[ ]`!+>+> Пример: `ALLOWED_USER_IDS=[123456789]` - правильно+> `ALLOWED_USER_IDS=123456789` - неправильно-<!-- TODO: Скриншот редактирования .env -->+Сохраните: `Ctrl+O` → `Enter` → `Ctrl+X`----## 3.7 Тестовый запуск+### 3.6 Тестовый запуск```bashuv run python -m d_brain```-Откройте Telegram, найдите своего бота, отправьте `/start`.--**Если работает** — увидите приветствие и кнопки. Нажмите `Ctrl+C` для остановки.+Откройте Telegram, найдите бота, отправьте `/start`.-**Если не работает** — проверьте:-- Правильный ли токен в .env?-- Совпадает ли ваш ID в ALLOWED_USER_IDS?+Если видите кнопки - работает. `Ctrl+C` для остановки.----## 3.8 Настройка автозапуска--Чтобы бот работал постоянно, даже после перезагрузки сервера:+### 3.7 Настройте автозапуск```bashsudo nano /etc/systemd/system/d-brain-bot.service```-Вставьте (замените `myuser` на имя вашего пользователя):+Вставьте (замените `myuser`):```ini[Unit]@@ -586,7 +466,7 @@ After=network.target[Service]Type=simpleUser=myuser-WorkingDirectory=/home/myuser/projects/dbrain+WorkingDirectory=/home/myuser/projects/agent-second-brainExecStart=/home/myuser/.local/bin/uv run python -m d_brainRestart=alwaysRestartSec=10@@ -595,194 +475,42 @@ RestartSec=10WantedBy=multi-user.target```-Сохраните и запустите:+Запустите:```bashsudo systemctl daemon-reloadsudo systemctl enable d-brain-botsudo systemctl start d-brain-bot-```--Проверьте статус:-```bashsudo systemctl status d-brain-bot```Должно показать `active (running)`.-<!-- TODO: Скриншот статуса systemd -->-------## 3.9 Настройка автоматической обработки--Бот может обрабатывать записи автоматически каждый день в 21:00.--### Создание таймера--```bash-sudo nano /etc/systemd/system/d-brain-process.timer-```--```ini-[Unit]-Description=Daily processing at 21:00--[Timer]-OnCalendar=*-*-* 21:00:00-Persistent=true--[Install]-WantedBy=timers.target-```--### Создание сервиса обработки--```bash-sudo nano /etc/systemd/system/d-brain-process.service-```--```ini-[Unit]-Description=d-brain Daily Processing--[Service]-Type=oneshot-User=myuser-WorkingDirectory=/home/myuser/projects/dbrain-ExecStart=/home/myuser/.local/bin/uv run python -c "-import asyncio-from d_brain.services.processor import ClaudeProcessor-from d_brain.services.git import VaultGit-from d_brain.config import Settings-from datetime import date--async def main():- settings = Settings()- processor = ClaudeProcessor(settings.vault_path)- git = VaultGit(settings.vault_path)-- result = await processor.process_daily(date.today())- print(result.get('report', 'No report'))-- if git.has_changes():- git.commit_and_push(f'chore: daily processing {date.today()}')--asyncio.run(main())-"-```--### Активация--```bash-sudo systemctl daemon-reload-sudo systemctl enable d-brain-process.timer-sudo systemctl start d-brain-process.timer--# Проверка-sudo systemctl list-timers | grep d-brain-```-----## 3.10 Настройка Git push--Чтобы сервер мог пушить изменения в GitHub:+### 3.8 Настройте Git push```bash-cd ~/projects/dbrain--# Настройка имени и email+cd ~/projects/agent-second-braingit config user.name "My Bot"git config user.email "[email protected]"```-### Создание токена для Git--1. Зайдите на GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)-2. Generate new token (classic)-3. Выберите scope: `repo`-4. Скопируйте токен--### Сохранение токена+Создайте токен на GitHub:+1. GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)+2. Generate new token+3. Scope: `repo`+4. Скопируйте```bashgit remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git```-Замените:-- `ТОКЕН` — ваш Personal Access Token-- `ВАШ_ЛОГИН` — ваш логин на GitHub--Теперь сервер сможет пушить изменения автоматически.-----# Часть 4: Дополнительная персонализация (опционально)--Если хотите, чтобы бот ещё лучше понимал ваш контекст.--## 4.1 Настройка профиля--Откройте `vault/.claude/skills/dbrain-processor/references/about.md` и заполните информацию о себе:--```markdown-# About User - System Profile--## Core Identity--**Иван Петров, 35** — Продакт-менеджер--- Работаю в fintech-стартапе-- Основные клиенты: B2B SaaS-- 10 лет в IT-- Строю продукты от идеи до масштабирования--## Primary Operating Mode--- Мыслю системами и фреймворками-- Предпочитаю данные интуиции-- Ценю краткость и конкретику-- Лучше работаю утром--## Strategic Focus--1. Запуск нового продукта до Q2-2. Построение пассивного дохода-3. Баланс работа/семья--## Work Domains--| Domain | Examples |-|--------|----------|-| **Работа** | продукт, метрики, команда, клиенты |-| **Обучение** | AI, no-code, инвестиции |-| **Идеи** | стартапы, автоматизация, контент |-| **Личное** | здоровье, семья, путешествия |-```--Это поможет агенту понимать контекст ваших записей.-------## 4.2 Настройка классификации--Если хотите изменить, как бот классифицирует записи, отредактируйте:--`vault/.claude/skills/dbrain-processor/references/classification.md`--Там можно добавить:-- Ключевые слова ваших проектов-- Имена клиентов (→ приоритет p1)-- Домены для автоматической категоризации-------# Часть 5: Использование--## 5.1 Кнопки бота+## Часть 4: Использование-После запуска бота у вас внизу экрана появятся кнопки:+### Кнопки бота```┌─────────────────────────────────────────┐@@ -794,307 +522,120 @@ git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-| Кнопка | Что делает ||--------|------------|| 📊 Статус | Сколько записей сегодня |-| ⚙️ Обработать | Запустить обработку записей |-| 📅 Неделя | Недельный дайджест с прогрессом |+| ⚙️ Обработать | Запустить обработку |+| 📅 Неделя | Недельный дайджест || ✨ Запрос | Попросить что-то сделать |-| ❓ Помощь | Показать справку |+| ❓ Помощь | Справка |----## 5.2 Что можно отправлять+### Что можно отправлять-**Голосовые** — основной способ. Говорите как думаете:+**Голосовые** - основной способ:- "Надо написать Пете по проекту"- "Идея: сделать лендинг с калькулятором"-- "Сегодня понял, что важно делегировать мелочи"-**Текст** — короткие заметки:-- Ссылки-- Цитаты-- Быстрые мысли+**Текст** - ссылки, цитаты, быстрые мысли-**Фото** — скриншоты, фото досок, документы+**Фото** - скриншоты, фото досок-**Пересланные сообщения** — из других чатов с контекстом+**Пересланные сообщения** - из других чатов----## 5.3 Кнопка ✨ Запрос+### Кнопка ✨ Запрос-Универсальный способ попросить что-то сделать:--1. Нажмите кнопку **✨ Запрос**+1. Нажмите **✨ Запрос**2. Бот спросит "Что сделать?"-3. Отправьте голосовое или текст с запросом+3. Отправьте голосовое или текст-Примеры запросов:+Примеры:- "покажи задачи на сегодня"- "перенеси просроченные на понедельник"-- "что я записывал вчера?"-- "создай задачу: позвонить в банк завтра"-- "покажи прогресс по целям"-------## 5.4 Ежедневный цикл--**Утро:**-- Откройте Todoist — там задачи на сегодня--**В течение дня:**-- Записывайте мысли голосом-- Пересылайте важные сообщения-- Делайте скриншоты--**Вечер (21:00 автоматически или кнопка ⚙️ Обработать):**-- Бот обрабатывает записи-- Создаёт задачи-- Сохраняет мысли-- Присылает отчёт--**Воскресенье:**-- Автоматический недельный дайджест-- Прогресс по целям-- Рекомендации на следующую неделю+- "создай задачу: позвонить в банк"----## 5.5 Пример отчёта--```html-📊 <b>Обработано: 27 дек</b>--<b>📥 Входящие</b>-• 3 голосовых, 2 текста, 1 фото+## Часть 5: Синхронизация-<b>✅ Создано задач: 4</b>-• [p1] Позвонить клиенту → сегодня-• [p2] Подготовить презентацию → пт-• [p3] Изучить новый инструмент → сл. нед-• [p4] Идея для блога → когда-нибудь+### На компьютере-<b>📝 Сохранено мыслей: 2</b>-• [[ideas/лендинг-калькулятор]]-• [[learnings/делегирование]]+1. Откройте Obsidian+2. Open folder as vault → выберите `vault`-<b>🎯 ONE Big Thing</b>-Запустить MVP до конца недели+### Мобильный доступ-<b>📈 Прогресс недели: 65%</b>-```-------# Часть 6: Синхронизация с Obsidian--## 6.1 Настройка на компьютере+**iPhone:**+1. Переместите папку в iCloud Drive+2. В приложении Файлы нажмите "Хранить на устройстве"+3. Obsidian откроет эту папку как vault-1. Откройте папку с репозиторием на компьютере-2. Запустите Obsidian-3. Open folder as vault → выберите папку `vault`--Теперь вы видите все свои заметки в красивом интерфейсе Obsidian.--<!-- TODO: Скриншот Obsidian с открытым vault -->-------## 6.2 Автоматическая синхронизация--Чтобы изменения с сервера автоматически появлялись на компьютере:--### Mac--Создайте файл `~/sync-brain.sh`:--```bash-#!/bin/bash-cd ~/Documents/agent-second-brain # путь к вашему fork-git pull --rebase-git add -A-git commit -m "sync: $(date '+%Y-%m-%d %H:%M')" 2>/dev/null || true-git push 2>/dev/null || true-```--Сделайте исполняемым:-```bash-chmod +x ~/sync-brain.sh-```--Добавьте в cron (запуск каждый час):-```bash-crontab -e-# Добавьте строку:-0 * * * * ~/sync-brain.sh-```--### Windows--1. Создайте файл `sync-brain.bat`:-```batch-cd C:\Users\ВАШЕ_ИМЯ\Documents\agent-second-brain-git pull --rebase-git add -A-git commit -m "sync: %date% %time%"-git push-```--2. Откройте "Планировщик заданий"-3. Создайте задачу → Триггер: каждый час → Действие: запуск sync-brain.bat-------## 6.3 Мобильный доступ--### iPhone--Самый простой способ — через iCloud:--1. Переместите папку `agent-second-brain` в папку iCloud Drive-2. Откройте Настройки → [Ваше имя] → iCloud-3. Убедитесь, что iCloud Drive включен-4. В приложении Файлы найдите вашу папку-5. **Важно:** Нажмите на папку и выберите "Хранить на устройстве" (чтобы файлы были доступны офлайн)--iCloud синхронизирует файлы очень быстро. Obsidian на iPhone откроет эту папку как vault.--### Android--Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal) — он синхронизирует репозиторий через Git.+**Android:**+Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal)---# FAQ-## Проблемы с настройкой? Claude Code поможет!--Самое важное — установить Claude Code и авторизоваться. После этого он сам поможет донастроить всё остальное.--**Если что-то не работает:**+## Проблемы? Claude Code поможет-1. Зайдите в папку проекта на VPS:-```bash-cd ~/projects/dbrain-```+Самое важное - установить Claude Code. После этого он сам донастроит всё остальное.-2. Запустите Claude Code:```bash+cd ~/projects/agent-second-brainclaude```-3. Скиньте ему ссылку на эту инструкцию:+Напишите:```-Помоги настроить проект по этой инструкции:+Помоги настроить проект по инструкции:https://github.com/smixs/agent-second-brain-У меня проблема с [опишите проблему]+У меня проблема с [опишите]```-Claude Code прочитает README, поймёт структуру проекта и поможет исправить любую проблему. Он видит все файлы и может сам вносить изменения.+Он прочитает README, увидит файлы и поможет.----## Общие вопросы+## Технические проблемы-**Можно без Obsidian?**-Да! Заметки хранятся как обычные .md файлы. Смотрите их на GitHub или в любом текстовом редакторе.--**Сколько стоит в месяц?**-- Claude: $20-- VPS: ~$5 (Contabo $4.96 / OVH $5)-- Deepgram: бесплатно ($200 хватает на год+)-- **Итого: ~$25/мес**--**Это безопасно?**-- Все данные на вашем сервере и в вашем GitHub-- Бот отвечает только на ваш Telegram ID-- Токены хранятся в .env (не в коде)-------## Технические вопросы--**Бот не отвечает**+**Бот не отвечает:**```bash-# Проверьте статусsudo systemctl status d-brain-bot--# Посмотрите логиsudo journalctl -u d-brain-bot -n 50```-**Не транскрибирует голосовые**-- Проверьте DEEPGRAM_API_KEY в .env-- Убедитесь, что не закончились $200 кредита--**Claude не работает**+**Claude не работает:**```bash-# Проверьте авторизациюclaude auth status--# Переавторизуйтесьclaude auth login```-**Изменения не пушатся в GitHub**-```bash-cd ~/projects/dbrain-git status-git push # посмотрите ошибку-```-------## Обновление--Когда выйдет новая версия:--```bash-cd ~/projects/dbrain--# Сохраните свои изменения-git stash--# Получите обновления из оригинального репозитория-git remote add upstream https://github.com/smixs/agent-second-brain.git-git fetch upstream-git merge upstream/main--# Верните свои изменения-git stash pop--# Обновите зависимости-uv sync--# Перезапустите бот-sudo systemctl restart d-brain-bot-```+**Голосовые не транскрибируются:**+- Проверьте DEEPGRAM_API_KEY в .env----## Полезные команды VPS+## Полезные команды```bash-# Логи в реальном времени+# Логиsudo journalctl -u d-brain-bot -f-# Перезапуск бота+# Перезапускsudo systemctl restart d-brain-bot-# Статус всех таймеров+# Статус таймеровsudo systemctl list-timers--# Ручной запуск обработки-cd ~/projects/dbrain-uv run python -m d_brain.services.processor```---# Поддержка-- **Вопросы:** [@aimastersme](https://t.me/aimastersme)-- **Баги:** [GitHub Issues](https://github.com/smixs/agent-second-brain/issues)+- Вопросы: [@aimastersme](https://t.me/aimastersme)+- Баги: [GitHub Issues](https://github.com/smixs/agent-second-brain/issues)---