Add application file

.dockerignore

@@ -0,0 +1,9 @@
+.env
+.env.*
+__pycache__/
+*.pyc
+*.pyo
+.git/
+.gitignore
+*.md
+sql_results/

.env.example

@@ -0,0 +1,15 @@
+# Copy this file to .env and fill in your values
+# cp .env.example .env
+
+# ── Required ───────────────────────────────────────────────────────────────────
+# Your NVIDIA API key (get one at https://integrate.api.nvidia.com)
+NVIDIA_API_KEY=nvapi-your_key_here
+
+# ── Optional (defaults shown) ──────────────────────────────────────────────────
+# URL of your PHP DB layer — update host/path to match your PHP server
+# If PHP runs on your host machine: http://host.docker.internal/api_ct/db_api.php
+# If PHP runs in another Docker container on the same network: http://php-container/api_ct/db_api.php
+PHP_DB_URL=http://host.docker.internal/api_ct/db_api.php
+
+# Shared secret between this API and the PHP layer (change this!)
+INTERNAL_SECRET=change_this_secret_in_production

Dockerfile

@@ -0,0 +1,26 @@
+FROM python:3.11-slim
+
+# System dependencies
+RUN apt-get update && apt-get install -y \
+    gcc \
+    g++ \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Install Python dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application files
+COPY app.py .
+COPY index.html .
+
+# Create directory for SQL results
+RUN mkdir -p /app/sql_results
+
+# Expose port
+EXPOSE 8000
+
+# Run the app
+CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]

README.md

@@ -1,13 +1,103 @@
+# ShopBot — Docker Setup
+
+A RAG-powered product search API using NVIDIA Llama + FastAPI.
+
+## Project Structure
+
+```
+.
+├── Dockerfile
+├── docker-compose.yml
+├── .env.example          ← copy to .env and fill in
+├── .dockerignore
+├── requirements.txt
+├── app.py                ← FastAPI application
+├── index.html            ← Chat UI (served at /)
+└── rag_integration.php   ← PHP integration helper (deploy on your PHP server)
+```
+
+## Quick Start
+
+### 1. Set up environment variables
+
+```bash
+cp .env.example .env
+# Edit .env and add your NVIDIA_API_KEY and PHP_DB_URL
+```
+
+### 2. Build and run
+
+```bash
+docker compose up --build
+```
+
+The API will be available at **http://localhost:8000**
+
+- Chat UI → http://localhost:8000/
+- API docs → http://localhost:8000/docs
+- Health check → http://localhost:8000/health
+
+### 3. Run in background (production)
+
+```bash
+docker compose up --build -d
+```
+
 ---
-title: ChatRAG
-emoji: 🐢
-colorFrom: indigo
-colorTo: red
-sdk: gradio
-sdk_version: 6.14.0
-python_version: '3.13'
-app_file: app.py
-pinned: false
+
+## PHP Integration
+
+Your PHP server needs to expose a `db_api.php` endpoint that:
+- Accepts `POST` requests with JSON body `{"sql": "SELECT ..."}` 
+- Verifies the `X-Internal-Secret` header matches `INTERNAL_SECRET`
+- Executes the SQL and returns `{"success": true, "results": [...], "row_count": N}`
+
+Copy `rag_integration.php` to your PHP server and call `get_rag_recommendations($conn, $query)` from your chat handler.
+
+---
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `NVIDIA_API_KEY` | ✅ Yes | — | Your NVIDIA API key |
+| `PHP_DB_URL` | No | `http://host.docker.internal/api_ct/db_api.php` | URL to your PHP DB layer |
+| `INTERNAL_SECRET` | No | `change_this_secret_in_production` | Shared secret for PHP auth |
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## Connecting to Your PHP Server
+
+**PHP on the same host machine:**
+```env
+PHP_DB_URL=http://host.docker.internal/api_ct/db_api.php
+```
+
+**PHP in another Docker container (same compose file):**
+Add your PHP container to `docker-compose.yml` and use its service name:
+```env
+PHP_DB_URL=http://php-service/api_ct/db_api.php
+```
+
+**PHP on a remote server:**
+```env
+PHP_DB_URL=https://yourserver.com/api_ct/db_api.php
+```
+
+---
+
+## Useful Commands
+
+```bash
+# View logs
+docker compose logs -f shopbot-api
+
+# Rebuild after code changes
+docker compose up --build
+
+# Stop
+docker compose down
+
+# Stop and remove volumes (clears saved SQL results)
+docker compose down -v
+```

docker-compose.yml

@@ -0,0 +1,41 @@
+version: "3.9"
+
+services:
+  shopbot-api:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: shopbot-api
+    ports:
+      - "8000:8000"
+    environment:
+      # ── Required: Set your NVIDIA API key ──────────────────────────────────
+      - NVIDIA_API_KEY=${NVIDIA_API_KEY}
+
+      # ── PHP DB layer URL (update to your PHP server's address) ─────────────
+      # If your PHP server runs on the host machine, use host.docker.internal
+      # Example: http://host.docker.internal/api_ct/db_api.php
+      - PHP_DB_URL=${PHP_DB_URL:-http://host.docker.internal/api_ct/db_api.php}
+
+      # ── Internal secret shared between this API and your PHP layer ─────────
+      - INTERNAL_SECRET=${INTERNAL_SECRET:-change_this_secret_in_production}
+
+    volumes:
+      # Persist SQL query result files outside the container
+      - sql_results:/app/sql_results
+
+    restart: unless-stopped
+
+    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 15s
+
+    extra_hosts:
+      # Allows the container to reach services on your host machine
+      - "host.docker.internal:host-gateway"
+
+volumes:
+  sql_results:

requirements.txt

@@ -14,5 +14,4 @@ langchain-community>=0.0.10
 faiss-cpu>=1.13.0
 sentence-transformers>=2.2.2
 python-multipart>=0.0.18
-cors==1.0.1
-python-json-logger>=2.0.0
+python-json-logger>=2.0.0