diff --git a/README.md b/README.md index c04a164..737edbe 100644 --- a/README.md +++ b/README.md @@ -1,42 +1,29 @@ -# Deep Agent – Search + Virtual Files +# Deep Agent from Scratch -This repository contains a minimal **deep agent** implementation based on the -"Deep Agents from Scratch" course. The agent can: +This repository contains a minimal implementation of a deep agent that 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. +1. Search the web using DuckDuckGo. +2. Create virtual files in memory. +3. Export the virtual files to the real file system. -## Setup +The agent is built using the new LangChain 1.x and LangGraph 1.x APIs. -```bash -# Create a virtual environment (optional but recommended) -python -m venv venv -source venv/bin/activate # Windows: venv\Scripts\activate +## Prerequisites -# Install dependencies -pip install -r requirements.txt -``` +- Python 3.11 or newer +- Ollama running locally with a model such as `llama3.1` +- `pip install -r requirements.txt` -> **Prerequisite** – An Ollama server must be running locally with a model -> such as `llama3.1` available. - -## Usage +## Running the Agent ```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 script will run the agent with a sample prompt, create a virtual file `report.txt`, and export it to the `exported_files` directory. -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. +## File Structure -## Files - -- `agent.py` – Main agent implementation. -- `virtual_fs.py` – Simple in‑memory file system. +- `agent.py` – Main implementation. - `requirements.txt` – Python dependencies. -- `README.md` – This documentation. +- `README.md` – This file. \ No newline at end of file