yassine-demo/tunisian-tourism-chatbot
Domain:
natural language processingRecord type:
software
Creator:
yas
Host:
title: Tunisian Tourism Chatbot
emoji: 🐢
colorFrom: purple
colorTo: purple
sdk: gradio
sdk_version: 6.0.0
app_file: app.py
pinned: false
license: mit
# 🇹🇳 Tunisian Tourism Chatbot – AI-Powered Travel Recommender
Live Demo → huggingface.co (you’ll add this after deployment)
A smart, multilingual-ready tourism chatbot that recommends the best cities and attractions in Tunisia based on:
- Your interests (beach, history, adventure, culture, food…)
- Season (summer, winter, spring, fall)
- Budget (low, medium, high)
Built with a hybrid approach: **rule-based engine + optional fine-tuned LLM (FLAN-T5-small)** for natural language understanding.
Perfect real-world NLP + tourism industry use case for Tunisia (#1 economic sector).
## Features
- 100+ real Tunisian attractions (Carthage, Djerba, Sahara, El Jem, Sidi Bou Said…)
- Handles natural queries: "Cheap beach vacation in July" → Hammamet recommendations
- Clean modular architecture (great for CV/portfolio)
- One-click deploy on Hugging Face Spaces
- Ready for multilingual extension (Arabic/French coming soon!)
## Screenshot
*(Screenshot will appear automatically on HF Spaces)*
## Tech Stack
- Python + Gradio (frontend)
- Hugging Face Transformers (`google/flan-t5-small`)
- Rule-based recommendation engine
- JSON knowledge base of Tunisian tourism spots
## Project Structure
tunisian-tourism-chatbot/
├── app/ → Core logic (rules, model, chatbot)
├── data/ → Attractions + fine-tuning dataset
├── ui/ → Gradio interface
├── notebooks/ → Experimentation & fine-tuning
├── app.py → Entry point for Hugging Face
└── requirements.txt
## 🚀 Quick Start (Local)
```bash
git clone github.com
cd tunisian-tourism-chatbot
pip install -r requirements.txt
python app.py
-> Deploy in 2 Minutes (Hugging Face Spaces)
Go to → huggingface.co
Choo …