Drop Gradio mount entirely; pure FastAPI on uvicorn (avoids SSR port conflict)

app.py

@@ -1,12 +1,12 @@
-"""KPAA Backend Space — OpenAI-compatible API on ZeroGPU (Gradio SDK).
+"""KPAA Backend Space — OpenAI-compatible API on ZeroGPU (Gradio SDK frontmatter).
 
-This Space is the inference backend. It exposes:
-- POST /v1/chat/completions  (OpenAI-compatible, streaming)
-- GET  /v1/models / /healthz / /info
-- GET  /gradio                (minimal status page)
+Pure FastAPI 진입점. Gradio Blocks/mount 없이 KPAA 의 OpenAI 호환 서버를 그대로
+uvicorn 으로 띄운다. Gradio 가 없어도 frontmatter `sdk: gradio` 는 ZeroGPU 권한을
+받기 위한 것일 뿐이고, ZeroGPU detector 는 module-level `@spaces.GPU` 데코레이터의
+존재만 본다.
 
-UI (Open WebUI) is hosted at a separate Space which points its
-OPENAI_API_BASE_URL to this Space's /v1.
+이 Space 는 추론 백엔드. UI 는 별도 Space (`scvcoder/korean-privacy-ai-assistant`)
+의 Open WebUI 가 제공.
 
 Hardware: ZeroGPU (zero-a10g).
 Required secret: LAW_OC.
@@ -17,35 +17,20 @@ import os
 import sys
 from pathlib import Path
 
-# HF Spaces 에서는 `pip install -e .` 가 동작하지 않는다 → src/ 를 sys.path 에 prepend.
-sys.path.insert(0, str(Path(__file__).resolve().parent / "src"))
-
-
-# ─── monkey-patch: gradio_client `/api_info` schema bug ────────────────────
-import gradio_client.utils as _gc_utils  # noqa: E402
-
-_orig_get_type = _gc_utils.get_type
-_orig_jstpt = _gc_utils._json_schema_to_python_type
-
+# Disable Gradio SSR globally — 일부 import 경로에서 SSR 서브프로세스를 띄우려
+# 시도하다가 포트 충돌을 일으킨다. 이 백엔드는 Gradio UI 자체를 노출하지 않으므로
+# SSR 은 무조건 끔.
+os.environ.setdefault("GRADIO_SSR_MODE", "False")
+os.environ.setdefault("GRADIO_SHARE", "False")
 
-def _safe_get_type(schema):
-    if not isinstance(schema, dict):
-        return ""
-    return _orig_get_type(schema)
-
-
-def _safe_jstpt(schema, defs):
-    if not isinstance(schema, dict):
-        return "Any"
-    return _orig_jstpt(schema, defs)
-
-
-_gc_utils.get_type = _safe_get_type
-_gc_utils._json_schema_to_python_type = _safe_jstpt
-# ──────────────────────────────────────────────────────────────────────────
+# HF Spaces: src/ 를 sys.path 에 prepend (pip install -e . 가 안 되므로)
+sys.path.insert(0, str(Path(__file__).resolve().parent / "src"))
 
 
-# ─── HF Spaces ZeroGPU startup canary (module-level required) ─────────────
+# ─── ZeroGPU startup canary (module-level required) ───────────────────────
+# HF Spaces ZeroGPU detector 는 startup 시점에 module-level `@spaces.GPU` 함수가
+# 적어도 하나 검출되어야 GPU 스케줄을 잡는다. 실제 GPU 작업은
+# ZeroGPUBackend.stream_chat 에서 동적으로 데코레이트.
 try:
     import spaces  # type: ignore[import-not-found]
 
@@ -57,47 +42,17 @@ except ImportError:
 # ──────────────────────────────────────────────────────────────────────────
 
 
-def main() -> None:
-    """Build app and run uvicorn.
-
-    Gradio Blocks (`demo`) is built INSIDE this function — not at module level —
-    so HF Spaces' Gradio SDK auto-launcher cannot detect it and call
-    `demo.launch()` separately (which would bind a second port and conflict
-    with our uvicorn on 7860).
-    """
-    import gradio as gr
-    import uvicorn
-
-    from kpaa.server import create_app
-
-    fastapi_app = create_app()
+from kpaa.server import create_app  # noqa: E402
 
-    with gr.Blocks(title="KPAA Backend", theme=gr.themes.Soft()) as demo:
-        gr.Markdown(
-            """
-            # 🧠 KPAA Backend — 개인정보보호법 RAG 추론 서버
+# Module-level FastAPI app — uvicorn 이 import 후 바로 사용.
+app = create_app()
 
-            한국 개인정보보호법 RAG 백엔드. **OpenAI 호환 API**.
-            UI 는 별도 Space (`scvcoder/korean-privacy-ai-assistant`) 의 Open WebUI 가 제공합니다.
 
-            ## API Endpoints
-
-            - **POST** `/v1/chat/completions` — OpenAI 호환 chat (스트리밍 지원)
-            - **GET** `/v1/models` — 모델 목록 (`kpaa-privacy-ko`)
-            - **GET** `/healthz` — health check
-            - **GET** `/info` — 상세 정보 / Swagger UI
-
-            ## 외부 연동
-            Open WebUI 등에 OpenAI provider 로 등록:
-            - **URL** `https://scvcoder-kpaa-backend.hf.space/v1`
-            - **Key** any (인증 없음)
-            - **Model** `kpaa-privacy-ko`
-            """
-        )
+def main() -> None:
+    import uvicorn
 
-    final_app = gr.mount_gradio_app(fastapi_app, demo, path="/gradio")
     port = int(os.environ.get("PORT", "7860"))
-    uvicorn.run(final_app, host="0.0.0.0", port=port)
+    uvicorn.run(app, host="0.0.0.0", port=port)
 
 
 if __name__ == "__main__":