readme and push

Dockerfile

@@ -1,7 +1,8 @@
-# Base Image
 FROM python:3.11-slim
 
-# System Dependencies
+# -------------------------
+# System dependencies
+# -------------------------
 RUN apt-get update && \
     apt-get install -y --no-install-recommends \
         build-essential \
@@ -9,36 +10,43 @@ RUN apt-get update && \
         curl \
     && rm -rf /var/lib/apt/lists/*
 
-# Working Directory
 WORKDIR /app
 
-# Copy Repo Files
-COPY . /app
-
-# Python Dependencies
+# -------------------------
+# Python dependencies
+# -------------------------
 RUN python -m pip install --upgrade pip setuptools wheel
+
 RUN pip install --no-cache-dir \
     fastapi \
     uvicorn[standard] \
-    streamlit \
     pydantic-settings \
     pydantic \
     requests \
-    scikit-learn \
-    transformers \
-    python-multipart
+    scikit-learn==1.8.0 \
+    python-multipart \
+    joblib \
+    jinja2
+
+# -------------------------
+# Copy application
+# -------------------------
+COPY . /app
 
-# Environment Variables
+# -------------------------
+# Environment (HF Spaces)
+# -------------------------
 ENV ENV=hf_spaces
 ENV DEBUG=False
 ENV MCP_EMBEDDED=True
-ENV API_HOST=127.0.0.1
-ENV API_PORT=8000
+ENV ENABLE_ABSTENTION=False
+ENV API_HOST=0.0.0.0
+ENV API_PORT=7860
 
-# Expose only HF port (Streamlit)
-EXPOSE 8501
+# HF default port
+EXPOSE 7860
 
-# Entrypoint
-COPY start.sh /app/start.sh
-RUN chmod +x /app/start.sh
-ENTRYPOINT ["/app/start.sh"]
+# -------------------------
+# Run FastAPI directly
+# -------------------------
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -15,8 +15,6 @@ venv\Scripts\activate
 
 uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
 
-streamlit run ui/streamlit_app.py --server.port 8501 --server.address 127.0.0.1
-
 ### Tests
 
 pytest -v

app/config.py

@@ -1,8 +1,10 @@
+import logging
 from functools import lru_cache
 from pathlib import Path
-from pydantic_settings import BaseSettings  # updated for Pydantic v2
+from pydantic_settings import BaseSettings
 from pydantic import Field
 
+logger = logging.getLogger(__name__)
 
 class Settings(BaseSettings):
     """
@@ -81,7 +83,21 @@ def get_settings() -> Settings:
     Ensures consistent config across the app.
     """
     settings = Settings()
-
+    
+    # HARD SAFETY GUARD FOR HF SPACES
+    # -------------------------
+    if settings.ENV == "hf_spaces":
+        settings.MCP_EMBEDDED = True
+        settings.MCP_FAIL_FAST = False
+        settings.ENABLE_ABSTENTION = False
+        logger.info(
+            "HF Spaces detected — forcing embedded MCP mode",
+            extra={
+                "env": settings.ENV,
+                "mcp_embedded": settings.MCP_EMBEDDED,
+                "abstention": settings.ENABLE_ABSTENTION,
+            },
+        )
     # Ensure required directories exist (safe for HF Spaces)
     settings.LOG_DIR.mkdir(parents=True, exist_ok=True)
     settings.MODEL_DIR.mkdir(parents=True, exist_ok=True)

docker-compose.yml

@@ -1,3 +1,9 @@
+# =====================================================
+# LOCAL DEVELOPMENT ONLY
+# Not used or supported by Hugging Face Spaces
+# Provides distributed MCP servers for local testing
+# =====================================================
+
 version: "3.9"
 
 services:
@@ -7,7 +13,7 @@ services:
   backend:
     build:
       context: .
-      dockerfile: Dockerfile  # Root-level Dockerfile
+      dockerfile: Dockerfile
     container_name: nlp_backend
     command: uvicorn app.main:app --host 0.0.0.0 --port 8000
     ports:
@@ -18,34 +24,17 @@ services:
       - ./logs:/app/logs
       - ./data:/app/data
     environment:
-      - ENV=local
-      - DEBUG=True
-      - MCP_EMBEDDED=False
-      - MCP_TAXONOMY_URL=http://taxonomy_server:7001
-      - MCP_POLICY_URL=http://policy_server:7002
-      - MCP_HISTORY_URL=http://history_server:7003
+      ENV: local
+      DEBUG: "true"
+      MCP_EMBEDDED: "false"
+      MCP_DISTRIBUTED_TAXONOMY_URL: http://taxonomy_server:7001
+      MCP_DISTRIBUTED_POLICY_URL: http://policy_server:7002
+      MCP_DISTRIBUTED_HISTORY_URL: http://history_server:7003
     depends_on:
       - taxonomy_server
       - policy_server
       - history_server
 
-  # -------------------------
-  # Streamlit Frontend
-  # -------------------------
-  frontend:
-    image: python:3.11-slim
-    container_name: nlp_frontend
-    working_dir: /app
-    command: streamlit run ui/streamlit_app.py --server.port 8501 --server.address 0.0.0.0
-    ports:
-      - "8501:8501"
-    volumes:
-      - ./:/app
-    depends_on:
-      - backend
-    environment:
-      - ENV=local
-
   # -------------------------
   # MCP Servers
   # -------------------------
@@ -78,11 +67,3 @@ services:
       - "7003:7003"
     volumes:
       - ./mcp_servers/history_server/data:/app/data
-
-# -------------------------
-# Shared Volumes (optional)
-# -------------------------
-volumes:
-  models:
-  data:
-  logs:

start.sh

@@ -1,15 +0,0 @@
-#!/bin/bash
-set -e
-
-# HF provides $PORT for the UI
-PORT=${PORT:-8501}
-
-echo "Starting FastAPI server in background..."
-uvicorn app.main:app \
-    --host 127.0.0.1 \
-    --port 8000 &
-
-echo "Starting Streamlit UI..."
-streamlit run ui/streamlit_app.py \
-    --server.port $PORT \
-    --server.address 0.0.0.0