Implementation:Vllm project Vllm Mergify Config

Knowledge Sources	vllm
Domains	CI/CD, GitHub Automation
Last Updated	2026-02-08 00:00 GMT

Overview

Configures Mergify rules to automate GitHub pull request labeling, commenting, and merge workflows for the vLLM repository.

Description

This YAML file defines Mergify pull request rules that automatically apply labels based on changed files (documentation, ci/build, deepseek, llama, multi-modality, new-model, performance, qwen, nvidia, rocm, cpu, structured-output, speculative-decoding, v1, frontend, and more). It also provides automated comments for pre-commit check failures and DCO check failures, and supports automatic merging of approved PRs with the ready label. The configuration reduces manual PR management overhead significantly.

Usage

This file is automatically loaded by the Mergify GitHub App when PRs are opened or updated. Repository maintainers modify this file to adjust auto-labeling rules, add new label categories for emerging features (e.g., new model families), or change the merge automation behavior. Contributors benefit from automatic labeling and helpful bot comments on CI failures.

Code Reference

Source Location

• Repository: vllm
• File: .github/mergify.yml
• Lines: 1-445

Signature

pull_request_rules:
  - name: label-documentation
    conditions: [...]
    actions:
      label:
        add: [documentation]
      comment:
        message: "Documentation preview: ..."

  - name: comment-pre-commit-failure
    conditions: [...]
    actions:
      comment:
        message: "Hi @{{author}}, the pre-commit checks have failed..."

  - name: comment-dco-failure
    conditions: [...]
    actions:
      comment:
        message: "Hi @{{author}}, the DCO check has failed..."

  - name: label-ci-build
  - name: label-deepseek
  - name: label-frontend
  - name: label-llama
  - name: label-multi-modality
  - name: label-new-model
  - name: label-performance
  - name: label-qwen
  - name: label-nvidia
  - name: label-rocm
  - name: label-cpu
  - name: label-structured-output
  - name: label-speculative-decoding
  - name: label-v1

Import

# Mergify automatically reads this file from .github/mergify.yml
# No manual import is required. The Mergify GitHub App evaluates these
# rules on every pull request event (open, update, label change, etc.).

I/O Contract

Inputs

Name	Type	Required	Description
Pull request event	GitHub PR event	Yes	PR open, update, label change, or status check events trigger rule evaluation
files	list[string]	Yes	Changed file paths in the PR, matched against regex conditions
title	string	Yes	PR title text, matched against regex conditions for model-specific labels
label	string	No	Existing labels on the PR (e.g., stale label excludes auto-labeling)
status-failure	string	No	CI check failure status (e.g., pre-commit, dco)
author	string	Yes	GitHub username of the PR author, used in automated comments

Outputs

Name	Type	Description
Labels	GitHub labels	Automatically applied labels (documentation, ci/build, deepseek, llama, etc.)
Comments	GitHub PR comments	Automated comments for pre-commit failures, DCO failures, and documentation previews
Merge actions	GitHub merge	Automatic merge for PRs with ready label and required approvals

Usage Examples

# Example: Adding a new auto-label rule for a model family
- name: label-mistral
  description: Automatically apply mistral label
  conditions:
    - label != stale
    - or:
      - files~=^vllm/model_executor/models/.*mistral.*\.py
      - files~=^tests/.*mistral.*\.py
      - title~=(?i)Mistral
  actions:
    label:
      add:
        - mistral

Related Pages

• Environment:Vllm_project_Vllm_GitHub