# SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved. # SPDX-License-Identifier: Apache-2.0 # # 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 json import logging import uuid from enum import Enum from typing import AsyncIterator, Tuple, Union from components.worker import VllmPDWorker from transformers import AutoTokenizer from utils.args import parse_vllm_args from utils.chat_processor import ChatProcessor, CompletionsProcessor, ProcessMixIn from utils.logging import check_required_workers from utils.protocol import MultiModalRequest, MyRequestOutput, vLLMMultimodalRequest from vllm.engine.arg_utils import AsyncEngineArgs from vllm.entrypoints.openai.protocol import ChatCompletionRequest, CompletionRequest from vllm.outputs import RequestOutput from vllm.transformers_utils.tokenizer import AnyTokenizer from dynamo.sdk import async_on_start, depends, dynamo_context, endpoint, service logger = logging.getLogger(__name__) class RequestType(Enum): CHAT = "chat" COMPLETION = "completion" @service( dynamo={ "namespace": "dynamo", }, resources={"cpu": "10", "memory": "20Gi"}, workers=1, ) class Processor(ProcessMixIn): """ vLLM pre and post processing """ pd_worker = depends(VllmPDWorker) def __init__(self): class_name = self.__class__.__name__ self.engine_args = parse_vllm_args(class_name, "") self.model_config = self.engine_args.create_model_config() self.default_sampling_params = self.model_config.get_diff_sampling_param() self.tokenizer = self._create_tokenizer(self.engine_args) self.chat_processor = ChatProcessor(self.tokenizer, self.model_config) self.completions_processor = CompletionsProcessor( self.tokenizer, self.model_config ) self.min_workers = 1 def _create_tokenizer(self, engine_args: AsyncEngineArgs) -> AnyTokenizer: """Create a TokenizerGroup using engine arguments similar to VLLM's approach""" model_path = engine_args.model # Create the base tokenizer with VLLM's typical settings base_tokenizer = AutoTokenizer.from_pretrained( model_path, trust_remote_code=True, padding_side="left", truncation_side="left", use_fast=True, # VLLM might use the fast tokenizer for efficiency ) return base_tokenizer @async_on_start async def async_init(self): runtime = dynamo_context["runtime"] comp_ns, comp_name = VllmPDWorker.dynamo_address() # type: ignore self.encode_worker_client = ( await runtime.namespace(comp_ns) .component(comp_name) .endpoint("generate") .client() ) await check_required_workers(self.encode_worker_client, self.min_workers) # Main method to parse the request and send the request to the vllm worker. async def _generate( self, raw_request: Union[CompletionRequest, ChatCompletionRequest], image: str, request_type: RequestType, ): request_id = str(uuid.uuid4().hex) logger.debug(f"Got raw request: {raw_request}") ( request, conversation, prompt, engine_prompt, sampling_params, ) = await self._parse_raw_request(raw_request) worker_request = vLLMMultimodalRequest( engine_prompt=engine_prompt, sampling_params=sampling_params, request_id=request_id, image_url=image, ) response_generator = await self.encode_worker_client.round_robin( worker_request.model_dump_json() ) output = self._generate_responses(response_generator, request_type) # Stream the processed responses async for response in await self._stream_response( request, output, request_id, conversation ): yield response # This method is used to process the responses from the engine generator. async def _generate_responses( self, response_generator: AsyncIterator[RequestOutput], request_type: RequestType, ) -> AsyncIterator[Union[RequestOutput, Tuple[int, RequestOutput]]]: async for resp in response_generator: # Deserialize the response from the engine # Creates correct vLLM objects for each field output = MyRequestOutput.model_validate_json(resp.data()) # OpenAIServingChat.chat_completion_stream_generator() method expects a RequestOutput object request_output = RequestOutput( request_id=output.request_id, prompt=output.prompt, prompt_token_ids=output.prompt_token_ids, prompt_logprobs=output.prompt_logprobs, outputs=output.outputs, finished=output.finished, metrics=output.metrics, ) if request_type == RequestType.CHAT: # For chat requests, yield the request_output directly. yield request_output else: raise NotImplementedError( f"Request type {request_type} not implemented" ) # The generate endpoint will be used by the frontend to handle incoming requests. @endpoint() async def generate(self, raw_request: MultiModalRequest): # Ensure the configured template includes the placeholder template = self.engine_args.prompt_template if "" not in template: raise ValueError("prompt_template must contain '' placeholder") # Safely extract user text try: user_text = raw_request.messages[0].content[0].text except (IndexError, AttributeError) as e: raise ValueError(f"Invalid message structure: {e}") prompt = template.replace("", user_text) msg = { "role": "user", "content": prompt, } chat_request = ChatCompletionRequest( model=raw_request.model, messages=[msg], stream=raw_request.stream, max_tokens=raw_request.max_tokens, temperature=raw_request.temperature, request_id=str(uuid.uuid4()), ) image_url = None for message in raw_request.messages: for item in message.content: if item.type == "image_url": image_url = item.image_url.url if image_url is None: raise ValueError("Image URL is required") async for response in self._generate(chat_request, image_url, RequestType.CHAT): yield json.dumps(response)