# Copyright 2025 SGLang Team # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # ============================================================================== import re from typing import Dict, List, Optional, Union import numpy as np import torch from sglang.srt.managers.multimodal_processor import ( BaseMultimodalProcessor as SGLangBaseProcessor, ) from sglang.srt.managers.schedule_batch import Modality, MultimodalProcessorOutput from sglang.srt.models.gemma4_audio import _SSCP_CONV_STRIDE_SIZES from sglang.srt.models.gemma4_mm import Gemma4ForConditionalGeneration from sglang.srt.multimodal.processors.base_processor import MultimodalSpecialTokens from sglang.srt.utils.video_decoder import VideoDecoderWrapper class Gemma4SGLangProcessor(SGLangBaseProcessor): """Multimodal processor for Gemma4 supporting image, video, and audio inputs.""" models = [Gemma4ForConditionalGeneration] def __init__(self, hf_config, server_args, _processor, *args, **kwargs): super().__init__(hf_config, server_args, _processor, *args, **kwargs) self.IM_START_TOKEN_ID = hf_config.boi_token_id self.IM_END_TOKEN_ID = hf_config.eoi_token_id self.AUDIO_START_TOKEN_ID = hf_config.boa_token_id self.AUDIO_END_TOKEN_ID = hf_config.eoa_token_id self.mm_tokens = MultimodalSpecialTokens( image_token="<|image|>", image_token_id=hf_config.image_token_id, image_token_regex=re.compile( r"<\|image>(?:<\|image\|>)+|<\|image\|>" ), video_token="<|video|>", video_token_id=hf_config.video_token_id, video_token_regex=re.compile( r"<\|image>(?:<\|video\|>)+|<\|video\|>" ), audio_token="<|audio|>", audio_token_id=hf_config.audio_token_id, audio_token_regex=re.compile( r"<\|audio>(?:<\|audio\|>)+|<\|audio\|>" ), ).build(_processor) # Register image-processor and video-processor outputs so they are stored on # MultimodalDataItem via collect_mm_items_from_processor_output. self.ATTR_NAME_TO_MODALITY["image_position_ids"] = Modality.IMAGE self.ATTR_NAME_TO_MODALITY["video_position_ids"] = Modality.VIDEO def _get_audio_pad_multiple(self) -> int: """Derive the waveform padding alignment from processor config. The HF processor's ceil(duration_ms / audio_ms_per_token) formula can overshoot by 1 token relative to what the SSCP convolutions produce. Padding waveforms to a multiple of (hop_length * first_conv_stride) aligns the two calculations. See: gemma-4-eap-extras/examples/gemma-4-audio-examples.ipynb """ fe = getattr(self._processor, "feature_extractor", None) hop = getattr(fe, "hop_length", 160) first_stride = _SSCP_CONV_STRIDE_SIZES[0][0] return hop * first_stride def _video_decoder_to_tensor(self, vdw: VideoDecoderWrapper) -> torch.Tensor: """Convert a VideoDecoderWrapper to a (sampled_frames, C, H, W) uint8 tensor. SGLang's load_video returns VideoDecoderWrapper which the HF Gemma4VideoProcessor does not recognise (expects torch.Tensor or np.ndarray). We replicate HF's uniform frame sampling here to avoid materialising the entire video in memory, then delegate the rest (resize, patchify, position IDs) to the HF video processor. """ total = len(vdw) num_frames = getattr( getattr(self._processor, "video_processor", None), "num_frames", 32, ) if total <= num_frames: indices = list(range(total)) else: indices = torch.arange(0, total, total / num_frames).int().tolist() frames_np = vdw.get_frames_at(indices) # (N, H, W, C) return torch.from_numpy(frames_np).permute(0, 3, 1, 2).contiguous() def process_mm_data( self, input_text, images=None, videos=None, audios=None, **kwargs ): if audios: pad_multiple = self._get_audio_pad_multiple() padded = [] for a in audios: a = np.asarray(a) remainder = len(a) % pad_multiple if remainder != 0: a = np.pad(a, (0, pad_multiple - remainder), mode="constant") padded.append(a) audios = padded if videos: videos = [ ( self._video_decoder_to_tensor(v) if isinstance(v, VideoDecoderWrapper) else v ) for v in videos ] kwargs.setdefault("do_sample_frames", False) return super().process_mm_data( input_text, images=images, videos=videos, audios=audios, **kwargs ) async def process_mm_data_async( self, image_data: Optional[List[Union[str, bytes, Dict]]] = None, audio_data: Optional[List[Union[str, bytes, Dict]]] = None, input_text: str = "", request_obj=None, *args, **kwargs, ): """Process multimodal data including images, video, and audio.""" base_output = await self.load_mm_data( prompt=input_text, image_data=image_data, video_data=request_obj.video_data if request_obj else None, audio_data=audio_data, multimodal_tokens=self.mm_tokens, ) mm_items, input_ids, _ = self.process_and_combine_mm_data( base_output, self.mm_tokens ) return MultimodalProcessorOutput( input_ids=input_ids.tolist(), mm_items=mm_items, im_token_id=self.mm_tokens.image_token_id, video_token_id=self.mm_tokens.video_token_id, audio_token_id=self.mm_tokens.audio_token_id, )