diff --git a/README.md b/README.md
index b8f1f91..4d1f8fe 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,33 @@
-# task-69de7223f309a98be0007e09
+# Самописный поисковый deep agent
 
-Deep search agent with virtual FS export
\ No newline at end of file
+На основе [deep agents from scratch](https://github.com/langchain-ai/deep-agents-from-scratch/blob/main/notebooks/4_full_agent.ipynb).
+
+## Возможности
+
+- Поиск в интернете: `web_search` (Tavily или DuckDuckGo)
+- Чтение страниц: `get_page_content`
+- Виртуальная ФС: `write_file`, `read_file`, `ls` (deepagents)
+- Экспорт в `output/` после завершения работы
+
+## Установка
+
+```bash
+pip install -r requirements.txt
+```
+
+`.env`:
+
+```env
+OPENAI_API_KEY=sk-or-...
+OPENROUTER_MODEL=poolside/laguna-m.1:free
+TAVILY_API_KEY=...   # опционально
+```
+
+## Запуск
+
+```bash
+python main.py
+python main.py "Обзор LangGraph для начинающих"
+```
+
+Файлы агента: `workspace/`, экспорт: `output/`.