Metadata-Version: 2.4
Name: whisperio
Version: 0.1.1
Summary: TUI Deployer for Whisperio — Telegram Voice-to-Text bot powered by Cloudflare AI
License: MIT
Project-URL: Homepage, https://github.com/Official-DevFlaw/whisperio
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: textual>=0.47.0
Requires-Dist: requests>=2.25.0

# 🎙️ Whisperio

[**English**](#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:

```bash
pipx run whisperio
```

---

### 🔑 Prerequisites

Before running the installer, make sure you have:
1. **Telegram Bot Token**: Get it from [@BotFather](https://t.me/BotFather).
2. **GitHub Personal Access Token**: Create one [here](https://github.com/settings/tokens) with `repo` and `delete_repo` scopes.
3. **Render API Key**: Generate it in your [Render Account Settings](https://dashboard.render.com/).
4. **Cloudflare Account ID & API Token**: Obtain them from your [Cloudflare dashboard](https://dash.cloudflare.com/profile/api-tokens) (requires `Workers Scripts: Edit` permission).

---

### 🛠️ Developer Setup & Manual Deployment

If you prefer to run or modify the deployer locally:

```bash
# 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) в одно нажатие.

---

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

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

```bash
pipx run whisperio
```

---

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

Для работы деплоера подготовьте следующие ключи:
1. **Telegram Bot Token**: Получите у [@BotFather](https://t.me/BotFather).
2. **GitHub Personal Access Token**: Создайте [здесь](https://github.com/settings/tokens) с разрешениями `repo` и `delete_repo`.
3. **Render API Key**: Создайте в настройках профиля [Render Dashboard](https://dashboard.render.com/).
4. **Cloudflare Account ID и API Token**: Получите в [панели Cloudflare](https://dash.cloudflare.com/profile/api-tokens) (токену требуются права `Workers Scripts: Edit`).

---

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

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

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

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

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