vllm-ascend-model-adapter

Adapts ML models for vLLM-Ascend NPUs with deterministic validation and signing.

2.6k|2.0k|Updated Jan 29, 2025
One-click install
npx skills add https://github.com/vllm-project/vllm-ascend --skill vllm-ascend-model-adapter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vllm-ascend-model-adapter
Source: https://github.com/vllm-project/vllm-ascend/tree/main/.agents/skills/vllm-ascend-model-adapter
Command: npx skills add https://github.com/vllm-project/vllm-ascend --skill vllm-ascend-model-adapter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of adapting existing or new machine learning models to run efficiently on vLLM with Ascend NPUs, ensuring compatibility and performance.

Core Features & Use Cases

  • Model Adaptation: Modify Hugging Face or local models for vLLM-Ascend with minimal code changes.
  • Deterministic Validation: Ensure models function correctly through a structured, two-stage validation process.
  • Use Case: You have a new large language model that needs to be deployed on Ascend hardware using vLLM. This Skill guides you through the necessary code modifications, testing, and documentation to achieve a successful integration.

Quick Start

Adapt the model located at '/models/my-new-model' for vLLM on Ascend, ensuring it passes real-weight validation.

Frequently Asked Questions about vllm-ascend-model-adapter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I adapt a Hugging Face model for vLLM on Ascend NPU?

Adapting a model for vLLM on Ascend NPU involves modifying Hugging Face or local model code within specified vLLM and vLLM-Ascend directories to ensure hardware compatibility, validated through direct vLLM serve commands.

What is the validation process for deploying models on Ascend NPUs using vLLM?

The validation process for Ascend NPU models is a deterministic, two-stage procedure using direct vLLM serve commands to ensure adapted models function correctly with real weights before final commit delivery.

Does vLLM on Ascend support features like ACLGraph and multimodal capabilities?

Yes, vLLM on Ascend supports ACLGraph, EP, flashcomm1, MTP, and multimodal capabilities. The adaptation process integrates these features while providing deterministic testing and troubleshooting guidance.

Can I use this vLLM Ascend adapter for local machine learning models?

Yes, you can adapt local machine learning models for vLLM on Ascend NPUs. The adapter modifies existing or new local models with minimal code changes and validates them through direct vLLM serve commands.

What are the limitations when adapting models for Ascend NPUs with vLLM?

Adapting models for Ascend NPUs requires implementing changes within specific vLLM and vLLM-Ascend directories and passing real-weight validation. Failures require utilizing the provided deterministic troubleshooting guidance to resolve compatibility issues.