Update README.md

2026-06-02 07:04:16 +00:00
parent 4cf97431a8
commit 83b95f9d38
1 changed files with 41 additions and 2 deletions
@@ -1,3 +1,42 @@
-# task-69de7223f309a98be0007e09
+# Deep Agent – Search + Virtual Files

-8. Самописный поисковый агент на основе deep agents from scratch
+This repository contains a minimal **deep agent** implementation based on the
+"Deep Agents from Scratch" course.  The agent can:
+
+1. Search the web (simple Bing wrapper).
+2. Create and modify files in an **in‑memory virtual file system**.
+3. Read those virtual files.
+4. Dump the virtual file system to the real disk at the end of the run.
+
+## Setup
+
+```bash
+# Create a virtual environment (optional but recommended)
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+
+# Install dependencies
+pip install -r requirements.txt
+```
+
+> **Prerequisite** – An Ollama server must be running locally with a model
+> such as `llama3.1` available.
+
+## Usage
+
+```bash
+python agent.py
+```
+
+You will be prompted to type questions.  The agent will decide which tool to
+use.  When you are finished, type `exit`.
+
+The virtual files are stored in memory.  To persist them, use the `DumpVirtualFS`
+tool or call `dump_virtual_fs_tool("output")` from within the agent.
+
+## Files
+
+- `agent.py` – Main agent implementation.
+- `virtual_fs.py` – Simple in‑memory file system.
+- `requirements.txt` – Python dependencies.
+- `README.md` – This documentation.