diff --git a/README.md b/README.md
index f6e3a59..37c7d50 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,25 @@
-# task-69de7223f309a98be0007e09
+# Deep research agent (deep agents from scratch)
 
+Самописный поисковый агент по мотивам [4_full_agent.ipynb](https://github.com/langchain-ai/deep-agents-from-scratch/blob/main/notebooks/4_full_agent.ipynb).
+
+## Возможности
+
+- Поиск в интернете: `web_search` (Tavily), `get_page_content`
+- Виртуальные файлы: `write_file` / `read_file` (deepagents + `LocalShellBackend`)
+- Экспорт на диск: `export_virtual_files` → папка `./output`
+
+## Запуск
+
+```bash
+pip install -r requirements.txt
+# .env: OPENAI_API_KEY, TAVILY_API_KEY (опционально OPENAI_BASE_URL)
+python main.py "ваш исследовательский запрос"
+```
+
+## Структура
+
+| Файл | Описание |
+|------|----------|
+| `main.py` | Сборка deep-агента и запуск |
+| `web_tools.py` | Поиск в сети |
+| `export_tools.py` | Выгрузка `agent_workspace/` → `output/` |