---
title: UnivAI Chatbot
emoji: 🤖
colorFrom: purple
colorTo: blue
sdk: docker
sdk_version: "1.0.0"
app_file: app.py
pinned: false
---

# UnivAI Chatbot Interface & AI Backend

This project merges a React UI (Vite) and a Flask AI backend into a single Hugging Face Space using Docker.

## Features

- Conversational UI for university handbook queries
- AI backend (Sentence Transformers + LLM) for semantic search and natural responses
- Feedback API for upvote/downvote tuning

## Running Locally

```bash
docker build -t univai-chatbot .
docker run -p 7860:7860 univai-chatbot
```

- UI available at `http://localhost:7860`
- API available at `http://localhost:7860/api/chat` and `/api/feedback`

## Endpoints

- **POST /api/chat**  
  `{ "query": "your question", "dev_mode": false }` → `{ "response": "answer" }`
- **POST /api/feedback**  
  `{ "query": "...", "response": "...", "feedback": "positive"|"negative" }` → `{ "status": "success" }`

## Hugging Face Spaces

- Push this repo and select Docker SDK.
- The UI and AI will run together, with Nginx proxying `/api/` to the backend.

## File Structure

- `src/` — React UI
- `app.py` — Flask AI backend
- `Dockerfile` — unified build
- `nginx.conf` — reverse proxy config
- `requirements.txt` — Python dependencies
- `dataset.json` — university Q&A set

## Connecting UI to AI

- The UI should send requests to `/api/chat` and `/api/feedback`.