---
title: Seminarchuyende
emoji: 🌍
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

# ĐỒ ÁN SEMINAR CHUYÊN ĐỀ  
**XÂY DỰNG TRỢ LÝ PHÂN LOẠI CẢM XÚC TIẾNG VIỆT SỬ DỤNG TRANSFORMER**

**Sinh viên thực hiện**: Nguyễn Hoàng Hải Nam  
**MSSV**: 3121410332  
**Lớp**: DCT1212  
**Giảng viên hướng dẫn**: PGS.TS Nguyễn Tuấn Đăng  
**Khoa Công nghệ Thông tin – Trường Đại học Sài Gòn**  
**Tháng 12/2025**
**Live Demo**: https://huggingface.co/spaces/HaiNam0305/seminarchuyende

---

### Mô tả dự án

Dự án xây dựng một trợ lý web tương tác có khả năng phân loại cảm xúc tiếng Việt theo 3 nhãn:  
**Positive – Negative – Neutral**  
sử dụng mô hình Transformer **ViSoBERT** (`5CD-AI/Vietnamese-Sentiment-visobert`) đã được fine-tune trên dữ liệu tiếng Việt.

### Tính năng chính
- Nhập văn bản tối đa 50 ký tự (hỗ trợ slang, teencode, viết tắt phổ biến)
- Tiền xử lý tiếng Việt thông minh (underthesea + từ điển thay thế thủ công)
- Phân loại tức thì kèm độ tin cậy (confidence %)
- Lưu trữ và hiển thị lịch sử phân loại
- Giao diện thân thiện, responsive, hoạt động mượt mà trên cả mobile và desktop
- Triển khai hoàn toàn miễn phí trên Hugging Face Spaces (Docker)

---

### Công nghệ & thư viện sử dụng

| Thành phần            | Công nghệ / Thư viện                                       |
|-----------------------|------------------------------------------------------------|
| Mô hình chính         | `5CD-AI/Vietnamese-Sentiment-visobert` (ViSoBERT)          |
| Xử lý tiếng Việt      | `underthesea==6.8.0`                                       |
| Backend               | Flask + Gunicorn                                           |
| Database              | SQLite (`history.db`)                                      |
| Frontend              | HTML5 + CSS3 + Vanilla JavaScript                          |
| Deploy                | Hugging Face Spaces (Docker SDK)                           |
| Các thư viện khác     | transformers, torch, numpy, accelerate, tqdm               |

---

### Cấu trúc thư mục
seminarchuyende/
├── app.py                  # Flask app + API endpoints
├── app_backend.py          # Model loading, preprocessing, database
├── Dockerfile              # Docker image cho Hugging Face Spaces
├── requirements.txt        # Dependencies
├── README.md
├── html/
│   └── index.html          # Trang giao diện chính
└── static/
├── css/style.css
└── js/script.js

---

### Hướng dẫn chạy local (nếu cần)

```bash
git clone https://huggingface.co/spaces/HaiNam0305/seminarchuyende
cd seminarchuyende
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# Chạy server
gunicorn -b 127.0.0.1:7860 app:app