Brain Bot - TG-бот для второго мозга

Ставишь у себя на компе - бот пишет файлы прямо в локальную папку. Никакого облака между телефоном и вики.

Кому полезно: тем у кого вики на компе, а идеи приходят в дороге.

• Python 3.10 или новее - python.org/downloads. При установке на Windows поставь галочку «Add Python to PATH».
• Obsidian-вика - папка с твоими .md заметками. Если вики ещё нет - просто создай пустую папку, бот будет писать в неё. Или возьми готовый шаблон CJM - Knowledge Graph.
• Telegram-бот - создашь за минуту (ниже).
• Ключ OpenRouter - для «мозга» бота (модель Claude / Gemini / др.).
• Ключ Groq - для расшифровки голоса (бесплатный).

Полный гайд внутри архива в SETUP.md. Вот выжимка:

Шаг 1. Создай Telegram-бота

• Открой в Telegram @BotFather
• Напиши /newbot
• Придумай имя и username бота
• BotFather пришлёт токен вида 1234567890:AAF... - скопируй его

Шаг 2. Узнай свой Telegram ID

• Открой @userinfobot
• Напиши ему что угодно
• Он пришлёт твой числовой ID (например 123456789) - скопируй

Это нужно чтобы бот отвечал только тебе, а не случайным людям.

Шаг 3. Получи ключ OpenRouter (мозг бота)

• Зарегистрируйся на openrouter.ai
• Зайди в openrouter.ai/keys → создай ключ
• Скопируй ключ вида sk-or-v1-...
• Пополни баланс на $5-10 (хватит надолго - бот тратит копейки на сообщение)

Шаг 4. Получи ключ Groq (расшифровка голоса, бесплатно)

• Зарегистрируйся на console.groq.com
• Зайди в API Keys → создай ключ
• Скопируй ключ вида gsk_...

> Если не хочешь Groq - бот расшифрует голос локально через faster-whisper (медленнее, но без ключа). Тогда просто оставь GROQ_API_KEY пустым.

Шаг 5. Настрой бота

• Распакуй архив в любую папку, например C:\brain-bot
• Найди файл .env.example, скопируй его и переименуй копию в .env
• Открой .env блокнотом и впиши свои данные:

TELEGRAM_TOKEN=сюда токен от BotFather
OPENROUTER_API_KEY=сюда ключ sk-or-v1-...
VAULT_PATH=путь к твоей папке с заметками
ALLOWED_USER_ID=твой числовой Telegram ID
GROQ_API_KEY=сюда ключ gsk-... (или оставь пустым)

Пример VAULT_PATH:

• Windows: C:\Users\Имя\Documents\MyVault
• Mac: /Users/имя/Documents/MyVault

Шаг 6. Установи и запусти

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m src.main

Если всё ок - в консоли появится строчка что бот запущен. Открой своего бота в Telegram и напиши ему.

Как пользоваться

• Текст: «Сегодня весил 82 кг» - бот найдёт где у тебя метрики и запишет.
• Голос: надиктуй мысль голосовым - бот расшифрует и обработает.
• Документ: кинь pdf / md / txt - бот разложит его по вики (создаст страницу-источник).
• Вопрос: «Что я записывал про проект X?» - бот прочитает вику и ответит.

Чтобы бот работал постоянно

В архиве есть watchdog.ps1 (только Windows) - он держит бота запущенным и перезапускает если упал. Запусти:

powershell -ExecutionPolicy Bypass -File watchdog.ps1

Чтобы стартовал автоматически при включении компа - добавь его в Планировщик заданий Windows на триггер «при входе в систему».

Если что-то не работает

• «Missing env var» - не заполнил один из ключей в .env. Проверь все 4 обязательных.
• Бот не отвечает - проверь что ALLOWED_USER_ID - это твой ID (число, без пробелов).
• Голос не расшифровывается - проверь GROQ_API_KEY, либо оставь пустым (надо pip install faster-whisper).
• Python не найден - переустанови Python с галочкой «Add to PATH».