diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5f92ce1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,62 @@
+# Органайзер для кошачьего корма (3D-модель)
+
+Органайзер для хранения влажного кошачьего корма. Дизайн по мотивам
+`cat_organaizer_a1_veroi.3mf`: высокая коробка + крышка из двух частей
+(верх с кошачьими ушками + низ с защёлками).
+
+## Содержимое
+
+| Файл | Описание |
+|---|---|
+| `box.stl` | Коробка **без боковой конструкции** (для печати) |
+| `lid_top.stl` | Крышка-верх с кошачьими ушками |
+| `lid_bottom.stl` | Крышка-низ с 4 защёлками |
+| `cat_organaizer_a1_veroi.3mf` | Оригинальный дизайн (исходник) |
+| `view_original.glb` / `view_edited.glb` | Собранные модели для просмотра |
+| `preview_original.html` | Просмотрщик: оригинал |
+| `preview_edited.html` | Просмотрщик: без боковой конструкции |
+| `preview.html` | Просмотрщик с переключателем версий |
+| `generate_box.py` | Параметрический генератор (Python) |
+| `vendor/` | Локальные файлы Three.js (просмотрщик работает без интернета) |
+
+## Просмотр модели
+
+Открой `preview_original.html` или `preview_edited.html` в браузере
+(модель встроена в HTML, интернет не нужен). Управление:
+ЛКМ — вращение, колесо — масштаб, ПКМ — сдвиг.
+
+Для просмотра с других устройств в локальной сети:
+
+```bash
+cd <папка проекта>
+python3 -m http.server 8000 --bind 0.0.0.0
+# затем открыть http://<IP-компьютера>:8000/preview_original.html
+```
+
+## Печать
+
+- **Коробка** (`box.stl`): печатать вертикально, дном вниз
+- **Крышка-верх** (`lid_top.stl`): пластиной вниз, ушки вверх
+- **Крышка-низ** (`lid_bottom.stl`): защёлками вверх
+- Рекомендации: слой 0.2 мм, сопло 0.4 мм, заполнение 20–30%,
+  материал PETG или PLA
+- Сборка: крышка-низ вставляется в отверстие коробки, её защёлки
+  входят в отверстия крышки-верха
+
+## Размеры
+
+- Коробка: 131.5 × 156.2 × 200 мм
+- Крышка-верх: 105 × 155 × 24 мм
+- Крышка-низ: 100.2 × 150.2 × 9 мм
+- Толщина стенок: ~3–4 мм, дно сплошное
+
+## Генератор
+
+`generate_box.py` строит модель параметрически (размеры пакета,
+количество, сегментация для печати). Запуск:
+
+```bash
+python3 generate_box.py
+```
+
+Требуются: `trimesh`, `numpy`, `shapely`, `manifold3d`, `matplotlib`.
\ No newline at end of file