# 🤖 Telegram Multi-Tool Bot

![Python](https://img.shields.io/badge/Python-3.10+-blue)
![aiogram](https://img.shields.io/badge/aiogram-3.x-green)
![License](https://img.shields.io/badge/license-MIT-lightgrey)

Многофункциональный 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

---

## 👨‍💻 Автор

Сделано с ❤️