🎙️ Dictation Buddy Bot v2

AI бот для Telegram, который превращает ваши голосовые сообщения в текст и помогает их быстро обработать.

🎯 Для кого этот бот?

Этот бот создан для решения реальных проблем занятых людей:

• 📱 Получаете длинные голосовые от клиентов/партнеров? Не нужно слушать их на встречах — бот сразу превратит в текст
• 🚗 Нужно быстро продиктовать длинное сообщение за рулем? Записывайте голосовое, бот транскрибирует — руки свободны
• 💼 Хотите поставить задачу команде после звонка с клиентом? Запишите голосовое в такси, превратите в бриф и отправьте
• ✍️ Сложно сформулировать промт для ИИ письменно? Наговорите, отредактируйте и используйте
• 🗣️ Нужно высказаться эмоционально и подробно? Говорите сколько угодно — получите структурированный текст

✨ Главная фишка — мгновенное редактирование

После транскрипции вы можете одним кликом:

• 📝 Proofread — исправить ошибки и улучшить текст
• 😊 Неформально — сделать текст естественным, "от руки"
• 💼 Бизнес-стиль — отформатировать для деловой переписки
• 📋 Brief — превратить разговор в структурированное ТЗ с задачами

🔒 Безопасность и конфиденциальность

Приватность — приоритет! Бот разработан с полным соблюдением принципов конфиденциальности:

• 🚫 Никакого логирования голосовых сообщений — аудио обрабатывается "на лету" и сразу удаляется
• ⚡ Мгновенная обработка — файлы отправляются на транскрипцию и тут же уничтожаются с сервера
• 🗑️ Нулевое хранение — транскрибированный текст не сохраняется на наших серверах
• 📊 Минимальная статистика — записываем только общее количество обработанных сообщений (без ID пользователей)
• 🔐 Ваши данные остаются при вас — вся история переписки хранится только в вашем Telegram
• 🛡️ Никаких персональных данных — не собираем ID пользователей, содержимое сообщений или историю

Принцип работы: получили аудио → отправили на Deepgram → получили текст → отправили вам → все удалили. Просто и безопасно!

🚀 Что нового в версии 2?

• 🎯 Оптимизированные промпты для AI обработки с XML-структурой
• ⚡ Улучшенная производительность и скорость обработки
• 📋 Новый стиль "Brief" для создания структурированных задач из аудио
• 🔧 Более надежная обработка ошибок транскрипции
• 📝 Улучшенное форматирование сообщений (жирный, курсив, подчеркивание)

Бот использует современные технологии распознавания речи и может улучшать получившийся текст с помощью ИИ!

🌟 Что умеет бот?

• 🗣️ Переводит голосовые сообщения в текст (до 20 минут)
• 🎵 Распознает речь из аудио файлов (до 20 минут)
• 🎥 Извлекает текст из видео
• 📝 Улучшает качество текста с помощью искусственного интеллекта
• 🔄 Автоматически преобразует числа из текста в цифры
• 📊 Показывает прогресс обработки прямо в Telegram
• 📨 Умеет работать с длинными сообщениями, автоматически разбивая их на части

🛠️ Требования

• Python 3.10 или выше
• Telegram Bot Token (от @BotFather)
• Deepgram API ключ
• Anthropic API ключ
• Docker (опционально)

⚙️ Установка

Шаг 1: Подготовка компьютера

1. Установите Python (это язык программирования, на котором написан бот)

   • Перейдите на официальный сайт Python
   • Нажмите большую желтую кнопку "Download Python"
   • Запустите скачанный файл
   • ⚠️ ВАЖНО: При установке поставьте галочку "Add Python to PATH"!
   • Нажимайте "Next" до завершения установки

2. Проверьте установку

   • Откройте программу "Командная строка" (Windows) или "Терминал" (Mac)
   • Введите команду:

     python --version

   • Должна появиться версия Python (например, Python 3.10.0)

Шаг 2: Получение бота

