Updated project with LFS for PDFs

.dockerignore

@@ -0,0 +1,6 @@
+frontend/
+.git/
+.gitignore
+data/chroma/
+*.pdf
+node_modules/

.env

@@ -0,0 +1,3 @@
+XAI_API_KEY=xai-Q6zYpn9C8ReN8bGZmp8QIgvyv8ZNee9UusbqUFpT4zPQpblvd1RTerx1mgRtu6L1n8DkdHV5lnzGi23D
+REDIS_HOST=redis
+REDIS_PORT=6379

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+*.pdf filter=lfs diff=lfs merge=lfs -text

Dockerfile

@@ -0,0 +1,11 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]

app/api/endpoints/chat.py

@@ -0,0 +1,51 @@
+from fastapi import APIRouter, HTTPException
+from fastapi.responses import StreamingResponse
+from pydantic import BaseModel
+from typing import List
+from app.services.llm import llm_service
+from app.services.rag import rag_service
+
+router = APIRouter()
+
+class Message(BaseModel):
+    role: str
+    content: str
+
+class ChatRequest(BaseModel):
+    messages: List[Message]
+
+@router.post("/chat")
+async def chat_endpoint(request: ChatRequest):
+    try:
+        # 1. Extract latest query
+        if not request.messages:
+            raise HTTPException(status_code=400, detail="No messages provided")
+        
+        last_message = request.messages[-1]
+        user_query = last_message.content
+
+        # 2. Retrieve Context (RAG)
+        # Note: In a real system, we'd only RAG on user queries, not history, 
+        # but here we keep it simple.
+        context_docs = rag_service.query(user_query)
+        context_text = "\n\n".join(context_docs) # context_docs is list of strings
+
+        # 3. Stream Response
+        # Convert pydantic messages to dict
+        messages_dict = [{"role": m.role, "content": m.content} for m in request.messages]
+        
+        return StreamingResponse(
+            llm_service.chat_stream(messages_dict, context=context_text),
+            media_type="text/event-stream"
+        )
+
+    except Exception as e:
+        print(f"Error in chat endpoint: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+@router.post("/ingest")
+async def ingest_endpoint(url: str):
+    success = rag_service.scrape_and_ingest(url)
+    if success:
+        return {"status": "success", "message": f"Ingested {url}"}
+    raise HTTPException(status_code=400, detail="Failed to ingest URL")

app/core/config.py

@@ -0,0 +1,11 @@
+from pydantic_settings import BaseSettings
+
+class Settings(BaseSettings):
+    XAI_API_KEY: str
+    REDIS_HOST: str = "redis"
+    REDIS_PORT: int = 6379
+
+    class Config:
+        env_file = ".env"
+
+settings = Settings()

app/main.py

@@ -0,0 +1,31 @@
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from app.core.config import settings
+from app.api.endpoints import chat
+
+app = FastAPI(title="DStv AI Support")
+
+# CORS
+origins = [
+    "http://localhost:5173",
+    "http://localhost:80",
+]
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=origins,
+    allow_credentials=True,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+@app.get("/health")
+def health_check():
+    return {"status": "ok", "service": "DStv AI Support Backend"}
+
+@app.get("/")
+def root():
+    return {"message": "DStv AI Support API is running"}
+
+app.include_router(chat.router, prefix="/api")
+

app/services/llm.py

@@ -0,0 +1,45 @@
+from openai import OpenAI
+from app.core.config import settings
+from typing import List, Dict, Generator
+
+class LLMService:
+    def __init__(self):
+        self.client = OpenAI(
+            api_key=settings.XAI_API_KEY,
+            base_url="https://api.x.ai/v1"
+        )
+        self.model = "grok-4-1-fast-reasoning" # Actually check if this is the exact string. Assuming yes based on prompt.
+
+    def get_system_prompt(self, context: str = "") -> str:
+        base_prompt = """You are DStv AI Support, a friendly and helpful customer service agent for DStv.
+Your goal is to assist customers with subscriptions, packages, payments, decoder issues, signal problems, installations, and account management.
+
+Brand Voice:
+- Friendly, practical, and clear.
+- Do NOT say "I am an AI", "Based on the context", or "Internal system details".
+- Speak like a real human agent.
+
+Context from Knowledge Base:
+{context}
+
+If the context helps, use it. If not, use your general knowledge but be careful not to hallucinate DStv specifics.
+If you don't know, suggest they check self-service on dstv.com or contact our call center.
+"""
+        return base_prompt.replace("{context}", context)
+
+    def chat_stream(self, messages: List[Dict[str, str]], context: str = "") -> Generator[str, None, None]:
+        system_msg = {"role": "system", "content": self.get_system_prompt(context)}
+        full_messages = [system_msg] + messages
+
+        stream = self.client.chat.completions.create(
+            model=self.model,
+            messages=full_messages, 
+            stream=True,
+            temperature=0.4 # Lower temperature for support accuracy
+        )
+
+        for chunk in stream:
+            if chunk.choices[0].delta.content:
+                yield chunk.choices[0].delta.content
+
+llm_service = LLMService()

app/services/rag.py

@@ -0,0 +1,112 @@
+import chromadb
+from chromadb.utils import embedding_functions
+import requests
+from bs4 import BeautifulSoup
+import uuid
+import os
+from pydantic_settings import BaseSettings
+from pypdf import PdfReader
+
+class RAGService:
+    def __init__(self):
+        # Persistent storage in ./data/chroma (relative to root now)
+        self.client = chromadb.PersistentClient(path="./data/chroma")
+        
+        self.embedding_fn = embedding_functions.DefaultEmbeddingFunction()
+        
+        self.collection = self.client.get_or_create_collection(
+            name="dstv_knowledge",
+            embedding_function=self.embedding_fn
+        )
+        # Auto ingest PDFs on startup
+        self.ingest_all_pdfs()
+
+    def ingest_pdf(self, file_path: str):
+        try:
+            print(f"Ingesting PDF: {file_path}")
+            reader = PdfReader(file_path)
+            text_chunks = []
+            
+            for i, page in enumerate(reader.pages):
+                text = page.extract_text()
+                if text and len(text) > 50:
+                    # In a real app, we'd split large pages. 
+                    # Assuming quick guides have less dense text per page or acceptable length.
+                    text_chunks.append(text)
+
+            if not text_chunks:
+                return False
+
+            ids = [f"{os.path.basename(file_path)}_page_{i}" for i in range(len(text_chunks))]
+            metadatas = [{"source": file_path, "page": i} for i in range(len(text_chunks))]
+            
+            self.collection.add(
+                documents=text_chunks,
+                ids=ids,
+                metadatas=metadatas
+            )
+            print(f"Ingested {len(text_chunks)} pages from {file_path}")
+            return True
+        except Exception as e:
+            print(f"Error ingesting PDF {file_path}: {e}")
+            return False
+
+    def ingest_all_pdfs(self, root_dir: str = "."):
+        for file in os.listdir(root_dir):
+            if file.lower().endswith(".pdf"):
+                # Check if already ingested (naive check by ID of page 0)
+                try:
+                    existing = self.collection.get(ids=[f"{file}_page_0"])
+                    if existing and existing['ids']:
+                       print(f"PDF {file} already found in DB.")
+                       continue
+                except:
+                    pass
+                    
+                self.ingest_pdf(os.path.join(root_dir, file))
+
+    def scrape_and_ingest(self, url: str):
+        try:
+            print(f"Scraping {url}...")
+            headers = {'User-Agent': 'Mozilla/5.0 (compatible; DStvBot/1.0)'}
+            response = requests.get(url, headers=headers, timeout=10)
+            if response.status_code != 200:
+                print(f"Failed to fetch {url}: {response.status_code}")
+                return False
+
+            soup = BeautifulSoup(response.text, 'html.parser')
+            
+            text_blocks = []
+            for tag in soup.find_all(['p', 'h1', 'h2', 'h3', 'li']):
+                text = tag.get_text(strip=True)
+                if len(text) > 30: 
+                    text_blocks.append(text)
+            
+            if not text_blocks:
+                return False
+
+            ids = [str(uuid.uuid4()) for _ in text_blocks]
+            metadatas = [{"source": url} for _ in text_blocks]
+            
+            self.collection.add(
+                documents=text_blocks,
+                ids=ids,
+                metadatas=metadatas
+            )
+            print(f"Ingested {len(text_blocks)} chunks from {url}")
+            return True
+
+        except Exception as e:
+            print(f"Error ingesting {url}: {e}")
+            return False
+
+    def query(self, query_text: str, n_results: int = 3):
+        results = self.collection.query(
+            query_texts=[query_text],
+            n_results=n_results
+        )
+        if results["documents"]:
+            return results["documents"][0]
+        return []
+
+rag_service = RAGService()

docker-compose.yml

@@ -0,0 +1,34 @@
+version: '3.8'
+
+services:
+  backend:
+    build: .
+    container_name: dstv_backend
+    ports:
+      - "8000:8000"
+    volumes:
+      - .:/app
+    environment:
+      - XAI_API_KEY=${XAI_API_KEY}
+      - REDIS_HOST=redis
+    depends_on:
+      - redis
+
+  frontend:
+    build:
+      context: ./frontend
+      dockerfile: Dockerfile
+    container_name: dstv_frontend
+    ports:
+      - "5173:5173"
+    volumes:
+      - ./frontend:/app
+      - /app/node_modules
+    environment:
+      - VITE_API_URL=http://localhost:8000
+
+  redis:
+    image: redis:alpine
+    container_name: dstv_redis
+    ports:
+      - "6379:6379"

dstv-explora-quick-guide.pdf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:195cdfb3e1dae4e9c717a27966ba4d68c68bf53a3e566f5bc277f061e7dddae8
+size 1380743

dstvhd6s_quickguide_v22_e_dec2020.pdf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6910dec0288a4c3698d3fde6ba93cdd5b48c859282f8530bb2fbafd54a7398fa
+size 1012623

frontend/.gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?

frontend/README.md

@@ -0,0 +1,73 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```

frontend/eslint.config.js

@@ -0,0 +1,23 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+  },
+])

frontend/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>frontend</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

frontend/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "frontend",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "autoprefixer": "^10.4.23",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.5.0",
+    "postcss": "^8.5.6",
+    "tailwindcss": "^4.1.18",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vite": "^7.2.4"
+  }
+}

frontend/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}

frontend/src/App.tsx

@@ -0,0 +1,11 @@
+import ChatInterface from './components/ChatInterface';
+
+function App() {
+  return (
+    <div className="App w-full h-full bg-dstv-black">
+      <ChatInterface />
+    </div>
+  );
+}
+
+export default App;

frontend/src/components/ChatInterface.tsx

@@ -0,0 +1,153 @@
+import React, { useState, useRef, useEffect } from 'react';
+import logo from '../assets/logo.jpeg';
+
+interface Message {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+}
+
+export default function ChatInterface() {
+    const [messages, setMessages] = useState<Message[]>([
+        { id: '1', role: 'assistant', content: 'Hello! I\'m your DStv guide. I can help with subscriptions, payments, technical issues, and more. How can I assist you today?' }
+    ]);
+    const [input, setInput] = useState('');
+    const [isLoading, setIsLoading] = useState(false);
+    const messagesEndRef = useRef<HTMLDivElement>(null);
+
+    const scrollToBottom = () => {
+        messagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
+    };
+
+    useEffect(() => {
+        scrollToBottom();
+    }, [messages]);
+
+    const sendMessage = async () => {
+        if (!input.trim()) return;
+
+        const userMsg: Message = { id: Date.now().toString(), role: 'user', content: input };
+        setMessages(prev => [...prev, userMsg]);
+        setInput('');
+        setIsLoading(true);
+
+        try {
+            const response = await fetch(`${import.meta.env.VITE_API_URL || 'http://localhost:8000'}/api/chat`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    messages: [...messages, userMsg].map(m => ({ role: m.role, content: m.content }))
+                }),
+            });
+
+            if (!response.ok) throw new Error('Network response was not ok');
+            if (!response.body) return;
+
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            const aiMsgId = (Date.now() + 1).toString();
+            
+            // Add empty AI message first
+            setMessages(prev => [...prev, { id: aiMsgId, role: 'assistant', content: '' }]);
+
+            let accumulatedContent = '';
+
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) break;
+                
+                const chunk = decoder.decode(value, { stream: true });
+                accumulatedContent += chunk;
+                
+                setMessages(prev => prev.map(msg => 
+                    msg.id === aiMsgId ? { ...msg, content: accumulatedContent } : msg
+                ));
+            }
+        } catch (error) {
+            console.error('Error sending message:', error);
+            setMessages(prev => [...prev, { id: Date.now().toString(), role: 'assistant', content: "Sorry, I'm having trouble connecting to the server. Please try again later." }]);
+        } finally {
+            setIsLoading(false);
+        }
+    };
+
+    return (
+        <div className="flex flex-col h-screen bg-dstv-black text-white font-sans max-w-md mx-auto shadow-2xl overflow-hidden border-x border-dstv-dark-gray sm:max-w-2xl md:max-w-4xl lg:max-w-6xl xl:max-w-full">
+            {/* Header */}
+            <header className="bg-dstv-blue p-4 flex items-center shadow-lg z-10">
+                <img src={logo} alt="DStv Logo" className="h-8 md:h-10 mr-3 rounded-sm" />
+                <div>
+                    <h1 className="font-bold text-lg md:text-xl tracking-wide">DStv Support</h1>
+                    <span className="text-xs text-blue-100 opacity-90 block">Always here for you</span>
+                </div>
+            </header>
+
+            {/* Chat Area */}
+            <div className="flex-1 overflow-y-auto p-4 space-y-4 bg-gradient-to-b from-dstv-black to-dstv-dark-gray backdrop-blur-sm">
+                {messages.map((msg) => (
+                    <div
+                        key={msg.id}
+                        className={`flex ${msg.role === 'user' ? 'justify-end' : 'justify-start'} animate-fadeIn`}
+                    >
+                        <div
+                            className={`max-w-[80%] md:max-w-[70%] p-3 md:p-4 rounded-2xl text-sm md:text-base leading-relaxed shadow-sm ${msg.role === 'user'
+                                    ? 'bg-dstv-blue text-white rounded-br-none'
+                                    : 'bg-zinc-800 text-gray-100 rounded-bl-none border border-zinc-700'
+                                }`}
+                        >
+                            {msg.content.split('\n').map((paragraph, idx) => (
+                                <p key={idx} className={idx > 0 ? 'mt-3' : ''}>{paragraph}</p>
+                            ))}
+                        </div>
+                    </div>
+                ))}
+                {isLoading && (
+                    <div className="flex justify-start">
+                        <div className="bg-zinc-800 p-3 rounded-2xl rounded-bl-none border border-zinc-700 flex space-x-2 items-center">
+                            <div className="w-2 h-2 bg-dstv-blue rounded-full animate-bounce" style={{ animationDelay: '0ms' }}></div>
+                            <div className="w-2 h-2 bg-dstv-blue rounded-full animate-bounce" style={{ animationDelay: '150ms' }}></div>
+                            <div className="w-2 h-2 bg-dstv-blue rounded-full animate-bounce" style={{ animationDelay: '300ms' }}></div>
+                        </div>
+                    </div>
+                )}
+                <div ref={messagesEndRef} />
+            </div>
+
+            {/* Input Area */}
+            <div className="p-4 bg-dstv-dark-gray border-t border-zinc-800">
+                <div className="flex items-end space-x-2 bg-zinc-900 p-2 rounded-xl border border-zinc-700 focus-within:border-dstv-blue transition-colors">
+                    <textarea
+                        value={input}
+                        onChange={(e) => setInput(e.target.value)}
+                        onKeyDown={(e) => {
+                            if (e.key === 'Enter' && !e.shiftKey) {
+                                e.preventDefault();
+                                sendMessage();
+                            }
+                        }}
+                        placeholder="Type your message..."
+                        className="flex-1 bg-transparent border-none text-white focus:ring-0 resize-none max-h-32 min-h-[44px] py-1 px-2 placeholder-zinc-500"
+                        rows={1}
+                    />
+                    <button
+                        onClick={sendMessage}
+                        disabled={!input.trim() || isLoading}
+                        className={`p-2 rounded-lg transition-all duration-200 ${input.trim() && !isLoading
+                                ? 'bg-dstv-blue text-white hover:bg-blue-600 shadow-lg shadow-blue-500/20'
+                                : 'bg-zinc-700 text-zinc-500 cursor-not-allowed'
+                            }`}
+                    >
+                        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" className="w-6 h-6 transform rotate-[-45deg] relative left-0.5 top-[-2px]">
+                            <path d="M3.478 2.404a.75.75 0 00-.926.941l2.432 7.905H13.5a.75.75 0 010 1.5H4.984l-2.432 7.905a.75.75 0 00.926.94 60.519 60.519 0 0018.445-8.986.75.75 0 000-1.218A60.517 60.517 0 003.478 2.404z" />
+                        </svg>
+                    </button>
+                </div>
+                <div className="text-center mt-2">
+                    <p className="text-[10px] text-zinc-500">AI responses may vary. Check DStv.com for official info.</p>
+                </div>
+            </div>
+        </div>
+    );
+}

frontend/src/index.css

@@ -0,0 +1,19 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+  body {
+    @apply bg-dstv-black text-white font-sans;
+  }
+}
+
+@layer utilities {
+    .scrollbar-hide::-webkit-scrollbar {
+        display: none;
+    }
+    .scrollbar-hide {
+        -ms-overflow-style: none;
+        scrollbar-width: none;
+    }
+}

frontend/src/main.tsx

@@ -0,0 +1,10 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import './index.css'
+import App from './App.tsx'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)

frontend/tailwind.config.js

@@ -0,0 +1,18 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: [
+    "./index.html",
+    "./src/**/*.{js,ts,jsx,tsx}",
+  ],
+  theme: {
+    extend: {
+      colors: {
+        'dstv-blue': '#1B8DC6',
+        'dstv-black': '#000000',
+        'dstv-dark-gray': '#121212',
+        'dstv-light-gray': '#E5E5E5',
+      },
+    },
+  },
+  plugins: [],
+}

frontend/tsconfig.app.json

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "types": ["vite/client"],
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["src"]
+}

frontend/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "files": [],
+  "references": [
+    { "path": "./tsconfig.app.json" },
+    { "path": "./tsconfig.node.json" }
+  ]
+}

frontend/tsconfig.node.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+    "target": "ES2023",
+    "lib": ["ES2023"],
+    "module": "ESNext",
+    "types": ["node"],
+    "skipLibCheck": true,
+
+    /* Bundler mode */
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+
+    /* Linting */
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "erasableSyntaxOnly": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true
+  },
+  "include": ["vite.config.ts"]
+}

frontend/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+// https://vite.dev/config/
+export default defineConfig({
+  plugins: [react()],
+})

requirements.txt

@@ -0,0 +1,17 @@
+fastapi
+uvicorn
+python-multipart
+# Networking
+requests
+httpx
+# AI / LLM
+openai
+# Database / Vector Store
+chromadb
+redis
+# Scraper
+beautifulsoup4
+# Utils
+pydantic-settings
+python-dotenv
+pypdf