feat: integrate FastAPI backend and health check functionality

- Added FastAPI as a backend server to handle API requests.
- Implemented health check endpoint to monitor backend status.
- Introduced new configuration management using Pydantic.
- Updated Gradio interface to display backend health status dynamically.
- Added necessary dependencies for FastAPI and Uvicorn in project configuration.

app.py

@@ -1,6 +1,9 @@
+import threading
+
 import gradio as gr
 import gradio.components as grc
 import pandas as pd
+import uvicorn
 from apscheduler.schedulers.background import BackgroundScheduler
 from huggingface_hub import snapshot_download
 from rich import print
@@ -14,6 +17,7 @@ from src.about import (
     LLM_BENCHMARKS_TEXT,
     TITLE,
 )
+from src.backend.app import create_app
 from src.display.css_html_js import custom_css
 from src.display.utils import (
     BASE_COLS,
@@ -404,7 +408,26 @@ with demo:
                 show_copy_button=True,
             )
 
-scheduler = BackgroundScheduler()
-scheduler.add_job(restart_space, "interval", seconds=1800)
-scheduler.start()
-demo.queue(default_concurrency_limit=40).launch()
+
+if __name__ == "__main__":
+    # Backend server - 在单独的线程中运行
+    app = create_app()
+
+    def run_fastapi():
+        print("Starting FastAPI server on http://0.0.0.0:8000")
+        uvicorn.run(
+            app,
+            host="0.0.0.0",
+            port=8000,
+            log_level="info",
+            access_log=True,
+        )
+
+    fastapi_thread = threading.Thread(target=run_fastapi, daemon=True)
+    fastapi_thread.start()
+
+    # Gradio server - 在主线程中运行（阻塞）
+    scheduler = BackgroundScheduler()
+    scheduler.add_job(restart_space, "interval", seconds=1800)
+    scheduler.start()
+    demo.queue(default_concurrency_limit=40).launch()

pyproject.toml

@@ -25,6 +25,9 @@ dependencies = [
   "pydantic>=2.11.10",
   "pydantic-settings>=2.11.0",
   "rich>=14.2.0",
+  "fastapi>=0.120.0",
+  "loguru>=0.7.3",
+  "uvicorn>=0.38.0",
 ]
 
 [dependency-groups]

src/backend/app.py

@@ -0,0 +1,30 @@
+from fastapi import FastAPI, Request
+from fastapi.responses import RedirectResponse
+from fastapi.routing import APIRoute
+
+from .config import settings
+from .routes.main import api_router
+
+
+def create_app() -> FastAPI:
+    app = FastAPI(
+        title="Leaderboard API",
+        description="API for the Leaderboard",
+        version="0.1.0",
+        docs_url=f"{settings.API_V1_STR}/docs",
+        openapi_url=f"{settings.API_V1_STR}/openapi.json",
+        generate_unique_id_function=custom_generate_unique_id,
+    )
+
+    app.include_router(api_router, prefix=settings.API_V1_STR)
+    app.add_route("/", _redirect_to_docs, methods=["GET"])
+
+    return app
+
+
+def custom_generate_unique_id(route: APIRoute) -> str:
+    return f"{route.tags[0]}-{route.name}"
+
+
+async def _redirect_to_docs(_: Request):
+    return RedirectResponse(url=f"{settings.API_V1_STR}/docs")

src/backend/config.py

@@ -0,0 +1,38 @@
+from functools import cached_property
+from typing import Annotated
+
+from dotenv import load_dotenv
+from pydantic import Field, SecretStr
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+load_dotenv()
+
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(env_file=".env", extra="ignore")
+
+    API_V1_STR: str = "/api/v1"
+
+    # ------------------------------------------------------------
+    # Hugging Face settings
+    # ------------------------------------------------------------
+    HF_TOKEN: Annotated[SecretStr, Field(description="Hugging Face Access Token")] = SecretStr("changethis")
+
+    @cached_property
+    def hf_api(self):
+        from huggingface_hub import HfApi
+
+        token = self.HF_TOKEN.get_secret_value()
+        if not token or token == "changethis":
+            raise RuntimeError("Hugging Face Access Token is not set.")
+
+        return HfApi(
+            endpoint="https://huggingface.co",
+            token=token,
+        )
+
+    REQUESTS_REPO_ID: str = "y-playground/requests"
+    RESULTS_REPO_ID: str = "y-playground/results"
+
+
+settings = Settings()