1. Скачайте проект
   • Если у вас есть Git:

     git clone https://github.com/your-username/transcription-bot.git
     cd transcription-bot

   • Если нет Git: нажмите зеленую кнопку "Code" → "Download ZIP" на странице проекта
     • Распакуйте архив
     • Откройте командную строку/терминал
     • Перейдите в папку с проектом:

       cd путь/к/папке/transcription-bot

Шаг 3: Настройка окружения

1. Создайте виртуальное окружение (это как отдельная комната для проекта)

   • В Windows:

     python -m venv venv
     venv\Scripts\activate

   • В Mac/Linux:

     python -m venv venv
     source venv/bin/activate

2. Установите необходимые программы

   pip install -r requirements.txt

Шаг 4: Получение ключей доступа

1. Получите токен Telegram бота

   • Найдите @BotFather в Telegram
   • Напишите ему /newbot
   • Следуйте инструкциям
   • Сохраните полученный токен

2. Получите ключ Deepgram

   • Зарегистрируйтесь на console.deepgram.com
   • Перейдите в раздел API Keys
   • Создайте новый ключ
   • Сохраните его

3. Получите ключ Anthropic

   • Зарегистрируйтесь на console.anthropic.com
   • Найдите раздел API Keys
   • Создайте ключ
   • Сохраните его

Шаг 5: Настройка бота

1. Создайте файл с настройками
   • В папке проекта создайте файл .env
   • Откройте его в любом текстовом редакторе
   • Вставьте следующий текст, заменив your_token на ваши ключи:

     BOT_TOKEN=your_telegram_bot_token
     DEEPGRAM_API_KEY=your_deepgram_api_key
     ANTHROPIC_API_KEY=your_anthropic_api_key

Шаг 6: Запуск бота

1. Обычный запуск

   python main.py

2. Запуск через Docker (если установлен Docker)

   docker-compose up --build

Шаг 7: Проверка работы

1. Найдите вашего бота в Telegram (по имени, которое вы дали при создании)
2. Отправьте ему голосовое сообщение
3. Бот должен ответить текстовой версией вашего сообщения!

🆘 Частые проблемы и их решение

1. "Python не найден"

   • Переустановите Python, не забыв поставить галочку "Add Python to PATH"

2. "pip не найден"

   • Это значит, что Python установлен неправильно
   • Переустановите Python

3. "ModuleNotFoundError"

   • Убедитесь, что вы активировали виртуальное окружение
   • Повторите установку зависимостей:

     pip install -r requirements.txt

4. "Не могу найти файл .env"

   • Проверьте, что файл создан и находится в корневой папке проекта
   • Убедитесь, что файл назван именно .env (с точкой в начале)

📁 Как устроен проект

Вот основные папки проекта и что в них находится:

transcription-bot/
├── config/         # Настройки бота
├── handlers/       # Обработка сообщений
├── models/         # Структуры данных
├── prompts/        # Шаблоны для AI
├── services/       # Работа с API
├── utils/          # Вспомогательные функции
├── .env            # Ваши ключи и токены
├── main.py         # Главный файл бота
└── requirements.txt # Список нужных программ

👩‍💻 Для разработчиков

Если вы хотите помочь в разработке бота:

1. Создайте свою копию проекта (форк)

   • Нажмите кнопку "Fork" на странице проекта
   • Клонируйте свой форк
   • Создайте новую ветку для ваших изменений

2. Внесите изменения

   • Добавьте новую функцию или исправьте ошибку
   • Протестируйте изменения
   • Следуйте стилю кода проекта

3. Отправьте изменения

   • Создайте Pull Request
   • Опишите, что вы изменили
   • Дождитесь проверки

📄 Лицензия

MIT License - вы можете свободно использовать этот код для своих проектов

🤝 Нужна помощь?

Если у вас возникли проблемы:

1. Проверьте раздел частых проблем выше
2. Создайте Issue в репозитории
3. Напишите нам в Telegram
4. Посмотрите дополнительную информацию в Wiki