diff --git a/README.md b/README.md
index e69de29..ce707ed 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,38 @@
+# Sex Bomba TG Bot
+
+Телеграм‑бот, который:
+- вписывает текст шрифтом Impact (белый с чёрной обводкой) в макеты (`/maket`);
+- делает мемы из присланных фото (`/gen_mem Up:... Down:...`);
+- подсказывает, сколько минут до перекура по заданному расписанию (`/break`).
+
+## Запуск
+
+```bash
+docker-compose up --build
+```
+
+Переменные окружения: задайте `BOT_TOKEN` в `.env` (уже добавлен шаблон).
+
+## Команды
+
+- `/start` — отвечает кратко.
+- `/help` — выводит подсказки и список макетов.
+- `/maket <id> <текст>` — вписать текст в макет. Доступные: `1 — Владимир Владимирович Путин самый лучший президент` (737x414, точка 104,240).
+- `/gen_mem Up:верх Down:низ` — прислать с фото (подпись) или ответом на фото. Можно указывать только Up или только Down.
+- `/break` — показывает, сколько минут до ближайшего перекура/идёт ли перекур.
+
+## Макеты и шрифт
+
+- Шрифт `impact.ttf` лежит в корне.
+- Макеты в `maket/`, сейчас есть `1.png`. Добавляйте новые, прописав их в словаре `TEMPLATES` в `main.py`.
+
+## Технологии
+
+- Python 3.11, aiogram 3, Pillow.
+- Dockerfile + docker-compose для развёртывания.
+
+## Кратко о логике
+
+- `/maket` подбирает размер текста, чтобы уместить его в область макета.
+- `/gen_mem` центрирует текст по ширине, масштабирует под изображение, рисует белый текст с чёрной обводкой.
+- `/break` считает по расписанию в `main.py` (словарь `SCHEDULE`).