app.py

import os
import base64
import json
from datetime import datetime
import traceback
from typing import Dict, Any

import gradio as gr
from huggingface_hub import HfApi, InferenceClient
from fastmcp import FastMCP
from pydantic import BaseModel, Field

HF_DATASET_REPO = os.environ.get("HF_DATASET_REPO", "OppaAI/Robot_MCP")
HF_VLM_MODEL = os.environ.get("HF_VLM_MODEL", "Qwen/Qwen2.5-VL-7B-Instruct")

mcp = FastMCP("Robot_MCP_Server")


# ---------------------------------------------------
#  Payload Schema
# ---------------------------------------------------
class RobotWatchPayload(BaseModel):
    hf_token: str = Field(description="Your Hugging Face API token.")
    robot_id: str = Field(description="Robot identifier.", default="unknown")
    image_b64: str = Field(description="Base64 encoded image data.")


# ---------------------------------------------------
# Upload Helper
# ---------------------------------------------------
def upload_image(image_b64: str, hf_token: str):
    try:
        image_bytes = base64.b64decode(image_b64)
        os.makedirs("/tmp", exist_ok=True)

        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S_%f")
        local_path = f"/tmp/robot_img_{timestamp}.jpg"

        with open(local_path, "wb") as f:
            f.write(image_bytes)

        filename = f"robot_{timestamp}.jpg"
        api = HfApi()

        api.upload_file(
            path_or_fileobj=local_path,
            path_in_repo=f"tmp/{filename}",
            repo_id=HF_DATASET_REPO,
            repo_type="dataset",
            token=hf_token
        )

        hf_url = f"https://huggingface.co/datasets/{HF_DATASET_REPO}/resolve/main/tmp/{filename}"
        return local_path, hf_url, filename, len(image_bytes)

    except Exception:
        traceback.print_exc()
        return None, None, None, 0


# ---------------------------------------------------
# JSON Cleaning Helper
# ---------------------------------------------------
def safe_parse_json_from_text(text: str):
    if not text:
        return None
    try:
        return json.loads(text)
    except:
        pass

    cleaned = text.strip().strip("`").strip()
    if cleaned.lower().startswith("json"):
        cleaned = cleaned[4:].strip()

    try:
        start = cleaned.find("{")
        end = cleaned.rfind("}")
        return json.loads(cleaned[start:end + 1])
    except:
        return None


# ---------------------------------------------------
# TRUE MCP TOOL
# ---------------------------------------------------
def robot_watch(payload: RobotWatchPayload):
    """
    Analyze a base64-encoded image using a Hugging Face Vision-Language Model (VLM) and return structured JSON.

    Args:
        payload (RobotWatchPayload): A Pydantic model containing:
            - hf_token (str): Your Hugging Face API token.
            - robot_id (str): The unique identifier for the robot.
            - image_b64 (str): Base64 encoded image data.

    Returns:
        dict: A dictionary containing:
            - status (str): "success" or "error".
            - robot_id (str): The ID of the robot.
            - file_size_bytes (int): Size of the uploaded image in bytes.
            - image_url (str): URL of the uploaded image on Hugging Face dataset.
            - result (dict): Parsed JSON response from the VLM containing "description", "human", "environment", "objects".
            - vlm_raw (str): Raw string response from the VLM model.
    """
    hf_token = payload.hf_token
    image_b64 = payload.image_b64
    robot_id = payload.robot_id

    _, hf_url, _, size_bytes = upload_image(image_b64, hf_token)
    if not hf_url:
        return {"error": "Image upload failed"}

    system_prompt = """
Respond in STRICT JSON ONLY:
{
 "description": "...",
 "human": "...",
 "environment": "...",
 "objects": []
}
"""

    messages = [
        {"role": "system", "content": system_prompt},
        {"role": "user", "content": [
            {"type": "text", "text": "Analyze the image."},
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{image_b64}"}}
        ]}
    ]

    client = InferenceClient(token=hf_token)
    try:
        resp = client.chat.completions.create(
            model=HF_VLM_MODEL,
            messages=messages,
            max_tokens=500,
            temperature=0.1
        )
    except Exception as e:
        return {"status": "error", "message": str(e)}

    vlm_output = resp.choices[0].message.content.strip()
    parsed = safe_parse_json_from_text(vlm_output) or {}

    return {
        "status": "success",
        "robot_id": robot_id,
        "file_size_bytes": size_bytes,
        "image_url": hf_url,
        "result": parsed,
        "vlm_raw": vlm_output
    }


# ---------------------------------------------------
# Gradio UI Placeholder
# ---------------------------------------------------
def robot_watch(payload):
    return {"message": "Use an MCP Client to call the robot_watch tool."}


app = gr.Interface(
    fn=robot_watch,
    inputs=gr.JSON(),
    outputs=gr.JSON(),
    title="Robot MCP Server",
    description="A MCP Server to describe image obtained from the CV of a robot/webcam.",
    api_name="predict"
)

if __name__ == "__main__":
    app.launch(mcp_server=True)