diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b512919
--- /dev/null
+++ b/README.md
@@ -0,0 +1,139 @@
+# Yandex Lyceum Projects 🚀
+
+> Коллекция веб-приложений разработанных в рамках образовательной программы Яндекс Лицея
+
+## 📋 Описание проекта
+
+Репозиторий содержит комплекс учебных проектов, демонстрирующих эволюцию навыков веб-разработки от базовых HTML-страниц до полнофункциональных Flask-приложений с интеграцией внешних API.
+
+## 🏗️ Архитектура решений
+
+### Модули проекта:
+
+#### 1. **WEB.HTML** - Базовая веб-разработка
+- Статические HTML-страницы с CSS-стилизацией
+- Обработка форм и файловых загрузок
+- Маршрутизация и шаблонизация
+
+#### 2. **WEB.HTML 2** - Продвинутая веб-архитектура
+- Flask-приложение с расширенной функциональностью
+- Интеграция Bootstrap для адаптивного дизайна
+- Система аутентификации и авторизации
+
+#### 3. **WEB.HTML flask-wtf** - Профессиональные веб-формы
+- Валидация пользовательского ввода
+- CSRF-защита
+- Обработка сложных форм с множественными полями
+
+#### 4. **Полный поиск** - Геоинформационные сервисы
+- Интеграция с Yandex Maps API
+- Алгоритмы геопозиционирования
+- Динамическое построение карт
+
+## 🛠️ Технологический стек
+
+```
+Backend:    Flask 2.0+, Python 3.8+
+Frontend:   HTML5, CSS3, Bootstrap 5.1.3
+Forms:      Flask-WTF, WTForms
+APIs:       Yandex Maps Search API
+Libraries:  Pillow, Requests, Jinja2
+```
+
+## 🚀 Быстрый старт
+
+### Установка зависимостей
+```bash
+pip install -r requirements.txt
+```
+
+### Запуск приложений
+```bash
+# Базовое HTML-приложение
+cd "WEB.HTML"
+python server.py
+
+# Flask-приложение с шаблонами
+cd "WEB.HTML 2"
+python server.py
+
+# Приложение с формами
+cd "WEB.HTML flask-wtf"
+python server.py
+```
+
+### Конфигурация API
+Для работы геосервисов необходимо настроить API-ключ в `main.py`:
+```python
+api_key = "your_yandex_api_key_here"
+```
+
+## 📁 Структура проекта
+
+```
+yandex_lyceum/
+├── WEB.HTML/                  # Базовые веб-технологии
+│   ├── server.py             # Flask-сервер
+│   ├── static/               # Статические ресурсы
+│   └── templates/            # HTML-шаблоны
+├── WEB.HTML 2/               # Расширенная веб-архитектура
+│   ├── server.py
+│   ├── loginform.py          # Формы авторизации
+│   └── templates/
+├── WEB.HTML flask-wtf/       # Профессиональные формы
+└── Полный поиск/             # Геоинформационные сервисы
+    ├── main.py               # Основная логика
+    └── delta.py              # Вспомогательные алгоритмы
+```
+
+## 🎯 Функциональные возможности
+
+### Веб-интерфейсы:
+- **Космическая тематика:** Интерактивные страницы миссии колонизации Марса
+- **Система профессий:** Каталогизация и фильтрация специальностей
+- **Анкетирование:** Комплексные формы с валидацией данных
+- **Аутентификация:** Многоуровневая система доступа
+
+### Геосервисы:
+- **Поиск объектов:** Интеграция с Yandex Search API
+- **Картографирование:** Динамическое построение карт
+- **Геопозиционирование:** Алгоритмы расчета координат
+
+## 🔧 Конфигурация
+
+### Переменные окружения:
+```bash
+FLASK_ENV=development
+SECRET_KEY=yandexlyceum_secret_key
+YANDEX_API_KEY=your_api_key
+```
+
+### Порты по умолчанию:
+- **Flask-приложения:** `127.0.0.1:8080`
+- **Статические файлы:** автоматическая маршрутизация
+
+## 🏆 Образовательные цели
+
+Проект демонстрирует прогрессивное освоение:
+- Фундаментальных веб-технологий
+- Серверной архитектуры Flask
+- Интеграции внешних API
+- Профессиональных практик разработки
+
+## 📄 Лицензия
+
+Образовательный проект в рамках программы Яндекс Лицея
+
+## 👨‍💻 Автор
+
+**Деев Егор Викторович**
+- GitHub: [@EDeev](https://github.com/EDeev)
+- Email: egor@deev.space
+- Сайт: [deev.space](https://deev.space)
+
+---
+
+<div align="center">
+  <sub>Разработано в рамках образовательной программы Яндекс Лицея для демонстрации навыков полного цикла веб-разработки</sub>
+  <p><sub>Создано с ❤️ от вашего дорогого - deev.space ©</sub></p>
+</div>