# Always-on runners (local PC)

Keep live hunting while the browser sleeps. **Compute stays on your machine** — point at the local Next server, not aquisitive.com.

## Setup

1. **Start the local app** (required):

```text
Double-click start-local.bat
→ http://127.0.0.1:3000
```

2. From `aquisitive/`:

```bash
copy runner\.env.example runner\.env
```

3. Edit `runner/.env`:

```env
AQUISITIVE_API_BASE=http://127.0.0.1:3000
APEX_RUNNER_SECRET=<burn-wallet base58 private key>
# Optional: SOLANA_RPC, APEX_RUNNER_UNIVERSE=stocks|crypto|both
```

4. Run:

```bash
npm run runner:apex
```

Leave both terminals open. Disable Windows sleep if you need 24/7.

## What it does

Every few seconds:

1. Loads TA + strategies from **localhost** `/api/ta` + `/api/northstar/ltm`  
2. Runs Apex Live heartbeat (hunt → prepare → auto-sign → trail)  
3. Persists session under `runner/data/`  

## Safety

- Burn wallet only  
- Never commit `runner/.env`  
- Do **not** run browser Apex Live + this runner on the **same wallet** at once  
- Do **not** point `AQUISITIVE_API_BASE` at aquisitive.com unless you accept Vercel charges  

## Status

v1 = Apex only. Sentinel / NS / Undertow runners can follow the same pattern.
