README.md

---
title: CapyCap Mouse Movement Dataset Demo
emoji: 🐹
colorFrom: yellow
colorTo: yellow
sdk: static
pinned: false
license: mit
---

# CapyCap Mouse Movement Dataset - Demo & Replay

This space lets you:

1. **Replay samples** from the [CaptchaSolve dataset](https://huggingface.co/datasets/Capycap-AI/CaptchaSolve30k) to visualize mouse movements
2. **Play the games** yourself and export your session data in the same format

## Usage

### Replay Mode
- Paste JSON from the dataset or upload a JSONL file
- Use playback controls to watch the mouse movement replay
- Navigate between multiple sessions if you load a JSONL file

### Play Mode
- Select a game type (Sheep Herding, Thread the Needle, or Polygon Stacking)
- Click "Start Game" and solve the puzzle using your mouse
- After completion, copy or download the exported session JSON

## Dataset Format

Each session contains:
- `tickInputs`: Array of `{x, y, isDown, sampleIndex}` at 240 Hz physics rate
- `inputStream`: Base64-encoded 1000 Hz mouse sampling (for biometric analysis)
- `gameType`: One of `sheep-herding`, `thread-the-needle`, `polygon-stacking`
- `duration`: Session length in milliseconds
- `physicsTickCount`: Total physics ticks

## Links

- [Dataset on HuggingFace](https://huggingface.co/datasets/Capycap-AI/CaptchaSolve30k)
- [CapyCap Website](https://capycap.com)