# 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)