README_SETUP.md

🚀 Multi-Modal Document Intelligence Platform - Setup Guide

✅ System Status

Production Readiness: [READY] Security: [SECURE] (Auth Enabled, Keys Rotated, Ports Locked) Performance: [OPTIMIZED] (Async I/O, Caching, RAM Limits)

---

🛠️ Step 1: Configuration

Ensure your .env file exists in the root directory with the following keys (Auto-Created):

OPENROUTER_API_KEY=sk-or-v1-...       # Your LLM Key
QDRANT_URL=http://qdrant:6333
CELERY_BROKER_URL=redis://redis:6379/0
CELERY_RESULT_BACKEND=redis://redis:6379/0
API_ACCESS_TOKEN=multimodal-admin-key # Default Admin Key

🐳 Step 2: Run with Docker (Recommended)

This ensures Tesseract OCR and all dependencies are perfectly isolated.

# Build and Run in Background
docker-compose up --build -d

# Check Logs
docker-compose logs -f api

🌐 Step 3: Access

• Frontend App: http://localhost:5173 (Run npm run dev in web/ folder)
• API Docs: http://localhost:8000/docs
• Health Check: http://localhost:8000/

🔑 Authentication

The system is now secured.

• Header: x-api-key: multimodal-admin-key
• The Frontend is pre-configured to send this key in development mode.

🧪 Testing

Run the verification suite (inside the container):

docker exec -it multimodal_api python verify_full_system.py

Note: This will verify imports, logic, and Tesseract presence.

---

Build Status: 🟢 PASSED