🇬🇧 English – Flask Chatbot 2.0 – Professional Version

# Flask Chatbot 2.0 — Professional Version (EN)

A **fully functional Flask chatbot**, built for real-world projects (clients, SaaS platforms, education, etc.) — not just a tutorial.

It includes a modern web interface, an embeddable floating widget, offline mode (no OpenAI required), OpenAI mode (GPT), and persistent memory using SQLite.

**Also available on Gumroad:**  

➡️ **Available also on Gumroad :**   [https://palks-studio.gumroad.com](https://palks-studio.gumroad.com)

---

## Main Features

- **Advanced web interface (/ui)**

  - Light / Dark mode

  - Typing animation effect

  - Browser-side message history

- **Embeddable floating widget**

  - Works on any website: HTML, WordPress, Webflow, etc.

  - Opens via a floating chat/support button

- **Two response modes**

  - **Offline mode** — Uses local JSON file, no API required  

  - **OpenAI mode (GPT-3.5 / GPT-4)** — Enabled when an API key is added to `.env`

- **Persistent memory (SQLite)**

  - Stores conversations in `storage.db`

  - Automatic generation of a unique `session_id` per user

- **Easy installation**

  - `install.sh` (Linux/Mac) and `install.bat` (Windows)

  - Run instantly using `python app.py`

- **Deployment-ready**

  - Works on **o2switch / Passenger**

  - Includes Docker + docker-compose setup

  - Deployable on VPS, Nginx, Apache, etc.

---

## What’s Included in the Pack

| File / Folder | Description |

|---------------|-------------|

| `app.py` | Main Flask API (routes `/chat`, `/ui`, `/history`) |

| `main.py` | Response logic (JSON + OpenAI) |

| `storage.py` | Conversation history using SQLite |

| `sample_data/sample_data.json` | Example local knowledge base |

| `templates/index.html` | Main web UI |

| `widget.html / widget.js / widget.css` | Embeddable floating widget |

| `install.sh / install.bat` | One-click installation scripts |

| `passenger_wsgi.py` | o2switch / Passenger deployment |

| `Dockerfile / docker-compose.yml` | Docker support |

| `.env.example` | Example env file (OpenAI key + persistence) |

| `README.md / INSTALL.md / CUSTOMISATION.md` | Full documentation |

---

## Who Is This For?

- Developers / freelancers delivering a chatbot to clients  

- Teachers, bootcamps, schools (real Flask project template)  

- SaaS creators and web platform builders  

- Web agencies adding an automated support assistant  

- Coaches, consultants, therapists wanting an AI assistant  

- Learners who want to study a complete Flask architecture

---

## Version 1 vs Version 2

| Version | Includes |

|---------|----------|

| **Flask Chatbot V1** | Basic Flask API (`/chat`), JSON or OpenAI mode, minimal UI |

| **Flask Chatbot V2.0 (this one)** | Full web UI, floating widget, memory system, install scripts, Docker, professional structure |

---

## Quick Installation

# 1. Install dependencies

pip install -r requirements.txt

# 2. Launch the chatbot

python app.py

# 3. (Optional) Enable OpenAI

Copy .env.example → .env and add your API key

Access the interface at:
➡ http://localhost:5000/ui

➡ http://localhost:5000

➡️ **Available also on Gumroad :**   [https://palks-studio.gumroad.com](https://palks-studio.gumroad.com)

## License & Credits

This project is an original creation by **Palks Studio**.

Personal and commercial use is allowed  

Reselling, sharing, or publishing the template as-is is prohibited  

You may modify and use it in your own projects (client work, SaaS, education, etc.),  

but you are not allowed to redistribute or sell the source code directly.

© 2025 – Palks Studio