| --- |
| 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 |
| 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 |
| 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. |
|
|
