README.md

---
title: Set Solver
emoji: 🃏
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
---

# Set Solver

Real-time vision-based solver for the [Set card game](https://www.setgame.com/).

Point your phone camera at Set cards and get all valid Sets highlighted instantly.

![Example detection](./example-detection.PNG)

## How to Use

1. Open this Space on your phone or desktop browser
2. Grant camera access (rear camera preferred)
3. Press **Start** to begin scanning
4. The solver announces "Set!" and highlights found Sets
5. Use the arrows to cycle through multiple Sets
6. Press **Restart** to scan again

## Under the Hood

- **YOLOv11n** detector (99.5% mAP50) locates cards on the board
- **MobileNetV3** classifier (100% accuracy) reads each card's 4 attributes (shape, color, number, fill)
- Combinatorial solver finds all valid Sets in the detected cards