An always-on second brain you talk to. Voice notes in Telegram → typed, linked knowledge in your Obsidian vault. Runs 24/7 on the Claude subscription you already have.
Python ai-agentsai-automationclaudeclaude-codeebbinghausknowledge-graphllmmemory-systemobsidianpersonal-assistantpkmproductivitypythonsecond-braintelegram-botvoice-assistant
docs: Обновить README
smixs08ee8001e200
diff --git a/README.md b/README.mdindex bc9bc65..5795b9d 100644--- a/README.md+++ b/README.md@@ -12,6 +12,37 @@---+## 📑 Оглавление++- [Зачем это нужно](#зачем-это-нужно)+- [Как это работает](#как-это-работает)+- [Словарь терминов](#-словарь-терминов)+- [Что понадобится](#что-понадобится)+- **Часть 1: Подготовка на компьютере** ⏱ 30-50 мин+ - [1.1 Установите Git и VS Code](#11-установите-git-и-vs-code)+ - [1.2 Создайте аккаунт на GitHub](#12-создайте-аккаунт-на-github)+ - [1.3 Сделайте Fork проекта](#13-сделайте-fork-проекта)+ - [1.4 Клонируйте Fork на компьютер](#14-клонируйте-fork-на-компьютер)+ - [1.5 Заполните ваши цели](#15-заполните-ваши-цели)+ - [1.6 Настройте профиль](#16-настройте-профиль)+ - [1.7 Настройте систему под себя](#17-настройте-систему-под-себя-важно)+ - [1.8 Сохраните изменения в GitHub](#18-сохраните-изменения-в-github)+- **Часть 2: Получите токены** ⏱ 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.1 Купите VPS и подключитесь](#31-купите-vps-и-подключитесь)+ - [3.2 Создайте пользователя](#32-создайте-пользователя)+ - [3.3 Установите всё необходимое](#33-установите-всё-необходимое)+ - [🚀 Перейти к запуску](#-всё-стоп-дальше-claude-code-сделает-сам)+- [Часть 4: Использование](#часть-4-использование)+- [Часть 5: Синхронизация](#часть-5-синхронизация)+- [FAQ](#faq)++---+## Зачем это нужноЭто GTD-система (Getting Things Done) на стероидах. Один раз настроите - и у вас всегда под рукой понимание, что происходит в жизни.@@ -94,6 +125,23 @@---+## 📖 Словарь терминов++Если какие-то слова незнакомы — вот короткий словарь:++| Термин | Что это значит |+|--------|----------------|+| **VPS** | Удалённый мини-компьютер в интернете. Как ваш ПК, но работает 24/7 и находится в дата-центре |+| **SSH** | Способ подключиться к VPS через терминал. Как удалённый рабочий стол, но текстом |+| **Token** | Пароль для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать |+| **Repo** | Репозиторий — папка проекта на GitHub. Там хранятся все файлы и история изменений |+| **.env** | Файл с секретами и настройками. Лежит только на сервере, никуда не публикуется |+| **systemd** | Автозапуск на сервере. Следит чтобы бот работал, перезапускает если упал |+| **Fork** | Ваша личная копия проекта. Можете менять как хотите, оригинал не затронете |+| **Clone** | Скачать проект на компьютер. После этого можете открыть его в VS Code |++---+## Что понадобится| Компонент | Зачем | Стоимость |@@ -115,7 +163,7 @@----# Часть 1: Подготовка на компьютере+# Часть 1: Подготовка на компьютере ⏱ 30-50 мин### 1.1 Установите Git и VS Code@@ -384,7 +432,19 @@ vault → .claude → skills → dbrain-processor → references → about.md----## Часть 2: Получите токены+### ✅ Контрольная точка: Часть 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 |++---++## Часть 2: Получите токены ⏱ 15 минСоберите все ключи заранее. Сохраните в надёжное место.@@ -436,18 +496,20 @@ vault → .claude → skills → dbrain-processor → references → about.md----### 2.5 Чек-лист+### ✅ Контрольная точка: Часть 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-- [ ] Ваш Telegram ID-- [ ] Deepgram API Key-- [ ] Todoist API Token+> 💾 **Сохрани все токены** в надёжное место (заметки, менеджер паролей). Они понадобятся на VPS.----## Часть 3: Настройка VPS+## Часть 3: Настройка VPS ⏱ 40-70 мин### 3.1 Купите VPS и подключитесь@@ -534,66 +596,79 @@ claude auth login----# 🎉 ВСЁ! ДАЛЬШЕ РУКАМИ НИЧЕГО ДЕЛАТЬ НЕ НУЖНО!+### ✅ Контрольная точка: Часть 3.3 завершена-> ✅ **Поздравляем!** Вы установили Claude Code и авторизовались.->-> **Теперь Claude Code сам настроит всё остальное.**->-> Вам не нужно читать и выполнять инструкции ниже — это техническая документация для Claude Code. Он сам её прочитает и всё сделает.+| Что проверить | Ожидаемый результат | Если не работает |+|---------------|---------------------|------------------|+| Подключение к VPS | `ssh user@IP` работает без ошибок | Проверь IP и пароль из письма хостера |+| Claude установлен | Команда `claude --version` показывает версию | Повтори `npm install -g @anthropic-ai/claude-code` |+| Claude авторизован | `claude auth status` показывает `Logged in` | Выполни `claude auth login` заново |-## Что делать дальше+----### Шаг 1: Перейдите в папку проекта+<h1 align="center">🛑 ВСЁ! СТОП!</h1>++<p align="center">+<strong>Вы установили Claude Code и авторизовались.</strong><br>+Дальше читать инструкцию не нужно — Claude Code сам всё настроит.+</p>++<p align="center">+<a href="#-первый-запуск-бота">+<img src="https://img.shields.io/badge/🚀_ПЕРЕЙТИ_К_ЗАПУСКУ-blue?style=for-the-badge&logoColor=white" alt="Перейти к запуску"/>+</a>+</p>++---++## 🚀 Первый запуск бота++Это простой сценарий из 4 действий. Каждый шаг — одна команда.++### Действие 1: Скачайте проект```bash-cd ~/projects-git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git-cd agent-second-brain+cd ~ && mkdir -p projects && cd projects && git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git && cd agent-second-brain```> ⚠️ **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!-### Шаг 2: Запустите Claude Code+### Действие 2: Запустите Claude Code```bashclaude```-### Шаг 3: Отправьте ему этот промпт--Скопируйте и вставьте:+### Действие 3: Скопируйте и вставьте этот промпт```Помоги мне настроить этот проект на VPS.--Инструкция здесь: https://github.com/smixs/agent-second-brain--Я уже:-✅ Установил Claude Code-✅ Авторизовался-✅ Клонировал репозиторий-✅ Настроил цели и about.md на своём компьютере--Теперь мне нужно:-- Настроить .env файл (попроси у меня токены)-- Запустить бота-- Настроить автозапуск--Веди меня пошагово, спрашивай что нужно.+Я уже установил Claude Code и авторизовался.+Мне нужно: настроить .env, запустить бота, настроить автозапуск.+Веди пошагово, спрашивай токены когда нужно.```-### Шаг 4: Следуйте инструкциям Claude+### Действие 4: Отвечайте на вопросы Claude-Claude Code:-- Прочитает README и поймёт что делать+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-синхронизация).---