setup.py 40.5 KB
Newer Older
1
# SPDX-License-Identifier: Apache-2.0
2
# SPDX-FileCopyrightText: Copyright contributors to the vLLM project
3

4
import ctypes
5
import importlib.util
6
import json
7
import logging
8
import os
9
import re
10
import shutil
11
import subprocess
bnellnm's avatar
bnellnm committed
12
import sys
13
import sysconfig
14
from pathlib import Path
15
from shutil import which
16

Woosuk Kwon's avatar
Woosuk Kwon committed
17
import torch
18
from packaging.version import Version, parse
19
from setuptools import Extension, setup
20
from setuptools.command.build_ext import build_ext
21
from setuptools_scm import get_version
22
from torch.utils.cpp_extension import CUDA_HOME, ROCM_HOME
23

24

zhuwenwen's avatar
zhuwenwen committed
25
26
27
28
29
30
31
32
33
from typing import Optional, Union
import subprocess
from pathlib import Path

pwd = os.path.dirname(os.path.abspath(__file__))
add_git_version = False
if int(os.environ.get('ADD_GIT_VERSION', '0')) == 1:
    add_git_version = True
    
34
35
36
37
38
39
40
41
def load_module_from_path(module_name, path):
    spec = importlib.util.spec_from_file_location(module_name, path)
    module = importlib.util.module_from_spec(spec)
    sys.modules[module_name] = module
    spec.loader.exec_module(module)
    return module


42
ROOT_DIR = Path(__file__).parent
43
logger = logging.getLogger(__name__)
44
45
46

# cannot import envs directly because it depends on vllm,
#  which is not installed yet
47
envs = load_module_from_path("envs", os.path.join(ROOT_DIR, "vllm", "envs.py"))
48
49

VLLM_TARGET_DEVICE = envs.VLLM_TARGET_DEVICE
50

51
if sys.platform.startswith("darwin") and VLLM_TARGET_DEVICE != "cpu":
52
    logger.warning("VLLM_TARGET_DEVICE automatically set to `cpu` due to macOS")
53
    VLLM_TARGET_DEVICE = "cpu"
54
elif not (sys.platform.startswith("linux") or sys.platform.startswith("darwin")):
55
56
    logger.warning(
        "vLLM only supports Linux platform (including WSL) and MacOS."
57
        "Building on %s, "
58
59
60
        "so vLLM may not be able to run correctly",
        sys.platform,
    )
61
    VLLM_TARGET_DEVICE = "empty"
62
63
64
65
elif sys.platform.startswith("linux") and os.getenv("VLLM_TARGET_DEVICE") is None:
    if torch.version.hip is not None:
        VLLM_TARGET_DEVICE = "rocm"
        logger.info("Auto-detected ROCm")
66
67
68
    elif torch.version.xpu is not None:
        VLLM_TARGET_DEVICE = "xpu"
        logger.info("Auto-detected XPU")
69
70
71
72
73
    elif torch.version.cuda is not None:
        VLLM_TARGET_DEVICE = "cuda"
        logger.info("Auto-detected CUDA")
    else:
        VLLM_TARGET_DEVICE = "cpu"
74

bnellnm's avatar
bnellnm committed
75
76

def is_sccache_available() -> bool:
77
78
79
    return which("sccache") is not None and not bool(
        int(os.getenv("VLLM_DISABLE_SCCACHE", "0"))
    )
bnellnm's avatar
bnellnm committed
80
81
82
83
84
85
86
87
88
89


def is_ccache_available() -> bool:
    return which("ccache") is not None


def is_ninja_available() -> bool:
    return which("ninja") is not None


90
91
def is_freethreaded():
    return bool(sysconfig.get_config_var("Py_GIL_DISABLED"))
92
93


bnellnm's avatar
bnellnm committed
94
class CMakeExtension(Extension):
95
    def __init__(self, name: str, cmake_lists_dir: str = ".", **kwa) -> None:
96
        super().__init__(name, sources=[], py_limited_api=not is_freethreaded(), **kwa)
bnellnm's avatar
bnellnm committed
97
98
99
100
101
        self.cmake_lists_dir = os.path.abspath(cmake_lists_dir)


class cmake_build_ext(build_ext):
    # A dict of extension directories that have been configured.
102
    did_config: dict[str, bool] = {}
bnellnm's avatar
bnellnm committed
103
104
105
106
107

    #
    # Determine number of compilation jobs and optionally nvcc compile threads.
    #
    def compute_num_jobs(self):
108
109
        # `num_jobs` is either the value of the MAX_JOBS environment variable
        # (if defined) or the number of CPUs available.
110
        num_jobs = envs.MAX_JOBS
111
112
        if num_jobs is not None:
            num_jobs = int(num_jobs)
113
            logger.info("Using MAX_JOBS=%d as the number of jobs.", num_jobs)
114
115
116
117
118
119
120
        else:
            try:
                # os.sched_getaffinity() isn't universally available, so fall
                #  back to os.cpu_count() if we get an error here.
                num_jobs = len(os.sched_getaffinity(0))
            except AttributeError:
                num_jobs = os.cpu_count()
bnellnm's avatar
bnellnm committed
121

