File size: 3,281 Bytes
23c518c
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
# Hướng dẫn Upload lên Hugging Face Space

## 📋 Các file cần thiết đã được tạo**app.py** - File chính của ứng dụng  
✅ **README.md** - Mô tả Space với metadata Hugging Face  
✅ **requirements.txt** - Dependencies cần thiết  
✅ **config.json** - Cấu hình Space  
✅ **.gitignore** - Loại trừ file không cần thiết  

## 🚀 Cách upload lên Hugging Face Space

### Phương pháp 1: Sử dụng Git (Khuyến nghị)

1. **Tạo Space mới trên Hugging Face:**
   - Truy cập: https://huggingface.co/new-space
   - Đặt tên: `your-username/finhigh` (thay your-username bằng tên của bạn)
   - Chọn SDK: Gradio
   - Chọn License: MIT
   - Tạo Space

2. **Clone Space về máy:**
   ```bash

   git clone https://huggingface.co/spaces/your-username/finhigh

   cd finhigh

   ```

3. **Copy files vào Space:**
   ```bash

   # Copy tất cả files từ FinHigh_HuggingFace_Upload/

   cp -r ../FinHigh_HuggingFace_Upload/* .

   ```

4. **Commit và push:**
   ```bash

   git add .

   git commit -m "Initial commit: FinHigh Stock Prediction App"

   git push

   ```

### Phương pháp 2: Upload trực tiếp

1. **Tạo Space mới trên Hugging Face**
2. **Upload từng file:**
   - Upload `app.py` làm file chính
   - Upload `requirements.txt`
   - Upload `README.md`
   - Upload `config.json` (nếu cần)

## ⚙️ Thiết lập API Keys

Sau khi upload, cần thiết lập các API keys trong Settings của Space:

1. **Vào Settings của Space**
2. **Thêm các Secrets:**
   - `FINNHUB_KEYS`: API keys cho Finnhub (phân cách bằng dòng mới)
   - `RAPIDAPI_KEYS`: API keys cho RapidAPI (phân cách bằng dòng mới)
   - `GOOGLE_API_KEYS`: API keys cho Google Generative AI (phân cách bằng dòng mới)

## 🔧 Cấu hình Space

- **Hardware**: CPU (đã cấu hình trong config.json)
- **Memory**: 2GB
- **Disk**: 10GB
- **SDK**: Gradio 4.44.0

## 📊 Kiểm tra sau khi upload

1. **Space sẽ tự động build** sau khi push code
2. **Kiểm tra logs** nếu có lỗi
3. **Test ứng dụng** với các ví dụ có sẵn
4. **Kiểm tra API keys** hoạt động đúng

## 🐛 Troubleshooting

### Lỗi thường gặp:

1. **Import Error**: Kiểm tra requirements.txt
2. **API Key Error**: Kiểm tra Secrets trong Settings
3. **Memory Error**: Tăng memory limit trong config.json
4. **Timeout Error**: Tối ưu code hoặc tăng timeout

### Giải pháp:

- Xem logs trong tab "Logs" của Space
- Kiểm tra file requirements.txt
- Đảm bảo API keys đúng format
- Test local trước khi upload

## 📝 Lưu ý quan trọng

- ✅ Code đã được tối ưu cho Hugging Face
- ✅ Dependencies đã được pin version
- ✅ README có metadata đúng format
- ✅ Config.json đã cấu hình sẵn
- ⚠️ Cần thiết lập API keys sau khi upload
- ⚠️ Test kỹ trước khi public

## 🔗 Liên kết hữu ích

- [Hugging Face Spaces Documentation](https://huggingface.co/docs/hub/spaces)
- [Gradio Documentation](https://gradio.app/docs/)
- [API Keys Guide](https://huggingface.co/docs/hub/spaces-sdks-docker-advanced#secrets)