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
Обновление README.md: исправлены опечатки, улучшены формулировки и структура разделов, добавлены новые инструкции по настройке и использованию бота.
smixse5e565a3a44b
diff --git a/README.md b/README.mdindex 8cc950b..dd2fb48 100644--- a/README.md+++ b/README.md@@ -6,7 +6,7 @@**Персональный AI-ассистент с долговременной памятью**-Записывайте голосовые в Telegram - агент сам разберётся что с ними делать: создаст задачи, сохранит мысли, обновит прогресс по целям.+Записывайте голосовые в Telegram — агент сам разберётся что с ними делать: создаст задачи, сохранит мысли, обновит прогресс по целям.<p align="center"><img width="350" alt="Telegram_27_December_2025_ALVR9dWM" src="https://github.com/user-attachments/assets/5f76a061-3b46-4857-b638-11783973c0ad" />@@ -14,52 +14,59 @@----## 📑 Оглавление+## Главное перед началом++| Параметр | Значение |+|----------|----------|+| **Время на настройку** | **2–3 часа тишины.** Не торопитесь — лучше один раз сделать правильно. |+| **Стоимость** | ~$25/мес (Claude Pro $20 + VPS $5) |+| **Приватность** | **Это ваш личный сервер. Никто, кроме вас, не имеет доступа к вашим мыслям и задачам.** |++---++## Оглавление- [Зачем это нужно](#зачем-это-нужно)- [Как это работает](#как-это-работает)-- [Словарь терминов](#-словарь-терминов)+- [Словарь терминов](#словарь-терминов)- [Что понадобится](#что-понадобится)-- **Часть 1: Подготовка на компьютере** ⏱ 30-50 мин+- **Часть 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.7 Настройте систему под себя](#17-настройте-систему-под-себя)- [1.8 Сохраните изменения в GitHub](#18-сохраните-изменения-в-github)-- **Часть 2: Получите токены** ⏱ 15 мин+- **Часть 2: Получите ключи** ⏱ 15 мин- [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)- [2.4 Todoist API Token](#24-todoist-api-token)-- **Часть 3: Настройка VPS** ⏱ 40-70 мин+- **Часть 3: Настройка сервера** ⏱ 40–70 мин- [3.1 Купите VPS и подключитесь](#31-купите-vps-и-подключитесь)- [3.2 Создайте пользователя](#32-создайте-пользователя)- [3.3 Установите всё необходимое](#33-установите-всё-необходимое)-- **🚀 Запуск бота** (выберите один способ)- - [Способ 1: Автоскрипт (рекомендуется)](#-способ-1-автоматический-скрипт-рекомендуется)- - [Способ 2: Через Claude Code](#-способ-2-через-claude-code)+ - [Запуск бота](#запуск-бота)- [Часть 4: Использование](#часть-4-использование)- [Часть 5: Синхронизация](#часть-5-синхронизация)-- [FAQ](#faq)-- [Дополнительно: MCP-серверы](#дополнительно-mcp-серверы)+- [Помощь](#помощь)---## Зачем это нужно-Это GTD-система (Getting Things Done) на стероидах. Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни.+Это система управления задачами и мыслями «на стероидах». Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни.**Кидайте туда вообще всё:**-- Интересные посты из Telegram - пересылайте боту-- Скриншоты - отправляйте-- После встречи - надиктуйте голосом что было и какие решения-- Эмоции, мысли, идеи - всё записывайте-- Ссылки, цитаты, заметки - абсолютно всё+- Интересные посты из Telegram — пересылайте боту+- Скриншоты — отправляйте+- После встречи — надиктуйте голосом что было и какие решения+- Эмоции, мысли, идеи — всё записывайте+- Ссылки, цитаты, заметки — абсолютно всё-### ✨ Самая крутая кнопка — "Запрос"+### Самая крутая кнопка — «Запрос»Это **полноценный AI-агент**, которому можно сказать что угодно — и он сам разберётся что делать.@@ -67,46 +74,41 @@| Запрос | Что сделает агент ||--------|-------------------|-| "Найди ту идею про маркетинг, которую я записывал на прошлой неделе" | Найдёт в ваших заметках и покажет |-| "Что я делал вчера?" | Даст отчёт по вчерашним записям и задачам |-| "Перенеси все просроченные задачи на понедельник" | Найдёт в Todoist и перенесёт |-| "Поставь повторяющуюся задачу: каждый день в 9 утра — зарядка" | Создаст в Todoist |-| "Обнови мои недельные цели" | Откроет файл целей и поможет обновить |-| "Какие задачи на этой неделе не сделаны?" | Покажет список из Todoist |-| "Посоветуй, на чём сфокусироваться сегодня" | Проанализирует цели и задачи, даст совет |+| «Найди ту идею про маркетинг, которую я записывал на прошлой неделе» | Найдёт в ваших заметках и покажет |+| «Что я делал вчера?» | Даст отчёт по вчерашним записям и задачам |+| «Перенеси все просроченные задачи на понедельник» | Найдёт в Todoist и перенесёт |+| «Поставь повторяющуюся задачу: каждый день в 9 утра — зарядка» | Создаст в Todoist |+| «Обнови мои недельные цели» | Откроет файл целей и поможет обновить |+| «Какие задачи на этой неделе не сделаны?» | Покажет список из Todoist |+| «Посоветуй, на чём сфокусироваться сегодня» | Проанализирует цели и задачи, даст совет |Вы общаетесь с ним как с настоящим ассистентом. Он сам найдёт нужные файлы, обновит структуру, создаст задачи — всё автоматически.----Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе - тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты.+Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе — тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты.-**Про Claude Code - не бойтесь названия.** Да, он называется "Code", но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями - создавать задачи, сохранять мысли, следить за целями. Он просто работает.+**Про Claude Code — не бойтесь названия.** Да, он называется «Code», но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями — создавать задачи, сохранять мысли, следить за целями. Он просто работает.----> ⚠️ **Если вы запутались**+> **Если вы запутались на каком-то шаге**>-> Не переживайте! Скопируйте ссылку на этот репозиторий:-> `https://github.com/smixs/agent-second-brain`+> Не переживайте! Откройте [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) и напишите:+> «Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]. Вот ссылка: https://github.com/ВАШ_ЛОГИН/agent-second-brain»>-> Отправьте её в [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) с вопросом:-> "Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]"->-> Он прочитает README и поможет вам пошагово.+> Он прочитает инструкцию и поможет вам пошагово.---## Как это работает<p align="center">-<img width="600" alt="как это работает" src="https://github.com/user-attachments/assets/83a0e140-6fbd-4fa3-a799-2b8544663ab1">--<p align="center">+</p>1. Вы отправляете голосовое/текст/фото в **Telegram**-2. **Бот на VPS** сохраняет всё в файл+2. **Бот на сервере** сохраняет всё в файл3. **Claude Code** анализирует записи4. Создаёт задачи в **Todoist**, сохраняет мысли в **Obsidian**5. Отправляет отчёт обратно в **Telegram**@@ -114,21 +116,19 @@----## 📖 Словарь терминов+## Словарь терминовЕсли какие-то слова незнакомы — вот короткий словарь:| Термин | Что это значит ||--------|----------------|| **VPS** | Удалённый мини-компьютер в интернете. Как ваш ПК, но работает 24/7 и находится в дата-центре |-| **SSH** | Способ подключиться к VPS через терминал. Как удалённый рабочий стол, но текстом |-| **Token** | Пароль для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать |+| **SSH** | Способ подключиться к VPS через чёрное окно с текстом (терминал). Как удалённый рабочий стол, но текстом |+| **Token** | Секретный код для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать || **Repo** | Репозиторий — папка проекта на GitHub. Там хранятся все файлы и история изменений || **.env** | Файл с секретами и настройками. Лежит только на сервере, никуда не публикуется |-| **systemd** | Автозапуск на сервере. Следит чтобы бот работал, перезапускает если упал || **Fork** | Ваша личная копия проекта. Можете менять как хотите, оригинал не затронете || **Clone** | Скачать проект на компьютер. После этого можете открыть его в VS Code |-| **MCP** | Model Context Protocol — способ подключить AI к внешним сервисам (Todoist, Gmail, Notion и др.) |---@@ -136,50 +136,83 @@| Компонент | Зачем | Стоимость ||-----------|-------|-----------|-| **Claude Pro/Max** | AI-агент | $20/мес |-| **VPS-сервер** | Бот работает 24/7 | ~$5/мес |-| **GitHub** | Backup и синхронизация | бесплатно |-| **Deepgram** | Транскрипция голосовых | бесплатно ($200 на старт) |-| **Todoist** | Задачи в одном месте | бесплатно / $4/мес Pro |+| **Claude Pro/Max** | AI-агент, который обрабатывает ваши записи | $20/мес |+| **VPS-сервер** | Чтобы бот работал круглосуточно | ~$5/мес |+| **GitHub** | Хранение и синхронизация всех ваших записей | бесплатно |+| **Deepgram** | Превращение голосовых сообщений в текст | бесплатно ($200 на старт) |+| **Todoist** | Хранение задач в одном месте | бесплатно / $4/мес Pro |**Итого: ~$25/мес**-### Где брать VPS+### Где взять VPS-Нужен сервер НЕ в РФ/РБ - там блокировка Claude по территории.+Нужен сервер НЕ в России/Беларуси — там блокировка Claude по территории.-- [Contabo](https://contabo.com) - $4.96/мес, работает с белорусскими картами-- [OVH](https://ovhcloud.com) - $5/мес, тоже работает с белорусскими картами+- [Contabo](https://contabo.com) — $4.96/мес, работает с белорусскими картами+- [OVH](https://ovhcloud.com) — $5/мес, тоже работает с белорусскими картами----# Часть 1: Подготовка на компьютере ⏱ 30-50 мин+# Часть 1: Подготовка на компьютере ⏱ 30–50 мин### 1.1 Установите Git и VS Code**Что это такое:**- **Git** — программа для скачивания и синхронизации проектов-- **VS Code** — бесплатный редактор файлов (как Word, но для кода и настроек)+- **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 запустится автоматически. Если нет — найдите его в меню «Пуск»-**Windows:**-1. Скачайте [Git для Windows](https://git-scm.com/download/win)-2. Запустите скачанный файл → нажимайте "Next" → "Install" → "Finish"-3. Скачайте [VS Code](https://code.visualstudio.com/)-4. Запустите скачанный файл → нажимайте "Next" → "Install" → "Finish"-5. Запустите VS Code (найдите в меню Пуск или на рабочем столе)+----**Mac:**-1. Откройте Terminal (`Cmd + Пробел` → введите "Terminal" → Enter)-2. Введите `git --version` и нажмите Enter- - Если появится окно "Установить инструменты разработчика?" → нажмите "Установить"-3. Скачайте [VS Code](https://code.visualstudio.com/)-4. Откройте скачанный файл → перетащите VS Code в папку "Программы"-5. Запустите VS Code из папки "Программы" или через Spotlight (`Cmd + Пробел` → "VS Code")+**Если у вас Mac:**-> 💡 **Как проверить что VS Code работает:**-> После запуска вы увидите тёмное окно с надписью "Welcome". Это значит всё установлено правильно.+1. Нажмите клавиши `Cmd + Пробел` одновременно (появится строка поиска)+2. Напечатайте слово `Terminal` и нажмите Enter+3. Откроется чёрное окно — это терминал+4. Напечатайте команду `git --version` и нажмите Enter+5. Если появится окно «Установить инструменты разработчика?» — нажмите кнопку **Установить**+6. Дождитесь завершения установки-<!-- TODO: Скриншот: VS Code с Welcome экраном -->+Теперь установите 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». Это значит, что всё установлено правильно.<p align="center"><img width="600" alt="Ghostty_27_December_2025_vPEZpgCt" src="https://github.com/user-attachments/assets/121bb943-ecf1-4827-93f4-ef59221bb49b" />@@ -189,10 +222,23 @@### 1.2 Создайте аккаунт на GitHub-1. Зайдите на [github.com](https://github.com)-2. Нажмите "Sign up"-3. Введите email, придумайте пароль, выберите username-4. Подтвердите email+**Что такое GitHub:**+GitHub — это сайт, где хранятся ваши файлы и записи. Как облачное хранилище, но для проектов.++**Как создать аккаунт:**++1. Откройте браузер и перейдите на сайт [github.com](https://github.com)+2. В правом верхнем углу найдите кнопку **Sign up** и нажмите её+3. Введите ваш email (электронную почту)+4. Придумайте пароль (запишите его, чтобы не забыть!)+5. Придумайте имя пользователя (логин) — это будет ваш адрес на GitHub++> **Важно:** Запомните или запишите ваш логин! Везде далее в инструкции, где написано `ВАШ_ЛОГИН`, вам нужно будет вписывать именно это имя.++6. Нажмите **Create account**+7. Пройдите проверку «Я не робот»+8. Откройте вашу почту и найдите письмо от GitHub+9. Нажмите на ссылку в письме для подтверждения<p align="center"><img width="600" alt="Arc_27_December_2025_bAQJJGoP" src="https://github.com/user-attachments/assets/c09c12d8-23ee-4a2c-800e-aab564453ecd" />@@ -202,102 +248,101 @@### 1.3 Сделайте Fork проекта-Fork - это ваша личная копия. Все записи будут храниться у вас.+**Что такое Fork:**+Fork — это ваша личная копия проекта. Все ваши записи будут храниться только у вас.-1. Откройте: [github.com/smixs/agent-second-brain](https://github.com/smixs/agent-second-brain)-2. Нажмите кнопку **Fork** (правый верхний угол)-3. Выберите свой аккаунт-4. Нажмите "Create fork"+**Как сделать Fork:**++1. Убедитесь, что вы вошли в свой аккаунт на GitHub (в правом верхнем углу должен быть ваш аватар)+2. Откройте в браузере ссылку на оригинальный проект (попросите её у того, кто дал вам эту инструкцию)+3. В правом верхнем углу страницы найдите кнопку **Fork** (она выглядит как значок вилки)+4. Нажмите на неё+5. Откроется новая страница с заголовком «Create a new fork»+6. Ничего не меняйте и нажмите зелёную кнопку **Create fork** внизу+7. Подождите несколько секунд — вас перенаправит на вашу копию проекта<p align="center"><img width="600" alt="Arc_27_December_2025_Uw5hbtiu" src="https://github.com/user-attachments/assets/c4cd5d39-f690-456b-892d-615c36460dba" /></p>-Теперь у вас есть своя копия: `https://github.com/ВАШ_ЛОГИН/agent-second-brain`--> ⚠️ **ВАЖНО:** Здесь и далее `ВАШ_ЛОГИН` — это ваш логин на GitHub!->-> Например, если ваш логин `ivan_petrov`, то адрес будет:-> `https://github.com/ivan_petrov/agent-second-brain`->-> Посмотреть свой логин можно в правом верхнем углу GitHub (там где ваш аватар).+Теперь у вас есть своя копия по адресу: `https://github.com/ВАШ_ЛОГИН/agent-second-brain`-<!-- TODO: Скриншот: GitHub с выделенным логином в правом верхнем углу -->+> **Где посмотреть свой логин:**+> Нажмите на свой аватар в правом верхнем углу GitHub — там будет написано ваше имя пользователя.---### 1.4 Клонируйте Fork на компьютер+**Что значит «клонировать»:**+Это значит скачать проект с GitHub на ваш компьютер, чтобы вы могли редактировать файлы.+**Шаг 1: Откройте VS Code**-- Windows: найдите "VS Code" в меню Пуск-- Mac: нажмите `Cmd + Пробел`, введите "VS Code", нажмите Enter+- На Windows: нажмите кнопку «Пуск» в левом нижнем углу экрана, напечатайте `VS Code`, нажмите Enter+- На Mac: нажмите `Cmd + Пробел`, напечатайте `VS Code`, нажмите Enter**Шаг 2: Откройте командную панель**-- Windows/Linux: нажмите `Ctrl + Shift + P`-- Mac: нажмите `Cmd + Shift + P`+- На Windows: нажмите одновременно три клавиши `Ctrl + Shift + P`+- На Mac: нажмите одновременно три клавиши `Cmd + Shift + P`-Сверху появится строка поиска.+Сверху окна появится строка для ввода команд.-**Шаг 3: Клонируйте проект**-1. Введите `Git: Clone` и нажмите Enter-2. Появится строка "Provide repository URL"-3. Вставьте URL **вашего fork**:+**Шаг 3: Введите команду клонирования**-> ⚠️ **НЕ копируйте как есть!** Замените `ВАШ_ЛОГИН` на ваш логин GitHub.+1. В появившейся строке напечатайте `Git: Clone` и нажмите Enter+2. Появится строка «Provide repository URL» (введите адрес репозитория)+3. Напечатайте адрес вашего репозитория:- ```- https://github.com/ВАШ_ЛОГИН/agent-second-brain.git- ```+```+https://github.com/ВАШ_ЛОГИН/agent-second-brain.git+```- Например: `https://github.com/ivan_petrov/agent-second-brain.git`+> **Важно:** Замените `ВАШ_ЛОГИН` на ваш реальный логин GitHub!+> Например, если ваш логин `ivan_petrov`, введите:+> `https://github.com/ivan_petrov/agent-second-brain.git`4. Нажмите Enter-5. Выберите папку куда сохранить (например, Documents или Документы)-6. Нажмите "Select as Repository Destination"-7. Дождитесь скачивания-8. Появится вопрос "Would you like to open?" → нажмите **"Open"**--> 💡 **Что произошло:**-> VS Code скачал проект на ваш компьютер и открыл его. Слева вы увидите список папок и файлов проекта.+5. Откроется окно выбора папки. Выберите папку «Документы» (Documents) и нажмите **Select as Repository Destination**+6. Дождитесь, пока проект скачается (появится индикатор загрузки)+7. Появится вопрос «Would you like to open?» — нажмите кнопку **Open**-<!-- TODO: Скриншот: VS Code с открытым проектом и списком папок слева -->+**Что произошло:**+VS Code скачал проект на ваш компьютер и открыл его. Слева вы увидите список папок и файлов проекта.<p align="center"><img width="600" alt="Code_27_December_2025_mBvxd2PN" src="https://github.com/user-attachments/assets/cb65c71c-8229-4caa-b958-9c636f952c72" /></p>-> ⚠️ **Если случайно закрыли VS Code:**+> **Если случайно закрыли VS Code:**> 1. Откройте VS Code снова-> 2. Нажмите `File` → `Open Folder` (или `Файл` → `Открыть папку`)-> 3. Найдите папку `agent-second-brain` там, куда сохраняли (например, в Documents)-> 4. Выберите её и нажмите "Open"+> 2. Нажмите меню **File** (Файл) в верхнем левом углу+> 3. Выберите **Open Folder** (Открыть папку)+> 4. Найдите папку `agent-second-brain` в папке «Документы»+> 5. Выберите её и нажмите **Open** (Открыть)---### 1.5 Заполните ваши цели-> ⚠️ **ЭТО САМЫЙ ВАЖНЫЙ ШАГ**+> **ЭТО САМЫЙ ВАЖНЫЙ ШАГ**>-> Бот использует ваши цели для приоритизации задач. Без целей он не понимает, что для вас важно.+> Бот использует ваши цели, чтобы понимать, что для вас важно. Без целей он не сможет правильно расставлять приоритеты.-В папке `vault/goals/` лежат 4 файла:-- `0-vision-3y.md` - видение на 3 года-- `1-yearly-2025.md` - цели на год-- `2-monthly.md` - приоритеты на месяц-- `3-weekly.md` - фокус на неделю+В левой части VS Code найдите папку `vault`, нажмите на стрелочку слева от неё, чтобы раскрыть. Внутри найдите папку `goals`. В ней лежат 4 файла:-**Заполняем с помощью ChatGPT или Claude:**+- `0-vision-3y.md` — видение на 3 года+- `1-yearly-2025.md` — цели на год+- `2-monthly.md` — приоритеты на месяц+- `3-weekly.md` — фокус на неделю-1. В VS Code откройте файл `vault/goals/0-vision-3y.md`+**Как заполнить с помощью ChatGPT или Claude:**-<p align="center">- <img width="600" alt="Code_27_December_2025_iTpZrkVd" src="https://github.com/user-attachments/assets/cd30d883-c430-4282-9fb6-3fc88edf1002" />-</p>--2. Выделите всё: `Ctrl+A` / `Cmd+A`-3. Скопируйте: `Ctrl+C` / `Cmd+C`-4. Откройте [claude.ai](https://claude.ai) или [chat.openai.com](https://chat.openai.com)-5. Вставьте текст и добавьте промпт:+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-летнего видения. Помоги мне его заполнить.@@ -305,20 +350,27 @@ Fork - это ваша личная копия. Все записи будутПравила:1. Задавай вопросы ПО ОДНОМУ2. Жди мой ответ, потом задавай следующий-3. Копай глубже - если отвечаю размыто, уточняй+3. Копай глубже — если отвечаю размыто, уточняй4. В конце сформируй заполненный документ в том же форматеНачни с первого вопроса о карьере.```-6. Ответьте на все вопросы-7. Когда получите результат - скопируйте его-8. Вернитесь в VS Code-9. Выделите всё в файле: `Ctrl+A` / `Cmd+A`-10. Вставьте: `Ctrl+V` / `Cmd+V`-11. **Сохраните:** `Ctrl+S` / `Cmd+S`+7. Отправьте сообщение и отвечайте на вопросы+8. Когда получите готовый заполненный документ — скопируйте его+9. Вернитесь в VS Code+10. В файле `0-vision-3y.md` нажмите `Ctrl+A` (выделить всё), затем `Ctrl+V` (вставить)+11. **Обязательно сохраните файл:** нажмите `Ctrl+S` (на Mac: `Cmd+S`)-Повторите для остальных файлов. Промпты для них:+> **Важно:** Если на вкладке файла рядом с названием горит белый кружочек — файл не сохранён! Обязательно нажмите `Ctrl+S` / `Cmd+S`.++<p align="center">+ <img width="600" alt="Code_27_December_2025_iTpZrkVd" src="https://github.com/user-attachments/assets/cd30d883-c430-4282-9fb6-3fc88edf1002" />+</p>++**Повторите для остальных файлов.**++Промпты для них:**Для `1-yearly-2025.md`:**```@@ -333,61 +385,64 @@ Fork - это ваша личная копия. Все записи будут**Для `3-weekly.md`:**```-Самое важное - секция "ONE Big Thing". Это одна главная задача на неделю.+Самое важное — секция "ONE Big Thing". Это одна главная задача на неделю.Помоги определить её. Задавай вопросы.```-> ⚠️ **Не забывайте сохранять:** `Ctrl+S` / `Cmd+S` после каждого файла!+> **Не забывайте сохранять каждый файл после изменений:** `Ctrl+S` / `Cmd+S`---### 1.6 Настройте профиль-Откройте файл с информацией о себе. В VS Code в левой панели откройте по пути:--```-vault → .claude → skills → dbrain-processor → references → about.md-```+Откройте файл с информацией о себе. Есть два способа:-> 💡 **Быстрый способ:** Нажмите `Ctrl+P` / `Cmd+P` → введите `about.md` → нажмите Enter+**Быстрый способ:**+1. Нажмите `Ctrl+P` (на Mac: `Cmd+P`)+2. В появившейся строке напечатайте `about.md`+3. Нажмите Enter-<!-- TODO: Скриншот: VS Code с открытым поиском файла и введённым about.md -->+**Или вручную:**+В левой панели VS Code раскройте папки по пути:+`vault` → `.claude` → `skills` → `dbrain-processor` → `references` → `about.md`-Замените информацию на свою:-- Имя+В этом файле замените информацию на свою:+- Ваше имя- Чем занимаетесь- Основные проекты- ПриоритетыЭто поможет боту понимать контекст ваших записей.+**Сохраните файл:** `Ctrl+S` / `Cmd+S`+----### 1.7 Настройте систему под себя (важно!)+### 1.7 Настройте систему под себя-> ⚠️ **ВНИМАНИЕ: Этот шаг критически важен!**->-> Помимо `about.md`, в папке `vault/.claude/skills/dbrain-processor/references/` есть ещё несколько файлов, которые нужно настроить под себя. Без этого бот не будет понимать ваш контекст.+> **Важно:** Помимо `about.md`, в папке `vault/.claude/skills/dbrain-processor/references/` есть ещё несколько файлов, которые нужно настроить под себя.-**Что нужно обновить:**+**Какие файлы нужно обновить:**| Файл | Что там настраивается ||------|----------------------|| `about.md` | Ваш профиль, цели, стиль работы |-| `classification.md` | Категории задач, имена клиентов (если есть) |+| `classification.md` | Категории задач, имена клиентов/проектов || `todoist.md` | Проекты в Todoist, приоритеты |<p align="center"><img width="350" alt="Antigravity_27_December_2025_POjAbCgi" src="https://github.com/user-attachments/assets/37a8c189-baef-4e90-8711-9e0c02855d72" /></p>-> 💡 **Может у вас нет клиентов** — вы работаете на производстве, в офисе, или фрилансер. Это нормально! Замените примеры на свои реалии: проекты, отделы, направления работы.+> Может, у вас нет клиентов — вы работаете на производстве, в офисе, или фрилансер. Это нормально! Замените примеры на свои реалии: проекты, отделы, направления работы.-**Самый простой способ настроить (рекомендуем):**+**Самый простой способ настроить:**-1. Скачайте папку `vault/.claude/skills/dbrain-processor/` целиком-2. Заархивируйте её в ZIP-3. Отправьте в [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) с промптом:+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-ассистента.@@ -395,61 +450,72 @@ vault → .claude → skills → dbrain-processor → references → about.mdКогда закончим — верни мне обновлённый ZIP-архив.```-4. Ответьте на все вопросы-5. Скачайте готовый архив-6. Разархивируйте и положите обратно с тем же названием папки+6. Ответьте на все вопросы+7. Скачайте готовый архив+8. Разархивируйте и положите файлы обратно в ту же папку, заменив старые**Или вручную:**--Откройте каждый файл в папке `references/` и замените плейсхолдеры `[Your ...]` на свою информацию. В каждом файле есть подсказки в комментариях.+Откройте каждый файл в папке `references/` и замените примеры `[Your ...]` на свою информацию. В каждом файле есть подсказки.---### 1.8 Сохраните изменения в GitHub-В VS Code:+Теперь нужно отправить все ваши изменения обратно на GitHub.-1. В левой панели нажмите на иконку с веткой (Source Control)-2. Вы увидите список изменённых файлов-3. В поле "Message" напишите: `Initial setup with my goals`-5. Нажмите кнопку "Commit"-6. Нажмите ещё раз на эту же кнопку, но там будет написано "Sync Changes" или "Publish Branch"+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<p align="center"><img width="400" alt="Antigravity_27_December_2025_2DT3p7IR" src="https://github.com/user-attachments/assets/f67958e9-8954-4d63-93d8-8cb7792abf3a" /></p>--Если спросит логин - введите ваш GitHub логин и пароль (или Personal Access Token).--Ваш проект с вашими целями теперь в вашем репозитории.+Готово! Ваш проект с вашими целями теперь сохранён в вашем репозитории на GitHub.----### ✅ Контрольная точка: Часть 1 завершена+### Контрольная точка: Часть 1 завершена-| Что проверить | Ожидаемый результат | Если не работает |-|---------------|---------------------|------------------|-| У вас есть свой репозиторий | Откройте `github.com/ВАШ_ЛОГИН/agent-second-brain` — видите свои файлы | Вернитесь к шагу 1.3 и сделайте Fork |-| Репозиторий приватный (опционально) | В настройках репо стоит Private | Settings → Change visibility → Private |-| На компе открывается папка проекта | В VS Code слева видно папки `vault`, `src` и файлы | Вернитесь к шагу 1.4 и клонируйте заново |-| Цели заполнены | Откройте `vault/goals/` — там ваши цели, не шаблон | Вернитесь к шагу 1.5 |-| Изменения в GitHub | На github.com видны ваши коммиты | Вернитесь к шагу 1.8, нажмите Sync Changes |+| Что проверить | Ожидаемый результат |+|---------------|---------------------|+| У вас есть свой репозиторий | Откройте `github.com/ВАШ_ЛОГИН/agent-second-brain` — видите свои файлы |+| На компьютере есть папка проекта | В VS Code слева видны папки `vault`, `src` и файлы |+| Цели заполнены | Откройте `vault/goals/` — там ваши цели, не шаблон |+| Изменения в GitHub | На сайте github.com видны ваши изменения |----## Часть 2: Получите токены ⏱ 15 мин+# Часть 2: Получите ключи ⏱ 15 мин++**Что нужно собрать:**+Вам понадобятся 4 секретных кода (токена). Соберите их все заранее и сохраните в надёжное место — блокнот, заметки или менеджер паролей.-Соберите все ключи заранее. Сохраните в надёжное место.+| Токен | Откуда взять | Как выглядит |+|-------|--------------|--------------|+| Telegram Bot Token | @BotFather в Telegram | `7123456789:AAH...` |+| Ваш Telegram ID | @userinfobot в Telegram | `123456789` |+| Deepgram API Key | console.deepgram.com | Длинная строка |+| Todoist API Token | todoist.com → Settings | 40 символов |++---### 2.1 Telegram Bot Token-1. Откройте Telegram-2. Найдите `@BotFather`-3. Отправьте `/newbot` или откройте миниапп и создайте там новый бот-4. Введите имя: `My Second Brain`-5. Введите username: `my_brain_777_bot` (уникальный, заканчивается на `bot`)-6. Скопируйте токен+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`<p align="center"><img width="350" alt="Telegram_27_December_2025_QyxHhZBg" src="https://github.com/user-attachments/assets/712f661c-c63a-4c67-82b0-dc40c2e66317" />@@ -459,18 +525,25 @@ vault → .claude → skills → dbrain-processor → references → about.md### 2.2 Ваш Telegram ID-1. Найдите `@userinfobot` в Telegram-2. Отправьте любое сообщение-3. Скопируйте свой ID: `123456789`+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. Зарегистрируйтесь-3. Settings → API Keys → Create API Key-4. Скопируйте ключ (показывается один раз!)+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. **Важно:** Ключ показывается только один раз! Скопируйте его сразу и сохраните.++> **Предупреждение:** Если вы закроете окно, не скопировав ключ — он исчезнет навсегда и придётся создавать новый.<p align="center"><img width="600" alt="Arc_27_December_2025_yTuxiFSA" src="https://github.com/user-attachments/assets/76d51155-7506-45f4-97b3-e4965496b266" />@@ -480,9 +553,13 @@ vault → .claude → skills → dbrain-processor → references → about.md### 2.4 Todoist API Token-1. Зайдите на [todoist.com](https://todoist.com)-2. Settings → Integrations → Developer-3. Скопируйте API token+1. Откройте в браузере сайт [todoist.com](https://todoist.com)+2. Войдите в свой аккаунт или зарегистрируйтесь+3. Нажмите на свой аватар в левом верхнем углу+4. Выберите **Settings** (Настройки)+5. В левом меню найдите **Integrations** (Интеграции)+6. Прокрутите вниз до раздела **Developer**+7. Скопируйте **API token**<p align="center"><img width="600" alt="Arc_27_December_2025_FlpSkZgR" src="https://github.com/user-attachments/assets/eb676e25-1633-44e4-b90e-6d066a3b46d2" />@@ -490,26 +567,30 @@ vault → .claude → skills → dbrain-processor → references → about.md----### ✅ Контрольная точка: Часть 2 завершена+### Контрольная точка: Часть 2 завершена-| Что проверить | Ожидаемый результат | Если не работает |-|---------------|---------------------|------------------|-| Telegram Bot Token | Строка вида `7123456789:AAH...` | Напишите `/newbot` в @BotFather |-| Telegram ID | Число вида `123456789` | Напишите что угодно в @userinfobot |-| Deepgram API Key | Длинная строка букв и цифр | Зайдите на console.deepgram.com → API Keys |-| Todoist API Token | Строка из 40 символов | Todoist → Settings → Integrations → Developer |+| Что проверить | Ожидаемый результат |+|---------------|---------------------|+| Telegram Bot Token | Строка вида `7123456789:AAH...` |+| Ваш Telegram ID | Число вида `123456789` |+| Deepgram API Key | Длинная строка букв и цифр |+| Todoist API Token | Строка из 40 символов |-> 💾 **Сохраните все токены** в надёжное место (заметки, менеджер паролей). Они понадобятся на VPS.+> **Сохраните все токены** в надёжное место. Они понадобятся при настройке сервера.----## Часть 3: Настройка VPS ⏱ 40-70 мин+# Часть 3: Настройка сервера ⏱ 40–70 мин### 3.1 Купите VPS и подключитесь-1. Купите VPS на [Contabo](https://contabo.com/en/vps/) или [OVH](https://ovhcloud.com/en/vps/)-2. Выберите Ubuntu 22.04-3. Получите на почту IP-адрес и пароль+**Шаг 1: Купите сервер**++1. Откройте сайт [Contabo](https://contabo.com/en/vps/) или [OVH](https://ovhcloud.com/en/vps/)+2. Выберите самый дешёвый тариф (хватит с запасом)+3. **Важно:** При выборе операционной системы выберите **Ubuntu 22.04** — это база+4. Завершите покупку и оплату+5. На вашу почту придёт письмо с данными для входа: IP-адрес и пароль<p align="center"><img width="600" alt="Arc_27_December_2025_XNzzknIo" src="https://github.com/user-attachments/assets/9cd54275-199a-418c-9881-6be3aee471f5" />@@ -527,12 +608,32 @@ vault → .claude → skills → dbrain-processor → references → about.md<img width="600" alt="Spark Desktop_27_December_2025_sltZRiMZ" src="https://github.com/user-attachments/assets/7dceb211-90af-4d78-abb0-cec19a0abbdd" /></p>-4. Откройте терминал и подключитесь:+**Шаг 2: Подключитесь к серверу**++На Windows:+1. Нажмите кнопку **Пуск** в левом нижнем углу+2. Напечатайте `cmd` и нажмите Enter+3. Откроется чёрное окно — это командная строка++На Mac:+1. Нажмите `Cmd + Пробел`+2. Напечатайте `Terminal` и нажмите Enter++В открывшемся окне напечатайте команду (замените `ВАШ_IP_АДРЕС` на IP из письма):```bashssh root@ВАШ_IP_АДРЕС```+Например: `ssh [email protected]`++Нажмите Enter.++Если спросит «Are you sure you want to continue?» — напечатайте `yes` и нажмите Enter.++> **Важно о пароле:**+> **Когда вы вводите пароль, в чёрном окне ничего не печатается — это нормально!** Это не зависание. Просто введите пароль из письма и нажмите Enter. Буквы не видно в целях безопасности.+<p align="center"><img width="600" alt="Ghostty_27_December_2025_OwCbt58A" src="https://github.com/user-attachments/assets/92b32f25-b6df-4d25-aac9-7733079cfac7" /></p>@@ -541,14 +642,26 @@ ssh root@ВАШ_IP_АДРЕС### 3.2 Создайте пользователя-Работать под root небезопасно:+Работать под пользователем root небезопасно. Создайте обычного пользователя.++Напечатайте эти команды **по одной**, нажимая Enter после каждой:```bashadduser myuser+```++Система попросит придумать пароль — придумайте и запомните его. На остальные вопросы просто нажимайте Enter.++```bashusermod -aG sudo myuser+```++```bashsu - myuser```+Теперь вы работаете под пользователем `myuser`.+<p align="center"><img width="600" alt="Ghostty_27_December_2025_4iOcEzsO" src="https://github.com/user-attachments/assets/d8e0823a-18ae-4b07-a68b-ff555a18943f" /></p>@@ -557,99 +670,95 @@ su - myuser### 3.3 Установите всё необходимое+Скопируйте и вставьте эти команды **по одной** (после каждой нажимайте Enter и ждите завершения):+```bash-# Обновлениеsudo apt update && sudo apt upgrade -y+```-# Инструменты+```bashsudo apt install -y git curl wget build-essential+```-# Python 3.12+```bashsudo apt install -y software-properties-common+```++```bashsudo add-apt-repository -y ppa:deadsnakes/ppa+```++```bashsudo apt update+```++```bashsudo apt install -y python3.12 python3.12-venv python3.12-dev+```-# uv (менеджер пакетов Python)+```bashcurl -LsSf https://astral.sh/uv/install.sh | sh+```++```bashsource ~/.bashrc+```-# Node.js 20+```bashcurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -+```++```bashsudo apt install -y nodejs+```-# Claude CLI+```bashnpm install -g @anthropic-ai/claude-code+```-# Авторизация+```bashclaude auth login```-<p align="center">- <img width="600" alt="Ghostty_27_December_2025_gAcpHg2c" src="https://github.com/user-attachments/assets/a4e2066d-fccb-4b6b-ba8d-8929c0709cc5" />-</p>------### ✅ Контрольная точка: Часть 3.3 завершена--| Что проверить | Ожидаемый результат | Если не работает |-|---------------|---------------------|------------------|-| Подключение к VPS | `ssh user@IP` работает без ошибок | Проверьте IP и пароль из письма хостера |-| Claude установлен | Команда `claude --version` показывает версию | Повторите `npm install -g @anthropic-ai/claude-code` |-| Claude авторизован | `claude auth status` показывает `Logged in` | Выполните `claude auth login` заново |-------<h1 align="center">🛑 ВСЁ! СТОП!</h1>+Последняя команда откроет ссылку для авторизации — следуйте инструкциям на экране.<p align="center">-<strong>Вы установили Claude Code и авторизовались.</strong><br>-Дальше руками ничего делать не нужно — Claude Code сам всё настроит.-Запустите Claude Code в папке проекта на VPS сервере через терминал по инструкции ниже - все остальное он настроит сам.-</p>--<p align="center">-<a href="#-первый-запуск-бота">-<img src="https://img.shields.io/badge/🚀_ПЕРЕЙТИ_К_ЗАПУСКУ-blue?style=for-the-badge&logoColor=white" alt="Перейти к запуску"/>-</a>+ <img width="600" alt="Ghostty_27_December_2025_gAcpHg2c" src="https://github.com/user-attachments/assets/a4e2066d-fccb-4b6b-ba8d-8929c0709cc5" /></p>----## 🚀 Первый запуск бота+### Контрольная точка: Часть 3.3 завершена-Выберите способ установки:--| Способ | Для кого | Что делает |-|--------|----------|------------|-| **🟢 Автоматический (setup.sh)** | Новички | Скрипт всё спросит и настроит сам |-| **🔵 Через Claude Code** | Продвинутые | Claude поможет с тонкой настройкой |+| Что проверить | Как проверить |+|---------------|---------------|+| Подключение к серверу | Команда `ssh myuser@ВАШ_IP` работает без ошибок |+| Claude установлен | Команда `claude --version` показывает номер версии |+| Claude авторизован | Команда `claude auth status` показывает `Logged in` |----### 🟢 Способ 1: Автоматический скрипт (рекомендуется)+## Запуск бота-**Одна команда + ответы на вопросы = работающий бот**+**Вы установили Claude Code и авторизовались — отлично!**-```bash-# Подключитесь к VPS под обычным пользователем (не root!)-# Затем выполните:+Теперь просто вставьте эту команду и следуйте подсказкам на экране:+```bashcurl -fsSL https://raw.githubusercontent.com/ВАШ_ЛОГИН/agent-second-brain/main/bootstrap.sh | bash```-> ⚠️ **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!+> **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!Скрипт сам:-- ✅ Установит Python, Node.js, uv, Claude CLI-- ✅ Клонирует ваш репозиторий-- ✅ Спросит токены (Telegram, Deepgram, Todoist)-- ✅ Создаст .env файл-- ✅ Настроит автозапуск (systemd)-- ✅ Запустит бота-- ✅ Покажет статус или список проблем+- Скачает ваш проект+- Спросит у вас все токены (Telegram, Deepgram, Todoist)+- Создаст файл с настройками+- Настроит автозапуск+- Запустит бота+- Покажет статус-**Если curl не работает**, скачайте вручную:+**Если команда не сработала**, выполните вручную:```bashcd ~@@ -660,197 +769,218 @@ bash setup.sh----### 🔵 Способ 2: Через Claude Code--Для тех, кто хочет больше контроля или нужна помощь с нестандартной настройкой.--#### Действие 1: Скачайте проект--```bash-cd ~ && mkdir -p projects && cd projects && git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git && cd agent-second-brain-```+### Контрольная точка: Бот работает-> ⚠️ **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!+| Что проверить | Ожидаемый результат |+|---------------|---------------------|+| Бот отвечает на /start | В Telegram видны кнопки меню |+| Голосовые распознаются | Бот отвечает текстом на голосовое сообщение |+| Бот работает после перезагрузки | Перезагрузите сервер, бот снова отвечает |-#### Действие 2: Запустите Claude Code+----```bash-claude-```+# Часть 4: Использование-#### Действие 3: Скопируйте и вставьте этот промпт+### Кнопки бота```-Помоги мне настроить этот проект на VPS https://github.com/smixs/agent-second-brain-Я уже установил Claude Code и авторизовался.-Мне нужно: настроить .env, запустить бота, настроить автозапуск.-Веди пошагово, спрашивай токены когда нужно.+┌─────────────────────────────────────────┐+│ [📊 Статус] [⚙️ Обработать] [📅 Неделя] │+│ [✨ Запрос] [❓ Помощь] │+└─────────────────────────────────────────┘```-#### Действие 4: Отвечайте на вопросы Claude--Claude Code сам:-- Попросит у вас токены (Telegram, Deepgram, Todoist)-- Создаст .env файл-- Запустит бота-- Настроит автозапуск-- Проверит что всё работает+| Кнопка | Что делает |+|--------|------------|+| 📊 Статус | Показывает сколько записей сегодня |+| ⚙️ Обработать | Запускает обработку всех записей |+| 📅 Неделя | Показывает недельный дайджест |+| ✨ Запрос | Можно попросить что-то сделать (самая крутая!) |+| ❓ Помощь | Показывает справку |----### ✅ Контрольная точка: Бот работает--| Что проверить | Ожидаемый результат | Если не работает |-|---------------|---------------------|------------------|-| Бот отвечает на /start | В Telegram видны кнопки меню | Проверьте TELEGRAM_BOT_TOKEN в .env |-| Голосовые транскрибируются | Бот отвечает текстом на голосовое | Проверьте DEEPGRAM_API_KEY в .env |-| Автозапуск настроен | `sudo systemctl status d-brain-bot` → `active (running)` | Claude поможет настроить systemd |-| Бот работает после перезагрузки | Перезагрузите VPS, бот снова отвечает | `sudo systemctl enable d-brain-bot` |+### Что можно отправлять-**Готово!** Переходите к [Часть 5: Синхронизация](#часть-5-синхронизация).+**Голосовые** — основной способ:+- «Надо написать Пете по проекту»+- «Идея: сделать лендинг с калькулятором»----+**Текст** — ссылки, цитаты, быстрые мысли-## Что дальше после настройки?+**Фото** — скриншоты, фото досок-Когда Claude Code всё настроит и бот заработает:+**Пересланные сообщения** — из других чатов-**➡️ Перейдите к [Часть 5: Синхронизация](#часть-5-синхронизация)** — чтобы настроить Obsidian на компьютере и телефоне.+----### Где смотреть свои записи?+### Кнопка «✨ Запрос»-| Способ | Описание |-|--------|----------|-| **Obsidian** | Красивый просмотр заметок с связями. Скачайте на [obsidian.md](https://obsidian.md) |-| **GitHub** | Все файлы хранятся в вашем репозитории. Всегда можно зайти и посмотреть |-| **Кнопка ✨ Запрос** | Спросите бота напрямую: "что я записал вчера?", "покажи мои цели" |+1. Нажмите **✨ Запрос**+2. Бот спросит «Что сделать?»+3. Отправьте голосовое или текст-> 💡 **Самое крутое** — кнопка **✨ Запрос** в боте. Вы всегда можете узнать текущий статус, внести изменения, спросить что угодно. Общайтесь с ботом напрямую как с ассистентом!+Примеры:+- «покажи задачи на сегодня»+- «перенеси просроченные на понедельник»+- «создай задачу: позвонить в банк»----# ⚙️ Техническая документация для Claude Code+# Часть 5: Синхронизация-> ⚠️ **Этот раздел читает Claude Code, не вы!**->-> Ниже — детальные инструкции которые Claude Code использует для настройки VPS. Вам не нужно их читать или выполнять вручную.->-> **Для вас:** после настройки перейдите к [Часть 5: Синхронизация](#часть-5-синхронизация)+Ваши записи хранятся в папке `vault/`. Есть несколько способов их просматривать:----+### Способ 1: Obsidian (рекомендуем)-### ⚠️ Инструкция для Claude Code: команды с sudo+**Что такое Obsidian:**+Это бесплатное приложение для просмотра заметок с красивыми связями между ними. Вы сможете видеть все свои мысли, задачи и цели в удобном интерфейсе.-**Claude Code не может выполнять команды с `sudo`** — они требуют ввода пароля.+<p align="center">+ <img width="1280" height="720" alt="image" src="https://github.com/user-attachments/assets/a5bb0499-1945-48b9-9cfe-512e75714d19" />+</p>-Когда нужно выполнить команду с sudo, попроси пользователя:+**На компьютере:**+1. Откройте браузер и перейдите на [obsidian.md](https://obsidian.md)+2. Скачайте приложение для вашей системы и установите его+3. Откройте Obsidian+4. Нажмите **Open folder as vault**+5. Найдите папку `agent-second-brain` (там, куда вы скачивали проект в Части 1)+6. Внутри неё выберите папку `vault`+7. Нажмите **Open**-```-Мне нужно выполнить команду с sudo, но я не могу ввести пароль.+Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе.-Пожалуйста, сделайте следующее:+**На iPhone/iPad:**+1. На компьютере переместите папку `vault` в iCloud Drive+2. На iPhone скачайте Obsidian из App Store+3. В приложении «Файлы» найдите папку `vault` в iCloud+4. В Obsidian нажмите «Open folder as vault» → выберите эту папку-1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T)-2. Подключитесь к серверу:- ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС+**На Android:**+1. Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal)+2. Подключите ваш GitHub репозиторий+3. Все заметки будут синхронизироваться автоматически-3. Выполните эту команду:- sudo [КОМАНДА]+----4. Введите пароль когда попросят-5. Вернитесь ко мне и скажите что готово+### Способ 2: GitHub напрямую++Все файлы хранятся в вашем репозитории на GitHub по адресу:+```+https://github.com/ВАШ_ЛОГИН/agent-second-brain```-Примеры команд которые требуют sudo:-- `sudo systemctl ...` — управление сервисами-- `sudo nano /etc/systemd/system/...` — создание сервисов-- `sudo apt install ...` — установка пакетов+Вы можете:+- Просматривать заметки прямо на сайте+- Редактировать файлы через веб-интерфейс+- Скачивать обновления командой `git pull`----### 3.4 Проверьте MCP Todoist+### Способ 3: Кнопка «✨ Запрос»-```bash-npx -y @doist/todoist-ai --help-```+Самый простой способ — спросить бота напрямую:+- «Что я записал вчера?»+- «Покажи мои цели на неделю»+- «Какие задачи на сегодня?»+- «Найди заметку про [тема]»-Если выполнилось без ошибок - всё ок. Подробнее: [github.com/Doist/todoist-ai](https://github.com/Doist/todoist-ai)+Бот найдёт и покажет всё что нужно прямо в Telegram.----### 3.5 Клонируйте ваш Fork--> ⚠️ **ОБЯЗАТЕЛЬНО замените `ВАШ_ЛОГИН`** на ваш логин GitHub!-> Иначе команда не сработает и вы увидите ошибку.+# Помощь-```bash-cd ~-mkdir -p projects-cd projects+### Если что-то пошло не так-# ⚠️ ЗАМЕНИТЕ ВАШ_ЛОГИН на свой логин GitHub!-# Например: git clone https://github.com/ivan_petrov/agent-second-brain.git-git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git+Самый простой способ решить проблему — запустить программу `claude` прямо в чёрном окне сервера.-cd agent-second-brain-uv sync-```+1. Подключитесь к серверу (как в Части 3)+2. Перейдите в папку проекта:+ ```bash+ cd ~/agent-second-brain+ ```+3. Запустите Claude:+ ```bash+ claude+ ```+4. Напишите ему:+ ```+ Я настраиваю бота, у меня возникла ошибка: [опишите что случилось]+ Что мне сделать?+ ```-<!-- TODO: Скриншот: терминал с успешным клонированием репозитория -->+Claude прочитает файлы проекта и поможет решить проблему.----### 3.6 Создайте файл .env+### Частые проблемы+**Бот не отвечает в Telegram:**+Проверьте, работает ли он. Подключитесь к серверу и выполните:```bash-nano .env+sudo systemctl status d-brain-bot```+Должно показать `active (running)`.-Вставьте (замените на свои токены):+**Голосовые не распознаются:**+Проверьте, правильно ли вы ввели ключ Deepgram при настройке.+**Claude не работает:**+Проверьте авторизацию:```bash-TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx-DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-TODOIST_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-VAULT_PATH=./vault-ALLOWED_USER_IDS=[123456789]+claude auth status+```+Если нужно авторизоваться заново:+```bash+claude auth login```--> ⚠️ **ВАЖНО:** В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки `[ ]`!->-> Пример: `ALLOWED_USER_IDS=[123456789]` - правильно-> `ALLOWED_USER_IDS=123456789` - неправильно--Сохраните: `Ctrl+O` → `Enter` → `Ctrl+X`----### 3.7 Тестовый запуск+<details>+<summary><strong>Технические детали (для продвинутых)</strong></summary>++### Полезные команды```bash-uv run python -m d_brain+# Посмотреть логи бота+sudo journalctl -u d-brain-bot -f++# Перезапустить бота+sudo systemctl restart d-brain-bot++# Остановить бота+sudo systemctl stop d-brain-bot++# Запустить бота+sudo systemctl start d-brain-bot```-Откройте Telegram, найдите бота, отправьте `/start`.+### MCP-серверы-Если видите кнопки - работает. `Ctrl+C` для остановки.+Эта система использует **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам. По умолчанию настроен Todoist, но вы можете подключить любой сервис, для которого есть MCP-сервер:----+| Сервис | MCP-сервер | Что можно делать |+|--------|------------|------------------|+| **Todoist** | [@doist/todoist-ai](https://github.com/Doist/todoist-ai) | Задачи, проекты, приоритеты *(уже настроен)* |+| **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) | Страницы, базы данных |+| **Things 3** | [things-mcp](https://github.com/hald/things-mcp) | Задачи на macOS/iOS |+| **GitHub** | [github-mcp-server](https://github.com/github/github-mcp-server) | Issues, PR, репозитории |-### 3.8 Настройте автозапуск+Полный список: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)++### Настройка systemd вручную++Если автоматический скрипт не создал сервис:```bashsudo nano /etc/systemd/system/d-brain-bot.service```-> ⚠️ **ВАЖНО: Замените `myuser`** на имя пользователя, которое вы создали в шаге 3.2!->-> Если вы создали пользователя `ivan`, замените **все** `myuser` на `ivan`:-> - `User=ivan`-> - `WorkingDirectory=/home/ivan/projects/...`-> - `ExecStart=/home/ivan/.local/bin/uv...`->-> В файле ниже `myuser` встречается **3 раза** — замените все!+Вставьте (замените `myuser` на ваше имя пользователя):```ini[Unit]@@ -860,7 +990,7 @@ After=network.target[Service]Type=simpleUser=myuser-WorkingDirectory=/home/myuser/projects/agent-second-brain+WorkingDirectory=/home/myuser/agent-second-brainExecStart=/home/myuser/.local/bin/uv run python -m d_brainRestart=alwaysRestartSec=10@@ -869,271 +999,91 @@ RestartSec=10WantedBy=multi-user.target```-<!-- TODO: Скриншот: nano редактор с заполненным конфигом (с реальным именем пользователя) -->--Запустите:+Сохраните (`Ctrl+O`, Enter, `Ctrl+X`) и выполните:```bashsudo systemctl daemon-reloadsudo systemctl enable d-brain-botsudo systemctl start d-brain-bot-sudo systemctl status d-brain-bot```-Должно показать `active (running)`.+</details>----### 3.9 Настройте Git push--```bash-cd ~/projects/agent-second-brain-git config user.name "My Bot"-git config user.email "[email protected]"-```--Создайте токен на GitHub:-1. GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)-2. Generate new token-3. Scope: `repo`-4. Скопируйте--> ⚠️ **Замените `ТОКЕН` и `ВАШ_ЛОГИН`** в команде ниже!->-> - `ТОКЕН` — это Personal Access Token, который вы только что создали-> - `ВАШ_ЛОГИН` — ваш логин на GitHub+<details>+<summary><strong>Инструкция для Claude Code (читает Claude, не вы)</strong></summary>-```bash-git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git-```+### Команды с sudo-Например: `git remote set-url origin https://[email protected]/ivan_petrov/agent-second-brain.git`+Claude Code не может выполнять команды с `sudo` — они требуют ввода пароля.------### 3.10 Claude поможет донастроить--> ✅ **ВАЖНЫЙ ШАГ**->-> Если вы успешно установили Claude Code и прошли авторизацию (`claude auth login`) —-> дальше можно попросить Claude помочь с настройкой!--Перейдите в папку проекта и запустите Claude:--```bash-cd ~/projects/agent-second-brain-claude-```--Отправьте ему:--```-Помоги мне настроить проект по инструкции.-Вот мой репозиторий: https://github.com/ВАШ_ЛОГИН/agent-second-brain--Я уже сделал:-- Клонировал репозиторий-- Установил Claude Code+Когда нужно выполнить команду с sudo, попроси пользователя:-Что делать дальше?```+Мне нужно выполнить команду с sudo, но я не могу ввести пароль.-> ⚠️ **Не забудьте заменить `ВАШ_ЛОГИН`** на ваш реальный логин GitHub!--Claude прочитает файлы проекта, поймёт контекст и проведёт вас по остальным шагам.--<!-- TODO: Скриншот: терминал с запущенным Claude Code -->-----+Пожалуйста, сделайте следующее:-## Часть 4: Использование+1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T)+2. Подключитесь к серверу:+ ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС-### Кнопки бота+3. Выполните эту команду:+ sudo [КОМАНДА]+4. Введите пароль когда попросят+5. Вернитесь ко мне и скажите что готово```-┌─────────────────────────────────────────┐-│ [📊 Статус] [⚙️ Обработать] [📅 Неделя] │-│ [✨ Запрос] [❓ Помощь] │-└─────────────────────────────────────────┘-```--| Кнопка | Что делает |-|--------|------------|-| 📊 Статус | Сколько записей сегодня |-| ⚙️ Обработать | Запустить обработку |-| 📅 Неделя | Недельный дайджест |-| ✨ Запрос | Попросить что-то сделать |-| ❓ Помощь | Справка |------### Что можно отправлять--**Голосовые** - основной способ:-- "Надо написать Пете по проекту"-- "Идея: сделать лендинг с калькулятором"--**Текст** - ссылки, цитаты, быстрые мысли--**Фото** - скриншоты, фото досок--**Пересланные сообщения** - из других чатов-------### Кнопка ✨ Запрос--1. Нажмите **✨ Запрос**-2. Бот спросит "Что сделать?"-3. Отправьте голосовое или текст+### Ручные шаги настройки-Примеры:-- "покажи задачи на сегодня"-- "перенеси просроченные на понедельник"-- "создай задачу: позвонить в банк"-------## Часть 5: Синхронизация--Ваши записи хранятся в папке `vault/`. Есть несколько способов их просматривать:--### Способ 1: Obsidian (рекомендуем)--[Obsidian](https://obsidian.md) — бесплатное приложение для просмотра заметок с красивыми связями между ними.--<p align="center">- <img width="1280" height="720" alt="image" src="https://github.com/user-attachments/assets/a5bb0499-1945-48b9-9cfe-512e75714d19" />-</p>--**На компьютере:**-1. Скачайте [Obsidian](https://obsidian.md) и установите-2. Откройте Obsidian-3. Нажмите "Open folder as vault"-4. Выберите папку `vault` из вашего проекта `agent-second-brain`--Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе.--**На iPhone/iPad:**-1. На компьютере переместите папку `vault` в iCloud Drive-2. На iPhone скачайте Obsidian из App Store-3. В приложении "Файлы" найдите папку `vault` в iCloud-4. Нажмите и удерживайте → "Сохранить на устройство" (чтобы работало офлайн)-5. В 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+**Проверка MCP Todoist:**+```bash+npx -y @doist/todoist-ai --help```-Вы можете:-- Просматривать заметки прямо на сайте-- Редактировать файлы через веб-интерфейс-- Скачивать обновления командой `git pull`--### Способ 3: Кнопка ✨ Запрос--Самый простой способ — спросить бота напрямую:-- "Что я записал вчера?"-- "Покажи мои цели на неделю"-- "Какие задачи на сегодня?"-- "Найди заметку про [тема]"--Бот найдёт и покажет всё что нужно прямо в Telegram.-------# FAQ--## Проблемы? Claude Code поможет--Самое важное - установить Claude Code. После этого он сам донастроит всё остальное.-+**Клонирование репозитория:**```bash-cd ~/projects/agent-second-brain-claude+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```-Помоги настроить проект по инструкции:-https://github.com/smixs/agent-second-brain-У меня проблема с [опишите]+Содержимое:+```bash+TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx+DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx+TODOIST_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx+VAULT_PATH=./vault+ALLOWED_USER_IDS=[123456789]```-Он прочитает README, увидит файлы и поможет.+> В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки!------## Технические проблемы--**Бот не отвечает:**+**Тестовый запуск:**```bash-sudo systemctl status d-brain-bot-sudo journalctl -u d-brain-bot -n 50+uv run python -m d_brain```-**Claude не работает:**+**Настройка Git push:**```bash-claude auth status-claude auth login+git config user.name "My Bot"+git config user.email "[email protected]"```-**Голосовые не транскрибируются:**-- Проверьте DEEPGRAM_API_KEY в .env-------## Полезные команды+Создайте Personal Access Token на GitHub: Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token (scope: repo)```bash-# Логи-sudo journalctl -u d-brain-bot -f--# Перезапуск-sudo systemctl restart d-brain-bot--# Статус таймеров-sudo systemctl list-timers+git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git```------# Дополнительно: MCP-серверы--> 💡 **Этот раздел для продвинутых пользователей.** Если вы только начинаете — пропустите его.--### 🔌 Универсальная система через MCP--Эта система использует **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам. По умолчанию здесь настроен Todoist, но вы можете подключить **любой сервис**, для которого есть MCP-сервер:--| Сервис | MCP-сервер | Что можно делать |-|--------|------------|------------------|-| **Todoist** | [@doist/todoist-ai](https://github.com/Doist/todoist-ai) | Задачи, проекты, приоритеты *(уже настроен)* |-| **Google Workspace** | [google_workspace_mcp](https://github.com/taylorwilsdon/google_workspace_mcp) | Gmail, Calendar, Drive, Docs, Sheets |-| **Notion** | [notion-mcp-server](https://github.com/makenotion/notion-mcp-server) | Страницы, базы данных, блоки |-| **Things 3** | [things-mcp](https://github.com/hald/things-mcp) | Задачи на macOS/iOS |-| **Obsidian** | [mcp-obsidian](https://github.com/MarkusPfundstein/mcp-obsidian) | Заметки, поиск, редактирование |-| **GitHub** | [github-mcp-server](https://github.com/github/github-mcp-server) | Issues, PR, репозитории |-| **Slack** | [slack-mcp](https://github.com/modelcontextprotocol/servers/tree/main/src/slack) | Сообщения, каналы |--> 💡 **Не используете Todoist?** Замените на Things, TickTick или любой другой сервис. Полный список MCP-серверов: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)-------# Поддержка--- Вопросы: [@aimastersme](https://t.me/aimastersme)-- Баги: [GitHub Issues](https://github.com/smixs/agent-second-brain/issues)-------*Made with 🧠 by [@serge shima](https://t.me/shimaoz)*+</details>