🎙️ ViWhisper - Ứng dụng Speech-to-Text & Tóm tắt Hội thoại

ViWhisper là một hệ thống ứng dụng AI cung cấp khả năng chuyển đổi giọng nói tiếng Việt thành văn bản (Speech-to-Text) và tự động tóm tắt nội dung cuộc họp/hội thoại bằng mô hình ngôn ngữ lớn (LLM).

Đồ án được phát triển dựa trên mô hình PhoWhisper-medium của VinAI và mô hình Google Gemini 2.5 Flash.

🌟 Tính năng chính

• Chuyển đổi Giọng nói: Upload file âm thanh/video và nhận lại văn bản phiên mã tiếng Việt chính xác cao.
• Tóm tắt Thông minh: Tự động trích xuất các ý chính, kết luận và hành động từ đoạn hội thoại bằng AI.
• Quản lý Tài khoản & Phân quyền: Hỗ trợ đăng ký/đăng nhập an toàn bằng mã hóa Bcrypt và JWT.
• Thanh toán Trực tuyến: Tích hợp cổng thanh toán PayOS để nâng cấp gói dịch vụ (Tier: Basic/Pro).
• Thiết kế Giao diện Hiện đại: Giao diện tối (Dark mode) phong cách với ReactJS và Tailwind CSS.

🛠️ Công nghệ sử dụng

Frontend

• ReactJS + Vite: Framework giao diện tốc độ cao.
• Tailwind CSS: Định dạng và thiết kế giao diện Responsive.
• React Router: Quản lý đa trang và xử lý callback thanh toán.
• Axios: Giao tiếp HTTP với Backend.

Backend

• Python + FastAPI: Máy chủ API hiệu năng cao, bất đồng bộ (ASGI).
• SQLAlchemy ORM: Quản lý cơ sở dữ liệu quan hệ bảo mật chống SQL Injection.
• PostgreSQL / SQLite: Lưu trữ thông tin người dùng, lịch sử và giao dịch.
• ThreadPoolExecutor: Cơ chế Failover tự động chuyển đổi API Key khi gặp sự cố timeout.

Trí tuệ Nhân tạo (AI)

• PhoWhisper (Medium): Xử lý âm thanh và nhận diện tiếng Việt.
• Google Gemini (2.5 Flash): Tóm tắt văn bản NLP.

🚀 Hướng dẫn Cài đặt & Chạy cục bộ

1. Backend (FastAPI)

# Di chuyển vào thư mục backend
cd app

# Cài đặt môi trường ảo và thư viện
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

# Thiết lập file .env

# Chạy Server
uvicorn main:app --reload --port 8000

2. Frontend (React + Vite)

# Di chuyển vào thư mục frontend
cd frontend

# Cài đặt Node modules
npm install


# Thiết lập file .env

# Chạy Server phát triển
npm run dev

🌍 Triển khai (Deployment)

Dự án hiện đã được triển khai trực tuyến, bạn có thể truy cập bằng các thông tin dưới đây:

1. Frontend (Vercel)

• Link truy cập: https://viwhisper-123.vercel.app/
• Giao diện đã được xây dựng hoàn chỉnh và host trực tiếp trên Vercel.

2. Backend (Ngrok)

Để Frontend trên Vercel có thể gọi được API tới máy chủ cục bộ (Backend) của bạn, hãy sử dụng ngrok để Public cổng 8000.

# Chạy lệnh ngrok với domain cố định
ngrok http --domain=emporium-excavator-borrower.ngrok-free.dev 8000

• Base URL API lúc này sẽ là: https://emporium-excavator-borrower.ngrok-free.dev (Lưu ý: Bạn cần cấu hình biến môi trường VITE_API_URL trên Vercel trỏ về đường link ngrok này)