whisperio 0.1.1

TUI Deployer for Whisperio — Telegram Voice-to-Text bot powered by Cloudflare AI

🎙️ Whisperio

English | Русский

---

English

Whisperio is a lightweight, modern Telegram Voice-to-Text bot powered by Cloudflare Whisper AI (whisper-large-v3-turbo) and Llama 3 (8B) Instruct. It automatically transcribes voice messages, generates concise summaries, and suggests quick reply options.

The project features a built-in terminal installer (TUI) that automatically provisions a GitHub repository, deploys the bot to a free Render instance, configures the Telegram Bot profile (including custom description and profile photo), and sets up a Cloudflare Worker to prevent the Render instance from sleeping.

✨ Features

• 🎙️ Voice-to-Text: High-accuracy transcription of voice and audio files.
• 📝 AI Summarization: Extracts key bullet points from transcripts.
• 💡 Smart Reply Ideas: Proposes 3 response options (polite, friendly, or short agreement/decline).
• ⚡ 1-Click TUI Deployer: Self-host the entire infrastructure in under 5 minutes without manual server setup.
• ✕ Full Teardown: Clean up all deployed resources (GitHub, Render, Cloudflare) with a single click.

---

🚀 One-Line Installer

Run the interactive TUI installer directly from your terminal:

pipx run whisperio

---

🔑 Prerequisites

Before running the installer, make sure you have:

1. Telegram Bot Token: Get it from @BotFather.
2. GitHub Personal Access Token: Create one here with repo and delete_repo scopes.
3. Render API Key: Generate it in your Render Account Settings.
4. Cloudflare Account ID & API Token: Obtain them from your Cloudflare dashboard (requires Workers Scripts: Edit permission).

---

🛠️ Developer Setup & Manual Deployment

If you prefer to run or modify the deployer locally:

# Clone the repository
git clone https://github.com/Official-DevFlaw/whisperio.git
cd whisperio

# Install dependencies
pip install -r requirements.txt

# Run the TUI deployer
python deployer.py

---

Русский

Whisperio — это легкий и современный Telegram-бот для автоматического перевода голосовых сообщений и аудиофайлов в текст с помощью моделей Cloudflare Whisper AI (whisper-large-v3-turbo) и Llama 3 (8B) Instruct.

Проект поставляется с интерактивным TUI-инсталлятором, который автоматически создает репозиторий на GitHub, деплоит бота на бесплатный хостинг Render, настраивает профиль бота в Telegram (включая имя, описание и аватарку) и создает Cloudflare Worker для поддержания активности сервера Render.

✨ Возможности

• 🎙️ Голос в текст: Высокоточное распознавание аудиосообщений любой длины.
• 📝 ИИ-Саммари: Извлечение краткой сути и тезисов из расшифрованного текста.
• 💡 Идеи для ответов: Предложение 3 вариантов быстрых ответов (вежливый, дружеский, согласие/отказ).
• ⚡ Авто-деплой в 1 клик: Развертывание всей инфраструктуры за пару минут прямо из терминала.
• ✕ Полное удаление: Автоматическая очистка всех созданных ресурсов (GitHub, Render, Cloudflare) в одно нажатие.

---

🚀 Запуск установщика в одну строку

Запустите интерактивный установщик прямо в вашем терминале:

pipx run whisperio

---

🔑 Подготовка токенов

Для работы деплоера подготовьте следующие ключи:

1. Telegram Bot Token: Получите у @BotFather.
2. GitHub Personal Access Token: Создайте здесь с разрешениями repo и delete_repo.
3. Render API Key: Создайте в настройках профиля Render Dashboard.
4. Cloudflare Account ID и API Token: Получите в панели Cloudflare (токену требуются права Workers Scripts: Edit).

---

🛠️ Локальный запуск для разработчиков

Если вы хотите запустить или модифицировать установщик локально:

# Клонирование репозитория
git clone https://github.com/Official-DevFlaw/whisperio.git
cd whisperio

# Установка зависимостей
pip install -r requirements.txt

# Запуск TUI деплоера
python deployer.py