completed

Author: rahul-aot

.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: RAG Application CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  backend-lint-and-build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./backend
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+        
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        pip install flake8
+        
+    - name: Lint with flake8
+      run: |
+        # stop the build if there are Python syntax errors or undefined names
+        flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        # exit-zero treats all errors as warnings
+        flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+  frontend-lint-and-build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./frontend
+        
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Use Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '18.x'
+        cache: 'npm'
+        cache-dependency-path: './frontend/package-lock.json'
+        
+    - name: Install dependencies
+      run: npm ci
+        
+    - name: Build
+      run: npm run build
+      
+    - name: Lint
+      run: npm run lint

README.md

@@ -0,0 +1,39 @@
+# AI Document RAG System
+
+A complete full-stack application for securely chatting with PDF documents using Retrieval-Augmented Generation (RAG) and Google's Gemini API.
+
+## Project Architecture
+
+- **Frontend**: React + TypeScript + Vite. A polished, single-page application with a modern SaaS CSS design.
+- **Backend**: FastAPI (Python). Handles embedding generation, vector search, and LLM interaction.
+- **Infrastructure**: Docker & Docker Compose for easy deployment.
+
+## Quick Start (Docker)
+
+The easiest way to run the entire system is with Docker Compose.
+
+1. **Prerequisites**: Ensure Docker and Docker Compose are installed.
+2. **Run**:
+   ```bash
+   docker-compose up --build
+   ```
+3. **Access**:
+   - Frontend: `http://localhost:5173`
+   - Backend API: `http://localhost:8000`
+
+## Manual Development Setup
+
+### Backend
+Navigate to `backend/` and follow the `README.md` to start the FastAPI server on port 8000.
+
+### Frontend
+Navigate to `frontend/` and follow the `README.md` to start the Vite dev server on port 5173.
+
+Ensure the backend is running before using the frontend.
+
+## Features
+
+- **Private by Design**: Your API key stays in your browser memory and is sent directly to the backend for that session only.
+- **Session Isolation**: Each user session gets its own vector store.
+- **Responsive Design**: Works on desktop and mobile.
+- **Type Safety**: Full TypeScript support in frontend, Pydantic validation in backend.

backend/Dockerfile

@@ -0,0 +1,21 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first for caching
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Expose port
+EXPOSE 8000
+
+# Run the application
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

backend/README.md

@@ -0,0 +1,39 @@
+# RAG Backend API
+
+This is the FastAPI backend for the Document RAG (Retrieval-Augmented Generation) application. It handles file processing, embeddings, vector storage, and chat interactions using Google's Gemini API.
+
+## Features
+
+- **Document Processing**: Upload and parse PDF documents.
+- **RAG Implementation**: Uses vector store to retrieve relevant context for queries.
+- **Session Management**: Isolated vector stores per session.
+- **API Key Security**: Validates Gemini API keys without storing them persistently.
+
+## Setup
+
+1. **Install Python 3.11+**
+2. **Create Virtual Environment**:
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # Windows: venv\Scripts\activate
+   ```
+3. **Install Dependencies**:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+## Running
+
+Start the server:
+```bash
+uvicorn app.main:app --reload
+```
+The API will be available at `http://localhost:8000`.
+Docs available at `http://localhost:8000/docs`.
+
+## API Endpoints
+
+- `POST /api/validate-key`: Validate Gemini API key.
+- `POST /api/upload`: Upload PDF for processing.
+- `POST /api/ask`: Ask a question about the uploaded document.
+- `DELETE /api/clear`: Clear session data.

docker-compose.yml

@@ -0,0 +1,26 @@
+version: '3.8'
+
+services:
+  backend:
+    build: ./backend
+    container_name: rag-backend
+    ports:
+      - "8000:8000"
+    environment:
+      - PYTHONUNBUFFERED=1
+    networks:
+      - app-network
+
+  frontend:
+    build: ./frontend
+    container_name: rag-frontend
+    ports:
+      - "5173:80"
+    depends_on:
+      - backend
+    networks:
+      - app-network
+
+networks:
+  app-network:
+    driver: bridge

frontend/Dockerfile

@@ -0,0 +1,23 @@
+# Build Stage
+FROM node:18-alpine as build
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm install
+
+COPY . .
+RUN npm run build
+
+# Production Stage
+FROM nginx:alpine
+
+# Copy built assets
+COPY --from=build /app/dist /usr/share/nginx/html
+
+# Copy custom nginx config
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]

frontend/README.md

@@ -1,33 +1,40 @@
-# Document RAG Frontend
+# RAG Frontend
 
-A React + Vite + TypeScript frontend for the Document RAG system.
+A modern, responsive React application for interacting with the Document RAG system. It features a professional SaaS-like UI with a focus on usability and aesthetics.
+
+## Features
+
+- **Modern UI**: Clean, card-based layout with glassmorphism effects.
+- **Interactive Experience**: Smooth transitions, drop-zone for files, and chat interface.
+- **Secure**: API keys are held in memory only and never persisted.
+- **Header Navigation**: Quick access to API status and session reset.
+
+## Tech Stack
+
+- React (Vite)
+- TypeScript
+- Vanilla CSS (Custom Design System)
 
 ## Setup
 
-1. Navigate to the frontend directory:
-   ```bash
-   cd frontend
-   ```
-2. Install dependencies:
+1. **Install Node.js 18+**
+2. **Install Dependencies**:
    ```bash
    npm install
    ```
-3. Start the development server:
-   ```bash
-   npm run dev
-   ```
 
-## Features
+## Running
 
-- **Session Management**: Automatically generates unique sessions, persists them in sessionStorage, and ensures backend cleanup on reload/reset.
-- **Secure Key Handling**: Gemini API Key is stored in memory only and cleared on reload.
-- **Styling**: Custom CSS (no frameworks) with a premium dark/glassmorphism design.
-- **Type Safety**: Full TypeScript implementation.
-- **API Integration**: Connects to `http://localhost:8000/api`.
+Start the development server:
+```bash
+npm run dev
+```
+Access the app at `http://localhost:5173`.
 
-## Tech Stack
+## Build
 
-- React
-- Vite
-- TypeScript
-- Vanilla CSS
+Create production build:
+```bash
+npm run build
+```
+The output will be in the `dist` directory.

frontend/nginx.conf

@@ -0,0 +1,16 @@
+server {
+    listen 80;
+    
+    location / {
+        root /usr/share/nginx/html;
+        index index.html index.htm;
+        try_files $uri $uri/ /index.html;
+    }
+
+    # Proxy API requests to the backend service
+    location /api/ {
+        proxy_pass http://backend:8000/api/;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}