README.md

metadata

title: Chép Lời Tiếng Việt
emoji: 🎙️
colorFrom: blue
colorTo: gray
sdk: gradio
sdk_version: 5.44.1
app_file: app.py
pinned: false

Chép lời tiếng Việt — ZipFormer-150M fine-tuned

Cách deploy

1. Vào https://huggingface.co/new-space, đặt tên, chọn SDK: Gradio, Hardware: CPU basic (miễn phí). Tạo Space.

2. Clone Space vừa tạo về máy (hoặc dùng "Upload files" trên web):

   git clone https://huggingface.co/spaces/<ten-user>/<ten-space>
   cd <ten-space>
   

3. Copy app.py, requirements.txt, README.md (file này) vào đó.

4. Upload checkpoint đã fine-tune. Có 2 cách:

   Cách A — khuyên dùng (tránh giới hạn 1GB private storage của Space): Tạo 1 Model repo riêng, để Public, tại https://huggingface.co/new (chọn "Model", không phải "Space"). Upload zipformer_best.pt (tải từ Drive ZipFormer_FineTuned/zipformer_best.pt) lên đó qua tab Files, giống hệt cách upload vào Space. Repo Public không bị giới hạn 1GB. Sau đó, vào Space → tab Settings → Variables and secrets → thêm biến FINETUNED_REPO với giá trị là <tên-tài-khoản>/<tên-model-repo> (ví dụ minh/zipformer-best-vi). Lưu lại, Space tự restart và app sẽ tự tải checkpoint từ đó.

   Cách B — nếu Space đã để Public: upload thẳng checkpoints/zipformer_best.pt vào Space như file khác (không bị giới hạn 1GB vì đó chỉ áp dụng cho repo Private).

5. Space sẽ tự build (vài phút, do phải tải model gốc + clone Icefall). Xong sẽ có link cố định dạng https://huggingface.co/spaces/<ten-user>/<ten-space> — mở bất cứ lúc nào, không cần chạy Colab.

Lưu ý

• Nếu chưa upload checkpoints/zipformer_best.pt, trang vẫn chạy được nhưng dùng model gốc chưa fine-tune (có cảnh báo trên giao diện).
• Hardware CPU basic miễn phí có thể ngủ sau một thời gian không ai dùng; lần mở lại đầu tiên sẽ chậm hơn (phải nạp lại model). Nếu cần phản hồi nhanh và ổn định, nâng cấp Space lên hardware có GPU (trả phí).
• Nếu muốn cập nhật checkpoint sau này (fine-tune tiếp), chỉ cần git add checkpoints/zipformer_best.pt && git commit && git push lại.