151 lines
2.8 KiB
Markdown
151 lines
2.8 KiB
Markdown
# 🤖 Telegram Multi-Tool Bot
|
||
|
||
|
||
|
||
|
||
|
||
Многофункциональный Telegram-бот на базе **aiogram 3**, который умеет:
|
||
|
||
- 🌤️ Показывать погоду
|
||
- 📥 Скачивать файлы с Яндекс.Диска
|
||
- 🎤 Распознавать голосовые сообщения (Yandex SpeechKit)
|
||
- 🔄 Восстанавливать раскладку клавиатуры
|
||
- 🚫 Защищать чат от спама
|
||
- 🗂️ Кешировать файлы через SQLite
|
||
|
||
---
|
||
|
||
## 🚀 Возможности
|
||
|
||
### 📌 Команды
|
||
|
||
| Команда | Описание |
|
||
|--------------|--------|
|
||
| `/start` | Приветствие |
|
||
| `/help` | Информация о боте |
|
||
| `/get_id` | Узнать свой ID |
|
||
| `/weather` | Погода (`/weather Москва`) |
|
||
| `/ydf` | Скачать файл с Яндекс.Диска |
|
||
| `/res` | Восстановить раскладку |
|
||
| `/info_ban` | Информация о бане |
|
||
|
||
---
|
||
|
||
## ⚙️ Установка
|
||
|
||
```bash
|
||
git clone <your-repo>
|
||
cd bot
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
---
|
||
|
||
## 🔐 Настройка
|
||
|
||
Создай `.env`:
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
```
|
||
|
||
Заполни:
|
||
|
||
```env
|
||
BOT_TOKEN=your_bot_token
|
||
|
||
YSK_API_KEY=your_yandex_speechkit_key
|
||
API_WEATHER=your_openweather_key
|
||
|
||
ACCESS_KEY=your_s3_access_key
|
||
SECRET_KEY=your_s3_secret_key
|
||
BUCKET_NAME=your_bucket
|
||
|
||
PROXY_URL=socks5://login:password@host:port
|
||
|
||
DB_PATH=bot_database.db
|
||
```
|
||
|
||
---
|
||
|
||
## 🌐 Прокси
|
||
|
||
Поддерживаются:
|
||
|
||
- HTTP
|
||
- SOCKS5 (рекомендуется)
|
||
|
||
Пример:
|
||
|
||
```env
|
||
PROXY_URL=socks5://user:pass@127.0.0.1:1080
|
||
```
|
||
|
||
---
|
||
|
||
## ▶️ Запуск
|
||
|
||
```bash
|
||
python main.py
|
||
```
|
||
|
||
---
|
||
|
||
## 🗂️ Структура проекта
|
||
|
||
```
|
||
.
|
||
├── main.py
|
||
├── config.py
|
||
├── database.py
|
||
├── functions.py
|
||
├── antispam.py
|
||
├── download_files.py
|
||
├── yandex_cloud_sk.py
|
||
├── switching_en_ru.py
|
||
├── requirements.txt
|
||
├── .env.example
|
||
```
|
||
|
||
---
|
||
|
||
## 🎤 SpeechKit
|
||
|
||
Используется библиотека:
|
||
|
||
```
|
||
yandex-speechkit
|
||
```
|
||
|
||
---
|
||
|
||
## 🛡️ Безопасность
|
||
|
||
- ❌ Не коммить `.env`
|
||
- 🔑 Перевыпускай ключи при утечке
|
||
- 🔒 Храни секреты только в окружении
|
||
|
||
---
|
||
|
||
## ⚡ Особенности
|
||
|
||
- Асинхронный код
|
||
- Поддержка прокси
|
||
- Безопасная обработка голосовых
|
||
- Кеширование файлов
|
||
- SQLite база данных
|
||
|
||
---
|
||
|
||
## 📈 Планы
|
||
|
||
- Redis
|
||
- Docker
|
||
- Web UI
|
||
|
||
---
|
||
|
||
## 👨💻 Автор
|
||
|
||
Сделано с ❤️
|