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
feat(install): add one-command installer for Mac/WSL
smixs1d20a4ab8573
diff --git a/README.md b/README.mdindex 1f383ed..ffd0896 100644--- a/README.md+++ b/README.md@@ -1,1123 +1,118 @@# Agent Second Brain-<p align="center">- <img alt="telegram-cloud-photo-size-2-5332708313742904084-y" src="https://github.com/user-attachments/assets/ea384e65-436b-48a1-a4e1-2b003cafcdbf" />-</p>+Personal AI assistant with memory. Voice messages in Telegram get transcribed, saved to Obsidian, and create tasks in Todoist.-**Персональный AI-ассистент с долговременной памятью**--Записывайте голосовые в 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" />-</p>-------## Главное перед началом--| Параметр | Значение |-|----------|----------|-| **Время на настройку** | **2–3 часа тишины.** Не торопитесь — лучше один раз сделать правильно. |-| **Стоимость** | ~$25/мес (Claude Pro $20 + VPS $5) |-| **Приватность** | **Это ваш личный сервер. Никто, кроме вас, не имеет доступа к вашим мыслям и задачам.** |-------## Оглавление--- [Зачем это нужно](#зачем-это-нужно)-- [Как это работает](#как-это-работает)-- [Словарь терминов](#словарь-терминов)-- [Что понадобится](#что-понадобится)-- **Часть 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: Настройка сервера** ⏱ 40–70 мин- - [3.1 Купите VPS и подключитесь](#31-купите-vps-и-подключитесь)- - [3.2 Создайте пользователя](#32-создайте-пользователя)- - [3.3 Установите всё необходимое](#33-установите-всё-необходимое)- - [Запуск бота](#запуск-бота)-- [Часть 4: Использование](#часть-4-использование)-- [Часть 5: Синхронизация](#часть-5-синхронизация)-- [Помощь](#помощь)-------## Зачем это нужно--Это система управления задачами и мыслями «на стероидах». Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни.--**Кидайте туда вообще всё:**-- Интересные посты из Telegram — пересылайте боту-- Скриншоты — отправляйте-- После встречи — надиктуйте голосом что было и какие решения-- Эмоции, мысли, идеи — всё записывайте-- Ссылки, цитаты, заметки — абсолютно всё--### Самая крутая кнопка — «Запрос»--Это **полноценный AI-агент**, которому можно сказать что угодно — и он сам разберётся что делать.--**Примеры того, что можно попросить:**--| Запрос | Что сделает агент |-|--------|-------------------|-| «Найди ту идею про маркетинг, которую я записывал на прошлой неделе» | Найдёт в ваших заметках и покажет |-| «Что я делал вчера?» | Даст отчёт по вчерашним записям и задачам |-| «Перенеси все просроченные задачи на понедельник» | Найдёт в Todoist и перенесёт |-| «Поставь повторяющуюся задачу: каждый день в 9 утра — зарядка» | Создаст в Todoist |-| «Обнови мои недельные цели» | Откроет файл целей и поможет обновить |-| «Какие задачи на этой неделе не сделаны?» | Покажет список из Todoist |-| «Посоветуй, на чём сфокусироваться сегодня» | Проанализирует цели и задачи, даст совет |--Вы общаетесь с ним как с настоящим ассистентом. Он сам найдёт нужные файлы, обновит структуру, создаст задачи — всё автоматически.-------Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе — тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты.--**Про Claude Code — не бойтесь названия.** Да, он называется «Code», но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями — создавать задачи, сохранять мысли, следить за целями. Он просто работает.-------> **Если вы запутались на каком-то шаге**->-> Не переживайте! Откройте [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) и напишите:-> «Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]. Вот ссылка: https://github.com/smixs/agent-second-brain»->-> Он прочитает инструкцию и поможет вам пошагово.-------## Как это работает--<p align="center">-<img width="600" alt="как это работает" src="https://github.com/user-attachments/assets/83a0e140-6fbd-4fa3-a799-2b8544663ab1">-</p>--1. Вы отправляете голосовое/текст/фото в **Telegram**-2. **Бот на сервере** сохраняет всё в файл-3. **Claude Code** анализирует записи-4. Создаёт задачи в **Todoist**, сохраняет мысли в **Obsidian**-5. Отправляет отчёт обратно в **Telegram**-6. Всё синхронизируется в **GitHub**-------## Словарь терминов--Если какие-то слова незнакомы — вот короткий словарь:--| Термин | Что это значит |-|--------|----------------|-| **VPS** | Удалённый мини-компьютер в интернете. Как ваш ПК, но работает 24/7 и находится в дата-центре |-| **SSH** | Способ подключиться к VPS через чёрное окно с текстом (терминал). Как удалённый рабочий стол, но текстом |-| **Token** | Секретный код для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать |-| **Repo** | Репозиторий — папка проекта на GitHub. Там хранятся все файлы и история изменений |-| **.env** | Файл с секретами и настройками. Лежит только на сервере, никуда не публикуется |-| **Fork** | Ваша личная копия проекта. Можете менять как хотите, оригинал не затронете |-| **Clone** | Скачать проект на компьютер. После этого можете открыть его в VS Code |-------## Что понадобится--| Компонент | Зачем | Стоимость |-|-----------|-------|-----------|-| **Claude Pro/Max** | AI-агент, который обрабатывает ваши записи | $20/мес |-| **VPS-сервер** | Чтобы бот работал круглосуточно | ~$5/мес |-| **GitHub** | Хранение и синхронизация всех ваших записей | бесплатно |-| **Deepgram** | Превращение голосовых сообщений в текст | бесплатно ($200 на старт) |-| **Todoist** | Хранение задач в одном месте | бесплатно / $4/мес Pro |--**Итого: ~$25/мес**--### Где взять VPS--Нужен сервер НЕ в России/Беларуси — там блокировка Claude по территории.--- [Contabo](https://contabo.com) — $4.96/мес, работает с белорусскими картами-- [OVH](https://ovhcloud.com) — $5/мес, тоже работает с белорусскими картами-------# Часть 1: Подготовка на компьютере ⏱ 30–50 мин--### 1.1 Установите Git и VS Code--**Что это такое:**-- **Git** — программа для скачивания и синхронизации проектов-- **VS Code** — бесплатный редактор файлов (как Word, но для настроек и кода)-------**Если у вас Windows:**--1. Откройте браузер и перейдите по ссылке: [git-scm.com/download/win](https://git-scm.com/download/win)-2. Скачивание начнётся автоматически. Дождитесь окончания.-3. Откройте папку «Загрузки» на вашем компьютере-4. Найдите скачанный файл (называется что-то вроде `Git-2.xx.x-64-bit.exe`)-5. Дважды щёлкните по нему мышкой-6. Если появится окно «Разрешить этому приложению вносить изменения?» — нажмите **Да**-7. Откроется окно установки. Нажимайте кнопку **Next** (Далее) внизу окна-8. Продолжайте нажимать **Next** до тех пор, пока не появится кнопка **Install** — нажмите её-9. Дождитесь завершения установки и нажмите **Finish**--Теперь установите VS Code:--1. Откройте браузер и перейдите по ссылке: [code.visualstudio.com](https://code.visualstudio.com/)-2. Нажмите большую синюю кнопку **Download for Windows**-3. Откройте папку «Загрузки»-4. Найдите скачанный файл (называется что-то вроде `VSCodeUserSetup-x64-1.xx.x.exe`)-5. Дважды щёлкните по нему-6. Если появится окно «Разрешить этому приложению?» — нажмите **Да**-7. Нажимайте **Next** до кнопки **Install**, затем нажмите **Install**-8. Дождитесь завершения и нажмите **Finish**-9. VS Code запустится автоматически. Если нет — найдите его в меню «Пуск»-------**Если у вас Mac:**--1. Нажмите клавиши `Cmd + Пробел` одновременно (появится строка поиска)-2. Напечатайте слово `Terminal` и нажмите Enter-3. Откроется чёрное окно — это терминал-4. Напечатайте команду `git --version` и нажмите Enter-5. Если появится окно «Установить инструменты разработчика?» — нажмите кнопку **Установить**-6. Дождитесь завершения установки--Теперь установите VS Code:--1. Откройте браузер и перейдите по ссылке: [code.visualstudio.com](https://code.visualstudio.com/)-2. Нажмите большую кнопку **Download for Mac**-3. Откройте папку «Загрузки» (Downloads)-4. Найдите файл `VSCode-darwin-universal.zip`-5. Дважды щёлкните по нему — он распакуется в приложение-6. Перетащите появившийся значок **Visual Studio Code** в папку **Программы** (Applications)-7. Откройте папку «Программы» и дважды щёлкните на **Visual Studio Code**-------**Как проверить, что всё установилось:**--После запуска VS Code вы увидите тёмное окно с надписью «Welcome». Это значит, что всё установлено правильно.--<p align="center">- <img width="600" alt="Ghostty_27_December_2025_vPEZpgCt" src="https://github.com/user-attachments/assets/121bb943-ecf1-4827-93f4-ef59221bb49b" />-</p>-------### 1.2 Создайте аккаунт на GitHub--**Что такое GitHub:**-GitHub — это сайт, где хранятся ваши файлы и записи. Как облачное хранилище, но для проектов.--**Как создать аккаунт:**--1. Откройте браузер и перейдите на сайт [github.com](https://github.com)-2. В правом верхнем углу найдите кнопку **Sign up** и нажмите её-3. Введите ваш email (электронную почту)-4. Придумайте пароль (запишите его, чтобы не забыть!)-5. Придумайте имя пользователя (логин) — это будет ваш адрес на GitHub--> **Важно:** Запомните или запишите ваш логин! Везде далее в инструкции, где написано `ВАШ_ЛОГИН`, вам нужно будет вписывать именно это имя.--6. Нажмите **Create account**-7. Пройдите проверку «Я не робот»-8. Откройте вашу почту и найдите письмо от GitHub-9. Нажмите на ссылку в письме для подтверждения--<p align="center">- <img width="600" alt="Arc_27_December_2025_bAQJJGoP" src="https://github.com/user-attachments/assets/c09c12d8-23ee-4a2c-800e-aab564453ecd" />-</p>-------### 1.3 Сделайте Fork проекта--**Что такое Fork:**-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 — там будет написано ваше имя пользователя.-------> ## 🔐🔐🔐 ВАЖНО: СДЕЛАЙТЕ РЕПОЗИТОРИЙ ПРИВАТНЫМ! 🔐🔐🔐->-> **⚠️ ВНИМАНИЕ: ВАШИ МЫСЛИ, ЦЕЛИ И ЗАПИСИ БУДУТ ВИДНЫ ВСЕМ В ИНТЕРНЕТЕ!**->-> По умолчанию форк — публичный. Это значит, что **любой человек** может прочитать ваши личные записи, цели и мысли. **Сделайте репозиторий приватным СРАЗУ после форка!**->-> ---->-> ### 📋 Шаги через веб-интерфейс GitHub:->-> 1. Перейдите в **Settings** (Настройки) вашего форка-> 2. Прокрутите вниз до раздела **"Danger Zone"** (красная зона)-> 3. Нажмите **"Leave fork network"** (Выйти из fork-сети) и подтвердите-> 4. **Обновите страницу** (F5)-> 5. Вернитесь в **"Danger Zone"**-> 6. Нажмите **"Change visibility"** → выберите **"Private"** (Приватный)-> 7. Подтвердите действие->-> ---->-> ✅ **После этого:** только вы сможете видеть содержимое репозитория.->-> ❌ **Если не сделать:** ваши голосовые расшифровки, личные цели, мысли и идеи будут доступны в Google и любому желающему.-------### 1.4 Клонируйте Fork на компьютер--**Что значит «клонировать»:**-Это значит скачать проект с GitHub на ваш компьютер, чтобы вы могли редактировать файлы.--**Шаг 1: Откройте VS Code**-- На Windows: нажмите кнопку «Пуск» в левом нижнем углу экрана, напечатайте `VS Code`, нажмите Enter-- На Mac: нажмите `Cmd + Пробел`, напечатайте `VS Code`, нажмите Enter--**Шаг 2: Откройте командную панель**-- На Windows: нажмите одновременно три клавиши `Ctrl + Shift + P`-- На Mac: нажмите одновременно три клавиши `Cmd + Shift + P`--Сверху окна появится строка для ввода команд.--**Шаг 3: Введите команду клонирования**--1. В появившейся строке напечатайте `Git: Clone` и нажмите Enter-2. Появится строка «Provide repository URL» (введите адрес репозитория)-3. Напечатайте адрес вашего репозитория:--```-https://github.com/ВАШ_ЛОГИН/agent-second-brain.git-```--> **Важно:** Замените `ВАШ_ЛОГИН` на ваш реальный логин GitHub!-> Например, если ваш логин `ivan_petrov`, введите:-> `https://github.com/ivan_petrov/agent-second-brain.git`--4. Нажмите Enter-5. Откроется окно выбора папки. Выберите папку «Документы» (Documents) и нажмите **Select as Repository Destination**-6. Дождитесь, пока проект скачается (появится индикатор загрузки)-7. Появится вопрос «Would you like to open?» — нажмите кнопку **Open**--**Что произошло:**-VS Code скачал проект на ваш компьютер и открыл его. Слева вы увидите список папок и файлов проекта.--<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:**-> 1. Откройте VS Code снова-> 2. Нажмите меню **File** (Файл) в верхнем левом углу-> 3. Выберите **Open Folder** (Открыть папку)-> 4. Найдите папку `agent-second-brain` в папке «Документы»-> 5. Выберите её и нажмите **Open** (Открыть)-------### 1.5 Заполните ваши цели--> **ЭТО САМЫЙ ВАЖНЫЙ ШАГ**->-> Бот использует ваши цели, чтобы понимать, что для вас важно. Без целей он не сможет правильно расставлять приоритеты.--В левой части VS Code найдите папку `vault`, нажмите на стрелочку слева от неё, чтобы раскрыть. Внутри найдите папку `goals`. В ней лежат 4 файла:--- `0-vision-3y.md` — видение на 3 года-- `1-yearly-2025.md` — цели на год-- `2-monthly.md` — приоритеты на месяц-- `3-weekly.md` — фокус на неделю--**Как заполнить с помощью ChatGPT или Claude:**--1. В левой панели VS Code нажмите на файл `vault/goals/0-vision-3y.md`, чтобы открыть его-2. Нажмите `Ctrl+A` (на Mac: `Cmd+A`), чтобы выделить весь текст-3. Нажмите `Ctrl+C` (на Mac: `Cmd+C`), чтобы скопировать-4. Откройте в браузере [claude.ai](https://claude.ai) или [chat.openai.com](https://chat.openai.com)-5. Вставьте скопированный текст (нажмите `Ctrl+V` или `Cmd+V`)-6. Добавьте после текста:--```-Это шаблон моего 3-летнего видения. Помоги мне его заполнить.--Правила:-1. Задавай вопросы ПО ОДНОМУ-2. Жди мой ответ, потом задавай следующий-3. Копай глубже — если отвечаю размыто, уточняй-4. В конце сформируй заполненный документ в том же формате--Начни с первого вопроса о карьере.-```--7. Отправьте сообщение и отвечайте на вопросы-8. Когда получите готовый заполненный документ — скопируйте его-9. Вернитесь в VS Code-10. В файле `0-vision-3y.md` нажмите `Ctrl+A` (выделить всё), затем `Ctrl+V` (вставить)-11. **Обязательно сохраните файл:** нажмите `Ctrl+S` (на Mac: `Cmd+S`)--> **Важно:** Если на вкладке файла рядом с названием горит белый кружочек — файл не сохранён! Обязательно нажмите `Ctrl+S` / `Cmd+S`.--<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`:**-```-Это шаблон годовых целей. На основе моего 3-летнего видения-помоги поставить цели на 2025 год. Задавай вопросы по одному.-```--**Для `2-monthly.md`:**-```-Какие 3 главных приоритета на этот месяц? Задавай вопросы по одному.-```--**Для `3-weekly.md`:**-```-Самое важное — секция "ONE Big Thing". Это одна главная задача на неделю.-Помоги определить её. Задавай вопросы.-```--> **Не забывайте сохранять каждый файл после изменений:** `Ctrl+S` / `Cmd+S`-------### 1.6 Настройте профиль--Откройте файл с информацией о себе. Есть два способа:--**Быстрый способ:**-1. Нажмите `Ctrl+P` (на Mac: `Cmd+P`)-2. В появившейся строке напечатайте `about.md`-3. Нажмите Enter--**Или вручную:**-В левой панели VS Code раскройте папки по пути:-`vault` → `.claude` → `skills` → `dbrain-processor` → `references` → `about.md`--В этом файле замените информацию на свою:-- Ваше имя-- Чем занимаетесь-- Основные проекты-- Приоритеты--Это поможет боту понимать контекст ваших записей.--**Сохраните файл:** `Ctrl+S` / `Cmd+S`-------### 1.7 Настройте систему под себя--> **Важно:** Помимо `about.md`, в папке `vault/.claude/skills/dbrain-processor/references/` есть ещё несколько файлов, которые нужно настроить под себя.--**Какие файлы нужно обновить:**--| Файл | Что там настраивается |-|------|----------------------|-| `about.md` | Ваш профиль, цели, стиль работы |-| `classification.md` | Категории задач, имена клиентов/проектов |-| `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. В левой панели VS Code найдите папку `vault/.claude/skills/dbrain-processor/`-2. Нажмите на неё правой кнопкой мыши-3. Выберите **Reveal in Finder** (Mac) или **Open in File Explorer** (Windows)-4. Заархивируйте эту папку в ZIP-5. Отправьте архив в [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) с текстом:--```-Это настройки моего AI-ассистента.-Задавай мне вопросы по одному, чтобы заполнить все файлы под меня.-Когда закончим — верни мне обновлённый ZIP-архив.-```--6. Ответьте на все вопросы-7. Скачайте готовый архив-8. Разархивируйте и положите файлы обратно в ту же папку, заменив старые--**Или вручную:**-Откройте каждый файл в папке `references/` и замените примеры `[Your ...]` на свою информацию. В каждом файле есть подсказки.-------### 1.8 Сохраните изменения в GitHub--Теперь нужно отправить все ваши изменения обратно на GitHub.--1. В левой части VS Code найдите третью иконку сверху — она выглядит как разветвление (три точки, соединённые линиями). Нажмите на неё.-2. Вы увидите раздел **Source Control** со списком изменённых файлов-3. Над списком файлов есть поле для ввода сообщения «Message»-4. Напечатайте в нём: `Initial setup with my goals`-5. Нажмите кнопку **Commit** (галочка сверху)-6. Если появится вопрос «Stage all changes?» — нажмите **Yes**-7. Затем нажмите кнопку **Sync Changes** или **Publish Branch**-8. Если спросит логин — введите ваш логин и пароль от GitHub--<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.-------### Контрольная точка: Часть 1 завершена--| Что проверить | Ожидаемый результат |-|---------------|---------------------|-| У вас есть свой репозиторий | Откройте `github.com/ВАШ_ЛОГИН/agent-second-brain` — видите свои файлы |-| На компьютере есть папка проекта | В VS Code слева видны папки `vault`, `src` и файлы |-| Цели заполнены | Откройте `vault/goals/` — там ваши цели, не шаблон |-| Изменения в GitHub | На сайте github.com видны ваши изменения |-------# Часть 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. Откройте чат с 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" />-</p>-------### 2.2 Ваш Telegram ID--1. В Telegram в строке поиска напечатайте `@userinfobot`-2. Откройте чат с этим ботом-3. Отправьте ему любое сообщение (например, «привет»)-4. Бот ответит информацией о вас. Найдите строку **Id:** и скопируйте число после неё-5. Это ваш Telegram ID, например: `123456789`-------### 2.3 Deepgram API Key--1. Откройте в браузере сайт [console.deepgram.com](https://console.deepgram.com/)-2. Нажмите **Sign Up** и зарегистрируйтесь (можно через Google)-3. После входа в левом меню найдите **Settings** (Настройки)-4. Выберите **API Keys** (Ключи API)-5. Нажмите кнопку **Create API Key** (Создать ключ)-6. Придумайте любое название (например, `second-brain`)-7. **Важно:** Ключ показывается только один раз! Скопируйте его сразу и сохраните.--> **Предупреждение:** Если вы закроете окно, не скопировав ключ — он исчезнет навсегда и придётся создавать новый.--<p align="center">- <img width="600" alt="Arc_27_December_2025_yTuxiFSA" src="https://github.com/user-attachments/assets/76d51155-7506-45f4-97b3-e4965496b266" />-</p>-------### 2.4 Todoist 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" />-</p>-------### Контрольная точка: Часть 2 завершена--| Что проверить | Ожидаемый результат |-|---------------|---------------------|-| Telegram Bot Token | Строка вида `7123456789:AAH...` |-| Ваш Telegram ID | Число вида `123456789` |-| Deepgram API Key | Длинная строка букв и цифр |-| Todoist API Token | Строка из 40 символов |--> **Сохраните все токены** в надёжное место. Они понадобятся при настройке сервера.-------# Часть 3: Настройка сервера ⏱ 40–70 мин--### 3.1 Купите VPS и подключитесь--**Шаг 1: Купите сервер**--1. Откройте сайт [Contabo](https://contabo.com/en/vps/) или [OVH](https://ovhcloud.com/en/vps/)-2. Выберите самый дешёвый тариф (хватит с запасом)-3. **Важно:** При выборе операционной системы выберите **Ubuntu 22.04** — это база-4. Завершите покупку и оплату-5. На вашу почту придёт письмо с данными для входа: IP-адрес и пароль--<p align="center">- <img width="600" alt="Arc_27_December_2025_XNzzknIo" src="https://github.com/user-attachments/assets/9cd54275-199a-418c-9881-6be3aee471f5" />-</p>--<p align="center">- <img width="600" alt="Arc_27_December_2025_a5D7KnnM" src="https://github.com/user-attachments/assets/78d1343d-94f8-47eb-be77-4eeda1ae76ff" />-</p>--<p align="center">- <img width="600" alt="Arc_27_December_2025_tvjyMe08" src="https://github.com/user-attachments/assets/a35a8176-31fa-4417-9603-ed83b741cece" />-</p>--<p align="center">- <img width="600" alt="Spark Desktop_27_December_2025_sltZRiMZ" src="https://github.com/user-attachments/assets/7dceb211-90af-4d78-abb0-cec19a0abbdd" />-</p>--**Шаг 2: Подключитесь к серверу**--На Windows:-1. Нажмите кнопку **Пуск** в левом нижнем углу-2. Напечатайте `cmd` и нажмите Enter-3. Откроется чёрное окно — это командная строка--На Mac:-1. Нажмите `Cmd + Пробел`-2. Напечатайте `Terminal` и нажмите Enter--В открывшемся окне напечатайте команду (замените `ВАШ_IP_АДРЕС` на IP из письма):--```bash-ssh 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>-------### 3.2 Создайте пользователя--Работать под пользователем root небезопасно. Создайте обычного пользователя.--Напечатайте эти команды **по одной**, нажимая Enter после каждой:--```bash-adduser myuser-```--Система попросит придумать пароль — придумайте и запомните его. На остальные вопросы просто нажимайте Enter.--```bash-usermod -aG sudo myuser-```--```bash-su - 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>-------### 3.3 Установите всё необходимое--Скопируйте и вставьте эти команды **по одной** (после каждой нажимайте Enter и ждите завершения):--```bash-sudo apt update && sudo apt upgrade -y-```--```bash-sudo apt install -y git curl wget build-essential-```--```bash-sudo apt install -y software-properties-common-```--```bash-sudo add-apt-repository -y ppa:deadsnakes/ppa-```--```bash-sudo apt update-```--```bash-sudo apt install -y python3.12 python3.12-venv python3.12-dev-```--```bash-curl -LsSf https://astral.sh/uv/install.sh | sh-```--```bash-source ~/.bashrc-```--```bash-curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash --```--```bash-sudo apt install -y nodejs-```--```bash-npm install -g @anthropic-ai/claude-code-```--```bash-claude 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 завершена--| Что проверить | Как проверить |-|---------------|---------------|-| Подключение к серверу | Команда `ssh myuser@ВАШ_IP` работает без ошибок |-| Claude установлен | Команда `claude --version` показывает номер версии |-| Claude авторизован | Команда `claude auth status` показывает `Logged in` |-------## Запуск бота--**Вы установили Claude Code и авторизовались — отлично!**--Теперь просто вставьте эту команду и следуйте подсказкам на экране:--```bash-curl -fsSL https://raw.githubusercontent.com/ВАШ_ЛОГИН/agent-second-brain/main/bootstrap.sh | bash-```--> **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub!--Скрипт сам:-- Скачает ваш проект-- Спросит у вас все токены (Telegram, Deepgram, Todoist)-- Создаст файл с настройками-- Настроит автозапуск-- Запустит бота-- Покажет статус--**Если команда не сработала**, выполните вручную:+## Installation```bash-cd ~-git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git-cd agent-second-brain-bash setup.sh+curl -fsSL https://raw.githubusercontent.com/smixs/agent-second-brain/main/install.sh | bash```----+The script will install everything and prompt for your tokens.-### Контрольная точка: Бот работает+**Works on:** Mac, Windows (WSL)-| Что проверить | Ожидаемый результат |-|---------------|---------------------|-| Бот отвечает на /start | В Telegram видны кнопки меню |-| Голосовые распознаются | Бот отвечает текстом на голосовое сообщение |-| Бот работает после перезагрузки | Перезагрузите сервер, бот снова отвечает |+## Requirements----+| Service | Purpose | Cost |+|---------|---------|------|+| Claude Pro | AI processing | $20/month |+| Telegram | Bot interface | Free |+| Deepgram | Voice transcription | Free ($200 credit) |+| Todoist | Task management | Free (optional) |-# Часть 4: Использование+## What You Need Before Installing-### Кнопки бота+1. **Claude Pro subscription** — [claude.ai/pricing](https://claude.ai/pricing)+2. **Telegram Bot Token** — create via [@BotFather](https://t.me/BotFather)+3. **Your Telegram ID** — get via [@userinfobot](https://t.me/userinfobot)+4. **Deepgram API Key** — [console.deepgram.com](https://console.deepgram.com/)+5. **Todoist API Token** (optional) — [Settings → Developer](https://todoist.com/app/settings/integrations/developer)-```-┌─────────────────────────────────────────┐-│ [📊 Статус] [⚙️ Обработать] [📅 Неделя] │-│ [✨ Запрос] [❓ Помощь] │-└─────────────────────────────────────────┘-```--| Кнопка | Что делает |-|--------|------------|-| 📊 Статус | Показывает сколько записей сегодня |-| ⚙️ Обработать | Запускает обработку всех записей |-| 📅 Неделя | Показывает недельный дайджест |-| ✨ Запрос | Можно попросить что-то сделать (самая крутая!) |-| ❓ Помощь | Показывает справку |-------### Что можно отправлять--**Голосовые** — основной способ:-- «Надо написать Пете по проекту»-- «Идея: сделать лендинг с калькулятором»--**Текст** — ссылки, цитаты, быстрые мысли--**Фото** — скриншоты, фото досок--**Пересланные сообщения** — из других чатов-------### Кнопка «✨ Запрос»--1. Нажмите **✨ Запрос**-2. Бот спросит «Что сделать?»-3. Отправьте голосовое или текст--Примеры:-- «покажи задачи на сегодня»-- «перенеси просроченные на понедельник»-- «создай задачу: позвонить в банк»-------# Часть 5: Синхронизация--Ваши записи хранятся в папке `vault/`. Есть несколько способов их просматривать:--### Способ 1: Obsidian (рекомендуем)--**Что такое Obsidian:**-Это бесплатное приложение для просмотра заметок с красивыми связями между ними. Вы сможете видеть все свои мысли, задачи и цели в удобном интерфейсе.--<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.md](https://obsidian.md)-2. Скачайте приложение для вашей системы и установите его-3. Откройте Obsidian-4. Нажмите **Open folder as vault**-5. Найдите папку `agent-second-brain` (там, куда вы скачивали проект в Части 1)-6. Внутри неё выберите папку `vault`-7. Нажмите **Open**--Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе.--**На iPhone/iPad:**-1. На компьютере переместите папку `vault` в iCloud Drive-2. На iPhone скачайте Obsidian из App Store-3. В приложении «Файлы» найдите папку `vault` в iCloud-4. В Obsidian нажмите «Open folder as vault» → выберите эту папку+## Running the Bot-**На Android:**-1. Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal)-2. Подключите ваш GitHub репозиторий-3. Все заметки будут синхронизироваться автоматически+After installation:------### Способ 2: GitHub напрямую--Все файлы хранятся в вашем репозитории на GitHub по адресу:-```-https://github.com/ВАШ_ЛОГИН/agent-second-brain-```--Вы можете:-- Просматривать заметки прямо на сайте-- Редактировать файлы через веб-интерфейс-- Скачивать обновления командой `git pull`-------### Способ 3: Кнопка «✨ Запрос»--Самый простой способ — спросить бота напрямую:-- «Что я записал вчера?»-- «Покажи мои цели на неделю»-- «Какие задачи на сегодня?»-- «Найди заметку про [тема]»--Бот найдёт и покажет всё что нужно прямо в Telegram.-------# Помощь--### Если что-то пошло не так--Самый простой способ решить проблему — запустить программу `claude` прямо в чёрном окне сервера.--1. Подключитесь к серверу (как в Части 3)-2. Перейдите в папку проекта:- ```bash- cd ~/agent-second-brain- ```-3. Запустите Claude:- ```bash- claude- ```-4. Напишите ему:- ```- Я настраиваю бота, у меня возникла ошибка: [опишите что случилось]- Что мне сделать?- ```--Claude прочитает файлы проекта и поможет решить проблему.-------### Частые проблемы--**Бот не отвечает в Telegram:**-Проверьте, работает ли он. Подключитесь к серверу и выполните:```bash-sudo systemctl status d-brain-bot+cd ~/agent-second-brain && uv run python -m d_brain```-Должно показать `active (running)`.-**Голосовые не распознаются:**-Проверьте, правильно ли вы ввели ключ Deepgram при настройке.+Or if you configured autostart, it runs automatically.-**Claude не работает:**-Проверьте авторизацию:-```bash-claude auth status-```-Если нужно авторизоваться заново:-```bash-claude auth login-```+## Features----+| Feature | Description |+|---------|-------------|+| Voice messages | Transcribed via Deepgram Nova-3 |+| Text messages | Saved as-is |+| Photos | Saved with captions |+| Forwards | Saved with source attribution |+| Processing | Classifies entries, creates tasks, saves thoughts |+| Weekly digest | Analyzes your week, shows goal progress |+| Custom requests | "Move overdue tasks", "Show today's tasks" |-<details>-<summary><strong>Технические детали (для продвинутых)</strong></summary>+## Bot Commands-### Полезные команды+| Command | Action |+|---------|--------|+| `/start` | Start bot, show keyboard |+| `/help` | Show help |+| `/status` | How many entries today |+| `/process` | Process entries (create tasks, save thoughts) |+| `/weekly` | Generate weekly digest |+| `/do [text]` | Execute custom request |-```bash-# Посмотреть логи бота-sudo journalctl -u d-brain-bot -f--# Перезапустить бота-sudo systemctl restart d-brain-bot--# Остановить бота-sudo systemctl stop d-brain-bot+## Vault Structure-# Запустить бота-sudo systemctl start d-brain-bot```--### MCP-серверы--Эта система использует **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам.--> **Рекомендуем:** Используйте [mcp-cli](docs/mcp-cli-setup.md) для стабильного подключения. Это обёртка с connection pooling и auto-retry — соединения не отваливаются.--По умолчанию настроен 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, репозитории |--Полный список: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)--### Настройка systemd вручную--Если автоматический скрипт не создал сервис:--```bash-sudo nano /etc/systemd/system/d-brain-bot.service+vault/+├── daily/ # Daily entries (YYYY-MM-DD.md)+├── goals/ # Your goals (customize these!)+├── thoughts/ # Processed thoughts+│ ├── ideas/+│ ├── projects/+│ ├── learnings/+│ └── reflections/+├── summaries/ # Weekly digests+└── attachments/ # Photos by date```-Вставьте (замените `myuser` на ваше имя пользователя):--```ini-[Unit]-Description=d-brain Telegram Bot-After=network.target+## Advanced-[Service]-Type=simple-User=myuser-WorkingDirectory=/home/myuser/agent-second-brain-ExecStart=/home/myuser/.local/bin/uv run python -m d_brain-Restart=always-RestartSec=10+- [VPS Setup](docs/vps-setup.md) — Run 24/7 on a server+- [MCP CLI Setup](docs/mcp-cli-setup.md) — Todoist integration details-[Install]-WantedBy=multi-user.target-```+## Troubleshooting-Сохраните (`Ctrl+O`, Enter, `Ctrl+X`) и выполните:+### Bot doesn't respond```bash-sudo systemctl daemon-reload-sudo systemctl enable d-brain-bot-sudo systemctl start d-brain-bot-```--</details>+# Check if running+ps aux | grep d_brain------<details>-<summary><strong>Инструкция для Claude Code (читает Claude, не вы)</strong></summary>--### Команды с sudo--Claude Code не может выполнять команды с `sudo` — они требуют ввода пароля.--Когда нужно выполнить команду с sudo, попроси пользователя:+# Check logs (if autostart configured)+# Mac:+tail -f ~/agent-second-brain/logs/bot.log+# Linux/WSL:+journalctl --user -u agent-second-brain -f```-Мне нужно выполнить команду с sudo, но я не могу ввести пароль.--Пожалуйста, сделайте следующее:-1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T)-2. Подключитесь к серверу:- ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС+### Voice not transcribing-3. Выполните эту команду:- sudo [КОМАНДА]--4. Введите пароль когда попросят-5. Вернитесь ко мне и скажите что готово-```--### Ручные шаги настройки--**Проверка MCP Todoist:**+Check your Deepgram key in `.env`:```bash-npx -y @doist/todoist-ai --help+cat ~/agent-second-brain/.env | grep DEEPGRAM```-**Клонирование репозитория:**-```bash-cd ~-mkdir -p projects-cd projects-git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git-cd agent-second-brain-uv sync-```+### Tasks not created-**Создание .env:**+Check your Todoist token:```bash-nano .env+cat ~/agent-second-brain/.env | grep TODOIST+mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'```-Содержимое:-```bash-TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx-DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-TODOIST_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-VAULT_PATH=./vault-ALLOWED_USER_IDS=[123456789]-```--> В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки!--**Тестовый запуск:**-```bash-uv run python -m d_brain-```--**Настройка Git push:**-```bash-git config user.name "My Bot"-git config user.email "[email protected]"-```--Создайте Personal Access Token на GitHub: Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token (scope: repo)--```bash-git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git-```--</details>-----+## License-*Версия 1.1.27*+MITdiff --git a/docs/vps-setup.md b/docs/vps-setup.mdnew file mode 100644index 0000000..bb1f4d9--- /dev/null+++ b/docs/vps-setup.md@@ -0,0 +1,515 @@+# VPS Setup Guide++Run Agent Second Brain 24/7 on a virtual private server.++## Requirements++- VPS with Ubuntu 22.04+ (minimum 1GB RAM, recommended 2GB)+- Root or sudo access+- SSH client++## Recommended VPS Providers++| Provider | Price | Region |+|----------|-------|--------|+| Contabo | from $5/mo | Europe |+| Hetzner | from $4/mo | Europe |+| DigitalOcean | from $6/mo | Global |+| Vultr | from $5/mo | Global |++---++## Step 1: Connect to Server++After purchasing VPS, you'll get:+- IP address (e.g., `162.55.123.45`)+- Root password++Connect via SSH:++```bash+ssh [email protected]+```++Enter password (characters won't display — that's normal).++---++## Step 2: Create User++Never work as root. Create a regular user:++```bash+# Create user (replace "myuser" with your name)+adduser myuser++# Follow prompts:+# - Enter password (twice)+# - Other fields can be skipped (Enter)++# Grant sudo rights+usermod -aG sudo myuser++# Switch to new user+su - myuser+```++---++## Step 3: Update System++```bash+sudo apt update && sudo apt upgrade -y+```++---++## Step 4: Install Base Tools++```bash+# Git+sudo apt install -y git++# Curl and wget+sudo apt install -y curl wget++# Build tools+sudo apt install -y build-essential++# Verify+git --version+```++---++## Step 5: Install Python 3.12++```bash+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++# Verify+python3.12 --version+```++---++## Step 6: Install uv++```bash+curl -LsSf https://astral.sh/uv/install.sh | sh+source ~/.bashrc++# Verify+uv --version+```++---++## Step 7: Install Node.js++Required for MCP servers (Todoist integration):++```bash+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -+sudo apt install -y nodejs++# Verify+node --version+npm --version+```++---++## Step 8: Install Claude CLI++```bash+npm install -g @anthropic-ai/claude-code++# Verify+which claude+claude --version++# Authenticate+claude auth login+```++After `claude auth login`:+1. A URL appears+2. Copy and open it in browser on your computer+3. Log in to Anthropic account+4. Authorize access+5. Return to terminal — it will confirm++---++## Step 9: Clone Project++```bash+cd ~+mkdir -p projects+cd projects++git clone https://github.com/smixs/agent-second-brain.git+cd agent-second-brain++ls -la+```++---++## Step 10: Install Dependencies++```bash+uv sync++# Verify+uv run python -c "import aiogram; print('aiogram OK')"+```++---++## Step 11: Get Tokens++### Telegram Bot Token++1. Open Telegram+2. Find `@BotFather`+3. Send `/newbot`+4. Enter bot name and username+5. Copy the token++### Your Telegram User ID++1. Find `@userinfobot` in Telegram+2. Send any message+3. Copy the ID number++### Deepgram API Key++1. Go to https://console.deepgram.com/+2. Sign up (free $200 credit)+3. Settings → API Keys+4. Create key and copy++### Todoist API Token (optional)++1. Go to https://todoist.com/+2. Settings → Integrations → Developer+3. Copy API token++---++## Step 12: Configure Environment++```bash+nano ~/projects/agent-second-brain/.env+```++Paste (replace with your values):++```bash+TELEGRAM_BOT_TOKEN=7123456789:AAHdN8J2K4m5N6o7P8q9R0s1T2u3V4w5X6y+DEEPGRAM_API_KEY=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0+TODOIST_API_KEY=+VAULT_PATH=./vault+ALLOWED_USER_IDS=[123456789]+```++Save: `Ctrl+O`, `Enter`, `Ctrl+X`++---++## Step 13: Clean Vault Examples++```bash+cd ~/projects/agent-second-brain++rm -rf vault/daily/*+rm -rf vault/thoughts/ideas/*+rm -rf vault/thoughts/projects/*+rm -rf vault/thoughts/learnings/*+rm -rf vault/thoughts/reflections/*+rm -rf vault/summaries/*+rm -rf vault/attachments/*+```++---++## Step 14: Customize Goals++Edit goals to match yours:++```bash+nano vault/goals/0-vision-3y.md # 3-year vision+nano vault/goals/1-yearly-2026.md # Yearly goals+nano vault/goals/2-monthly.md # Monthly priorities+nano vault/goals/3-weekly.md # Weekly focus+```++---++## Step 15: Test Run++```bash+cd ~/projects/agent-second-brain+uv run python -m d_brain+```++Should show:+```+INFO:aiogram.dispatcher:Start polling+INFO:aiogram.dispatcher:Run polling for bot @your_bot_name+```++Test in Telegram:+- Find your bot+- Send `/start`+- Send a voice message++Stop with `Ctrl+C`.++---++## Step 16: Setup Autostart (systemd)++### Bot Service++```bash+sudo nano /etc/systemd/system/d-brain-bot.service+```++Paste (replace `myuser`):++```ini+[Unit]+Description=d-brain Telegram Bot+After=network.target++[Service]+Type=simple+User=myuser+WorkingDirectory=/home/myuser/projects/agent-second-brain+ExecStart=/home/myuser/.local/bin/uv run python -m d_brain+Restart=always+RestartSec=10+Environment=PYTHONUNBUFFERED=1++[Install]+WantedBy=multi-user.target+```++Enable and start:++```bash+sudo systemctl daemon-reload+sudo systemctl start d-brain-bot+sudo systemctl enable d-brain-bot++# Check status+sudo systemctl status d-brain-bot+```++---++## Step 17: Daily Processing Timer (optional)++Automatically process entries at 21:00 daily.++### Edit process script++```bash+nano ~/projects/agent-second-brain/scripts/process.sh+```++Update paths at the top:+```bash+export HOME="/home/myuser"+PROJECT_DIR="/home/myuser/projects/agent-second-brain"+```++Make executable:+```bash+chmod +x ~/projects/agent-second-brain/scripts/process.sh+```++### Create timer++```bash+sudo nano /etc/systemd/system/d-brain-process.timer+```++```ini+[Unit]+Description=Run d-brain processing daily at 21:00++[Timer]+OnCalendar=*-*-* 21:00:00+Persistent=true++[Install]+WantedBy=timers.target+```++### Create service++```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/agent-second-brain+ExecStart=/home/myuser/projects/agent-second-brain/scripts/process.sh+Environment=PYTHONUNBUFFERED=1+```++### Enable++```bash+sudo systemctl daemon-reload+sudo systemctl enable d-brain-process.timer+sudo systemctl start d-brain-process.timer++# Check timer+sudo systemctl list-timers | grep d-brain+```++---++## Step 18: Git Configuration++```bash+cd ~/projects/agent-second-brain++git config user.email "[email protected]"+git config user.name "Your Name"+```++### Create your own repository++1. GitHub → "+" → "New repository"+2. Name: `my-second-brain`+3. Leave empty (no README)+4. Create++### Change remote++```bash+git remote set-url origin https://github.com/YOUR_USERNAME/my-second-brain.git+git remote -v+git push -u origin main+```++If prompted for password, use Personal Access Token:+- GitHub → Settings → Developer settings → Personal access tokens++---++## Useful Commands++```bash+# Bot status+sudo systemctl status d-brain-bot++# Restart bot+sudo systemctl restart d-brain-bot++# Stop bot+sudo systemctl stop d-brain-bot++# Real-time logs+sudo journalctl -u d-brain-bot -f++# Last 100 log lines+sudo journalctl -u d-brain-bot -n 100++# All d-brain services+sudo systemctl status 'd-brain-*'++# List timers+sudo systemctl list-timers++# Manual processing+cd ~/projects/agent-second-brain+./scripts/process.sh++# Update code+cd ~/projects/agent-second-brain+git pull+uv sync+sudo systemctl restart d-brain-bot+```++---++## Troubleshooting++### Bot doesn't respond++```bash+sudo systemctl status d-brain-bot+sudo journalctl -u d-brain-bot -n 100+cat ~/projects/agent-second-brain/.env | grep TELEGRAM_BOT_TOKEN+sudo systemctl restart d-brain-bot+```++### Voice not transcribing++```bash+cat ~/projects/agent-second-brain/.env | grep DEEPGRAM+sudo journalctl -u d-brain-bot | grep -i error+```++### Processing errors++```bash+claude --version+claude auth status+claude auth login # if needed+```++### Todoist not working++```bash+cat ~/projects/agent-second-brain/.env | grep TODOIST+mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'+```++### Permission errors++```bash+sudo chown -R myuser:myuser ~/projects/agent-second-brain+chmod -R 755 ~/projects/agent-second-brain+```++### Git push fails++```bash+git remote -v+git status+git config --global credential.helper store+git push+```++---++## Sync with Local Computer++See main [README](../README.md) for Obsidian sync options.++---++## Security Tips++- Use SSH keys instead of passwords+- Keep system updated: `sudo apt update && sudo apt upgrade`+- `.env` is in `.gitignore` — never commit tokens+- Consider setting up firewall: `sudo ufw enable`diff --git a/install.sh b/install.shnew file mode 100755index 0000000..751c10c--- /dev/null+++ b/install.sh@@ -0,0 +1,525 @@+#!/bin/bash+# Agent Second Brain — One-command installer+# Works on Mac and Windows WSL+# https://github.com/smixs/agent-second-brain++set -e++# Colors+RED='\033[0;31m'+GREEN='\033[0;32m'+YELLOW='\033[1;33m'+BLUE='\033[0;34m'+NC='\033[0m' # No Color++# Config+REPO_URL="https://github.com/smixs/agent-second-brain.git"+INSTALL_DIR="$HOME/agent-second-brain"++#######################################+# Print colored message+#######################################+info() { echo -e "${BLUE}ℹ${NC} $1"; }+success() { echo -e "${GREEN}✓${NC} $1"; }+warn() { echo -e "${YELLOW}⚠${NC} $1"; }+error() { echo -e "${RED}✗${NC} $1"; exit 1; }++#######################################+# Detect OS+#######################################+detect_os() {+ if [[ "$OSTYPE" == "darwin"* ]]; then+ OS="mac"+ info "Detected: macOS"+ elif grep -q Microsoft /proc/version 2>/dev/null; then+ OS="wsl"+ info "Detected: Windows WSL"+ elif [[ "$OSTYPE" == "linux-gnu"* ]]; then+ OS="linux"+ info "Detected: Linux"+ else+ error "Unsupported OS. This script works on Mac and Windows WSL only."+ fi+}++#######################################+# Check if command exists+#######################################+has_command() {+ command -v "$1" &> /dev/null+}++#######################################+# Install Homebrew (Mac only)+#######################################+install_homebrew() {+ if [[ "$OS" != "mac" ]]; then return; fi++ if has_command brew; then+ success "Homebrew already installed"+ else+ info "Installing Homebrew..."+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"++ # Add to PATH for current session+ if [[ -f /opt/homebrew/bin/brew ]]; then+ eval "$(/opt/homebrew/bin/brew shellenv)"+ elif [[ -f /usr/local/bin/brew ]]; then+ eval "$(/usr/local/bin/brew shellenv)"+ fi++ success "Homebrew installed"+ fi+}++#######################################+# Install dependencies+#######################################+install_dependencies() {+ info "Installing dependencies..."++ if [[ "$OS" == "mac" ]]; then+ # Node.js+ if ! has_command node; then+ info "Installing Node.js..."+ brew install node+ fi+ success "Node.js $(node --version)"++ # Python 3.12+ if ! has_command python3.12; then+ info "Installing Python 3.12..."+ brew install [email protected]+ fi+ success "Python $(python3.12 --version)"++ # Git+ if ! has_command git; then+ info "Installing Git..."+ brew install git+ fi+ success "Git $(git --version | head -1)"++ elif [[ "$OS" == "wsl" ]] || [[ "$OS" == "linux" ]]; then+ info "Updating apt packages..."+ sudo apt update && sudo apt upgrade -y++ # Node.js 20+ if ! has_command node; then+ info "Installing Node.js..."+ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -+ sudo apt install -y nodejs+ fi+ success "Node.js $(node --version)"++ # Python 3.12+ if ! has_command python3.12; then+ info "Installing 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+ fi+ success "Python $(python3.12 --version)"++ # Git+ if ! has_command git; then+ info "Installing Git..."+ sudo apt install -y git curl wget+ fi+ success "Git $(git --version | head -1)"+ fi+}++#######################################+# Install uv (Python package manager)+#######################################+install_uv() {+ if has_command uv; then+ success "uv already installed: $(uv --version)"+ else+ info "Installing uv..."+ curl -LsSf https://astral.sh/uv/install.sh | sh++ # Add to PATH for current session+ export PATH="$HOME/.local/bin:$PATH"++ success "uv installed: $(uv --version)"+ fi+}++#######################################+# Install Claude Code CLI+#######################################+install_claude() {+ if has_command claude; then+ success "Claude Code already installed: $(claude --version)"+ else+ info "Installing Claude Code CLI..."+ npm install -g @anthropic-ai/claude-code+ success "Claude Code installed"+ fi+}++#######################################+# Clone repository+#######################################+clone_repo() {+ if [[ -d "$INSTALL_DIR" ]]; then+ warn "Directory $INSTALL_DIR already exists"+ read -p "Overwrite? (y/n): " -n 1 -r+ echo+ if [[ $REPLY =~ ^[Yy]$ ]]; then+ rm -rf "$INSTALL_DIR"+ else+ error "Installation cancelled"+ fi+ fi++ info "Cloning repository..."+ git clone "$REPO_URL" "$INSTALL_DIR"+ success "Repository cloned to $INSTALL_DIR"+}++#######################################+# Prompt for token+#######################################+prompt_token() {+ local name="$1"+ local desc="$2"+ local url="$3"+ local var_name="$4"+ local optional="${5:-false}"++ echo+ echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"+ echo -e "${YELLOW}$name${NC}"+ echo "$desc"+ echo -e "Get it here: ${GREEN}$url${NC}"+ echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"++ if [[ "$optional" == "true" ]]; then+ read -p "Enter token (or press Enter to skip): " token+ else+ while true; do+ read -p "Enter token: " token+ if [[ -n "$token" ]]; then+ break+ fi+ warn "This token is required"+ done+ fi++ eval "$var_name=\"$token\""+}++#######################################+# Collect tokens interactively+#######################################+collect_tokens() {+ echo+ echo -e "${GREEN}╔════════════════════════════════════════════════╗${NC}"+ echo -e "${GREEN}║ TOKEN CONFIGURATION ║${NC}"+ echo -e "${GREEN}╚════════════════════════════════════════════════╝${NC}"+ echo+ echo "You'll need to provide 4 tokens. Instructions for each below."++ # Telegram Bot Token+ prompt_token \+ "1/4: Telegram Bot Token" \+ "Create a bot via @BotFather in Telegram:+1. Open Telegram and search for @BotFather+2. Send /newbot+3. Follow instructions to create your bot+4. Copy the token (looks like: 7123456789:AAHd...)" \+ "https://t.me/BotFather" \+ "TELEGRAM_BOT_TOKEN"++ # Telegram User ID+ prompt_token \+ "2/4: Your Telegram User ID" \+ "Get your ID via @userinfobot:+1. Search for @userinfobot in Telegram+2. Send any message+3. Copy your ID (just the number)" \+ "https://t.me/userinfobot" \+ "TELEGRAM_USER_ID"++ # Deepgram API Key+ prompt_token \+ "3/4: Deepgram API Key" \+ "For voice transcription (free \$200 credit):+1. Sign up at console.deepgram.com+2. Go to Settings → API Keys+3. Create new key and copy it" \+ "https://console.deepgram.com/" \+ "DEEPGRAM_API_KEY"++ # Todoist API Token (optional)+ prompt_token \+ "4/4: Todoist API Token (optional)" \+ "For task management:+1. Log in to todoist.com+2. Settings → Integrations → Developer+3. Copy the API token" \+ "https://todoist.com/app/settings/integrations/developer" \+ "TODOIST_API_KEY" \+ "true"+}++#######################################+# Create .env file+#######################################+create_env() {+ info "Creating .env file..."++ cat > "$INSTALL_DIR/.env" << EOF+# Telegram Bot Token (from @BotFather)+TELEGRAM_BOT_TOKEN=$TELEGRAM_BOT_TOKEN++# Deepgram API Key (from console.deepgram.com)+DEEPGRAM_API_KEY=$DEEPGRAM_API_KEY++# Todoist API Token (optional)+TODOIST_API_KEY=$TODOIST_API_KEY++# Path to vault (don't change)+VAULT_PATH=./vault++# Your Telegram ID (bot responds only to you)+ALLOWED_USER_IDS=[$TELEGRAM_USER_ID]+EOF++ success ".env file created"+}++#######################################+# Install Python dependencies+#######################################+install_python_deps() {+ info "Installing Python dependencies..."+ cd "$INSTALL_DIR"+ uv sync+ success "Python dependencies installed"+}++#######################################+# Install mcp-cli+#######################################+install_mcp_cli() {+ if has_command mcp-cli; then+ success "mcp-cli already installed"+ else+ info "Installing mcp-cli..."+ curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash+ export PATH="$HOME/.local/bin:$PATH"+ success "mcp-cli installed"+ fi++ # Configure mcp-cli for Todoist if token provided+ if [[ -n "$TODOIST_API_KEY" ]]; then+ info "Configuring mcp-cli for Todoist..."+ mkdir -p ~/.config/mcp+ cat > ~/.config/mcp/mcp_servers.json << EOF+{+ "mcpServers": {+ "todoist": {+ "command": "npx",+ "args": ["-y", "@doist/todoist-ai"],+ "env": {+ "TODOIST_API_KEY": "$TODOIST_API_KEY"+ }+ }+ }+}+EOF+ success "mcp-cli configured"+ fi+}++#######################################+# Authenticate Claude+#######################################+auth_claude() {+ echo+ echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"+ echo -e "${YELLOW}Claude Authentication${NC}"+ echo "You need Claude Pro subscription (\$20/month) for this to work."+ echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"+ echo++ if claude auth status &>/dev/null; then+ success "Claude already authenticated"+ else+ info "Starting Claude authentication..."+ echo "A browser window will open. Log in with your Anthropic account."+ echo+ claude auth login+ success "Claude authenticated"+ fi+}++#######################################+# Setup autostart (optional)+#######################################+setup_autostart() {+ echo+ read -p "Configure autostart (bot runs when computer starts)? (y/n): " -n 1 -r+ echo++ if [[ ! $REPLY =~ ^[Yy]$ ]]; then+ info "Skipping autostart configuration"+ return+ fi++ if [[ "$OS" == "mac" ]]; then+ setup_launchd+ else+ setup_systemd+ fi+}++#######################################+# Setup launchd (Mac)+#######################################+setup_launchd() {+ info "Configuring launchd..."++ mkdir -p ~/Library/LaunchAgents++ cat > ~/Library/LaunchAgents/com.agent-second-brain.plist << EOF+<?xml version="1.0" encoding="UTF-8"?>+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">+<plist version="1.0">+<dict>+ <key>Label</key>+ <string>com.agent-second-brain</string>+ <key>ProgramArguments</key>+ <array>+ <string>$HOME/.local/bin/uv</string>+ <string>run</string>+ <string>python</string>+ <string>-m</string>+ <string>d_brain</string>+ </array>+ <key>WorkingDirectory</key>+ <string>$INSTALL_DIR</string>+ <key>RunAtLoad</key>+ <true/>+ <key>KeepAlive</key>+ <true/>+ <key>StandardOutPath</key>+ <string>$INSTALL_DIR/logs/bot.log</string>+ <key>StandardErrorPath</key>+ <string>$INSTALL_DIR/logs/bot-error.log</string>+</dict>+</plist>+EOF++ mkdir -p "$INSTALL_DIR/logs"+ launchctl load ~/Library/LaunchAgents/com.agent-second-brain.plist++ success "Autostart configured (launchd)"+ info "Bot will start automatically on login"+}++#######################################+# Setup systemd (Linux/WSL)+#######################################+setup_systemd() {+ info "Configuring systemd..."++ mkdir -p ~/.config/systemd/user++ cat > ~/.config/systemd/user/agent-second-brain.service << EOF+[Unit]+Description=Agent Second Brain Telegram Bot+After=network.target++[Service]+Type=simple+WorkingDirectory=$INSTALL_DIR+ExecStart=$HOME/.local/bin/uv run python -m d_brain+Restart=always+RestartSec=10+Environment=PYTHONUNBUFFERED=1++[Install]+WantedBy=default.target+EOF++ systemctl --user daemon-reload+ systemctl --user enable agent-second-brain+ systemctl --user start agent-second-brain++ success "Autostart configured (systemd)"+ info "Bot is running now and will start on boot"+}++#######################################+# Start bot manually+#######################################+start_bot() {+ echo+ echo -e "${GREEN}╔════════════════════════════════════════════════╗${NC}"+ echo -e "${GREEN}║ INSTALLATION COMPLETE! ║${NC}"+ echo -e "${GREEN}╚════════════════════════════════════════════════╝${NC}"+ echo++ if [[ "$OS" == "mac" ]] && [[ -f ~/Library/LaunchAgents/com.agent-second-brain.plist ]]; then+ echo "Bot is running in background."+ echo+ echo "Commands:"+ echo " Stop: launchctl unload ~/Library/LaunchAgents/com.agent-second-brain.plist"+ echo " Start: launchctl load ~/Library/LaunchAgents/com.agent-second-brain.plist"+ echo " Logs: tail -f $INSTALL_DIR/logs/bot.log"+ elif systemctl --user is-active --quiet agent-second-brain 2>/dev/null; then+ echo "Bot is running in background."+ echo+ echo "Commands:"+ echo " Stop: systemctl --user stop agent-second-brain"+ echo " Start: systemctl --user start agent-second-brain"+ echo " Logs: journalctl --user -u agent-second-brain -f"+ else+ echo "To start the bot manually:"+ echo+ echo -e " ${GREEN}cd $INSTALL_DIR && uv run python -m d_brain${NC}"+ echo+ read -p "Start bot now? (y/n): " -n 1 -r+ echo+ if [[ $REPLY =~ ^[Yy]$ ]]; then+ cd "$INSTALL_DIR"+ info "Starting bot... (Ctrl+C to stop)"+ uv run python -m d_brain+ fi+ fi+}++#######################################+# Main+#######################################+main() {+ echo+ echo -e "${GREEN}╔════════════════════════════════════════════════╗${NC}"+ echo -e "${GREEN}║ AGENT SECOND BRAIN INSTALLER ║${NC}"+ echo -e "${GREEN}║ ║${NC}"+ echo -e "${GREEN}║ Voice-first AI assistant with memory ║${NC}"+ echo -e "${GREEN}╚════════════════════════════════════════════════╝${NC}"+ echo++ detect_os+ install_homebrew+ install_dependencies+ install_uv+ install_claude+ clone_repo+ collect_tokens+ create_env+ install_python_deps+ install_mcp_cli+ auth_claude+ setup_autostart+ start_bot+}++main "$@"