---
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):
   ```bash
   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.