README.md

metadata

title: ChatVNS
emoji: 📈
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
python_version: 3.11

ChatVNS

Chatbot RAG hỗ trợ phân tích dữ liệu chứng khoán Việt Nam.

API key do người dùng cung cấp

Space không dùng Gemini API key hoặc Hugging Face inference token của chủ Space. Mỗi người dùng nhập key của họ trong mục API key của bạn ở sidebar:

• Gemini API key: dùng để tạo câu trả lời.
• Hugging Face token: không bắt buộc, dùng cho embedding và reranking.

Key được giữ trong bộ nhớ của session Streamlit hiện tại, không ghi vào file hoặc interaction log. Khi thiếu Hugging Face token hoặc Qdrant không khả dụng, ứng dụng tự fallback sang BM25 trên dữ liệu chunks đi kèm.

Cấu hình Space

Không cấu hình GEMINI_API_KEY hoặc HF_API_KEY trong Space Secrets.

Các biến hạ tầng tùy chọn:

• QDRANT_URL và QDRANT_API_KEY: Qdrant Cloud dùng chung.
• CHATVNS_DATASET_REPO: Hugging Face Dataset repo chứa thư mục data/.
• HF_DATASET_TOKEN: chỉ cần khi dataset repo ở chế độ private.
• APP_TICKERS=HPG,FPT,VCB

Tạo bundle để push

Chạy từ thư mục gốc dự án:

powershell -ExecutionPolicy Bypass -File .\prepare_hf_space.ps1

Lệnh mặc định đóng gói mã nguồn và tối đa 500 chunks cho mỗi scope HPG, FPT, VCB, MARKET, đủ để Space chạy ngay bằng BM25.

Đóng gói toàn bộ dữ liệu local:

powershell -ExecutionPolicy Bypass -File .\prepare_hf_space.ps1 -IncludeLocalData

Sau đó push toàn bộ nội dung trong hf-space/ lên Hugging Face Space repository. Với dữ liệu lớn, nên dùng một Dataset repo và CHATVNS_DATASET_REPO thay vì commit trực tiếp vào Space.