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)