Skip to content

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.

docs: обновить README

smixs31833393b3bb
diff --git a/README.md b/README.md
index b7895c5..58c2d5d 100644
--- a/README.md
+++ b/README.md
@@ -2,51 +2,15 @@
![telegram-cloud-photo-size-2-5332708313742904084-y](https://github.com/user-attachments/assets/ea384e65-436b-48a1-a4e1-2b003cafcdbf)
-
**Персональный 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 Создайте аккаунт на GitHub
1. Зайдите на [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 Token
1. Откройте 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` в Telegram
2. Отправьте любое сообщение
3. Скопируйте свой ID: `123456789`
-**Сохраните ID!**
-
---
-## 2.3 Deepgram API Key
-
-Deepgram транскрибирует голосовые сообщения. При регистрации дают $200 — хватает надолго.
+### 2.3 Deepgram API Key
1. Зайдите на [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 Token
1. Зайдите на [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
-
-# Даём права sudo
usermod -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.12
sudo apt install -y software-properties-common
sudo add-apt-repository -y ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.12 python3.12-venv python3.12-dev
-```
-### uv (быстрый менеджер пакетов Python)
-```bash
+# uv (менеджер пакетов Python)
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
-```
-### Node.js 20
-```bash
+# Node.js 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
-```
-### Claude CLI
-```bash
+# Claude CLI
npm 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
```bash
cd ~
mkdir -p projects
cd 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
```bash
nano .env
@@ -541,42 +424,39 @@ nano .env
```bash
TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx
DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-TODOIST_API_KEY=
+TODOIST_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
VAULT_PATH=./vault
ALLOWED_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 Тестовый запуск
```bash
uv run python -m d_brain
```
-Откройте Telegram, найдите своего бота, отправьте `/start`.
-
-**Если работает** — увидите приветствие и кнопки. Нажмите `Ctrl+C` для остановки.
+Откройте Telegram, найдите бота, отправьте `/start`.
-**Если не работает** — проверьте:
-- Правильный ли токен в .env?
-- Совпадает ли ваш ID в ALLOWED_USER_IDS?
+Если видите кнопки - работает. `Ctrl+C` для остановки.
---
-## 3.8 Настройка автозапуска
-
-Чтобы бот работал постоянно, даже после перезагрузки сервера:
+### 3.7 Настройте автозапуск
```bash
sudo nano /etc/systemd/system/d-brain-bot.service
```
-Вставьте (замените `myuser` на имя вашего пользователя):
+Вставьте (замените `myuser`):
```ini
[Unit]
@@ -586,7 +466,7 @@ After=network.target
[Service]
Type=simple
User=myuser
-WorkingDirectory=/home/myuser/projects/dbrain
+WorkingDirectory=/home/myuser/projects/agent-second-brain
ExecStart=/home/myuser/.local/bin/uv run python -m d_brain
Restart=always
RestartSec=10
@@ -595,194 +475,42 @@ RestartSec=10
WantedBy=multi-user.target
```
-Сохраните и запустите:
+Запустите:
```bash
sudo systemctl daemon-reload
sudo systemctl enable d-brain-bot
sudo systemctl start d-brain-bot
-```
-
-Проверьте статус:
-```bash
sudo 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-brain
git 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. Скопируйте
```bash
git 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-brain
claude
```
-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)
---