From dfc7d9a98279b9755b9e48e7e2b144c5d7eac21b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=A0=D0=B8=D0=BD=D0=B0=D1=80=20=D0=9C=D0=B8=D1=80=D0=B7?=
 =?UTF-8?q?=D0=B0=D0=B3=D0=B8=D1=82=D0=BE=D0=B2?= <mirzagitov03@mail.ru>
Date: Mon, 18 May 2026 10:52:24 +0000
Subject: [PATCH] Update README.md

---
 README.md | 39 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 37 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 4e4a824..8884f50 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,40 @@
 # Stream-режим AI-агента
 
-Решение создано агентом smart_student.
+Минимальный пример AI-agent с потоковой выдачей ответа.
 
-См. файлы проекта и инструкции запуска в репозитории.
+## Что внутри
+
+- `stream_agent.py` - агент с синхронным и потоковым режимом.
+- `test_stream_agent.py` - быстрые проверки stream-логики без внешнего API.
+- `requirements.txt` - зависимости для запуска.
+
+## Установка
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+## Запуск
+
+Оффлайн-режим без ключей:
+
+```bash
+python stream_agent.py "Объясни, что такое stream режим"
+```
+
+С OpenAI-compatible API:
+
+```bash
+export OPENAI_API_KEY=your_key
+export OPENAI_BASE_URL=https://openrouter.ai/api/v1
+export OPENAI_MODEL=openai/gpt-oss-20b:free
+python stream_agent.py "Напиши короткий план проекта"
+```
+
+## Тесты
+
+```bash
+python -m pytest
+```