Muyiiwaa/soup_explorer

The Naija Soup Buddy is an interactive application designed to identify Nigerian soups from uploaded images and provide insightful information about them using a finetuned efficient-net model and Google-Gemini. # Naija-Soup Buddy ## Overview The **Naija Soup Buddy** is an interactive application designed to identify Nigerian soups from uploaded images and provide insightful information about them. The app combines state-of-the-art image classification using a pre-trained `EfficientNet` model with an AI-powered conversational system to deliver an engaging and educational user experience. Whether you're curious about the ingredients, cooking techniques, or cultural relevance of a Nigerian soup, this bot can handle that! --- ## Demo screen-capture (11).webm Click the thumbnail above to watch a demonstration of the **Naija Soup Buddy** in action! --- ## Features ### 1. **Soup Image Classification** - Upload an image of a Nigerian soup, and the app will identify it as one of the following: - **Afang** - **Banga** - **Edikaikong** - **Efo Riro** - **Egusi** - **Ewedu** - **Ofe Nsala** - **Ogbono** - **Oha** - **Okro** ### 2. **Culinary Knowledge Base** - The bot can answer questions about Nigerian soups, such as: - Ingredients used - Nutritional value - Preparation methods - Regional variations ### 3. **Interactive Chat System** - Chat with the bot to learn more about the identified soup. - The system uses Google's `Gemini-1.5` model for intelligent and contextual responses. ### 4. **User-Friendly Interface** - Streamlit-based application for easy interaction. - Sidebar for image upload and soup analysis. - Responsive and clean design for an enhanced user experience. --- ## How It Works ### 1. **Image Upload** - Upload a `.jpg`, `.jpeg`, or `.png` image of a Nigerian soup via the sidebar. ### 2. **Image Classification** - The uploaded image is processed using a pre-trained `EfficientNet` model fine-tuned on 10 Nigerian soup categories. - The app displays the predicted soup class. ### 3. **Conversational Interaction** - Start a chat with the bot to ask questions about the identified soup. - The bot uses contextual memory to provide coherent and tailored answers. …