diff --git a/README.md b/README.md
index 6b1fffd..f2578be 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,29 @@
-# task-6997111cd6d3a5544a3deffd
+# AI-агент: планирование списка покупок
 
-LangChain shopping agent KFU-26-1
\ No newline at end of file
+Иерархический агент на LangChain с локальной моделью через LM Studio.
+
+## Запуск
+
+1. Запустите LM Studio и включите локальный сервер на `http://localhost:1234`.
+2. Установите зависимости:
+
+```bash
+pip install -r requirements.txt
+```
+
+3. При необходимости задайте имя модели:
+
+```bash
+set LM_STUDIO_MODEL=имя-модели-в-lm-studio
+```
+
+4. Запустите:
+
+```bash
+python main.py
+```
+
+## Структура
+
+- `main.py` — главный агент и инструмент `get_price` с субагентом внутри
+- `requirements.txt` — зависимости LangChain