From a4ea978f84df5e8aed31b977b56914a084c367ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=9A=D0=B8=D1=80=D0=B8=D0=BB=D0=BB=20=D0=9A=D1=83=D1=82?=
 =?UTF-8?q?=D0=BB=D0=B0=D1=85=D0=BC=D0=B5=D1=82=D0=BE=D0=B2?=
 <kirillkutlahmetov10@gmail.com>
Date: Tue, 26 May 2026 12:40:30 +0000
Subject: [PATCH] add README.md

---
 README.md | 71 +++++++------------------------------------------------
 1 file changed, 9 insertions(+), 62 deletions(-)

diff --git a/README.md b/README.md
index c8d4015..f5d6d2b 100644
--- a/README.md
+++ b/README.md
@@ -1,70 +1,17 @@
-# Deep Agent — поисковый агент с виртуальной ФС
+# DeepAgent Search
 
-Реализация **Deep Agent** на основе фреймворка `deepagents` (deep agents from scratch).
+This repository contains a simple deep agent that can search the web and create virtual files. The agent is built using the `deepagents` library and follows the "deep agents from scratch" pattern.
 
-## Что умеет агент
+## Features
 
-| Возможность | Инструмент |
-|-------------|------------|
-| Поиск в интернете | `web_search` (DuckDuckGo, без API-ключа) |
-| Создание файлов в виртуальной ФС | `write_file` |
-| Чтение и редактирование файлов | `read_file`, `edit_file` |
-| Выгрузка виртуальных файлов в реальную ФС | `export_virtual_files` |
+- Web search using DuckDuckGo.
+- Virtual file creation in an in‑memory filesystem.
+- Export virtual files to the real filesystem at the end of the run.
 
-## Архитектура
-
-```
-main.py
-├── LLM: ChatOpenAI → BroJS (openai/gpt-oss-20b:free)
-├── Backend: CompositeBackend
-│   ├── LocalShellBackend  (virtual_mode=True, root=./workspace/)
-│   └── FilesystemBackend  (virtual_mode=True, route=/fs/)
-└── Tools: web_search, export_virtual_files
-```
-
-Агент работает в **виртуальной ФС** (`./workspace/`). По завершении инструмент `export_virtual_files` копирует все созданные файлы в реальную папку `./output/`.
-
-## Установка
+## Usage
 
 ```bash
-pip install -r requirements.txt
+python main.py "search query"
 ```
 
-## Переменные окружения
-
-| Переменная | Описание |
-|------------|----------|
-| `JOURNAL_MCP_PAT` | Токен доступа к BroJS LLM |
-
-Создай файл `.env`:
-```
-JOURNAL_MCP_PAT=jrnl_...
-```
-
-## Запуск
-
-```bash
-# Запрос по умолчанию (исследование LangGraph)
-python main.py
-
-# Свой запрос
-python main.py "расскажи про LangChain агентов и сохрани в файл"
-```
-
-## Пример работы
-
-```
-Запрос: Найди информацию о LangGraph...
-
-=== Ответ агента ===
-Файл langgraph_research.md сохранён и выгружен в ./output/
-
-=== Файлы в output/ ===
-  langgraph_research.md (2847 байт)
-```
-
-## Источники
-
-- [deep-agents-from-scratch](https://github.com/langchain-ai/deep-agents-from-scratch)
-- [deepagents PyPI](https://pypi.org/project/deepagents/)
-- [LangChain docs](https://python.langchain.com/)
+The agent will perform the search, create virtual files, and write them to the current directory.