---
title: e6 Visual Ratings
emoji: 🐾
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: "6.11.0"
app_file: app.py
pinned: false
---

# e621 Image Rater

Pairwise image quality voting for e621 images. Pairs are sampled from prebuilt group buckets.

## How it works

- The app loads `pool.parquet` at startup (from local `data/pool.parquet` in debug mode, or from the dataset repo in HF mode).
- Each round samples two items from the same `group`, then shows their image URLs and links to e621 post pages.
- Votes are buffered in memory, then flushed in batches to append-only parquet shards under `ratings_log/`.
- Local/debug mode defaults: flush every 3 votes or every 15 seconds.
- HF mode defaults: flush every 50 votes or every 300 seconds.

## Vote Log Schema

Each vote row stores:

- `vote_id`
- `timestamp` (ISO-8601 UTC)
- `md5a`
- `md5b`
- `winner_md5` (or `None` for tie)
- `url_a` and `url_b` (e621 post URLs)
- `dataset`
- `group`
- `session_id`