README.md

---
title: Water Sort Puzzle Solver
emoji: 🧪
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: "4.44.1"
app_file: app.py
pinned: false
license: mit
---

# Water Sort Puzzle Solver - Gradio App

Ứng dụng giải Water Sort Puzzle với AI sử dụng Gradio.

## Yêu cầu

- Python 3.8+
- PyTorch (GPU hoặc CPU)
- Gradio 4.0+

## Cài đặt

1. Clone repo hoặc tải file
2. Cài đặt dependencies:
```bash
pip install -r requirements.txt
```

3. Tạo folder `models` và upload các file `.pth`:
```bash
mkdir models
# Copy file .pth vào folder này
```

4. Chạy ứng dụng:
```bash
python app.py
```

5. Mở browser: http://localhost:7860

## Cách sử dụng

1. **Chọn Model**: Chọn model từ dropdown và click "Tải Model"
2. **Bắt đầu**: Click "Bắt đầu" để tạo game mới
3. **Di chuyển**: Click hai chai liên tiếp (chai nguồn → chai đích)
4. **Gợi ý**: Click "Gợi ý" để AI gợi ý nước đi tiếp theo
5. **Reset**: Click "Reset" để chơi lại

## Tính năng

- 🎮 Giao diện trực quan với Gradio
- 🤖 AI gợi ý nước đi tối ưu
- 📊 Hiển thị thống kê game (số bước, model, device)
- 💾 Hỗ trợ nhiều model khác nhau
- 🚀 Hỗ trợ GPU/CPU

## Model cần thiết

Đặt các file model trong folder `models/`:
- `watersort_imitation.pth` (từ Imitation Learning)
- `watersort_rl_model.pth` (từ Reinforcement Learning)
- Hoặc bất kỳ model nào khác

## Troubleshooting

### Model không load được
- Kiểm tra đường dẫn file model
- Kiểm tra định dạng file (phải là .pth)
- Kiểm tra dung lượng file (phải > 1KB)

## Deploy lên Hugging Face Spaces

1. Tạo repo mới trên [Hugging Face](https://huggingface.co/new)
2. Chọn **SDK: Docker** hoặc **SDK: Gradio**
3. Push code (bao gồm `app.py`, `config.py`, `utils.py`, `requirements.txt`)
4. Tự động deploy 🚀