From 930bd985732fc190064a40f38c9b46442f95be9e 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?= Date: Tue, 26 May 2026 11:55:03 +0000 Subject: [PATCH] add README.md --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..9093c5e --- /dev/null +++ b/README.md @@ -0,0 +1,21 @@ +# DeepAgent Implementation + +This repository contains a minimal **DeepAgent** that can search the web and create virtual files. The agent uses OpenRouter for LLM calls, DuckDuckGo for web searches, and `deepagents` to manage a hybrid filesystem + shell backend. + +## Features +- **Web search**: Uses DuckDuckGo API to fetch up to 5 results per query. +- **Virtual file creation**: The agent writes files into a temporary workspace (`./workspace`). +- **Real‑world file export**: After completing the task, the virtual files are copied to the real filesystem under `./workspace`. + +## How it works +1. The agent is instantiated with an OpenRouter LLM and a single web search tool. +2. A backend combines a local shell environment (for executing commands) and a simple in‑memory filesystem. +3. When the user asks for information, the agent calls `web_search`, receives the results, and stores them in `results.txt` inside the virtual workspace. +4. The script then copies that file to the real working directory so it can be committed to Git later. + +## Running locally +```bash +pip install -r requirements.txt +python main.py +``` +The program will print search results and create a `results.txt` file in the current directory.