Files
project_6_89d52222/upstream_ref/xllm/xllm/pybind/mm_utils.py
EX Engine 002f9879b2 ref(upstream): FULL TREE — Deep-Spark xllm (1470) + ds_vllm csrc/models (703)
Replaces cherry-picked upstream_ref with complete source trees.

xllm/ — Iluvatar official C++ inference engine (15MB, 1470 files)
  Complete: kernels → layers → models → runtime → scheduler → api
  Excluded: .git, binary images, third_party submodule checkouts

ds_vllm/ — Iluvatar official vllm fork (8MB, 703 files)
  Included: csrc/ (ALL CUDA kernels), fused_moe/, qwen3_5 model, _custom_ops
  Excluded: tests, benchmarks, docs, examples (not needed for reference)

Critical call chains now fully traceable:
  MoE: moe_topk_softmax_kernels.cuh → ixformer.h → fused_moe.cpp → layer
  GDN: qwen3_gated_delta_net_base.cpp → qwen3_5_gated_delta_net.cpp
  Attention: ixformer.h → xllm_paged_attention → attention.cpp
2026-08-10 02:54:03 +00:00

114 lines
3.6 KiB
Python

import base64
from io import BytesIO
from typing import Any, Dict, List, Optional, Tuple
from PIL import Image
from xllm_export import MMData
def _bytes_to_data_url(data: bytes) -> str:
encoded = base64.b64encode(data).decode("ascii")
return f"data:image;base64,{encoded}"
def _pil_to_data_url(image: Image.Image) -> str:
buf = BytesIO()
fmt = image.format or "PNG"
image.save(buf, format=fmt)
return _bytes_to_data_url(buf.getvalue())
def normalize_vllm_style_inputs(
prompts: Any,
) -> Tuple[List[str], Optional[List[MMData]], Optional[List[List[str]]]]:
if isinstance(prompts, dict):
requests = [prompts]
return _parse_vllm_style_requests(requests)
if isinstance(prompts, list) and prompts and all(isinstance(x, dict) for x in prompts):
return _parse_vllm_style_requests(prompts)
raise TypeError(
"VLM-style inputs must be dict/List[dict] with key 'prompt', e.g. "
"{'prompt': '...', 'multi_modal_data': {'image': image}}"
)
def _parse_vllm_style_requests(
requests: List[Dict[str, Any]],
) -> Tuple[List[str], Optional[List[MMData]], Optional[List[List[str]]]]:
prompts: List[str] = []
mm_datas: List[MMData] = []
image_urls: List[List[str]] = []
use_mm_data: Optional[bool] = None
for req in requests:
if "prompt" not in req:
raise ValueError("Each request dict must contain key 'prompt'")
prompt = req["prompt"]
if not isinstance(prompt, str):
raise TypeError("request['prompt'] must be a string")
prompts.append(prompt)
if "multi_modal_data" not in req:
if use_mm_data is True:
raise TypeError("Cannot mix MMData and empty multi_modal_data in one batch")
use_mm_data = False
image_urls.append([])
continue
payload = req["multi_modal_data"]
if isinstance(payload, MMData):
if use_mm_data is False:
raise TypeError("Cannot mix MMData and image inputs in one batch")
use_mm_data = True
mm_datas.append(payload)
else:
if use_mm_data is True:
raise TypeError("Cannot mix MMData and image inputs in one batch")
use_mm_data = False
image_urls.append(_to_image_urls(payload))
if use_mm_data:
return prompts, mm_datas, None
return prompts, None, image_urls
def _to_image_urls(payload: Any) -> List[str]:
if not isinstance(payload, dict):
raise TypeError("multi_modal_data must be dict or MMData")
if "image" in payload:
images = payload["image"]
return _normalize_images(images)
if "video" in payload:
raise NotImplementedError("video multi_modal_data is not supported yet")
if "audio" in payload:
raise NotImplementedError("audio multi_modal_data is not supported yet")
raise ValueError(
"Unsupported multi_modal_data format. Expected {'image': ...} or MMData."
)
def _normalize_images(images: Any) -> List[str]:
if isinstance(images, (list, tuple)):
if len(images) == 0:
raise ValueError("multi_modal_data['image'] cannot be empty")
return [_to_image_url(img) for img in images]
return [_to_image_url(images)]
def _to_image_url(image: Any) -> str:
if isinstance(image, str):
return image
if isinstance(image, Image.Image):
return _pil_to_data_url(image.convert("RGB"))
if isinstance(image, (bytes, bytearray)):
return _bytes_to_data_url(bytes(image))
raise TypeError(
"image must be image path/url string, PIL.Image, bytes, "
"or a list of these"
)