Getting started (first hour)

Alert-only claim ledger. You bring feeds + Discord webhook. No orders.

1. Clone / install deps

   git clone <your-fork-or-release> GuruWatcher
   cd GuruWatcher
   python3 -m venv .venv && source .venv/bin/activate
   pip install -r requirements.txt

2. Init portable data dir

   python3 -m guru_watcher init --data-dir ./gw-data
   export GURU_WATCHER_DATA="$(pwd)/gw-data"

3. Webhook (optional for dry-run)

   cp gw-data/.env.example gw-data/.env
   # Edit gw-data/.env — set GURU_WATCHER_DISCORD_WEBHOOK_URL only when ready for live

4. Add / edit a source — edit gw-data/config.yaml or gw-data/sources/example.yaml for your symbols (content you have rights to use).
5. Ingest once

   mkdir -p gw-data/drop
   # Drop a .md/.txt issue you own rights to into gw-data/drop/
   python3 -m guru_watcher ingest-run --adapter file_drop --data-dir "$GURU_WATCHER_DATA" --path drop --once

6. Dry-run check

   python3 -m guru_watcher check --dry-run

7. Optional Docker loop

   export GURU_WATCHER_HOST_DATA="$(pwd)/gw-data"
   export GURU_WATCHER_MODE=dry-run
   docker compose up --build

Full checklist, claim fence, and compose notes: GuruWatcher-Setup.md.