FinHight / UPLOAD_GUIDE.md
Starfish55's picture
Upload 8 files
23c518c verified

A newer version of the Gradio SDK is available: 6.1.0

Upgrade

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:

    git clone https://huggingface.co/spaces/your-username/finhigh
    cd finhigh
    
  3. Copy files vào Space:

    # Copy tất cả files từ FinHigh_HuggingFace_Upload/
    cp -r ../FinHigh_HuggingFace_Upload/* .
    
  4. Commit và push:

    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