README.md

---
title: Arca Processor
emoji: 🔄
colorFrom: blue
colorTo: indigo
sdk: docker
app_file: app.py
pinned: false
---

# Arca Processor

Pre-computed champion stats generator for ArcaThread.

## Purpose

This space processes matchup-matrix parquet files from `arca-thread-priors` dataset and generates lightweight JSON files per champion.

## Output Structure

```
champ-stats/{patch}/{championId}.json
champ-stats/{patch}/tier-list.json
champ-stats/{patch}/meta.json
```

## Schedule

Runs hourly to detect new patches and update stats.

## Environment Variables

- `HF_TOKEN` - HuggingFace API token
- `DATASET_REPO` - Source dataset (default: ArcaThread/arca-thread-priors)
- `PROCESS_INTERVAL_SECONDS` - Processing interval in seconds (default: 3600, min 60)
- `MIN_SAMPLE_SIZE` - Minimum sample size for champion aggregation (default: 100)
- `DATASET_FILE_CACHE_SECONDS` - TTL for cached `list_repo_files` index (default: 300, min 30)
- `TIER_MIN_GAMES` - Minimum games for tier-list eligibility (default: 500)
- `TIER_CALIBRATION_MODE` - `quantile` (default) or `static`
- `TIER_STATIC_S_MIN_WR`, `TIER_STATIC_A_MIN_WR`, `TIER_STATIC_B_MIN_WR`, `TIER_STATIC_C_MIN_WR`
  - Used only when `TIER_CALIBRATION_MODE=static`