STT / README.md
macvinh's picture
Update README.md
1699d73 verified
|
Raw History Blame Contribute Delete
2.43 kB
---
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.