122
        nvcc_threads = None
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
        if _is_cuda() and CUDA_HOME is not None:
            try:
                nvcc_version = get_nvcc_cuda_version()
                if nvcc_version >= Version("11.2"):
                    # `nvcc_threads` is either the value of the NVCC_THREADS
                    # environment variable (if defined) or 1.
                    # when it is set, we reduce `num_jobs` to avoid
                    # overloading the system.
                    nvcc_threads = envs.NVCC_THREADS
                    if nvcc_threads is not None:
                        nvcc_threads = int(nvcc_threads)
                        logger.info(
                            "Using NVCC_THREADS=%d as the number of nvcc threads.",
                            nvcc_threads,
                        )
                    else:
                        nvcc_threads = 1
                    num_jobs = max(1, num_jobs // nvcc_threads)
            except Exception as e:
                logger.warning("Failed to get NVCC version: %s", e)
bnellnm's avatar
bnellnm committed
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

        return num_jobs, nvcc_threads

    #
    # Perform cmake configuration for a single extension.
    #
    def configure(self, ext: CMakeExtension) -> None:
        # If we've already configured using the CMakeLists.txt for
        # this extension, exit early.
        if ext.cmake_lists_dir in cmake_build_ext.did_config:
            return

        cmake_build_ext.did_config[ext.cmake_lists_dir] = True

        # Select the build type.
        # Note: optimization level + debug info are set by the build type
        default_cfg = "Debug" if self.debug else "RelWithDebInfo"
160
        cfg = envs.CMAKE_BUILD_TYPE or default_cfg
bnellnm's avatar
bnellnm committed
161
162

        cmake_args = [
163
164
            "-DCMAKE_BUILD_TYPE={}".format(cfg),
            "-DVLLM_TARGET_DEVICE={}".format(VLLM_TARGET_DEVICE),
bnellnm's avatar
bnellnm committed
165
166
        ]

167
        verbose = envs.VERBOSE
bnellnm's avatar
bnellnm committed
168
        if verbose:
169
            cmake_args += ["-DCMAKE_VERBOSE_MAKEFILE=ON"]
bnellnm's avatar
bnellnm committed
170
171
172

        if is_sccache_available():
            cmake_args += [
173
174
175
176
                "-DCMAKE_C_COMPILER_LAUNCHER=sccache",
                "-DCMAKE_CXX_COMPILER_LAUNCHER=sccache",
                "-DCMAKE_CUDA_COMPILER_LAUNCHER=sccache",
                "-DCMAKE_HIP_COMPILER_LAUNCHER=sccache",
bnellnm's avatar
bnellnm committed
177
178
179
            ]
        elif is_ccache_available():
            cmake_args += [
180
181
182
183
                "-DCMAKE_C_COMPILER_LAUNCHER=ccache",
                "-DCMAKE_CXX_COMPILER_LAUNCHER=ccache",
                "-DCMAKE_CUDA_COMPILER_LAUNCHER=ccache",
                "-DCMAKE_HIP_COMPILER_LAUNCHER=ccache",
bnellnm's avatar
bnellnm committed
184
185
186
187
            ]

        # Pass the python executable to cmake so it can find an exact
        # match.
188
        cmake_args += ["-DVLLM_PYTHON_EXECUTABLE={}".format(sys.executable)]
bnellnm's avatar
bnellnm committed
189

190
191
        # Pass the python path to cmake so it can reuse the build dependencies
        # on subsequent calls to python.
192
        cmake_args += ["-DVLLM_PYTHON_PATH={}".format(":".join(sys.path))]
193

194
195
196
197
198
199
        # Override the base directory for FetchContent downloads to $ROOT/.deps
        # This allows sharing dependencies between profiles,
        # and plays more nicely with sccache.
        # To override this, set the FETCHCONTENT_BASE_DIR environment variable.
        fc_base_dir = os.path.join(ROOT_DIR, ".deps")
        fc_base_dir = os.environ.get("FETCHCONTENT_BASE_DIR", fc_base_dir)
200
        cmake_args += ["-DFETCHCONTENT_BASE_DIR={}".format(fc_base_dir)]
201

bnellnm's avatar
bnellnm committed
202
203
204
205
206
207
        #
        # Setup parallelism and build tool
        #
        num_jobs, nvcc_threads = self.compute_num_jobs()

        if nvcc_threads:
208
            cmake_args += ["-DNVCC_THREADS={}".format(nvcc_threads)]
bnellnm's avatar
bnellnm committed
209
210

        if is_ninja_available():
211
            build_tool = ["-G", "Ninja"]
bnellnm's avatar
bnellnm committed
212
            cmake_args += [
213
214
                "-DCMAKE_JOB_POOL_COMPILE:STRING=compile",
                "-DCMAKE_JOB_POOLS:STRING=compile={}".format(num_jobs),
bnellnm's avatar
bnellnm committed
215
216
217
218
            ]
        else:
            # Default build tool to whatever cmake picks.
            build_tool = []
219
        # Make sure we use the nvcc from CUDA_HOME
220
        if _is_cuda() and CUDA_HOME is not None:
221
            cmake_args += [f"-DCMAKE_CUDA_COMPILER={CUDA_HOME}/bin/nvcc"]
222
        elif _is_hip() and ROCM_HOME is not None:
223
            cmake_args += [f"-DROCM_PATH={ROCM_HOME}"]
224
225
226
227
228

        other_cmake_args = os.environ.get("CMAKE_ARGS")
        if other_cmake_args:
            cmake_args += other_cmake_args.split()

bnellnm's avatar
bnellnm committed
229
        subprocess.check_call(
230
231
232
            ["cmake", ext.cmake_lists_dir, *build_tool, *cmake_args],
            cwd=self.build_temp,
        )
bnellnm's avatar
bnellnm committed
233
234
235
236

    def build_extensions(self) -> None:
        # Ensure that CMake is present and working
        try:
237
            subprocess.check_output(["cmake", "--version"])
bnellnm's avatar
bnellnm committed
238
        except OSError as e:
239
            raise RuntimeError("Cannot find CMake executable") from e
bnellnm's avatar
bnellnm committed
240
241
242
243
244

        # Create build directory if it does not exist.
        if not os.path.exists(self.build_temp):
            os.makedirs(self.build_temp)

245
        targets = []
246
247
248
249

        def target_name(s: str) -> str:
            return s.removeprefix("vllm.").removeprefix("vllm_flash_attn.")

bnellnm's avatar
bnellnm committed
250
251
252
        # Build all the extensions
        for ext in self.extensions:
            self.configure(ext)
253
            targets.append(target_name(ext.name))
bnellnm's avatar
bnellnm committed
254

255
        num_jobs, _ = self.compute_num_jobs()
bnellnm's avatar
bnellnm committed
256

257
258
259
260
261
262
        build_args = [
            "--build",
            ".",
            f"-j={num_jobs}",
            *[f"--target={name}" for name in targets],
        ]
bnellnm's avatar
bnellnm committed
263

264
        subprocess.check_call(["cmake", *build_args], cwd=self.build_temp)
265

266
267
268
269
270
271
272
273
274
275
276
277
        # Install the libraries
        for ext in self.extensions:
            # Install the extension into the proper location
            outdir = Path(self.get_ext_fullpath(ext.name)).parent.absolute()

            # Skip if the install directory is the same as the build directory
            if outdir == self.build_temp:
                continue

            # CMake appends the extension prefix to the install path,
            # and outdir already contains that prefix, so we need to remove it.
            prefix = outdir
278
            for _ in range(ext.name.count(".")):
279
280
281
282
                prefix = prefix.parent

            # prefix here should actually be the same for all components
            install_args = [
283
284
285
286
287
288
289
                "cmake",
                "--install",
                ".",
                "--prefix",
                prefix,
                "--component",
                target_name(ext.name),
290
291
292
            ]
            subprocess.check_call(install_args, cwd=self.build_temp)

293
294
295
296
    def run(self):
        # First, run the standard build_ext command to compile the extensions
        super().run()

297
        # copy vllm/vllm_flash_attn/**/*.py from self.build_lib to current
298
299
        # directory so that they can be included in the editable build
        import glob
300
301
302
303
304

        files = glob.glob(
            os.path.join(self.build_lib, "vllm", "vllm_flash_attn", "**", "*.py"),
            recursive=True,
        )
305
        for file in files:
306
307
308
            dst_file = os.path.join(
                "vllm/vllm_flash_attn", file.split("vllm/vllm_flash_attn/")[-1]
            )
309
            print(f"Copying {file} to {dst_file}")
310
            os.makedirs(os.path.dirname(dst_file), exist_ok=True)
311
312
            self.copy_file(file, dst_file)

zhuwenwen's avatar
zhuwenwen committed
313
        if _is_cuda():
314
315
316
317
318
319
320
321
322
323
324
325
326
            # copy vllm/third_party/triton_kernels/**/*.py from self.build_lib
            # to current directory so that they can be included in the editable
            # build
            print(
                f"Copying {self.build_lib}/vllm/third_party/triton_kernels "
                "to vllm/third_party/triton_kernels"
            )
            shutil.copytree(
                f"{self.build_lib}/vllm/third_party/triton_kernels",
                "vllm/third_party/triton_kernels",
                dirs_exist_ok=True,
            )

327

328
329
330
331
class precompiled_build_ext(build_ext):
    """Disables extension building when using precompiled binaries."""

    def run(self) -> None:
332
        return
333
334
335
336
337
338
339

    def build_extensions(self) -> None:
        print("Skipping build_ext: using precompiled extensions.")
        return


class precompiled_wheel_utils:
340
341
    """Extracts libraries and other files from an existing wheel."""

342
    @staticmethod
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
    def fetch_metadata_for_variant(
        commit: str, variant: str | None
    ) -> tuple[list[dict], str]:
        """
        Fetches metadata for a specific variant of the precompiled wheel.
        """
        variant_dir = f"{variant}/" if variant is not None else ""
        repo_url = f"https://wheels.vllm.ai/{commit}/{variant_dir}vllm/"
        meta_url = repo_url + "metadata.json"
        print(f"Trying to fetch nightly build metadata from {meta_url}")
        from urllib.request import urlopen

        with urlopen(meta_url) as resp:
            # urlopen raises HTTPError on unexpected status code
            wheels = json.loads(resp.read().decode("utf-8"))
        return wheels, repo_url

360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
    @staticmethod
    def is_rocm_system() -> bool:
        """Detect ROCm without relying on torch (for build environment)."""
        if os.getenv("ROCM_PATH"):
            return True
        if os.path.isdir("/opt/rocm"):
            return True
        if which("rocminfo") is not None:
            return True
        try:
            import torch

            return torch.version.hip is not None
        except ImportError:
            return False

376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
    @staticmethod
    def detect_system_cuda_variant() -> str:
        """Auto-detect CUDA variant from torch, nvidia-smi, or env default."""

        # Map CUDA major version to hosted wheel variants on wheels.vllm.ai
        supported = {12: "cu129", 13: "cu130"}

        # Respect explicitly set VLLM_MAIN_CUDA_VERSION
        if envs.is_set("VLLM_MAIN_CUDA_VERSION"):
            v = envs.VLLM_MAIN_CUDA_VERSION
            print(f"Using VLLM_MAIN_CUDA_VERSION={v}")
            return "cu" + v.replace(".", "")[:3]

        # Try torch.version.cuda
        cuda_version = None
        try:
            import torch

            cuda_version = torch.version.cuda
        except Exception:
            pass

        # Try nvidia-smi
        if not cuda_version:
            try:
                out = subprocess.run(
                    ["nvidia-smi"], capture_output=True, text=True, timeout=10
                )
                if m := re.search(r"CUDA Version:\s*(\d+\.\d+)", out.stdout):
                    cuda_version = m.group(1)
            except Exception:
                pass

        # Fall back to default
        if not cuda_version:
            cuda_version = envs.VLLM_MAIN_CUDA_VERSION

        # Map to supported variant
        major = int(cuda_version.split(".")[0])
        variant = supported.get(major, supported[max(supported)])
        print(f"Detected CUDA {cuda_version}, using variant {variant}")
        return variant

419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
    @staticmethod
    def find_local_rocm_wheel() -> str | None:
        """Search for a local vllm wheel in common locations."""
        import glob

        for pattern in ["/vllm-workspace/dist/vllm-*.whl", "./dist/vllm-*.whl"]:
            wheels = glob.glob(pattern)
            if wheels:
                return sorted(wheels)[-1]
        return None

    @staticmethod
    def fetch_wheel_from_pypi_index(index_url: str, package: str = "vllm") -> str:
        """Fetch the latest wheel URL from a PyPI-style simple index."""
        import platform
        from html.parser import HTMLParser
        from urllib.parse import urljoin
        from urllib.request import urlopen

        arch = platform.machine()

        class WheelLinkParser(HTMLParser):
            def __init__(self):
                super().__init__()
                self.wheels = []

            def handle_starttag(self, tag, attrs):
                if tag == "a":
                    for name, value in attrs:
                        if name == "href" and value.endswith(".whl"):
                            self.wheels.append(value)

        simple_url = f"{index_url.rstrip('/')}/{package}/"
        print(f"Fetching wheel list from {simple_url}")
        with urlopen(simple_url) as resp:
            html = resp.read().decode("utf-8")

        parser = WheelLinkParser()
        parser.feed(html)

        for wheel in reversed(parser.wheels):
            if arch in wheel:
                if wheel.startswith("http"):
                    return wheel
                return urljoin(simple_url, wheel)

        raise ValueError(f"No compatible wheel found for {arch} at {simple_url}")

    @staticmethod
    def determine_wheel_url_rocm() -> tuple[str, str | None]:
        """Determine the precompiled wheel for ROCm."""
        # Search for local wheel first
        local_wheel = precompiled_wheel_utils.find_local_rocm_wheel()
        if local_wheel is not None:
            print(f"Found local ROCm wheel: {local_wheel}")
            return local_wheel, None

        # Fall back to AMD's PyPI index
        index_url = os.getenv(
            "VLLM_ROCM_WHEEL_INDEX", "https://pypi.amd.com/vllm-rocm/simple"
        )
        print(f"Fetching ROCm precompiled wheel from {index_url}")
        wheel_url = precompiled_wheel_utils.fetch_wheel_from_pypi_index(index_url)
        download_filename = wheel_url.split("/")[-1].split("#")[0]
        print(f"Using ROCm precompiled wheel: {wheel_url}")
        return wheel_url, download_filename

486
487
488
489
490
491
492
    @staticmethod
    def determine_wheel_url() -> tuple[str, str | None]:
        """
        Try to determine the precompiled wheel URL or path to use.
        The order of preference is:
        1. user-specified wheel location (can be either local or remote, via
           VLLM_PRECOMPILED_WHEEL_LOCATION)
493
        2. user-specified variant (VLLM_PRECOMPILED_WHEEL_VARIANT) from nightly repo
494
495
           or auto-detected CUDA variant based on system (torch, nvidia-smi)
        3. the default variant from nightly repo
496
497
498
499

        If downloading from the nightly repo, the commit can be specified via
        VLLM_PRECOMPILED_WHEEL_COMMIT; otherwise, the head commit in the main branch
        is used.
500
501
502
503
504
505
        """
        wheel_location = os.getenv("VLLM_PRECOMPILED_WHEEL_LOCATION", None)
        if wheel_location is not None:
            print(f"Using user-specified precompiled wheel location: {wheel_location}")
            return wheel_location, None
        else:
506
507
508
509
510
            # ROCm: use local wheel or AMD's PyPI index
            # TODO: When we have ROCm nightly wheels, we can update this logic.
            if precompiled_wheel_utils.is_rocm_system():
                return precompiled_wheel_utils.determine_wheel_url_rocm()

511
512
513
            import platform

            arch = platform.machine()
514
515
516
517
518
            # try to fetch the wheel metadata from the nightly wheel repo,
            # detecting CUDA variant from system if not specified
            variant = os.getenv("VLLM_PRECOMPILED_WHEEL_VARIANT", None)
            if variant is None:
                variant = precompiled_wheel_utils.detect_system_cuda_variant()
519
520
521
522
523
524
525
            commit = os.getenv("VLLM_PRECOMPILED_WHEEL_COMMIT", "").lower()
            if not commit or len(commit) != 40:
                print(
                    f"VLLM_PRECOMPILED_WHEEL_COMMIT not valid: {commit}"
                    ", trying to fetch base commit in main branch"
                )
                commit = precompiled_wheel_utils.get_base_commit_in_main_branch()
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
            print(f"Using precompiled wheel commit {commit} with variant {variant}")
            try_default = False
            wheels, repo_url, download_filename = None, None, None
            try:
                wheels, repo_url = precompiled_wheel_utils.fetch_metadata_for_variant(
                    commit, variant
                )
            except Exception as e:
                logger.warning(
                    "Failed to fetch precompiled wheel metadata for variant %s: %s",
                    variant,
                    e,
                )
                try_default = True  # try outside handler to keep the stacktrace simple
            if try_default:
                print("Trying the default variant from remote")
                wheels, repo_url = precompiled_wheel_utils.fetch_metadata_for_variant(
                    commit, None
                )
                # if this also fails, then we have nothing more to try / cache
            assert wheels is not None and repo_url is not None, (
                "Failed to fetch precompiled wheel metadata"
            )
            # The metadata.json has the following format:
            # see .buildkite/scripts/generate-nightly-index.py for details
            """[{
    "package_name": "vllm",
    "version": "0.11.2.dev278+gdbc3d9991",
    "build_tag": null,
    "python_tag": "cp38",
    "abi_tag": "abi3",
    "platform_tag": "manylinux1_x86_64",
    "variant": null,
    "filename": "vllm-0.11.2.dev278+gdbc3d9991-cp38-abi3-manylinux1_x86_64.whl",
    "path": "../vllm-0.11.2.dev278%2Bgdbc3d9991-cp38-abi3-manylinux1_x86_64.whl"
    },
    ...]"""
            from urllib.parse import urljoin

            for wheel in wheels:
                # TODO: maybe check more compatibility later? (python_tag, abi_tag, etc)
                if wheel.get("package_name") == "vllm" and arch in wheel.get(
                    "platform_tag", ""
                ):
                    print(f"Found precompiled wheel metadata: {wheel}")
                    if "path" not in wheel:
                        raise ValueError(f"Wheel metadata missing path: {wheel}")
                    wheel_url = urljoin(repo_url, wheel["path"])
                    download_filename = wheel.get("filename")
                    print(f"Using precompiled wheel URL: {wheel_url}")
                    break
            else:
                raise ValueError(
                    f"No precompiled vllm wheel found for architecture {arch} "
                    f"from repo {repo_url}. All available wheels: {wheels}"
                )

        return wheel_url, download_filename

    @staticmethod
    def extract_precompiled_and_patch_package(
        wheel_url_or_path: str, download_filename: str | None
    ) -> dict:
589
590
591
592
593
594
        import tempfile
        import zipfile

        temp_dir = None
        try:
            if not os.path.isfile(wheel_url_or_path):
595
596
                # use provided filename first, then derive from URL
                wheel_filename = download_filename or wheel_url_or_path.split("/")[-1]
597
598
                temp_dir = tempfile.mkdtemp(prefix="vllm-wheels")
                wheel_path = os.path.join(temp_dir, wheel_filename)
599
                print(f"Downloading wheel from {wheel_url_or_path} to {wheel_path}")
600
                from urllib.request import urlretrieve
601

602
603
604
605
606
607
608
609
610
611
                urlretrieve(wheel_url_or_path, filename=wheel_path)
            else:
                wheel_path = wheel_url_or_path
                print(f"Using existing wheel at {wheel_path}")

            package_data_patch = {}

            with zipfile.ZipFile(wheel_path) as wheel:
                files_to_copy = [
                    "vllm/_C.abi3.so",
612
                    "vllm/_C_stable_libtorch.abi3.so",
613
614
                    "vllm/_moe_C.abi3.so",
                    "vllm/_flashmla_C.abi3.so",
615
616
                    "vllm/_flashmla_extension_C.abi3.so",
                    "vllm/_sparse_flashmla_C.abi3.so",
617
618
619
                    "vllm/vllm_flash_attn/_vllm_fa2_C.abi3.so",
                    "vllm/vllm_flash_attn/_vllm_fa3_C.abi3.so",
                    "vllm/cumem_allocator.abi3.so",
620
621
                    # ROCm-specific libraries
                    "vllm/_rocm_C.abi3.so",
622
623
                ]

624
                flash_attn_regex = re.compile(
625
626
                    r"vllm/vllm_flash_attn/(?:[^/.][^/]*/)*(?!\.)[^/]*\.py"
                )
627
628
629
                triton_kernels_regex = re.compile(
                    r"vllm/third_party/triton_kernels/(?:[^/.][^/]*/)*(?!\.)[^/]*\.py"
                )
630
631
632
                flashmla_regex = re.compile(
                    r"vllm/third_party/flashmla/(?:[^/.][^/]*/)*(?!\.)[^/]*\.py"
                )
633
                file_members = list(
634
635
                    filter(lambda x: x.filename in files_to_copy, wheel.filelist)
                )
636
                file_members += list(
637
638
639
640
641
642
                    filter(lambda x: flash_attn_regex.match(x.filename), wheel.filelist)
                )
                file_members += list(
                    filter(
                        lambda x: triton_kernels_regex.match(x.filename), wheel.filelist
                    )
643
                )
644
645
646
                file_members += list(
                    filter(lambda x: flashmla_regex.match(x.filename), wheel.filelist)
                )
647
648
649
650
651

                for file in file_members:
                    print(f"[extract] {file.filename}")
                    target_path = os.path.join(".", file.filename)
                    os.makedirs(os.path.dirname(target_path), exist_ok=True)
652
653
654
655
                    with (
                        wheel.open(file.filename) as src,
                        open(target_path, "wb") as dst,
                    ):
656
657
658
659
                        shutil.copyfileobj(src, dst)

                    pkg = os.path.dirname(file.filename).replace("/", ".")
                    package_data_patch.setdefault(pkg, []).append(
660
661
                        os.path.basename(file.filename)
                    )
662
663
664
665
666
667
668
669
670

            return package_data_patch
        finally:
            if temp_dir is not None:
                print(f"Removing temporary directory {temp_dir}")
                shutil.rmtree(temp_dir)

    @staticmethod
    def get_base_commit_in_main_branch() -> str:
671
        try:
672
            # Get the latest commit hash of the upstream main branch.
673
674
675
676
677
678
679
680
681
682
            curl_cmd = [
                "curl",
                "-s",
                "https://api.github.com/repos/vllm-project/vllm/commits/main",
            ]
            github_token = os.getenv("GH_TOKEN", os.getenv("GITHUB_TOKEN"))
            if github_token:
                curl_cmd += [
                    "-H",
                    f"Authorization: token {github_token}",
683
                ]
684
            resp_json = subprocess.check_output(curl_cmd).decode("utf-8")
685
            upstream_main_commit = json.loads(resp_json)["sha"]
686
            print(f"Upstream main branch latest commit: {upstream_main_commit}")
687

688
689
690
691
            # In Docker build context, .git may be immutable or missing.
            if envs.VLLM_DOCKER_BUILD_CONTEXT:
                return upstream_main_commit

692
693
694
            # Check if the upstream_main_commit exists in the local repo
            try:
                subprocess.check_output(
695
696
                    ["git", "cat-file", "-e", f"{upstream_main_commit}"]
                )
697
698
699
700
701
            except subprocess.CalledProcessError:
                # If not present, fetch it from the remote repository.
                # Note that this does not update any local branches,
                # but ensures that this commit ref and its history are
                # available in our local repo.
702
703
704
                subprocess.check_call(
                    ["git", "fetch", "https://github.com/vllm-project/vllm", "main"]
                )
705
706
707

            # Then get the commit hash of the current branch that is the same as
            # the upstream main commit.
708
709
710
711
712
            current_branch = (
                subprocess.check_output(["git", "branch", "--show-current"])
                .decode("utf-8")
                .strip()
            )
713

714
715
716
717
718
719
720
            base_commit = (
                subprocess.check_output(
                    ["git", "merge-base", f"{upstream_main_commit}", current_branch]
                )
                .decode("utf-8")
                .strip()
            )
721
            return base_commit
722
723
        except ValueError as err:
            raise ValueError(err) from None
724
725
726
727
        except Exception as err:
            logger.warning(
                "Failed to get the base commit in the main branch. "
                "Using the nightly wheel. The libraries in this "
728
729
730
                "wheel may not be compatible with your dev branch: %s",
                err,
            )
731
            return "nightly"
732
733


734
735
736
737
def _no_device() -> bool:
    return VLLM_TARGET_DEVICE == "empty"


738
def _is_cuda() -> bool:
739
    has_cuda = torch.version.cuda is not None
740
    return VLLM_TARGET_DEVICE == "cuda" and has_cuda and not _is_tpu()
741
742


743
def _is_hip() -> bool:
744
745
746
    return (
        VLLM_TARGET_DEVICE == "cuda" or VLLM_TARGET_DEVICE == "rocm"
    ) and torch.version.hip is not None
747
748


749
750
751
752
def _is_tpu() -> bool:
    return VLLM_TARGET_DEVICE == "tpu"


753
754
755
756
def _is_cpu() -> bool:
    return VLLM_TARGET_DEVICE == "cpu"


757
758
759
760
def _is_xpu() -> bool:
    return VLLM_TARGET_DEVICE == "xpu"


761
def _build_custom_ops() -> bool:
762
    return _is_cuda() or _is_hip()
763
764


765
766
767
768
def get_rocm_version():
    # Get the Rocm version from the ROCM_HOME/bin/librocm-core.so
    # see https://github.com/ROCm/rocm-core/blob/d11f5c20d500f729c393680a01fa902ebf92094b/rocm_version.cpp#L21
    try:
769
770
        if ROCM_HOME is None:
            return None
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
        librocm_core_file = Path(ROCM_HOME) / "lib" / "librocm-core.so"
        if not librocm_core_file.is_file():
            return None
        librocm_core = ctypes.CDLL(librocm_core_file)
        VerErrors = ctypes.c_uint32
        get_rocm_core_version = librocm_core.getROCmVersion
        get_rocm_core_version.restype = VerErrors
        get_rocm_core_version.argtypes = [
            ctypes.POINTER(ctypes.c_uint32),
            ctypes.POINTER(ctypes.c_uint32),
            ctypes.POINTER(ctypes.c_uint32),
        ]
        major = ctypes.c_uint32()
        minor = ctypes.c_uint32()
        patch = ctypes.c_uint32()
786

787
788
789
790
791
792
        if (
            get_rocm_core_version(
                ctypes.byref(major), ctypes.byref(minor), ctypes.byref(patch)
            )
            == 0
        ):
793
            return f"{major.value}.{minor.value}.{patch.value}"
794
        return None
795
    except Exception:
796
        return None
Woosuk Kwon's avatar
Woosuk Kwon committed
797

798

bnellnm's avatar
bnellnm committed
799
def get_nvcc_cuda_version() -> Version:
800
801
802
803
    """Get the CUDA version from nvcc.

    Adapted from https://github.com/NVIDIA/apex/blob/8b7a1ff183741dd8f9b87e7bafd04cfde99cea28/setup.py
    """
804
    assert CUDA_HOME is not None, "CUDA_HOME is not set"
805
806
807
    nvcc_output = subprocess.check_output(
        [CUDA_HOME + "/bin/nvcc", "-V"], universal_newlines=True
    )
808
809
810
811
812
813
    output = nvcc_output.split()
    release_idx = output.index("release") + 1
    nvcc_cuda_version = parse(output[release_idx].split(",")[0])
    return nvcc_cuda_version


zhuwenwen's avatar
zhuwenwen committed
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
def get_sha(root: Union[str, Path]) -> str:
    try:
        return subprocess.check_output(['git', 'rev-parse', 'HEAD'], cwd=root).decode('ascii').strip()
    except Exception:
        return 'Unknown'


def get_version_add(sha: Optional[str] = None) -> str:
    command = "git config --global --add safe.directory "+pwd  
    subprocess.run(command, shell=True, capture_output=False, text=True) 
    vllm_root = os.path.dirname(os.path.abspath(__file__))
    add_version_path = os.path.join(os.path.join(vllm_root, "vllm"), "version.py")
    major, minor, _ = torch.__version__.split('.')
    if add_git_version:
        if sha != 'Unknown':
            if sha is None:
                sha = get_sha(vllm_root)
            version = 'das.ori.' + sha[:7]
    else:
        version = 'das.ori'


    # dtk version
    if os.getenv("ROCM_PATH"):
        rocm_path = os.getenv('ROCM_PATH', "")
        rocm_version_path = os.path.join(rocm_path, '.info', "rocm_version")
        with open(rocm_version_path, 'r',encoding='utf-8') as file:
            lines = file.readlines()
        rocm_version=lines[0].replace(".", "")
        version += ".dtk" + rocm_version
    
    new_version_content = f"""
try:
    __version__ = "0.18.1"
    __version_tuple__ = (0, 18, 1)
    __hcu_version__ = f'0.18.1+{version}' 
    
    from vllm.version import __version__, __version_tuple__, __hcu_version__
except Exception as e:
    import warnings

    warnings.warn(f"Failed to read commit hash:\\n + str(e)",
                  RuntimeWarning,
                  stacklevel=2)
    __version__ = "dev"
    __version_tuple__ = (0, 0, __version__)
    
    
def _prev_minor_version_was(version_str):
    '''Check whether a given version matches the previous minor version.

    Return True if version_str matches the previous minor version.

    For example - return True if the current version if 0.7.4 and the
    supplied version_str is '0.6'.

    Used for --show-hidden-metrics-for-version.
    '''
    # Match anything if this is a dev tree
    if __version_tuple__[0:2] == (0, 0):
        return True

    # Note - this won't do the right thing when we release 1.0!
    # assert __version_tuple__[0] == 0
    assert isinstance(__version_tuple__[1], int)
    return version_str == f"{{__version_tuple__[0]}}.{{__version_tuple__[1] - 1}}"


def _prev_minor_version():
    '''For the purpose of testing, return a previous minor version number.'''
    # In dev tree, this will return "0.-1", but that will work fine"
    assert isinstance(__version_tuple__[1], int)
    return f"{{__version_tuple__[0]}}.{{__version_tuple__[1] - 1}}"
"""
    
    with open(add_version_path, encoding="utf-8",mode="w") as file:
        file.write(new_version_content)
    file.close()
    
    
def get_version():
    get_version_add()
    version_file = 'vllm/version.py'
    with open(version_file, encoding='utf-8') as f:
        exec(compile(f.read(), version_file, 'exec'))
    return locals()['__hcu_version__']


902
def get_vllm_version() -> str:
903
904
905
    # Allow overriding the version. This is useful to build platform-specific
    # wheels (e.g. CPU, TPU) without modifying the source.
    if env_version := os.getenv("VLLM_VERSION_OVERRIDE"):
906
907
908
        print(f"Overriding VLLM version with {env_version} from VLLM_VERSION_OVERRIDE")
        os.environ["SETUPTOOLS_SCM_PRETEND_VERSION"] = env_version
        return get_version(write_to="vllm/_version.py")
909

zhuwenwen's avatar
zhuwenwen committed
910
911
912
    if not _is_hip():
        version = get_version(write_to="vllm/_version.py")
        sep = "+" if "+" not in version else "."  # dev versions might contain +
913

914
    if _no_device():
915
        if envs.VLLM_TARGET_DEVICE == "empty":
916
            version += f"{sep}empty"
917
    elif _is_cuda():
918
        if envs.VLLM_USE_PRECOMPILED and not envs.VLLM_SKIP_PRECOMPILED_VERSION_SUFFIX:
919
            version += f"{sep}precompiled"
920
921
        else:
            cuda_version = str(get_nvcc_cuda_version())
922
            if cuda_version != envs.VLLM_MAIN_CUDA_VERSION:
923
924
925
926
                cuda_version_str = cuda_version.replace(".", "")[:3]
                # skip this for source tarball, required for pypi
                if "sdist" not in sys.argv:
                    version += f"{sep}cu{cuda_version_str}"
927
    elif _is_hip():
928
        # Get the Rocm Version
zhuwenwen's avatar
zhuwenwen committed
929
930
931
932
        # rocm_version = get_rocm_version() or torch.version.hip
        # if rocm_version and rocm_version != envs.VLLM_MAIN_CUDA_VERSION:
        #     version += f"{sep}rocm{rocm_version.replace('.', '')[:3]}"
        version = get_version()
933
    elif _is_tpu():
934
        version += f"{sep}tpu"
935
    elif _is_cpu():
936
937
        if envs.VLLM_TARGET_DEVICE == "cpu":
            version += f"{sep}cpu"
938
    elif _is_xpu():
939
        version += f"{sep}xpu"
940
    else:
941
        raise RuntimeError("Unknown runtime environment")
942

943
944
945
    return version


946
def get_requirements() -> list[str]:
947
    """Get Python package dependencies from requirements.txt."""
948
    requirements_dir = ROOT_DIR / "requirements"
949

950
    def _read_requirements(filename: str) -> list[str]:
951
        with open(requirements_dir / filename) as f:
952
            requirements = f.read().strip().split("\n")
953
954
955
956
        resolved_requirements = []
        for line in requirements:
            if line.startswith("-r "):
                resolved_requirements += _read_requirements(line.split()[1])
957
958
959
960
961
            elif (
                not line.startswith("--")
                and not line.startswith("#")
                and line.strip() != ""
            ):
962
963
964
                resolved_requirements.append(line)
        return resolved_requirements

965
    if _no_device():
966
        requirements = _read_requirements("common.txt")
967
    elif _is_cuda():
968
        requirements = _read_requirements("cuda.txt")
969
        cuda_major, cuda_minor = torch.version.cuda.split(".")
970
971
        modified_requirements = []
        for req in requirements:
972
            if "vllm-flash-attn" in req and cuda_major != "12":
973
                # vllm-flash-attn is built only for CUDA 12.x.
974
975
976
                # Skip for other versions.
                continue
            modified_requirements.append(req)
977
        requirements = modified_requirements
978
    elif _is_hip():
979
        requirements = _read_requirements("rocm.txt")
980
    elif _is_tpu():
981
        requirements = _read_requirements("tpu.txt")
982
    elif _is_cpu():
983
        requirements = _read_requirements("cpu.txt")
984
    elif _is_xpu():
985
        requirements = _read_requirements("xpu.txt")
986
    else:
987
        raise ValueError("Unsupported platform, please use CUDA, ROCm, or CPU.")
988
989
990
    return requirements


bnellnm's avatar
bnellnm committed
991
992
ext_modules = []

993
if _is_cuda() or _is_hip():
bnellnm's avatar
bnellnm committed
994
    ext_modules.append(CMakeExtension(name="vllm._moe_C"))
995
    ext_modules.append(CMakeExtension(name="vllm.cumem_allocator"))
996
997
    # Optional since this doesn't get built (produce an .so file). This is just
    # copying the relevant .py files from the source repository.
zhuwenwen's avatar
zhuwenwen committed
998
    # ext_modules.append(CMakeExtension(name="vllm.triton_kernels", optional=True))
bnellnm's avatar
bnellnm committed
999

1000
1001
# if _is_hip():
#     ext_modules.append(CMakeExtension(name="vllm._rocm_C"))
1002

1003
if _is_cuda():
1004
    ext_modules.append(CMakeExtension(name="vllm.vllm_flash_attn._vllm_fa2_C"))
1005
1006
1007
    if envs.VLLM_USE_PRECOMPILED or (
        CUDA_HOME and get_nvcc_cuda_version() >= Version("12.3")
    ):
1008
        # FA3 requires CUDA 12.3 or later
1009
        ext_modules.append(CMakeExtension(name="vllm.vllm_flash_attn._vllm_fa3_C"))
1010
1011
1012
1013
1014
    # FA4 CuteDSL - Python-only component for FA4's cute DSL support
    # Optional since this doesn't produce a .so file, just copies Python files
    ext_modules.append(
        CMakeExtension(name="vllm.vllm_flash_attn._vllm_fa4_cutedsl_C", optional=True)
    )
1015
1016
1017
1018
    if envs.VLLM_USE_PRECOMPILED or (
        CUDA_HOME and get_nvcc_cuda_version() >= Version("12.9")
    ):
        # FlashMLA requires CUDA 12.9 or later
1019
1020
        # Optional since this doesn't get built (produce an .so file) when
        # not targeting a hopper system
1021
        ext_modules.append(CMakeExtension(name="vllm._flashmla_C", optional=True))
1022
        ext_modules.append(
1023
1024
            CMakeExtension(name="vllm._flashmla_extension_C", optional=True)
        )
1025

1026
1027
1028
1029
1030
if _is_cpu():
    import platform

    if platform.machine() in ("x86_64", "AMD64"):
        ext_modules.append(CMakeExtension(name="vllm._C"))
1031
        ext_modules.append(CMakeExtension(name="vllm._C_AVX512"))
1032
1033
1034
1035
        ext_modules.append(CMakeExtension(name="vllm._C_AVX2"))
    else:
        ext_modules.append(CMakeExtension(name="vllm._C"))

1036
if _build_custom_ops():
bnellnm's avatar
bnellnm committed
1037
    ext_modules.append(CMakeExtension(name="vllm._C"))
1038
1039
1040
1041
    # also _is_hip() once https://github.com/vllm-project/vllm/issues/35163 is
    # fixed
    if _is_cuda():
        ext_modules.append(CMakeExtension(name="vllm._C_stable_libtorch"))
bnellnm's avatar
bnellnm committed
1042

1043
package_data = {
1044
1045
1046
1047
    "vllm": [
        "py.typed",
        "model_executor/layers/fused_moe/configs/*.json",
        "model_executor/layers/quantization/utils/configs/*.json",
1048
1049
        "entrypoints/serve/instrumentator/static/*.js",
        "entrypoints/serve/instrumentator/static/*.css",
1050
    ]
1051
}
Simon Mo's avatar
Simon Mo committed
1052

1053

1054
1055
# If using precompiled, extract and patch package_data (in advance of setup)
if envs.VLLM_USE_PRECOMPILED:
1056
1057
1058
1059
    wheel_url, download_filename = precompiled_wheel_utils.determine_wheel_url()
    patch = precompiled_wheel_utils.extract_precompiled_and_patch_package(
        wheel_url, download_filename
    )
1060
1061
1062
    for pkg, files in patch.items():
        package_data.setdefault(pkg, []).extend(files)

1063
1064
1065
if _no_device():
    ext_modules = []

1066
if not ext_modules:
1067
    cmdclass = {}
1068
1069
else:
    cmdclass = {
1070
1071
        "build_ext": precompiled_build_ext
        if envs.VLLM_USE_PRECOMPILED
1072
        else cmake_build_ext,
1073
1074
    }

bnellnm's avatar
bnellnm committed
1075
setup(
1076
    # static metadata should rather go in pyproject.toml
1077
    version=get_vllm_version(),
Woosuk Kwon's avatar
Woosuk Kwon committed
1078
    ext_modules=ext_modules,
1079
    install_requires=get_requirements(),
1080
    extras_require={
1081
1082
        # AMD Zen CPU optimizations via zentorch
        "zen": ["zentorch"],
1083
        "bench": ["pandas", "matplotlib", "seaborn", "datasets", "scipy", "plotly"],
1084
        "tensorizer": ["tensorizer==2.10.1"],
1085
        "fastsafetensors": ["fastsafetensors >= 0.2.2"],
1086
        "instanttensor": ["instanttensor >= 0.1.5"],
1087
        "runai": ["runai-model-streamer[s3,gcs,azure] >= 0.15.7"],
1088
        "audio": [
1089
1090
            "av",
            "resampy",
1091
            "scipy",
1092
1093
1094
            "soundfile",
            "mistral_common[audio]",
        ],  # Required for audio processing
1095
        "video": [],  # Kept for backwards compatibility
1096
        "flashinfer": [],  # Kept for backwards compatibility
1097
1098
        # Optional deps for AMD FP4 quantization support
        "petit-kernel": ["petit-kernel"],
1099
        # Optional deps for Helion kernel development
Yanan Cao's avatar
Yanan Cao committed
1100
        "helion": ["helion==0.3.2"],
1101
        # Optional deps for gRPC server (vllm serve --grpc)
1102
        "grpc": ["smg-grpc-servicer[vllm] >= 0.5.0"],
1103
1104
1105
1106
1107
1108
1109
        # Optional deps for OpenTelemetry tracing
        "otel": [
            "opentelemetry-sdk>=1.26.0",
            "opentelemetry-api>=1.26.0",
            "opentelemetry-exporter-otlp>=1.26.0",
            "opentelemetry-semantic-conventions-ai>=0.4.1",
        ],
1110
    },
1111
    cmdclass=cmdclass,
Simon Mo's avatar
Simon Mo committed
1112
    package_data=package_data,
Woosuk Kwon's avatar
Woosuk Kwon committed
1113
)