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
+```