# Galatiq Invoice Processing Agent

A local, multi-agent system powered by **xAI Grok 4.1 Fast Reasoning** that automates invoice processing:
Ingestion (OCR/LLM) → Validation (Mock Inventory) → Approval (VP Persona) → Payment.

## 🚀 Features
*   **Multi-Agent Architecture:** Built with `langgraph`.
*   **Intelligent Extraction:** Uses Grok 4.1 Fast Reasoning for robust data parsing.
*   **Stateful Validation:** Checks line items against a local SQLite inventory.
*   **Reflective Approval:** "VP Agent" scrutinizes high-value invoices (> $10k).
*   **Web UI:** Includes a Streamlit dashboard for easy demoing.

## 🛠️ Setup

1.  **Install Dependencies:**
    ```bash
    pip install -r requirements.txt
    pip install streamlit  # For the Web UI
    ```

2.  **Environment Variables:**
    Create a `.env` file in the root:
    ```
    XAI_API_KEY=your_grok_api_key
    ```

## 🏃‍♂️ Usage

### Option 1: Web UI (Recommended)
Run the interactive dashboard:
```bash
streamlit run streamlit_app.py
```
Open your browser to `http://localhost:8501`. You can upload invoices and see the agents in action.

### Option 2: CLI (Local)
Run the agent manually on specific files:
```bash
python3 main.py --invoice_path data/invoice_valid_low.txt
```

## ☁️ Cloud Run Deployment (Manual)

To update the live version on Google Cloud Run:

1.  **Set Project:**
    ```bash
    export PROJECT_ID=profitscout-lx6bb
    export SERVICE_NAME=galatiq-invoice-agent
    ```

2.  **Build & Deploy:**
    ```bash
    # Prepare Dockerfile
    mv Dockerfile.monolith Dockerfile
    
    # Build Image
    gcloud builds submit --tag gcr.io/$PROJECT_ID/$SERVICE_NAME .
    
    # Restore Dockerfile name
    mv Dockerfile Dockerfile.monolith
    
    # Deploy Service
    gcloud run deploy $SERVICE_NAME \
      --image gcr.io/$PROJECT_ID/$SERVICE_NAME \
      --platform managed \
      --region us-central1 \
      --allow-unauthenticated \
      --set-env-vars XAI_API_KEY=your_key_here \
      --max-instances 1
    ```

For detailed demo instructions and architecture, refer to `docs/demo_script.md`.

## 📂 Mock Data
Test files are provided in `data/`:
*   `invoice_valid_low.txt`: Standard invoice, should be **APPROVED**.
*   `invoice_high_suspicious.txt`: >$10k, odd patterns, should be **REJECTED** by VP.
*   `invoice_invalid_stock.txt`: Requests items not in stock, should fail **VALIDATION**.

## 📊 Logging
Execution logs are saved to `run_logs.json`.