---
title: ChatBot MVP
emoji: 🏆
colorFrom: pink
colorTo: gray
sdk: gradio
sdk_version: 5.46.0
app_file: app.py
pinned: false
---

# ChatBot MVP for Customer Support

A Minimum Viable Product (MVP) customer support chatbot built with Gradio and OpenAI's GPT API, designed for Hugging Face Spaces.

## Features
- Intent recognition
- Entity extraction
- Conversation state management (remembers entities across turns)
- Context-aware response generation
- Clean Gradio chat UI
- API key and environment variable support

## Setup

1. **Clone the repository**
2. **Install dependencies:**
   ```bash
   pip install -r requirements.txt
   # or manually:
   pip install gradio openai python-dotenv
   ```
3. **Create a `.env` file** in the root directory with your API keys:
   ```env
   OPENAI_API_KEY=your_openai_api_key
   ```
   (Other keys are optional for this MVP)

## Running the App

```bash
python app.py
```

The app will launch a Gradio interface in your browser.

## Example Usage
- Ask about order status, product info, or submit a complaint.
- The bot will extract your intent and relevant entities, and remember them for follow-up questions.

## Hugging Face Spaces
This project is ready for deployment on Hugging Face Spaces with Gradio SDK.

## Configuration Reference
See: https://huggingface.co/docs/hub/spaces-config-reference