TDN-M commited on
Commit
df618ae
·
1 Parent(s): 9060cc7
Files changed (4) hide show
  1. .env.example +10 -0
  2. API_SETUP.md +169 -0
  3. app.py +7 -0
  4. requirements.txt +5 -1
.env.example ADDED
@@ -0,0 +1,10 @@
 
 
 
 
 
 
 
 
 
 
 
1
+ # Hugging Face Token - Bắt buộc cho TTS
2
+ HF_TOKEN=your_huggingface_token_here
3
+
4
+ # Cách lấy HF_TOKEN:
5
+ # 1. Đăng ký tại https://huggingface.co
6
+ # 2. Vào Settings > Access Tokens
7
+ # 3. Tạo token mới với quyền "Read"
8
+ # 4. Copy token và paste vào đây
9
+
10
+ # Lưu ý: Đổi tên file này thành .env và điền token thật
API_SETUP.md ADDED
@@ -0,0 +1,169 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # 🔑 Hướng Dẫn Thiết Lập API cho Dự Án Voff
2
+
3
+ ## 📋 Tổng Quan API Cần Thiết
4
+
5
+ ### 1. **Hugging Face Token** (BẮT BUỘC)
6
+ - **Mục đích**: Tải model viXTTS để chuyển đổi text thành speech
7
+ - **Mức độ**: 🔴 **BẮT BUỘC** - Không có sẽ không chạy được TTS
8
+ - **Chi phí**: 🆓 **MIỄN PHÍ**
9
+
10
+ ### 2. **TensorArt API** (TÙY CHỌN)
11
+ - **Mục đích**: Tạo ảnh từ text để làm video
12
+ - **Mức độ**: 🟡 **TÙY CHỌN** - Chỉ cần khi tạo video
13
+ - **Chi phí**: 💰 **TRẢ PHÍ**
14
+
15
+ ### 3. **RSS Feeds** (TỰ ĐỘNG)
16
+ - **Mục đích**: Lấy tin thể thao từ các nguồn
17
+ - **Mức độ**: 🟢 **TỰ ĐỘNG** - Không cần setup
18
+ - **Chi phí**: 🆓 **MIỄN PHÍ**
19
+
20
+ ---
21
+
22
+ ## 🚀 Hướng Dẫn Thiết Lập Chi Tiết
23
+
24
+ ### Bước 1: Thiết Lập Hugging Face Token
25
+
26
+ #### 1.1. Tạo tài khoản Hugging Face
27
+ 1. Truy cập: https://huggingface.co
28
+ 2. Nhấn **Sign Up** và tạo tài khoản miễn phí
29
+ 3. Xác nhận email
30
+
31
+ #### 1.2. Tạo Access Token
32
+ 1. Đăng nhập vào Hugging Face
33
+ 2. Nhấn vào avatar (góc phải) → **Settings**
34
+ 3. Chọn **Access Tokens** từ menu bên trái
35
+ 4. Nhấn **New token**
36
+ 5. Điền thông tin:
37
+ - **Name**: `voff-tts-token`
38
+ - **Role**: `Read` (đủ cho việc tải model)
39
+ 6. Nhấn **Generate a token**
40
+ 7. **QUAN TRỌNG**: Copy token ngay lập tức (chỉ hiển thị 1 lần)
41
+
42
+ #### 1.3. Cấu hình Token
43
+ 1. Tạo file `.env` trong thư mục dự án:
44
+ ```bash
45
+ # Tạo file .env
46
+ copy .env.example .env
47
+ ```
48
+
49
+ 2. Mở file `.env` và thay thế:
50
+ ```env
51
+ HF_TOKEN=hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
52
+ ```
53
+
54
+ ### Bước 2: Thiết Lập TensorArt API (Tùy chọn)
55
+
56
+ #### 2.1. Đăng ký TensorArt
57
+ 1. Truy cập: https://tensorart.net
58
+ 2. Tạo tài khoản
59
+ 3. Vào **API Settings** để lấy API key
60
+
61
+ #### 2.2. Cấu hình API Key
62
+ Thêm vào file `.env`:
63
+ ```env
64
+ api_key_token=your_tensorart_api_key_here
65
+ ```
66
+
67
+ ---
68
+
69
+ ## 🔧 Cài Đặt Dependencies
70
+
71
+ ### Cài đặt packages cần thiết:
72
+ ```bash
73
+ pip install -r requirements.txt
74
+ ```
75
+
76
+ ### Nếu gặp lỗi, cài từng package:
77
+ ```bash
78
+ # Core packages
79
+ pip install python-dotenv
80
+ pip install gradio==4.36.1
81
+ pip install TTS>=0.22.0
82
+ pip install torch torchaudio
83
+ pip install huggingface-hub
84
+
85
+ # Vietnamese processing
86
+ pip install vinorm==2.0.7
87
+ pip install underthesea
88
+
89
+ # Web scraping
90
+ pip install requests feedparser beautifulsoup4
91
+
92
+ # Image/Video processing
93
+ pip install Pillow opencv-python moviepy
94
+ ```
95
+
96
+ ---
97
+
98
+ ## ✅ Kiểm Tra Cấu Hình
99
+
100
+ ### Test script để kiểm tra API:
101
+ ```python
102
+ import os
103
+ from dotenv import load_dotenv
104
+
105
+ # Load environment variables
106
+ load_dotenv()
107
+
108
+ # Kiểm tra Hugging Face Token
109
+ hf_token = os.getenv("HF_TOKEN")
110
+ if hf_token:
111
+ print("✅ Hugging Face Token: OK")
112
+ print(f"Token: {hf_token[:10]}...")
113
+ else:
114
+ print("❌ Hugging Face Token: MISSING")
115
+
116
+ # Kiểm tra TensorArt API (tùy chọn)
117
+ api_token = os.getenv("api_key_token")
118
+ if api_token:
119
+ print("✅ TensorArt API: OK")
120
+ else:
121
+ print("⚠️ TensorArt API: MISSING (tùy chọn)")
122
+ ```
123
+
124
+ ---
125
+
126
+ ## 🚨 Xử Lý Lỗi Thường Gặp
127
+
128
+ ### Lỗi 1: "HF_TOKEN not found"
129
+ **Nguyên nhân**: Chưa thiết lập Hugging Face token
130
+ **Giải pháp**:
131
+ 1. Kiểm tra file `.env` có tồn tại không
132
+ 2. Kiểm tra token có đúng format không
133
+ 3. Restart ứng dụng sau khi thêm token
134
+
135
+ ### Lỗi 2: "Model download failed"
136
+ **Nguyên nhân**: Token không có quyền hoặc mạng chậm
137
+ **Giải pháp**:
138
+ 1. Kiểm tra token có quyền "Read" không
139
+ 2. Thử download lại
140
+ 3. Kiểm tra kết nối mạng
141
+
142
+ ### Lỗi 3: "Image generation failed"
143
+ **Nguyên nhân**: TensorArt API không hoạt động
144
+ **Giải pháp**:
145
+ 1. Kiểm tra API key
146
+ 2. Kiểm tra credit trong tài khoản
147
+ 3. Tính năng này là tùy chọn, có thể bỏ qua
148
+
149
+ ---
150
+
151
+ ## 📊 Chi Phí Ước Tính
152
+
153
+ | Dịch vụ | Chi phí | Mục đích | Bắt buộc |
154
+ |---------|---------|----------|----------|
155
+ | Hugging Face | 🆓 Miễn phí | TTS Model | ✅ Có |
156
+ | TensorArt | ~$0.01/ảnh | Tạo ảnh | ❌ Không |
157
+ | RSS Feeds | 🆓 Miễn phí | Tin thể thao | ✅ Có |
158
+
159
+ **Tổng chi phí tối thiểu**: **$0** (chỉ cần Hugging Face miễn phí)
160
+
161
+ ---
162
+
163
+ ## 🎯 Kết Luận
164
+
165
+ - **Để chạy TTS**: Chỉ cần Hugging Face Token (miễn phí)
166
+ - **Để tạo video**: Cần thêm TensorArt API (trả phí)
167
+ - **Để lấy tin thể thao**: Tự động, không cần setup
168
+
169
+ **Bắt đầu ngay**: Chỉ cần thiết lập Hugging Face Token là có thể sử dụng được 80% tính năng!
app.py CHANGED
@@ -22,6 +22,13 @@ import requests
22
  import json
23
  import hashlib
24
 
 
 
 
 
 
 
 
25
  # Download for mecab
26
  os.system("python -m unidic download")
27
 
 
22
  import json
23
  import hashlib
24
 
25
+ # Load environment variables
26
+ try:
27
+ from dotenv import load_dotenv
28
+ load_dotenv()
29
+ except ImportError:
30
+ print("Warning: python-dotenv not installed. Using system environment variables only.")
31
+
32
  # Download for mecab
33
  os.system("python -m unidic download")
34
 
requirements.txt CHANGED
@@ -30,8 +30,12 @@ feedparser>=6.0.10
30
  beautifulsoup4>=4.11.0
31
  lxml>=4.9.0
32
 
 
 
 
33
  # Utilities
34
  anyio>=3.6.0
35
  groq
36
  numpy>=1.21.0
37
- pandas>=1.5.0
 
 
30
  beautifulsoup4>=4.11.0
31
  lxml>=4.9.0
32
 
33
+ # Environment variables
34
+ python-dotenv>=1.0.0
35
+
36
  # Utilities
37
  anyio>=3.6.0
38
  groq
39
  numpy>=1.21.0
40
+ pandas>=1.5.0
41
+ hashlib2>=1.3.1