Skip to content

ChAbdulWahhab/Pizzence

Repository files navigation

🍕 Pizzence – Your Pizza Restaurant Review Assistant

Pizzence is an AI-powered chatbot built with Streamlit and LangChain, designed to answer customer questions based on real restaurant reviews. Whether it's gluten-free options, service quality, or favorite dishes—Pizzence delivers quick, relevant answers powered by LLaMA3 via Ollama.


🚀 Features

  • 💬 Chat with real customer reviews
  • ⚡ Fast, relevant, and to-the-point responses
  • 🧠 Uses local vector search (ChromaDB) for context
  • 🌐 Simple Streamlit web UI

🛠️ Tech Stack

  • Python
  • Streamlit for frontend
  • LangChain for prompt orchestration
  • Ollama (LLaMA3.2) as the LLM
  • ChromaDB for vector database
  • OllamaEmbeddings for review embedding

📂 Project Structure


pizzence/
│
├── chrome\_langchain\_db/              # ChromaDB vector store (auto-created)
├── .gitignore                        # Git ignore rules
├── .python-version                   # Python version file (optional)
├── main.py                           # Streamlit chatbot app
├── vector.py                         # Review embedding and retriever setup
├── realistic\_restaurant\_reviews.csv  # Customer reviews dataset
├── pyproject.toml                    # Project dependencies and config
├── uv.lock                           # Package lock file (if using uv/rye)
└── README.md                         # You’re here!


⚙️ Setup Instructions

1. Clone the repository

git clone https://github.com/ChAbdulWahhab/pizzence.git
cd pizzence

2. (Optional) Create a virtual environment

python -m venv venv
venv\Scripts\activate  # Windows
source venv/bin/activate  # macOS/Linux

3. Install dependencies

If you're using uv:

uv pip install -r requirements.txt

Otherwise:

pip install -r requirements.txt

4. Start the chatbot

streamlit run main.py

🧠 How It Works

  1. Loads and embeds the reviews using OllamaEmbeddings.
  2. Saves them to a local ChromaDB vector store.
  3. When a user asks a question, relevant reviews are retrieved.
  4. These are used as context for the LLaMA3 model to generate an answer.

✨ Example Questions

  • Do they offer gluten-free pizzas?
  • How is the staff behavior according to reviews?
  • What’s the most appreciated item on the menu?

📬 Feedback

Open an issue or contribute on GitHub.

Enjoy chatting with your reviews – powered by Pizzence 🍕

About

An intelligent chatbot for pizza restaurants that assists customers with menu browsing, order placement, and personalized recommendations using AI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages