Update README.md

README.md

@@ -1,12 +1,34 @@
----
-title: Hunyuan MT 7B CPU
-emoji: 🧠
-colorFrom: red
-colorTo: blue
-sdk: gradio
-sdk_version: 5.45.0
-app_file: app.py
-pinned: false
-license: apache-2.0
-hardware: cpu-basic
----
+# Hunyuan-MT Translation (Hugging Face Space - Free CPU)
+
+**Demo dịch đa ngôn ngữ** dùng mô hình **Tencent Hunyuan-MT** thông qua **Hugging Face Serverless Inference API**, chạy được trên **Space CPU (free)** — không cần GPU.
+
+## Tính năng
+- Chọn mô hình:
+  - `tencent/Hunyuan-MT-7B-fp8` (khuyến nghị cho serverless)
+  - `tencent/Hunyuan-MT-7B`
+- Hỗ trợ 30+ ngôn ngữ (bao gồm `zh`, `zh-Hant`, `yue`, `en`, `vi`, v.v.).
+- Prompt tuân theo hướng dẫn của model card:
+  - **ZH <=> XX**: `把下面的文本翻译成<target_language>，不要额外解释。`
+  - **XX <=> XX**: `Translate the following segment into <target_language>, without additional explanation.`
+
+## Triển khai
+1. Tạo Space mới (Python) trên Hugging Face và chọn **Hardware: CPU Basic (Free)**.
+2. Tải 3 file: `app.py`, `requirements.txt`, `README.md` vào repo Space.
+3. (Tùy chọn) Vào **Settings → Repository secrets** tạo secret:
+   - `HF_TOKEN`: token của bạn để tăng hạn mức Inference API.
+4. Bấm **Restart** Space sau khi commit.
+
+## Biến môi trường (tùy chọn)
+- `HYMT_MODEL`: đổi mô hình mặc định (mặc định: `tencent/Hunyuan-MT-7B-fp8`).
+- `HF_TOKEN`: token truy cập Hugging Face (khuyên dùng để tránh rate-limit ẩn danh).
+
+## Ghi chú kỹ thuật
+- Ứng dụng gọi **Serverless Inference API** qua `huggingface_hub.InferenceClient.text_generation(...)` nên **không cần** tải checkpoint nặng về máy.
+- Nếu bạn muốn **tự tải model** và suy luận nội bộ:
+  - Cần GPU; trên CPU free sẽ không đủ bộ nhớ/tốc độ.
+  - Tham khảo phần “Use with transformers” trong model card.
+
+## Nguồn tham khảo
+- Model card Hunyuan-MT-7B-fp8 trên Hugging Face. 0
+- Bộ sưu tập Hunyuan-MT (các biến thể 7B, fp8, Chimera) trên Hugging Face. 1
+- Repo GitHub chính thức Hunyuan-MT (hướng dẫn & prompt). 2