python-agent

WarpGrep: Python Agent

A complete WarpGrep implementation in Python. No SDK needed — just requests and ripgrep.

This is the same protocol that the TypeScript SDK uses under the hood. Use this as a reference for building WarpGrep integrations in any language.

Prerequisites

• Python 3.10+
• ripgrep installed (brew install ripgrep / apt install ripgrep)

Setup

pip install -r requirements.txt

Run

MORPH_API_KEY=your-key python search.py

Search a specific repo:

MORPH_API_KEY=your-key python search.py "Find auth middleware" /path/to/repo

How it works

The agent runs a multi-turn conversation with the morph-warp-grep-v1 model:

1. Send the repo structure + search query to the API
2. Parse XML tool calls (<grep>, <read>, <list_directory>, <finish>) from the response
3. Execute tools locally using ripgrep and file reads
4. Format results as XML and send them back
5. Repeat until the model calls <finish> (max 4 turns)

Each component (API client, XML parser, tool executors, result formatter, agent loop) is clearly separated in the code.