diff --git a/README.md b/README.md
index 10a2487..b2bedb8 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,16 @@
-Для запуска перейдите в Command Prompt.
-Запуск осуществляется из папки проекта.
-Введите команду npm run dev
\ No newline at end of file
+## Запуск
+1. Для запуска перейдите в Command Prompt.
+2. Запуск осуществляется из папки проекта.
+3. Введите команду npm run dev
+
+## Настройка AI-подсказок
+
+В приложении используется AI для генерации подсказок к заданиям (OpenRouter API).
+
+1. Зарегистрируйтесь на [openrouter.ai](https://openrouter.ai)
+2. Перейдите в раздел **Keys** → **Create Key**
+3. Скопируйте ключ — он показывается **только один раз**
+4. Создайте файл `.env` в корне проекта:
+OPENROUTER_API_KEY=sk-or-v1-ваш_ключ_здесь
+
+Без этого файла приложение работает, но кнопка «Подсказка» будет недоступна.
\ No newline at end of file