README_EN.md

---
title: ColorLinkPuzzle
emoji: 🟧
colorFrom: red
colorTo: purple
sdk: static
license: mit
pinned: false
---

# Color Link Puzzle

## Demo
[ColorLinkPuzzle](https://huggingface.co/spaces/miya3333/ColorLinkPuzzle)

## Overview
This is a match-style puzzle game where you link four or more tiles of the same color in a straight line horizontally, vertically, or diagonally to clear them.

You can swap adjacent tiles in the four directions. When a match is formed, the tiles are cleared automatically and your score increases. Emptied cells are refilled with new tiles falling from above.

With the AI Auto-Play feature, you can let the AI play entirely or partially. You can also adjust the AI play speed via a slider.

Both Dark and Light modes are supported.

## Future Prospects
1. Add LLM-driven auto play and a performance evaluation feature
2. Improve AI strength
3. Add versus modes against AI and human players
4. Enhance sound effects, animations, and graphics
5. Add online multiplayer
6. Add difficulty settings

## Tech Stack
### LLM
Used gpt-oss-120b for code generation. Parameters used:

| Item | Value |
|------|-------|
| **LLM** | [gpt-oss-120b](https://console.groq.com/playground?model=openai/gpt-oss-120b) |
| **Reasoning** | medium |
| **Max Completion Tokens** | 8192 |

### Frontend
HTML / CSS / JavaScript

## License
MIT License

## Developer
miya

- Hugging Face: [miya3333](https://huggingface.co/miya3333)
- X: [@miya00907380](https://x.com/miya00907380)