src/backend/routes/health.py

@@ -0,0 +1,17 @@
+from datetime import datetime, timezone
+
+from fastapi import APIRouter
+
+router = APIRouter(tags=["health"])
+
+
+@router.get("/")
+async def health():
+    utc_now = datetime.now(timezone.utc).isoformat()
+    return {
+        "code": 0,
+        "msg": "ok",
+        "data": {
+            "utc_now": utc_now,
+        },
+    }

src/backend/routes/hf.py

@@ -0,0 +1,47 @@
+import io
+from dataclasses import asdict
+
+from fastapi import APIRouter
+from loguru import logger
+
+from src.backend.config import settings
+from src.backend.schemas import HfRepoUrl, ResponseData, Submit_Params, Submit_RespData
+
+router = APIRouter(tags=["huggingface"])
+
+
+@router.post("/community/submit/")
+async def submit(params: Submit_Params) -> ResponseData[Submit_RespData]:
+    """Submit a new evaluation request to the Hugging Face repository."""
+    file_obj = io.BytesIO(params.content.encode("utf-8"))
+    commit_info = settings.hf_api.upload_file(
+        path_or_fileobj=file_obj,
+        path_in_repo=params.path_in_repo,
+        repo_id=settings.REQUESTS_REPO_ID,
+        repo_type="dataset",
+        commit_message=params.commit_message,
+    )
+    data_dict = asdict(commit_info)
+    try:
+        repo_url = HfRepoUrl.model_validate({
+            "endpoint": commit_info.repo_url.endpoint,
+            "namespace": commit_info.repo_url.namespace,
+            "repo_name": commit_info.repo_url.repo_name,
+            "repo_id": commit_info.repo_url.repo_id,
+            "repo_type": commit_info.repo_url.repo_type,
+            "url": commit_info.repo_url.url,
+        })
+        return ResponseData(
+            data=Submit_RespData.model_validate({
+                **data_dict,
+                "repo_url": repo_url,
+            })
+        )
+    except Exception as e:
+        msg = f"Failed to validate repo url: {e}"
+        logger.warning(msg)
+        return ResponseData(
+            code=500,
+            msg=msg,
+            data=Submit_RespData.model_validate(data_dict),
+        )

src/backend/routes/main.py

@@ -0,0 +1,8 @@
+from fastapi import APIRouter
+
+from .health import router as health_router
+from .hf import router as hf_router
+
+api_router = APIRouter()
+api_router.include_router(health_router, prefix="/health")
+api_router.include_router(hf_router, prefix="/hf")

src/backend/schemas.py

