FinHight / UPLOAD_GUIDE.md
Starfish55's picture
Upload 8 files
23c518c verified
# 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)