shima.me

Serge Shima / Work and projects

d-buddy

Transctiption Telegram Bot

Python · 9 GitHub stars · Snapshot

GitHub · Full documentation

From the project documentation

An excerpt in the original language from the README. Current instructions, requirements and license are maintained in the repository.

🎙️ 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 - вы можете свободно использовать этот код для своих проектов 🤝 Нужна помощь?

Source retrieved · README d65eb842f0d3

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.

All repositories · github.com/smixs