Second Brain Telegram Bot

Телеграм‑бот «Второй мозг»: голосовые сообщения превращаются в структурированные записи в Google Таблицах.
Whisper делает транскрибацию, GPT — маршрутизацию и извлечение данных по колонкам.

---

Что умеет

• Голос → таблица: расшифровка, выбор категории из Settings, запись в нужный лист и Inbox.
• Намерение из голоса (для коротких сообщений): бот понимает, это добавление, вопрос или удаление.
• Thinking‑mode для длинных голосовых (>2 мин): бот структурирует мысли и просит подтвердить сохранение в лист «Прочее» (если листа нет — сохранит в Inbox).
• Поиск по базе: задайте вопрос голосом — бот ответит по данным всех листов категорий.
• Удаление: бот покажет список найденных записей и попросит подтверждение.
• Обязательные поля: добавьте * к заголовку (например Приоритет*) — бот попросит уточнение.
• Сводки: ежедневные/еженедельные отчеты из Inbox.
• Свои промпты: можно менять через /settings (лист Prompts).

---

Как это работает

1. Голос → Whisper → текст.
2. Если голос длиннее 2 минут → Thinking‑mode:
   • бот приводит мысли в порядок,
   • показывает структуру,
   • просит подтвердить сохранение в «Прочее».
3. Если голос короткий → определяется намерение:
   • add → запись в нужный лист + Inbox,
   • ask → ответ по базе,
   • delete → выбор кандидата и удаление.

---

Что нужно

• Python 3.10+
• Telegram Bot Token (получить у @BotFather)
• OpenAI API Key
• Google Sheets + Service Account (JSON‑ключ)

---

Подготовка Google Таблицы

Создайте таблицу и дайте доступ на редактирование email сервисного аккаунта.

Обязательные листы:

• Settings — A: название категории (имя листа), B: описание категории.
• Inbox — резервная копия каждой записи.
• Прочее — лист для длинных голосовых (Thinking‑mode).

Опционально:

• Prompts — для кастомных промптов из /settings.

Категорийные листы:

• По одному листу на категорию (название как в Settings, колонка A).
• Первая строка — заголовки.
• Обязательные поля помечайте * (например Приоритет*).

---

Переменные окружения (.env)

Файл .env лежит в корне проекта. Пример в .env.example.

Переменная	Описание
TELEGRAM_TOKEN	токен бота
OPENAI_API_KEY	ключ OpenAI
GOOGLE_SHEET_ID	ID таблицы из URL
ALLOWED_USER_IDS	Telegram ID (через запятую)
ALLOWED_USERNAMES	usernames без @ (через запятую)

Также положите service_account.json в корень проекта.

---

Локальный запуск (Mac / Linux)

git clone https://github.com/morf3uzzz/second-brain-telegram-bot.git
cd second-brain-telegram-bot

cp .env.example .env
# заполните .env и положите service_account.json в корень

python3 -m venv .venv
.venv/bin/pip install aiogram openai gspread python-dotenv
.venv/bin/python main.py

---

Локальный запуск (Windows / PowerShell)

git clone https://github.com/morf3uzzz/second-brain-telegram-bot.git
cd second-brain-telegram-bot

copy .env.example .env
# заполните .env и положите service_account.json в корень

python -m venv .venv
.venv\Scripts\pip install aiogram openai gspread python-dotenv
.venv\Scripts\python main.py

---

Деплой на Beget (рекомендуемый способ)

Почему не архив?

В панели Beget загрузка архива часто очень долгая из‑за большого количества файлов.
Самый быстрый путь — git clone через консоль.

1) Подключение по SSH

После покупки сервера Beget присылает IP и пароль на почту.

Mac / Linux:

ssh root@ВАШ_IP

Windows (PowerShell):

ssh root@ВАШ_IP

2) Клонирование проекта на сервер

mkdir -p /root/second-brain-bot
cd /root/second-brain-bot
git clone https://github.com/morf3uzzz/second-brain-telegram-bot.git .

3) Установка зависимостей и запуск

cp .env.example .env
# заполните .env

# загрузите service_account.json в корень проекта
bash setup.sh

Скрипт setup.sh:

• ставит зависимости,
• создаёт systemd‑сервис,
• включает автозапуск.

Проверка:

systemctl status second-brain-bot
journalctl -u second-brain-bot -f

---

Как загрузить service_account.json

Вариант 1: через файловый менеджер Beget

