TamuTalk is an intelligent, bilingual chatbot designed to provide personalized food recommendations based on a user’s budget, dietary preferences, and health conditions. Built with natural language processing (NLP) and machine learning, it understands both Swahili and English, making it accessible and inclusive for diverse communities.
# TamuTalk Chatbot 🍽️🗣️
**TamuTalk** is an intelligent, bilingual (English and Swahili) chatbot designed to offer personalized food suggestions based on a user's budget, diet, and health conditions. It also supports basic health advice and conversational flow from greetings to goodbyes.
---
## 🌟 Features
- 🤖 NLP-powered intent classification using Scikit-Learn
- 🔁 Real-time learning and retraining support
- 🌍 Language detection and translation (Swahili/English)
- 💬 Web-based chat interface (frontend + backend)
- 🧠 Entity extraction (budget, dietary preferences, health conditions)
- 📦 Logs all conversations and responses for traceability
- 🔧 Flask web server for communication with the chatbot
- 📁 Option to save chats to a file
---
## 🛠️ Tech Stack
- Python 3.10+
- Flask
- Scikit-learn
- Googletrans (Translation and Language Detection)
- HTML/CSS/JavaScript (Frontend)
- JSON (Training Data)
---
## 🚀 Getting Started
### 1. Clone the Repository
git clone
github.com
### 2. Install Python Dependencies
pip install -r requirements.txt
### 3. Add training data
add chatbot_training_data.json file inside the project directory. This contains intents, patterns and responses.
### 4. Run the Chatbot Server
write a command "flask run" on your terminal or cmd
### 5. 🔒Disclaimer
TamuTalk provides food and general health suggestions only. It is not a substitute for professional medical advice.
### 6. 🤝Contributions
Pull request are welcome....For major changes, open an issue first to discuss what you'd like to change.
### 7. 👩💻 Created by
Glory Lazaro Msasalaga
Data Scientist | IoT Expert | AI/ML engineer
Tanzania 🇹🇿