Release Scripts

This directory contains scripts to automate version bumping for SGLang releases.

Scripts

`bump_sglang_version.py`

Updates SGLang version across all relevant files following the pattern from PR #10468.

Usage:

bash

python scripts/release/bump_sglang_version.py 0.5.3rc0

Files updated:

Makefile
benchmark/deepseek_v3/README.md
docker/rocm.Dockerfile
docs_new/docs/get-started/install.mdx
docs_new/docs/hardware-platforms/amd_gpu.mdx
docs_new/docs/hardware-platforms/ascend-npus/ascend_npu.mdx
python/pyproject.toml
python/pyproject_other.toml
python/pyproject_npu.toml
python/sglang/version.py

`bump_docs_install_version.py`

Bumps the release version pinned in the Mintlify install docs — both the git clone -b v<version> ...sglang.git "install from source" line and the version-pinned lmsysorg/sglang:v<version> Docker example. Mutable tags (latest, dev) are intentionally left untouched. Driven automatically on release-tag push by .github/workflows/bot-bump-docs-version.yml, which opens a PR with the change.

Usage:

bash

python scripts/release/bump_docs_install_version.py 0.5.13

Files updated:

docs_new/docs/get-started/install.mdx (Method 2: From source; Method 3: pinned Docker image)
docs_new/docs/hardware-platforms/amd_gpu.mdx (Install from Source)

`bump_kernel_version.py`

Updates the sglang-kernel release version across all relevant files following the pattern from PR #10732.

Usage:

bash

python scripts/release/bump_kernel_version.py 0.4.0

Files updated:

sgl-kernel/pyproject.toml
sgl-kernel/pyproject_cpu.toml
sgl-kernel/pyproject_rocm.toml
sgl-kernel/pyproject_musa.toml
sgl-kernel/python/sgl_kernel/version.py

Manual Testing Instructions

Test SGLang Version Bump

Run the script:

bash

python scripts/release/bump_sglang_version.py 0.5.4rc0

Verify changes with git diff:
bash
```
git diff
```

Check specific files contain the new version:

bash

grep -r "0.5.4rc0" python/sglang/version.py
grep -r "0.5.4rc0" python/pyproject.toml
grep -r "0.5.4rc0" docs_new/docs/get-started/install.mdx

Reset changes (if testing):
bash
```
git checkout .
```

Test Kernel Version Bump

Run the script:

bash

python scripts/release/bump_kernel_version.py 0.4.0

Verify changes with git diff:
bash
```
git diff
```

Check specific files contain the new version:

bash

grep -r "0.4.0" sgl-kernel/python/sgl_kernel/version.py
grep -r "0.4.0" sgl-kernel/pyproject.toml

Reset changes (if testing):
bash
```
git checkout .
```

Version Format Validation

SGLang versions: X.Y.Z or X.Y.ZrcN (e.g., 0.5.3 or 0.5.3rc0)
Kernel versions: X.Y.Z (e.g., 0.4.0)

The scripts will validate the version format and exit with an error if invalid.