AgriBot / README.md
Abdo-Eid
project scaffolding
02e4173
---
title: AgriBot
emoji: 🌱
colorFrom: green
colorTo: green
sdk: docker
app_port: 7860
pinned: false
license: mit
---
# 🌱 Agricash Chatbot Overlay
This project provides a fully customizable chatbot overlay that sits on top of the Agricash web application.
It includes:
### βœ” Custom HTML/CSS/JS Chat Widget
The chat widget is styled with an agriculture theme and appears as a floating assistant on the page.
### βœ” FastAPI Backend
The backend is implemented using FastAPI and runs inside a Hugging Face Docker Space.
Endpoint structure:
- `GET /` β†’ Serves the chat UI (index.html)
- `POST /chat` β†’ Handles chatbot messages (currently placeholder logic)
### βœ” Iframe Integration
The chatbot overlay loads the Agricash website inside an iframe while keeping the chat widget on top.
### βœ” Ready for LLM Integration
The backend is designed so the `/chat` endpoint can easily be updated to use any Hugging Face-supported LLM (e.g., Llama 3, Mixtral, Phi-3).
---
## πŸš€ Local Development
Build the Docker image:
```bash
docker build -t agricash-chatbot .
````
Run it locally:
```bash
docker run -p 7860:7860 agricash-chatbot
```
Open in browser:
```
http://localhost:7860/
```
---
## πŸ“ž Contact
For improvements or future integration with real LLM models, feel free to reach out.