Upload 3 files

Dockerfile

@@ -0,0 +1,78 @@
+# ============================================
+# Dockerfile for Hugging Face Spaces
+# Novel Scraper with Playwright
+# ============================================
+
+# --- Stage 1: Use Python 3.10 slim base ---
+FROM python:3.10-slim-bookworm
+
+# --- Hugging Face requires port 7860 ---
+ENV PORT=7860
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV DEBIAN_FRONTEND=noninteractive
+
+# --- Create non-root user (HF requirement) ---
+RUN useradd -m -u 1000 user
+
+# --- Install system dependencies for Playwright ---
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    # Playwright browser dependencies
+    libnss3 \
+    libnspr4 \
+    libatk1.0-0 \
+    libatk-bridge2.0-0 \
+    libcups2 \
+    libdrm2 \
+    libdbus-1-3 \
+    libxkbcommon0 \
+    libatspi2.0-0 \
+    libxcomposite1 \
+    libxdamage1 \
+    libxfixes3 \
+    libxrandr2 \
+    libgbm1 \
+    libpango-1.0-0 \
+    libcairo2 \
+    libasound2 \
+    libwayland-client0 \
+    # Additional libs often needed
+    libglib2.0-0 \
+    libgtk-3-0 \
+    libx11-xcb1 \
+    fonts-liberation \
+    fonts-noto-cjk \
+    wget \
+    ca-certificates \
+    && rm -rf /var/lib/apt/lists/*
+
+# --- Set working directory ---
+WORKDIR /home/user/app
+
+# --- Copy requirements first (Docker cache optimization) ---
+COPY --chown=user:user requirements.txt .
+
+# --- Install Python dependencies ---
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir -r requirements.txt
+
+# --- Install Playwright browsers (Chromium only to save space) ---
+# Must run as user who will execute the app
+USER user
+RUN playwright install chromium
+
+# --- Copy application code ---
+COPY --chown=user:user . .
+
+# --- Create screenshots directory ---
+RUN mkdir -p /home/user/app/app/static/screenshots
+
+# --- Expose the port ---
+EXPOSE 7860
+
+# --- Health check ---
+HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
+    CMD python -c "import httpx; httpx.get('http://localhost:7860/health')" || exit 1
+
+# --- Start the application ---
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860", "--workers", "1", "--timeout-keep-alive", "120"]

README.md

@@ -0,0 +1,42 @@
+# 📚 Novel Scraper Pro
+
+Concurrent web novel scraper with captcha intervention support.
+Runs on Hugging Face Spaces with Render PostgreSQL database.
+
+## 🚀 Quick Deploy to Hugging Face
+
+### Step 1: Create Render Database
+1. Go to [render.com](https://render.com)
+2. Create a new PostgreSQL database (Free tier)
+3. Copy the **External Database URL**
+4. Replace `postgresql://` with `postgresql+asyncpg://`
+
+### Step 2: Create Hugging Face Space
+1. Go to [huggingface.co/spaces](https://huggingface.co/spaces)
+2. Click "Create new Space"
+3. Choose **Docker** as the SDK
+4. Set visibility to **Private** (recommended)
+
+### Step 3: Set Environment Variables
+In your Space settings, add:
+
+| Variable | Value |
+|----------|-------|
+| `DATABASE_URL` | `postgresql+asyncpg://user:pass@host:5432/dbname` |
+| `MAX_CONCURRENT_BROWSERS` | `3` |
+| `MIN_DELAY_SECONDS` | `3` |
+| `MAX_DELAY_SECONDS` | `8` |
+
+### Step 4: Upload Files
+Upload all project files to your Space repository.
+The Space will automatically build and deploy.
+
+### Step 5: Use It!
+1. Open your Space URL
+2. Add novel URLs in the form
+3. Click "Start All"
+4. Watch the dashboard for progress
+5. Solve captchas when alerted
+6. Download completed novels as .txt
+
+## 📁 Project Structure

requirements.txt

@@ -0,0 +1,31 @@
+# ============================================
+# Novel Scraper - Exact Stable Versions
+# Tested & Compatible with Python 3.10
+# ============================================
+
+# --- Web Framework ---
+fastapi==0.110.0
+uvicorn[standard]==0.27.1
+python-multipart==0.0.9
+jinja2==3.1.3
+
+# --- Browser Automation ---
+playwright==1.42.0
+
+# --- Database (Async PostgreSQL) ---
+SQLAlchemy[asyncio]==2.0.28
+asyncpg==0.29.0
+psycopg2-binary==2.9.9
+
+# --- Environment & Config ---
+pydantic==2.6.3
+pydantic-settings==2.2.1
+python-dotenv==1.0.1
+
+# --- Utilities ---
+aiofiles==23.2.1
+httpx==0.27.0
+Pillow==10.2.0
+
+# --- For .epub generation (optional, .txt by default) ---
+# ebooklib==0.18