mihailberd/telegram_echo_bot
Простой современный Telegram эхо-бот на aiogram 3.
Image
0
10K+
mihailberd/telegram_echo_bot repository overview
⚡ Echo-Bot (aiogram 3 + Docker)
Telegram-бот “Эхо”: принимает текст, фото, файлы ≤ 10 МБ — и мгновенно отправляет их обратно.
Проект демонстрирует чистую асинхронную архитектуру, работу с множеством типов сообщений и грамотный DevOps-пайплайн.
✨ Ключевые фичи
| Фича | Что показывает |
|---|---|
| aiogram 3 + Router | Современная асинхронная обработка апдейтов |
| Поддержка 8 типов сообщений | Текст, фото, стикер, видео, GIF, документ, аудио, голос |
| Ролевое ограничение /users | Базовая RBAC-проверка (админы только из config.py) |
| Persist пользователей | Автоматически логирует user_id в файл |
| Ограничение размера 10 МБ | Пример middle-layer валидации входящих файлов |
| Dockerfile 9 строк | Сборка лёгкого образа (Python 3.12-slim) |
| ENV-секреты (BOT_TOKEN) | Безопасное управление токенами / CI-секретами |
🚀 Быстрый старт
Требования: Docker 20.10+, токен Telegram-бота.
# 1. Забираем образ
docker pull mihailberd/telegram_echo_bot:latest
# 2. Запускаем
docker run --rm -e BOT_TOKEN=YOUR_TOKEN mihailberd/telegram_echo_bot:latest
Локальная сборка
git clone https://github.com/BerdnikovM/Telegram_Echo_Bot.git
cd echo-bot
pip install -r requirements.txt # aiogram 3.21+
export BOT_TOKEN=
python bot.py
🛠️ Стек и техники
| Слой | Технологии |
|---|---|
| 🐍 Язык | Python 3.12 |
| 🤖 Telegram SDK | aiogram 3 (Router, Filters, FSM) |
| 🐋 Контейнеризация | Docker + официальный образ python:3.12-slim |
| 🔐 Secrets | ENV-переменные (BOT_TOKEN), поддержка .env |
| 📈 Логирование | logging.basicConfig(level=INFO) |
| 🧪 Тесты (roadmap) | pytest-asyncio, GitHub Actions CI |
| ☁️ Деплой | Render (free tier) / Docker Hub image |
🤝 Связаться
| Контакт | |
|---|---|
| ✉ Telegram | @MihailBerd |
| 💼 Kwork | [https://kwork.ru/user/berdnikovmiha) |
| [email protected] |
Tag summary
Content type
Image
Digest
sha256:b9112a135…
Size
54.4 MB
Last updated
about 1 year ago
docker pull mihailberd/telegram_echo_bot