Hide demo inside main() to avoid HF auto-launch port conflict

app.py

@@ -2,9 +2,8 @@
 
 This Space is the inference backend. It exposes:
 - POST /v1/chat/completions  (OpenAI-compatible, streaming)
-- GET  /v1/models
-- GET  /healthz / /info
-- GET  /gradio                (minimal status page; Gradio SDK detection)
+- GET  /v1/models / /healthz / /info
+- GET  /gradio                (minimal status page)
 
 UI (Open WebUI) is hosted at a separate Space which points its
 OPENAI_API_BASE_URL to this Space's /v1.
@@ -23,10 +22,6 @@ sys.path.insert(0, str(Path(__file__).resolve().parent / "src"))
 
 
 # ─── monkey-patch: gradio_client `/api_info` schema bug ────────────────────
-# Gradio 5.x 의 gradio_client.utils 는 JSON Schema 의 `additionalProperties: True`
-# (bool, 합법적 형식) 를 dict 로만 가정해서 TypeError 를 낸다. 이 백엔드는
-# Gradio UI 자체를 사용자에게 노출하지 않지만 Gradio 가 mount 되어 있어
-# /api_info 가 호출될 가능성이 있으므로 안전 패치.
 import gradio_client.utils as _gc_utils  # noqa: E402
 
 _orig_get_type = _gc_utils.get_type
@@ -50,10 +45,7 @@ _gc_utils._json_schema_to_python_type = _safe_jstpt
 # ──────────────────────────────────────────────────────────────────────────
 
 
-# ─── HF Spaces ZeroGPU startup canary ─────────────────────────────────────
-# ZeroGPU 는 startup 시점에 module-level `@spaces.GPU` 함수가 적어도 하나 검출되어야
-# GPU 스케줄을 잡는다. 실제 GPU 작업은 ZeroGPUBackend.stream_chat 안에서 동적으로
-# 데코레이트되지만 startup 스캔에서 안 보이므로 sentinel 추가.
+# ─── HF Spaces ZeroGPU startup canary (module-level required) ─────────────
 try:
     import spaces  # type: ignore[import-not-found]
 
@@ -65,48 +57,45 @@ except ImportError:
 # ──────────────────────────────────────────────────────────────────────────
 
 
-import gradio as gr  # noqa: E402
-
-from kpaa.server import create_app  # noqa: E402
-
-
-# Build the FastAPI app from KPAA's existing OpenAI-compatible server.
-fastapi_app = create_app()
-
-
-# Build a minimal Gradio status page so HF Spaces 에 "Gradio app" 으로 인식되고,
-# 사용자가 backend URL 에 접속해도 친절한 안내 페이지가 나오도록 함.
-with gr.Blocks(title="KPAA Backend", theme=gr.themes.Soft()) as demo:
-    gr.Markdown(
-        """
-        # 🧠 KPAA Backend — 개인정보보호법 RAG 추론 서버
+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
 
-        한국 개인정보보호법 RAG 백엔드. **OpenAI 호환 API**.
-        UI 는 별도 Space (`scvcoder/korean-privacy-ai-assistant`) 의 Open WebUI 가 제공합니다.
+    from kpaa.server import create_app
 
-        ## API Endpoints
+    fastapi_app = create_app()
 
-        - **POST** `/v1/chat/completions` — OpenAI 호환 chat (스트리밍 지원)
-        - **GET** `/v1/models` — 모델 목록 (`kpaa-privacy-ko`)
-        - **GET** `/healthz` — health check
-        - **GET** `/info` — 상세 정보 / Swagger UI 링크
+    with gr.Blocks(title="KPAA Backend", theme=gr.themes.Soft()) as demo:
+        gr.Markdown(
+            """
+            # 🧠 KPAA Backend — 개인정보보호법 RAG 추론 서버
 
-        ## 외부 연동
-        Open WebUI 등에 OpenAI provider 로 등록:
-        - **URL** `https://scvcoder-kpaa-backend.hf.space/v1`
-        - **Key** any (인증 없음)
-        - **Model** `kpaa-privacy-ko`
-        """
-    )
+            한국 개인정보보호법 RAG 백엔드. **OpenAI 호환 API**.
+            UI 는 별도 Space (`scvcoder/korean-privacy-ai-assistant`) 의 Open WebUI 가 제공합니다.
 
-# Mount the Gradio Blocks at /gradio. The FastAPI routes (/v1/..., /healthz, ...)
-# remain at the root.
-final_app = gr.mount_gradio_app(fastapi_app, demo, path="/gradio")
+            ## API Endpoints
 
+            - **POST** `/v1/chat/completions` — OpenAI 호환 chat (스트리밍 지원)
+            - **GET** `/v1/models` — 모델 목록 (`kpaa-privacy-ko`)
+            - **GET** `/healthz` — health check
+            - **GET** `/info` — 상세 정보 / Swagger UI
 
-def main() -> None:
-    import uvicorn
+            ## 외부 연동
+            Open WebUI 등에 OpenAI provider 로 등록:
+            - **URL** `https://scvcoder-kpaa-backend.hf.space/v1`
+            - **Key** any (인증 없음)
+            - **Model** `kpaa-privacy-ko`
+            """
+        )
 
+    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)