Skip to content
 
 

Repository files navigation

vLLM-MUSA

High-performance LLM serving on Moore Threads MUSA

中文 · Issues · Serving recipes · Documentation

License Python 3.10


New model support images 🔥

  • Qwen3.8-Flash-Nextregistry.mthreads.com/mcconline/inference/vllm/vllm-openai:qwen38-flash-next
  • GLM-5.3-Flashregistry.mthreads.com/mcconline/inference/vllm/vllm-openai:glm53-flash
  • Hy4-previewregistry.mthreads.com/mcconline/inference/vllm/vllm-openai:hy4-preview

These model-specific tags are maintained independently of this branch; verify the exact image and model revision before production use.


About

vLLM-MUSA is the Moore Threads backend for vLLM, providing an OpenAI-compatible inference and serving engine for MUSA GPUs.

  • v0.28.0-dev development line with the vLLM V1 engine.
  • Uses the pinned MUSA stack: PyTorch/torch_musa 2.11.0.post1 (MUSA 5.2.0), MATE 0.2.6, and torchada 0.1.83; this branch remains an upgrade candidate.
  • MUSA-native attention, communication, custom ops, and compilation support.
  • Per-checkpoint recipes for Qwen and DeepSeek-V4-Flash on S5000.

Getting started

Install

Use the published v0.28.0 release image:

export VLLM_MUSA_IMAGE=registry.mthreads.com/mcconline/inference/vllm/vllm-openai:v0.28.0
docker pull "${VLLM_MUSA_IMAGE}"

The image is built independently of this branch. Verify its installed package versions against third_party/PINS; build the local image from the installation guide when exact branch parity is needed.

Quickstart

vllm serve /path/to/model \
  --trust-remote-code \
  --served-model-name my-model

The command above assumes that vllm is installed and on the current environment's PATH. For the release image, use the container launch shape in the Docker guide.

The OpenAI-compatible endpoint is available at http://localhost:8000/v1. For recommended tensor-parallel, scheduler, and speculative-decoding settings, use the serving cookbook.

Documentation

Supported release

vLLM-MUSA PyTorch/MUSA Engine Status
v0.28.0-dev 2.11.x V1 engine; Runner V2 where supported Upgrade candidate

The V1 engine may automatically select Model Runner V2 for supported model architectures; both runners are supported on MUSA. This branch tracks the upstream v0.28.0 commit in third_party/PINS and intentionally keeps the MUSA PyTorch 2.11.x stack; promote it to a supported release only after build and model-smoke validation.

Contributing

See the development guide for editable installs, tests, patch workflow, and issue reports. Contributions and bug reports are welcome through GitHub Issues.

Related projects

License

vLLM-MUSA is released under the Apache License 2.0.

About

A high-throughput and memory-efficient inference and serving engine for LLMs

Resources

Stars

117 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages