# Agent Second Brain [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [![Stars](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fsmixs%2Fagent-second-brain&query=%24.stargazers_count&label=stars&logo=github&color=blue)](https://github.com/smixs/agent-second-brain/stargazers) [![Forks](https://img.shields.io/github/forks/smixs/agent-second-brain?style=flat&logo=github)](https://github.com/smixs/agent-second-brain/forks)

Agent Second Brain

**Отправь голосовое в Telegram - получи организованную базу знаний, выполненные задачи и дневной отчёт.** Всё. Вся идея в одном предложении. [🇬🇧 Read in English](README.md) --- ## Проблема Любая система продуктивности умирает одинаково. Настраиваешь в воскресенье, пользуешься две недели, потом бросаешь - потому что поддержка системы отнимает больше сил, чем сама работа. Заметки раскиданы везде. Голосовые, которые никогда не переслушаешь. Идеи, утонувшие в истории чатов. Задачи, которые забыл записать. А если записал - они лежат в папке, которую ты больше не откроешь. Корень проблемы: организовывать сложнее, чем думать. Поэтому мысли остаются неорганизованными. ## Что делает эта штука Ты пишешь боту в Telegram. Голосовые, текст, фото, пересланные сообщения - как удобно. Не думаешь про категории, теги или куда что положить. Агент разбирается сам: - **Расшифровывает** голосовые (Deepgram, пара секунд) - **Классифицирует** каждую запись - задача, идея, заметка о клиенте, прогресс по цели, случайная мысль - **Создаёт задачи** в Todoist с нужным приоритетом и датой - **Сохраняет всё** в Obsidian-хранилище с правильными ссылками и тегами - **Присылает дневной отчёт** в 21:00 - что произошло, что сделано, что висит - **Помнит важное, забывает ненужное** - память угасает со временем, как у живого человека Бот работает 24/7 на сервере за $5. Ты его не обслуживаешь. Ты просто с ним разговариваешь. ## Разговаривай как с человеком Это не бот с кнопками. Это разговор. > **Ты:** что я писал про маркетинговый проект на прошлой неделе? > > **Бот:** *находит и показывает записи* > > **Ты:** вторую идею превращай в задачу на понедельник > > **Бот:** *создаёт задачу в Todoist* > > **Ты:** сделай высокий приоритет и добавь подзадачу на презентацию > > **Бот:** *обновляет задачу* У агента доступ ко всему хранилищу, всем целям и Todoist. Спроси что угодно про свои записи - найдёт. ## Память, которая работает как память Большинство AI-систем либо помнят всё навсегда (утопая в шуме), либо забывают всё между сессиями. Agent Second Brain использует кривую забывания Эббингауза - ту же модель, что описывает работу человеческой памяти. Каждая запись начинает с максимальной «яркости» и постепенно тускнеет, если к ней не возвращаются. Пять уровней - от «всегда под рукой» до «почти забыто»: | Уровень | Что происходит | |---------|---------------| | **Ядро** | Всегда в контексте. Текущие проекты, активные клиенты, ключевые цели. | | **Активные** | Проверяются регулярно. Свежие идеи, текущие разговоры. | | **Тёплые** | Находятся при поиске. Заметки за прошлый месяц, принятые решения. | | **Холодные** | Всплывают только при глубоком поиске. Старые проекты, архивные планы. | | **Архив** | Почти забытые - но иногда случайно вспоминаются для неожиданных связей. | Архив - самое интересное. Иногда агент достаёт случайную старую запись и связывает с чем-то текущим. Бывает - мимо. А бывает - это лучшая идея, которую ты забыл. ## Здоровье хранилища - заметки сами себя чинят Со временем любая система заметок гниёт. Ссылки ломаются. Файлы становятся сиротами. Теги расползаются. В итоге - кладбище маркдаун-файлов, по которому не может пройти никто. Система здоровья работает автоматически: - Оценивает хранилище по 100-балльной шкале - Находит сироты (файлы без связей) и предлагает ссылки - Чинит сломанные вики-линки - Генерирует карты содержимого (MOC) для каждой области - Отмечает файлы без описаний Ты не занимаешься обслуживанием. Агент занимается. ## Что отправляешь - что получаешь | Ты отправляешь | Агент делает | |----------------|-------------| | Голосовое о звонке с клиентом | Расшифровывает, создаёт CRM-карточку, добавляет follow-up задачу | | Текст: «идея для Q2 кампании» | Сохраняет в папку идей, связывает с похожими заметками | | Пересланная статья из чата | Сохраняет с источником, вытаскивает ключевые мысли | | Фото доски | Сохраняет с AI-описанием | | Кнопка «Process» | Запускает полный цикл обработки прямо сейчас | | «Какие приоритеты на эту неделю?» | Читает цели и Todoist, даёт прямой ответ | ## Как это работает (для любопытных) Ежедневная обработка идёт в три фазы: 1. **Захват** - читает записи за день, классифицирует каждую (задача? идея? обновление CRM? прогресс по цели?) 2. **Исполнение** - создаёт задачи в Todoist, пишет файлы в хранилище, обновляет карточки 3. **Рефлексия** - генерирует сводный отчёт, обновляет долговременную память, отправляет в Telegram Каждая фаза создаёт чистый JSON, который подхватывает следующая. Если что-то ломается - видно где именно и почему. ``` Telegram → Deepgram → Claude Code → Todoist + Obsidian → Telegram отчёт ``` ## Сколько стоит | Сервис | Цена | |--------|------| | Claude Pro | $20/мес | | VPS (любой дешёвый) | ~$5/мес | | Deepgram | Бесплатно ($200 кредит) | | Todoist | Бесплатный план работает | | **Итого** | **~$25/мес** | $25 в месяц за личного ассистента, который организует твою жизнь, никогда не спит и становится лучше с каждым днём использования. ## Быстрый старт ### 1. Форкни репо Нажми **Fork** вверху страницы. Сделай форк **приватным** - в нём будут твои личные данные. ### 2. Склонируй ```bash git clone https://github.com/YOUR_USERNAME/agent-second-brain.git cd agent-second-brain ``` ### 3. Заполни свою информацию Открой эти файлы и замени шаблоны на свои данные: - `vault/goals/` - видение, годовые цели, месячные приоритеты, фокус недели - `vault/.claude/skills/dbrain-processor/references/about.md` - расскажи агенту о себе - `vault/.claude/skills/dbrain-processor/references/classification.md` - как сортировать записи ### 4. Получи четыре API-ключа | Что | Где взять | Время | |-----|----------|-------| | Telegram Bot Token | [@BotFather](https://t.me/BotFather) | 2 мин | | Твой Telegram ID | [@userinfobot](https://t.me/userinfobot) | 30 сек | | Deepgram API Key | [console.deepgram.com](https://console.deepgram.com/) | 3 мин | | Todoist API Token | Todoist → Settings → Integrations → Developer | 1 мин | ### 5. Разверни Следуй [инструкции по настройке VPS](docs/vps-setup.md), или: ```bash ssh root@YOUR_SERVER_IP curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/agent-second-brain/main/bootstrap.sh | bash ``` Бот запускается, ты отправляешь ему сообщение - система живёт. --- ## Структура хранилища ``` vault/ ├── daily/ # Дневные записи (голосовые, текст, фото) ├── goals/ # Видение → год → месяц → неделя ├── business/ │ ├── crm/ # Карточки клиентов │ └── network/ # Профессиональные контакты ├── projects/ # Клиентские проекты, лиды, пайплайн ├── thoughts/ │ ├── ideas/ # Идеи и мозговые штурмы │ ├── learnings/ # Уроки │ └── reflections/ # Рефлексии ├── MOC/ # Карты содержимого (генерируются автоматически) └── MEMORY.md # Долговременная память агента ``` ## Навыки агента | Навык | Что делает | |-------|-----------| | **dbrain-processor** | Классифицирует записи, создаёт задачи, сохраняет заметки | | **agent-memory** | Движок памяти Эббингауза - помнит, забывает, вспоминает | | **vault-health** | Оценка здоровья, починка ссылок, генерация MOC | | **graph-builder** | Карта связей между заметками, поиск кластеров | | **todoist-ai** | Управление задачами, проектами, приоритетами | Нужен только движок памяти? Смотри [agent-memory-skill](https://github.com/smixs/agent-memory-skill) - работает отдельно, без зависимостей. ## Конфигурация | Файл | За что отвечает | |------|----------------| | `.env` | API-токены (скопируй из `.env.example`) | | `.memory-config.json` | Скорость угасания памяти, границы уровней | | `mcp-config.json` | Подключения к внешним инструментам | | `vault/.claude/CLAUDE.md` | Личность и правила агента | Все секреты в `.env`, который в gitignore. Не коммить токены. --- ## Кто сделал [Сергей Шима](https://shima.me) - 20 лет в маркетинге (BBDO, Publicis), сейчас руководит AI-креативным агентством в Центральной Азии и учит бизнес работать с AI на [aimasters.me](https://aimasters.me). Эта система работает в моей реальной жизни. 1,100+ карточек в хранилище, 5 AI-агентов, ежедневные отчёты. Начиналось как проект на выходных - стало инфраструктурой. ## Лицензия [MIT](LICENSE) - делай с этим что хочешь.