README.md

metadata

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:

pip install -r requirements.txt

3. Tạo folder models và upload các file .pth:

mkdir models
# Copy file .pth vào folder này

4. Chạy ứng dụng:

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
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 🚀