@@ -0,0 +1,44 @@
+from typing import Annotated, Generic, Literal, TypeVar
+
+from pydantic import BaseModel, ConfigDict, Field
+
+T = TypeVar("T", bound=BaseModel)
+
+
+class ResponseData(BaseModel, Generic[T]):
+    code: int = 0
+    msg: str = "ok"
+    data: T | None = None
+
+
+# --- Submit
+class Submit_Params(BaseModel):
+    path_in_repo: str
+    commit_message: str | None = None
+
+    model_id: str
+    model_sha: str = "main"
+    model_dtype: str
+
+    content: str
+
+
+class Submit_RespData(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    commit_url: str
+    commit_message: str
+    commit_description: str
+    oid: Annotated[str, Field(description="Commit hash id.")]
+    repo_url: "HfRepoUrl | None" = None
+
+
+class HfRepoUrl(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    endpoint: str
+    namespace: str
+    repo_name: str
+    repo_id: str
+    repo_type: Literal["model", "dataset", "space"]
+    url: str

uv.lock

@@ -674,10 +674,12 @@ source = { virtual = "." }
 dependencies = [
     { name = "apscheduler" },
     { name = "datasets" },
+    { name = "fastapi" },
     { name = "gradio", extra = ["oauth"] },
     { name = "gradio-client" },
     { name = "gradio-leaderboard" },
     { name = "huggingface-hub" },
+    { name = "loguru" },
     { name = "matplotlib" },
     { name = "numpy" },
     { name = "pandas" },
@@ -690,6 +692,7 @@ dependencies = [
     { name = "tokenizers" },
     { name = "tqdm" },
     { name = "transformers" },
+    { name = "uvicorn" },
 ]
 
 [package.dev-dependencies]
@@ -701,11 +704,13 @@ dev = [
 requires-dist = [
     { name = "apscheduler" },
     { name = "datasets" },
+    { name = "fastapi", specifier = ">=0.120.0" },
     { name = "gradio" },
     { name = "gradio", extras = ["oauth"] },
     { name = "gradio-client" },
     { name = "gradio-leaderboard", specifier = "==0.0.13" },
     { name = "huggingface-hub", specifier = ">=0.18.0" },
+    { name = "loguru", specifier = ">=0.7.3" },
     { name = "matplotlib" },
     { name = "numpy" },
     { name = "pandas" },
@@ -718,11 +723,25 @@ requires-dist = [
     { name = "tokenizers", specifier = ">=0.15.0" },
     { name = "tqdm" },
     { name = "transformers" },
+    { name = "uvicorn", specifier = ">=0.38.0" },
 ]
 
 [package.metadata.requires-dev]
 dev = [{ name = "ruff", specifier = ">=0.14.0,<0.15.0" }]
 
+[[package]]
+name = "loguru"
+version = "0.7.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "win32-setctime", marker = "sys_platform == 'win32'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/3a/05/a1dae3dffd1116099471c643b8924f5aa6524411dc6c63fdae648c4f1aca/loguru-0.7.3.tar.gz", hash = "sha256:19480589e77d47b8d85b2c827ad95d49bf31b0dcde16593892eb51dd18706eb6", size = 63559, upload-time = "2024-12-06T11:20:56.608Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0c/29/0348de65b8cc732daa3e33e67806420b2ae89bdce2b04af740289c5c6c8c/loguru-0.7.3-py3-none-any.whl", hash = "sha256:31a33c10c8e1e10422bfd431aeb5d351c7cf7fa671e3c4df004162264b28220c", size = 61595, upload-time = "2024-12-06T11:20:54.538Z" },
+]
+
 [[package]]
 name = "markdown-it-py"
 version = "4.0.0"
@@ -1478,6 +1497,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/fa/a8/5b41e0da817d64113292ab1f8247140aac61cbf6cfd085d6a0fa77f4984f/websockets-15.0.1-py3-none-any.whl", hash = "sha256:f7a866fbc1e97b5c617ee4116daaa09b722101d4a3c170c787450ba409f9736f", size = 169743, upload-time = "2025-03-05T20:03:39.41Z" },
 ]
 
+[[package]]
+name = "win32-setctime"
+version = "1.2.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b3/8f/705086c9d734d3b663af0e9bb3d4de6578d08f46b1b101c2442fd9aecaa2/win32_setctime-1.2.0.tar.gz", hash = "sha256:ae1fdf948f5640aae05c511ade119313fb6a30d7eabe25fef9764dca5873c4c0", size = 4867, upload-time = "2024-12-07T15:28:28.314Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e1/07/c6fe3ad3e685340704d314d765b7912993bcb8dc198f0e7a89382d37974b/win32_setctime-1.2.0-py3-none-any.whl", hash = "sha256:95d644c4e708aba81dc3704a116d8cbc974d70b3bdb8be1d150e36be6e9d1390", size = 4083, upload-time = "2024-12-07T15:28:26.465Z" },
+]
+
 [[package]]
 name = "xxhash"
 version = "3.6.0"