GUIDE.md

# Hướng dẫn sử dụng Template HuggingFace Space
Template này được thiết kế để nhanh chóng xây dựng và triển khai một AIO Gradio demo trên HuggingFace Space.

## Cấu trúc thư mục
```
Folder/
├── .gitattributes (HuggingFace tự tạo khi tạo Space)
├── app.py
├── README.md (HuggingFace tự tạo khi tạo Space)
├── requirements.txt
├── ui_template.py
├── src/
└── static/
```

- `app.py`: Đây là file chính để chạy Gradio demo.
- `requirements.txt`: Liệt kê các thư viện Python cần thiết cho demo.
- `ui_template.py`: Chứa các hàm và CSS tùy chỉnh để tạo UI cho demo.
- `src/`: Chứa các code như mô hình.
- `static/`: Chứa các tài nguyên tĩnh như hình ảnh logo.

## Hướng dẫn sử dụng
1.  **Cập nhật `src`**:
    *   Xây dựng các hàm khởi tạo, định nghĩa mô hình hoặc các hàm liên quan khác.

2.  **Cập nhật `app.py`**:
    *   Thêm các hàm cần thiết như khởi tạo/gọi mô hình, xử lý đầu vào, ... tại vùng Functions.
    *   Có thể thêm các thành phần UI khác vào phần `gr.Blocks` nếu cần.
    *   **Quan trọng**: Không thay đổi các dòng liên quan đến `ui_template.create_header()`, `ui_template.create_footer()`, và `demo.launch()`.

3.  **Cập nhật `ui_template.py`**:
    *   Thay đổi giá trị của biến `PROJECT_NAME` thành tên dự án của bạn.
    *   Thay đổi giá trị của biến `AIO_YEAR` và `AIO_MODULE` cho phù hợp với thời điểm hiện tại.

4.  **Cập nhật `requirements.txt` và thêm `.gitignore`**:
    *   Thêm tất cả các thư viện Python cần thiết cho demo, mỗi thư viện trên một dòng và nên kèm theo phiên bản cụ thể. Ví dụ: `torch==1.0.0`.
    *   Tạo thêm file `.gitignore` nếu cần.

5.  **Linh hoạt với các file còn lại**

6.  **Chạy thử ở local trước khi deploy**
    *   Chạy lệnh sau trong Terminal:
    ```
    python Folder/app.py
    ```

Hết,
Koi (last edited: 22/7/2025)