# 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)