diff --git a/README.md b/README.md
index 088ed1b..e2185c3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,24 @@
-# task-69dd4221f309a98be0006b2e
+# Сырой текст задания → плоская карточка
 
-Task text to flat card structured output
\ No newline at end of file
+Один проход: `PromptTemplate` → `ChatOpenAI` (OpenRouter) → `PydanticOutputParser`.
+
+## Установка
+
+```bash
+pip install -r requirements.txt
+```
+
+В `.env`:
+
+```env
+OPENAI_API_KEY=sk-or-...
+OPENROUTER_MODEL=poolside/laguna-m.1:free
+```
+
+> `openai/gpt-oss-20b:free` сейчас часто даёт 429 — используйте другую free-модель с [openrouter.ai/models](https://openrouter.ai/models).
+
+## Запуск
+
+```bash
+python main.py
+```