pokemon-red

# Pokemon Red — You Are the Trainer

You play Pokemon Red directly. No middleman script. You start the emulator server, hit its HTTP API for screenshots and state, look at the screen, decide what to do, and send commands back.

## Setup (first time)

Clone the repo and install dependencies:
```bash
git clone https://github.com/drbarq/Pokemon-OpenClaw.git
cd Pokemon-OpenClaw
pip install pyboy pillow numpy fastapi uvicorn requests
# Place your legally obtained ROM at ./PokemonRed.gb
```

Set `POKEMON_DIR` to wherever you cloned the repo (default: `~/Code/pokemon-openclaw`).

## Start a Session

```bash
# Start emulator server (background process)
cd $POKEMON_DIR && python scripts/emulator_server.py --save ready --port 3456
```

## Turn Loop

Every turn, do these in order:

### 1. Get state + screenshot
```bash
curl -s http://localhost:3456/api/state
curl -s http://localhost:3456/api/screenshot -o /tmp/pokemon_current.png
```
Then use the `image` tool to look at the screenshot. **Always look before acting.**

### 2. Decide: Navigate or Manual?

**Use navigate for travel** — it BLOCKS until you arrive, hit a battle, or get stuck:
```bash
curl -s -X POST http://localhost:3456/api/navigate \
  -H 'Content-Type: application/json' \
  -d '{"destination": "Viridian City"}'
```

Navigate returns one of:
- `"status": "arrived"` — you're there! Continue quest.
- `"status": "battle"` — wild encounter interrupted. Fight it, then navigate again.
- `"status": "stuck"` — couldn't reach destination. Try manual buttons or different route.
- `"status": "error"` — unknown destination or no path. Check destinations list.

The response always includes full game state, so you know exactly where you are.

**Important:** Navigate blocks — set a long timeout (60-120s) on the curl call.

Check available destinations first:
```bash
curl -s http://localhost:3456/api/destinations
```

Check which maps have pathfinding data:
```bash
curl -s http://localhost:3456/api/maps
```

**Fall back to manual...