Serge Shima / Work and projects
d-buddy
Transctiption Telegram Bot
From the project documentation
🎙️ 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 (например, Python 3.10.0)
Шаг 2: Получение бота
1. **Скачайте проект**
- Если у вас есть Git:
- Если нет Git: нажмите зеленую кнопку "Code" → "Download ZIP" на странице проекта
- Распакуйте архив
- Откройте командную строку/терминал
- Перейдите в папку с проектом:
Шаг 3: Настройка окружения
1. **Создайте виртуальное окружение** (это как отдельная комната для проекта)
- В Windows:
- В Mac/Linux:
2. **Установите необходимые программы**
Шаг 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` на ваши ключи:
Шаг 6: Запуск бота
1. **Обычный запуск**
2. **Запуск через Docker** (если установлен Docker)
Шаг 7: Проверка работы
1. Найдите вашего бота в Telegram (по имени, которое вы дали при создании)
2. Отправьте ему голосовое сообщение
3. Бот должен ответить текстовой версией вашего сообщения!
🆘 Частые проблемы и их решение
1. **"Python не найден"**
- Переустановите Python, не забыв поставить галочку "Add Python to PATH"
2. **"pip не найден"**
- Это значит, что Python установлен неправильно
- Переустановите Python
3. **"ModuleNotFoundError"**
- Убедитесь, что вы активировали виртуальное окружение
- Повторите установку зависимостей:
4. **"Не могу найти файл .env"**
- Проверьте, что файл создан и находится в корневой папке проекта
- Убедитесь, что файл назван именно `.env` (с точкой в начале)
📁 Как устроен проект
Вот основные папки проекта и что в них находится:
👩💻 Для разработчиков
Если вы хотите помочь в разработке бота:
1. **Создайте свою копию проекта (форк)**
- Нажмите кнопку "Fork" на странице проекта
- Клонируйте свой форк
- Создайте новую ветку для ваших изменений
2. **Внесите изменения**
- Добавьте новую функцию или исправьте ошибку
- Протестируйте изменения
- Следуйте стилю кода проекта
3. **Отправьте изменения**
- Создайте Pull Request
- Опишите, что вы изменили
- Дождитесь проверки
📄 Лицензия
MIT License - вы можете свободно использовать этот код для своих проектов
🤝 Нужна помощь?
About the author
Serge Shima is co-founder and CTO of Majento in Tashkent and founder of Aimasters. He builds AI products and open-source tools for agents.