diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4ae1608
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+# Orientator
+
+Веб-сервис для автоматического поворота страниц в PDF, изображениях и архивах.
+
+Модель определяет ориентацию каждой страницы/картинки (`0`, `90`, `180`, `270`), после чего файл сохраняется уже исправленным. Для нескольких файлов результат отдается одним zip-архивом.
+
+## Запуск
+
+```bash
+go run ./cmd/orientator -addr :8080
+```
+
+Открыть:
+
+```text
+http://127.0.0.1:8080
+```
+
+## Сборка
+
+```bash
+go build -o orientator ./cmd/orientator
+```
+
+Linux x86_64 удобнее собирать в Linux/Docker из-за cgo-зависимостей:
+
+```bash
+docker run --rm --platform linux/amd64 -v "$PWD:/src" -w /src golang:1.25-bookworm sh -lc \
+  'export PATH=/usr/local/go/bin:$PATH; CGO_ENABLED=1 GOOS=linux GOARCH=amd64 go build -o dist/orientator-linux-amd64 ./cmd/orientator'
+```
+
+## Форматы
+
+Поддерживаются:
+
+- PDF
+- JPG, PNG, TIFF, WEBP, BMP
+- ZIP, TAR, TAR.GZ, TGZ, 7Z, RAR
+
+ONNX-модель и runtime-библиотеки для `darwin-arm64` и `linux-amd64` встроены в бинарь.