diff --git a/README.md b/README.md
new file mode 100644
index 0000000..880136b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,56 @@
+# Room-3D
+
+Интерактивный 3D-сайт для демонстрации контактов, презентации и резюме.
+
+## О проекте
+
+Это современный веб-сайт с 3D-интерактивной сценой интерьера, разработанный на базе **Three.js**. Проект служит персональной визитной карточкой, презентацией портфолио и онлайн-резюме.
+
+## Возможности
+
+- 🏠 Интерактивная 3D-комната с реалистичным освещением
+- 🖱️ Вращение модели мышью и зум колёсиком
+- 💡 Реалистичное освещение: Spot-светильники и LED-ленты
+- 🌆 HDRI-окружение для фотореалистичности
+- 📱 Адаптивный дизайн
+
+## Технологии
+
+- **Three.js** — 3D-графика
+- **HTML5 / CSS3** — верстка и стили
+- **JavaScript (ES6 modules)** — логика приложения
+
+## Установка и запуск
+
+Проект не требует сборки. Просто откройте `index.html` в браузере или используйте локальный сервер:
+
+```bash
+# Python 3
+python -m http.server 8000
+
+# Node.js (если установлен http-server)
+npx http-server
+```
+
+Затем перейдите по адресу: `http://localhost:8000`
+
+## Структура проекта
+
+```
+/
+├── index.html          # Главная страница
+├── css/
+│   └── style.css       # Стили
+├── js/
+│   ├── main.js         # Точка входа
+│   ├── scene.js        # Сцена и рендерер
+│   ├── camera.js       # Камера
+│   ├── controls.js     # Управление мышью
+│   └── lights.js       # Освещение
+├── models/             # 3D-модели
+└── textures/           # Текстуры и HDRI
+```
+
+## Лицензия
+
+© Oleg Tolchin