README.md

---
title: Text To Image Vietnamese
emoji: 🌖
colorFrom: purple
colorTo: gray
sdk: gradio
sdk_version: 5.31.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: Tạo ảnh từ mô tả văn bản bằng tiếng Việt
---

# 🧠 Text-to-Image Vietnamese with Stable Diffusion

Tạo ảnh từ văn bản mô tả bằng mô hình **Stable Diffusion** và giao diện người dùng Gradio. Ứng dụng này sử dụng thư viện `diffusers` của Hugging Face để chạy mô hình tạo ảnh từ mô tả văn bản, có thể áp dụng cho các mục đích như tạo dữ liệu huấn luyện cho OCR, thiết kế hình ảnh sáng tạo, v.v.

---

## 🚀 Demo nhanh

Truy cập Space: [https://huggingface.co/spaces/vanhai123/text-to-image-vietnamese](https://huggingface.co/spaces/vanhai123/text-to-image-vietnamese) *(ví dụ)*

---

## 📦 Cài đặt

```bash
pip install diffusers transformers accelerate gradio
```

---

## ▶️ Cách chạy (local hoặc Colab)

```bash
python app.py
```

Hoặc nếu chạy trong Jupyter/Colab, có thể thêm:

```python
from huggingface_hub import login
login()  # Nhập token Hugging Face của bạn nếu cần
```

---

## 📜 Ví dụ prompt đầu vào

* `handwritten Vietnamese text on white paper`
* `bold black Vietnamese text on wooden background`
* `printed text in Vietnamese using red ink on lined notebook`
* `neon sign in Vietnamese glowing in the dark`

> ⚠️ Prompt nên viết bằng tiếng Anh để mô hình hiểu tốt hơn. Có thể sử dụng từ khóa mô tả kiểu chữ, màu, chất liệu nền.

---

## ⚙️ Tham số mặc định

* `num_inference_steps = 30`
* `guidance_scale = 7.5`
* Pipeline: `runwayml/stable-diffusion-v1-5`

Bạn có thể sửa trong file `app.py` để điều chỉnh chất lượng và tốc độ.

---

## 🖼 Ảnh mẫu

*Hãy thêm một vài ảnh minh họa đầu ra tại đây nếu bạn deploy lên Spaces.*

---

## 📚 Tài liệu tham khảo

* [Hugging Face Diffusers Documentation](https://huggingface.co/docs/diffusers/index)
* [Stable Diffusion Paper (Rombach et al., 2022)](https://arxiv.org/abs/2112.10752)
* [Gradio Docs](https://gradio.app/)

---