Просто загрузите файл в корень проекта.

Вариант 2: через консоль (быстро)

Mac / Linux:

scp /путь/к/service_account.json root@ВАШ_IP:/root/second-brain-bot/

Windows PowerShell:

scp C:\путь\к\service_account.json root@ВАШ_IP:/root/second-brain-bot/

---

Обновление на сервере

cd /root/second-brain-bot
git pull
systemctl restart second-brain-bot

---

Лицензия

MIT. См. LICENSE.

Second Brain Telegram Bot

---

Русский

Телеграм-бот для продуктивности: голосовые сообщения превращаются в структурированные записи в Google Таблицах. Использует OpenAI Whisper для транскрибации и GPT для категоризации и извлечения данных. Поддерживает поиск по базе, удаление по намерению, ежедневные и еженедельные сводки и настраиваемые промпты.

Возможности

• Голос → таблица: отправьте голосовое — бот расшифрует, выберет категорию из Settings, заполнит строку по заголовкам листа и запишет в целевой лист и Inbox.
• Намерение из голоса: для коротких сообщений бот сам понимает, хотите ли вы добавить запись, задать вопрос по данным или удалить запись — кнопки не нужны.
• Thinking‑mode для длинных голосовых: если сообщение длиннее 2 минут, бот структурирует мысли и предлагает подтвердить сохранение в «Прочее» (если листа нет — сохранит в Inbox).
• Поиск: задайте вопрос голосом — бот ответит на основе всех листов категорий.
• Удаление: скажите, что нужно удалить — бот найдёт кандидатов, вы выберете запись; удаление идёт из листа категории и из Inbox.
• Обязательные поля: в заголовке колонки поставьте * (например Приоритет*); если значение пустое, бот спросит уточнение одним сообщением (формат: Поле=значение; Поле=значение или просто значение для одного поля).
• Ежедневные и еженедельные сводки: краткие сводки из Inbox в выбранный чат, время и таймзона настраиваются в /settings.
• Свои промпты: редактирование промптов роутера и извлечения через /settings (хранятся в листе Prompts).

Требования

• Python 3.10+
• Токен бота Telegram (@BotFather)
• API-ключ OpenAI (Whisper и GPT)
• Проект в Google Cloud с включённым Sheets API и сервисным аккаунтом (JSON-ключ)

Настройка Google Таблицы

1. Создайте таблицу и дайте доступ на редактирование email сервисного аккаунта из JSON-ключа.
2. Листы:
   • Settings: колонка A — категория (название листа), колонка B — описание для роутера.
   • Inbox: копия каждой заметки (Дата, Категория, Текст). Создаётся/используется ботом.
   • Прочее: свалка для длинных голосовых из Thinking‑mode (рекомендуется).
   • Prompts (необязательно): ключ / значение для своих промптов. Создаётся при сохранении промпта из /settings.
   • По одному листу на категорию (название как в Settings, колонка A). Первая строка — заголовки. Для обязательных колонок добавьте * (например Приоритет*).

Локальный запуск

# Клонирование
git clone https://github.com/morf3uzzz/second-brain-telegram-bot.git
cd second-brain-telegram-bot

# Переменные окружения
cp .env.example .env
# Заполните .env: TELEGRAM_TOKEN, OPENAI_API_KEY, GOOGLE_SHEET_ID, ALLOWED_USER_IDS, ALLOWED_USERNAMES

# Ключ сервисного аккаунта положите как service_account.json (или service_account.json.json) в корень проекта

# Виртуальное окружение и запуск
python3 -m venv .venv
.venv/bin/pip install aiogram openai gspread python-dotenv
.venv/bin/python main.py

Деплой на сервер (например Beget)

git clone https://github.com/morf3uzzz/second-brain-telegram-bot.git
cd second-brain-telegram-bot
cp .env.example .env
# Добавьте .env и service_account.json
bash setup.sh

Скрипт setup.sh ставит зависимости, создаёт systemd-сервис и включает его. Логи: journalctl -u second-brain-bot -f.

Переменные окружения

Переменная	Описание
TELEGRAM_TOKEN	Токен бота от BotFather
OPENAI_API_KEY	API-ключ OpenAI
GOOGLE_SHEET_ID	ID таблицы из URL
ALLOWED_USER_IDS	ID пользователей Telegram через запятую
ALLOWED_USERNAMES	Юзернеймы без @ через запятую

Использование

