🚀 Add Docker & cloud deployment configuration (Railway, Render)

.dockerignore

@@ -0,0 +1,55 @@
+# Git
+.git
+.gitignore
+
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info
+dist
+build
+*.egg
+
+# Virtual Environment
+venv
+env
+ENV
+
+# Environment files (use docker env vars instead)
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Cache
+.cache
+.pytest_cache
+.mypy_cache
+
+# Uploads (will be created at runtime)
+uploads/*
+!uploads/.gitkeep
+
+# Documentation (not needed in container)
+*.md
+!README.md
+LICENSE
+
+# Development files
+requirements-dev.txt
+test_*.py

DEPLOYMENT.md

@@ -0,0 +1,250 @@
+# 🚀 Deployment Guide
+
+This guide covers multiple deployment options for PaperBOT.
+
+---
+
+## 📋 Prerequisites
+
+Before deploying, ensure you have:
+- ✅ Pinecone API key (index: `paperbot`, dimensions: `1024`)
+- ✅ Google AI API key (Gemini)
+- ✅ (Optional) HuggingFace token
+
+---
+
+## 🐳 Option 1: Docker (Recommended)
+
+Docker provides the most consistent deployment across any environment.
+
+### Local Docker Deployment
+
+```bash
+# 1. Build the image
+docker build -t paperbot .
+
+# 2. Run the container
+docker run -d \
+  --name paperbot \
+  -p 8000:8000 \
+  -e PINECONE_API_KEY=your_pinecone_key \
+  -e GOOGLE_API_KEY=your_google_key \
+  paperbot
+
+# 3. Access at http://localhost:8000
+```
+
+### Docker Compose (Easier)
+
+```bash
+# 1. Create .env file with your API keys
+cp .env.example .env
+# Edit .env with your actual keys
+
+# 2. Start the application
+docker-compose up -d
+
+# 3. View logs
+docker-compose logs -f
+
+# 4. Stop the application
+docker-compose down
+```
+
+---
+
+## 🚂 Option 2: Railway (Free Tier)
+
+Railway offers easy deployment with a generous free tier.
+
+### Steps
+
+1. **Create Railway Account**
+   - Go to [railway.app](https://railway.app)
+   - Sign up with GitHub
+
+2. **Deploy from GitHub**
+   - Click "New Project" → "Deploy from GitHub repo"
+   - Select your `PaperBOT` repository
+   - Railway auto-detects Dockerfile
+
+3. **Set Environment Variables**
+   - Go to your project → "Variables"
+   - Add:
+     ```
+     PINECONE_API_KEY=your_key
+     GOOGLE_API_KEY=your_key
+     HF_TOKEN=your_token (optional)
+     ```
+
+4. **Generate Domain**
+   - Go to "Settings" → "Networking"
+   - Click "Generate Domain"
+   - Your app is live! 🎉
+
+### Railway Pricing
+- **Free Tier**: $5/month credit (enough for light usage)
+- **Hobby**: $5/month for 8GB RAM, 8 vCPU
+
+---
+
+## 🎨 Option 3: Render (Free Tier)
+
+Render provides simple deployment with auto-scaling.
+
+### Steps
+
+1. **Create Render Account**
+   - Go to [render.com](https://render.com)
+   - Sign up with GitHub
+
+2. **Deploy Web Service**
+   - Click "New +" → "Web Service"
+   - Connect your GitHub repo
+   - Select "Docker" as runtime
+   - Choose "Free" plan
+
+3. **Configure Environment**
+   - Add environment variables:
+     ```
+     PINECONE_API_KEY=your_key
+     GOOGLE_API_KEY=your_key
+     ```
+
+4. **Deploy**
+   - Click "Create Web Service"
+   - Wait 5-10 minutes for first build
+
+### Render Pricing
+- **Free Tier**: 750 hours/month, sleeps after 15 min inactivity
+- **Starter**: $7/month for always-on
+
+---
+
+## ☁️ Option 4: Cloud VPS (Full Control)
+
+For production with full control, use a VPS.
+
+### DigitalOcean / Linode / Vultr
+
+```bash
+# 1. Create a VPS (Ubuntu 22.04, 2GB RAM minimum)
+
+# 2. SSH into server
+ssh root@your-server-ip
+
+# 3. Install Docker
+curl -fsSL https://get.docker.com | sh
+
+# 4. Clone repository
+git clone https://github.com/vikash-48413/PaperBOT.git
+cd PaperBOT
+
+# 5. Create environment file
+cp .env.example .env
+nano .env  # Add your API keys
+
+# 6. Start with Docker Compose
+docker-compose up -d
+
+# 7. (Optional) Setup Nginx reverse proxy with SSL
+apt install nginx certbot python3-certbot-nginx
+```
+
+### Nginx Configuration
+
+```nginx
+server {
+    listen 80;
+    server_name your-domain.com;
+
+    location / {
+        proxy_pass http://localhost:8000;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_read_timeout 300s;
+        client_max_body_size 20M;
+    }
+}
+```
+
+---
+
+## 🔧 Configuration for Production
+
+### Modify app.py for Production
+
+The app already binds to `0.0.0.0:8000`, which works for containers.
+
+### Memory Considerations
+
+The embedding model requires ~2GB RAM. Ensure your deployment has:
+- **Minimum**: 2GB RAM
+- **Recommended**: 4GB RAM
+
+### File Upload Storage
+
+- Uploaded files are stored in `/app/uploads/`
+- For persistent storage, mount a volume (see docker-compose.yml)
+- Consider using cloud storage (S3, GCS) for production
+
+---
+
+## 🔍 Health Checks
+
+The app exposes `/model_status` for health checks:
+
+```bash
+curl http://your-domain.com/model_status
+# Returns: {"status": "ready", "model_loaded": true}
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### Container won't start
+- Check logs: `docker logs paperbot`
+- Ensure environment variables are set
+- Verify Pinecone index exists
+
+### Out of memory
+- The embedding model needs 2GB+ RAM
+- Use swap if needed: `fallocate -l 2G /swapfile`
+- Consider the "fast" model for less memory usage
+
+### Slow first request
+- Normal! The model warms up on first load
+- Takes 30-60 seconds initially
+
+---
+
+## 📊 Deployment Comparison
+
+| Platform | Free Tier | Min RAM | Auto Deploy | Custom Domain | SSL |
+|----------|-----------|---------|-------------|---------------|-----|
+| Railway | $5 credit | 512MB | ✅ | ✅ | �� |
+| Render | 750 hrs | 512MB | ✅ | ✅ | ✅ |
+| Fly.io | 3 VMs | 256MB | ✅ | ✅ | ✅ |
+| DigitalOcean | - | 1GB | Manual | ✅ | Manual |
+| Docker Local | - | 2GB | - | - | - |
+
+---
+
+## 🎯 Recommendation
+
+For your use case, I recommend:
+
+1. **Just testing?** → Use Docker locally
+2. **Free hosting?** → Use Railway (best free tier)
+3. **Production?** → Use DigitalOcean + Docker + Nginx
+4. **Enterprise?** → Use AWS/GCP with Kubernetes
+
+---
+
+<p align="center">
+  <b>Happy Deploying! 🚀</b>
+</p>

Dockerfile

@@ -0,0 +1,40 @@
+# ================================
+# PaperBOT - Production Dockerfile
+# ================================
+FROM python:3.11-slim
+
+# Set environment variables
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+# Set working directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first (for Docker cache optimization)
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Create directories for uploads and data
+RUN mkdir -p uploads data
+
+# Expose port
+EXPOSE 8000
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
+    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/model_status')" || exit 1
+
+# Run the application
+CMD ["python", "app.py"]

Procfile

@@ -0,0 +1 @@
+web: python app.py

README.md

@@ -357,6 +357,8 @@ PaperBOT/
 ├── uploads/               # User uploads (gitignored)
 ├── requirements.txt       # Python dependencies
 ├── .env.example           # Environment template
+├── Dockerfile             # Docker container config
+├── docker-compose.yml     # Docker Compose setup
 ├── start.bat              # Windows launcher
 ├── start.sh               # Linux/Mac launcher
 └── LICENSE                # MIT License
@@ -364,6 +366,31 @@ PaperBOT/
 
 ---
 
+## 🚀 Deployment
+
+### Quick Deploy with Docker
+
+```bash
+# Build and run
+docker build -t paperbot .
+docker run -d -p 8000:8000 \
+  -e PINECONE_API_KEY=your_key \
+  -e GOOGLE_API_KEY=your_key \
+  paperbot
+```
+
+### Deploy to Cloud (Free Options)
+
+| Platform | Command / Link | Free Tier |
+|----------|----------------|-----------|
+| **Railway** | [railway.app](https://railway.app) → Deploy from GitHub | $5/month credit |
+| **Render** | [render.com](https://render.com) → New Web Service | 750 hrs/month |
+| **Docker** | `docker-compose up -d` | Local only |
+
+📖 **Full deployment guide**: See [DEPLOYMENT.md](DEPLOYMENT.md)
+
+---
+
 ## 🧪 Testing
 
 ### Run System Tests

docker-compose.yml

@@ -0,0 +1,32 @@
+# ================================
+# PaperBOT - Docker Compose
+# ================================
+# Usage:
+#   docker-compose up -d          # Start in background
+#   docker-compose logs -f        # View logs
+#   docker-compose down           # Stop
+
+version: '3.8'
+
+services:
+  paperbot:
+    build: .
+    container_name: paperbot
+    ports:
+      - "8000:8000"
+    environment:
+      - PINECONE_API_KEY=${PINECONE_API_KEY}
+      - GOOGLE_API_KEY=${GOOGLE_API_KEY}
+      - HF_TOKEN=${HF_TOKEN:-}
+    volumes:
+      # Persist uploaded files (optional)
+      - ./uploads:/app/uploads
+      # Persist preloaded data
+      - ./data:/app/data
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000/model_status')"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 60s

railway.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://railway.app/railway.schema.json",
+  "build": {
+    "builder": "DOCKERFILE",
+    "dockerfilePath": "Dockerfile"
+  },
+  "deploy": {
+    "startCommand": "python app.py",
+    "healthcheckPath": "/model_status",
+    "healthcheckTimeout": 60,
+    "restartPolicyType": "ON_FAILURE",
+    "restartPolicyMaxRetries": 3
+  }
+}

render.yaml

@@ -0,0 +1,20 @@
+# ================================
+# Render.com Blueprint
+# ================================
+# Deploy: https://render.com/deploy
+# Click "New +" → "Blueprint" → Connect this repo
+
+services:
+  - type: web
+    name: paperbot
+    runtime: docker
+    dockerfilePath: ./Dockerfile
+    plan: free  # or "starter" for $7/month with more resources
+    healthCheckPath: /model_status
+    envVars:
+      - key: PINECONE_API_KEY
+        sync: false  # Set manually in dashboard
+      - key: GOOGLE_API_KEY
+        sync: false  # Set manually in dashboard
+      - key: HF_TOKEN
+        sync: false  # Optional

runtime.txt

@@ -0,0 +1 @@
+python-3.11.7