CoolFace
Apppublic

MidNusmee1474/sukishi-promotion-assistant

sourceHugging Facemitupdated 5mo agoView on Hugging Face
0likes
App README

🔥 Sukishi Promotion Assistant

ระบบ RAG Chatbot สำหรับตอบคำถามโปรโมชันร้านในเครือ Sukishi Intergroup ใช้ Custom HTML/CSS + Flask + Sentence Transformers + ChromaDB + Hugging Face Inference API

🏪 ร้านที่รองรับ

  • —🥩 Sukishi Korean Charcoal Grill (BQ / BQ-OVL / BQ-ALC)
  • —🌙 Bogeul Bogrill (BGBG)
  • —🍲 Suki King
  • —🍖 Bar B Q King
  • —🔥 WGG

⚡ Features

  • —✅ รองรับภาษาไทย 100%
  • —✅ ค้นหาโปรโมชันแบบ semantic search
  • —✅ แสดงแหล่งข้อมูลอ้างอิง
  • —✅ รองรับการสนทนาต่อเนื่อง
  • —✅ Custom UI ที่สวยงาม mobile-responsive
  • —✅ ไม่ใช้ Gradio - ใช้ HTML/CSS/JavaScript บริสุทธิ์

🔧 Tech Stack

Frontend  : Custom HTML/CSS/JavaScript
Backend   : Flask (Python)
LLM       : Llama 3.1 70B (via Groq API - ⚡ เร็วมาก!)
Embedding : multilingual-e5-small (Sentence Transformers)
Vector DB : ChromaDB (local persistent)
Data      : 112 promotion documents (JSONL)

🚀 Deploy to Hugging Face Spaces

Option 1: Auto Deploy (Recommended)

bash
python quick_deploy.py

Option 2: Manual Deploy

  1. 1.สร้าง Space ใหม่: https://huggingface.co/new-space
  2. 2.เลือก SDK: Docker
  3. 3.Upload ไฟล์:
  4. 4.app.py
  5. 5.requirements.txt
  6. 6.templates/index.html
  7. 7.static/style.css
  8. 8.static/script.js
  9. 9.data/promotions_rag_ready.jsonl
  10. 10.README.md
  11. 11.Dockerfile (สร้างอัตโนมัติ)
  12. 12.รอ Space build (~3-5 นาที)
  13. 13.เสร็จแล้ว! 🎉

📝 Environment Variables (Required for LLM)

GROQ_API_KEY - ใช้สำหรับ LLM (ฟรี, เร็วมาก):

  1. 1.สมัครที่ https://console.groq.com (ฟรี!)
  2. 2.สร้าง API Key
  3. 3.ไปที่ Space Settings → Repository secrets
  4. 4.เพิ่ม GROQ_API_KEY = yourgroqapikeyhere

หมายเหตุ: Groq ให้ใช้ฟรี และเร็วกว่า HuggingFace Inference API มาก!

🔄 Update Data

เมื่อมีโปรโมชันใหม่:

  1. 1.อัปเดตไฟล์ data/promotions_rag_ready.jsonl
  2. 2.Push to Space → จะ rebuild vector DB อัตโนมัติ

📊 Data Format

json
{
  "id": "promo_001",
  "text": "โปรโมชัน KTC แลกพอยต์...",
  "brand": "Multi-Brand",
  "promotion_name": "KTC แลกพอยต์",
  "branch": "ทุกสาขา",
  "start_date": "01/01/2026",
  "end_date": "31/12/2026"
}

🛠️ Local Development

bash
# ติดตั้ง dependencies
pip install -r requirements.txt

# รัน Flask server
python app.py

เปิดที่: http://localhost:7860

📱 Mobile Support

  • —✅ Responsive design ทำงานได้ทุกขนาดหน้าจอ
  • —✅ Touch-friendly UI
  • —✅ Optimized for iOS และ Android
  • —✅ ไม่ zoom เมื่อ focus input (iOS fix)

📄 License

MIT License - ใช้งานได้อย่างอิสระ

Made with ❤️ using Flask + Custom HTML/CSS + Groq AI ⚡