• Добавить запись: отправьте голосовое — бот добавит в нужный лист и Inbox.
• Длинное голосовое (>2 мин): бот сначала структурирует мысли и попросит подтвердить сохранение в «Прочее» (или в Inbox, если листа нет).
• Вопрос: отправьте голосовое с вопросом — бот ответит по вашим таблицам.
• Удалить: скажите, например, «удали задачу про X» — выберите из списка; строка удалится из листа и Inbox.
• Настройки: команда /settings — промпты, чат для сводок, время и таймзона ежедневных/еженедельных сводок.

Лицензия

MIT. См. LICENSE.

---

English

A productivity Telegram bot that turns voice messages into structured notes in Google Sheets. Uses OpenAI Whisper for transcription and GPT for categorization and data extraction. Supports search over your data, deletion by intent, daily/weekly summaries, and customizable prompts.

Features

• Voice → Sheet: Send a voice message; the bot transcribes it, picks a category from your Settings, fills the row by sheet headers, and writes to the target sheet + Inbox.
• Intent from voice: For short messages, the bot infers whether you want to add, ask, or delete—no buttons required.
• Thinking mode for long voice: If a message is longer than 2 minutes, the bot structures your thoughts and asks to confirm saving to Прочее (or Inbox if the sheet is missing).
• Search: Ask questions in voice; the bot answers using data from all category sheets.
• Delete: Say you want to remove something; the bot finds candidates and lets you pick one to delete (from both the category sheet and Inbox).
• Required fields: Mark columns with * in the header (e.g. Приоритет*); if empty, the bot asks for values in one round (e.g. Поле=значение; Поле=значение or just the value for a single field).
• Daily / weekly summaries: Optional summaries from Inbox, sent to a chat you choose, with configurable time and timezone in /settings.
• Custom prompts: Edit router and extract prompts via /settings (stored in the Prompts sheet).

Requirements

• Python 3.10+
• Telegram Bot Token (@BotFather)
• OpenAI API key (Whisper + GPT)
• Google Cloud project with Sheets API enabled and a service account (JSON key)

Google Sheets setup

1. Create a spreadsheet and share it with the service account email (Editor).
2. Sheets:
   • Settings: Col A = Category (sheet name), Col B = Description (for the router).
   • Inbox: Backup of every note (Date, Category, Transcript). Created/used by the bot.
   • Прочее: Catch‑all for long voice messages from Thinking mode (recommended).
   • Prompts (optional): Key / Value for custom prompts. The bot can create it when you save a prompt from /settings.
   • One sheet per category (same name as in Settings Col A), first row = column headers. Use * for required columns (e.g. Приоритет*).

Local setup

# Clone
git clone https://github.com/morf3uzzz/second-brain-telegram-bot.git
cd second-brain-telegram-bot

# Env
cp .env.example .env
# Edit .env: TELEGRAM_TOKEN, OPENAI_API_KEY, GOOGLE_SHEET_ID, ALLOWED_USER_IDS, ALLOWED_USERNAMES

# Service account key as service_account.json (or service_account.json.json) in project root

# Venv + run
python3 -m venv .venv
.venv/bin/pip install aiogram openai gspread python-dotenv
.venv/bin/python main.py

Server deploy (e.g. Beget)

git clone https://github.com/morf3uzzz/second-brain-telegram-bot.git
cd second-brain-telegram-bot
cp .env.example .env
# Add .env and service_account.json
bash setup.sh

setup.sh installs dependencies, creates a systemd service, and enables it. Logs: journalctl -u second-brain-bot -f.

Environment variables

Variable	Description
TELEGRAM_TOKEN	Bot token from BotFather
OPENAI_API_KEY	OpenAI API key
GOOGLE_SHEET_ID	Spreadsheet ID from the sheet URL
ALLOWED_USER_IDS	Comma-separated Telegram user IDs
ALLOWED_USERNAMES	Comma-separated usernames (without @)

Usage

• Add a note: Send a voice message; the bot adds it to the right sheet and Inbox.
• Long voice (>2 min): The bot structures the thoughts and asks to confirm saving to Прочее (or Inbox if missing).
• Ask: Send a voice message that is a question; the bot answers from your sheets.
• Delete: Say something like “удали задачу про X”; choose from the list, then the row is removed from the sheet and Inbox.
• Settings: Send /settings to configure prompts, summary chat, daily/weekly time and timezone.

License

MIT License. See LICENSE.