From 459382b0077acaca8e6137d09df996c4ff0c25c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=AD=D0=BC=D0=B8=D0=BB=D1=8C=20=D0=90=D0=BC=D0=B8=D1=80?=
 =?UTF-8?q?=D0=BE=D0=B2?= <emillamirov555777@mail.ru>
Date: Wed, 27 May 2026 09:28:44 +0000
Subject: [PATCH] rework: update README.md (langgraph + run instructions)

---
 README.md | 45 +++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 43 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index bdc718c..3e6a888 100644
--- a/README.md
+++ b/README.md
@@ -2,11 +2,52 @@
 
 Агент покупок с `MemorySaver`, `interrupt_before=['tools']`, stream-выводом и чат-циклом.
 
-## Запуск
+## Требования
+
+- Python 3.11+
+- [LM Studio](https://lmstudio.ai/) с запущенным локальным API: `http://localhost:1234/v1`
+
+## Установка
+
+Проект использует **LangChain** и **LangGraph** (`MemorySaver`, прерывания перед tools).  
+Обязательно установите зависимости из `requirements.txt`, включая `langgraph>=1.0.8`:
 
 ```bash
+python -m venv .venv
+
+# Windows
+.venv\Scripts\activate
+
+# Linux / macOS
+# source .venv/bin/activate
+
 pip install -r requirements.txt
+```
+
+Проверка, что `langgraph` установлен:
+
+```bash
+python -c "from langgraph.checkpoint.memory import MemorySaver; print('langgraph OK')"
+```
+
+## Запуск
+
+1. Запустите LM Studio и загрузите модель (по умолчанию endpoint `http://localhost:1234/v1`).
+2. При необходимости задайте переменные окружения:
+
+```bash
+set LM_STUDIO_BASE_URL=http://localhost:1234/v1
+set LM_STUDIO_MODEL=local-model
+set OPENAI_API_KEY=fake
+```
+
+3. Запустите агента:
+
+```bash
 python main.py
 ```
 
-LM Studio: `http://localhost:1234`. Команда выхода: `exit`.
+В чате введите запрос (например: «Сколько стоит молоко в Казани?»).  
+При вызове инструмента агент спросит подтверждение: `Y` — разрешить, иначе — отмена.
+
+Выход: `exit`.