5个关键步骤在AMD硬件上高效运行Step-3.5-Flash-MXFP4模型【免费下载链接】Step-3.5-Flash-MXFP4项目地址: https://ai.gitcode.com/hf_mirrors/amd/Step-3.5-Flash-MXFP4Step-3.5-Flash-MXFP4是基于AMD MI350/MI355硬件优化的高性能语言模型通过MXFP4量化技术实现了效率与精度的平衡。本文将详细介绍在AMD平台上部署和运行该模型的完整流程帮助用户快速上手这一强大的AI工具。 准备工作环境检查与依赖安装在开始部署前请确保您的系统满足以下要求硬件要求AMD MI350/MI355 GPU支持MXFP4指令集软件环境操作系统LinuxROCm7.1.0PyTorch2.10.0Transformers4.57.6vLLM推荐使用特定commit版本de7dd634b969adc6e5f50cff0cc09c1be1711d01首先克隆项目仓库git clone https://gitcode.com/hf_mirrors/amd/Step-3.5-Flash-MXFP4 cd Step-3.5-Flash-MXFP4建议使用Docker环境以确保依赖兼容性项目推荐使用的Docker镜像为rocm/vllm-devsha256:63f1fe04d87376bb173a1e837fba8610ab2dd77039fe7c9b97195f2a89d4d463 步骤1模型量化配置与执行Step-3.5-Flash-MXFP4模型采用了AMD-Quark量化技术将权重和激活值均量化为MXFP4格式。项目提供了专用的量化脚本step3p5_quantize_quark.py执行以下命令进行量化python3 step3p5_quantize_quark.py --model_dir $MODEL_DIR \ --num_calib_data 128 \ --multi_gpu \ --trust_remote_code \ --preset mxfp4_moe_only_no_kvcache \ --output_dir $output_dir关键参数说明--preset mxfp4_moe_only_no_kvcache指定MXFP4量化方案仅对MoE层进行量化--multi_gpu启用多GPU量化加速--num_calib_data 128使用128条校准数据优化量化精度量化过程会生成MXFP4格式的模型权重保存在指定的output_dir中。 步骤2vLLM框架准备与补丁应用该模型需要使用vLLM框架进行高效推理但需要应用特定补丁以支持Step-3.5-Flash架构。按照以下步骤准备vLLM环境安装vLLMpip uninstall vllm -y git clone https://github.com/vllm-project/vllm.git cd vllm git checkout de7dd634b969adc6e5f50cff0cc09c1be1711d01 pip install -r requirements/rocm.txt python setup.py develop cd .. export QUARK_MXFP4_IMPLtriton修改vLLM源码文件文件1vllm/model_executor/models/step3p5.py添加packed_modules_mapping属性到Step3p5ForCausalLM类class Step3p5ForCausalLM(nn.Module, SupportsPP, MixtureOfExperts): hf_to_vllm_mapper WeightsMapper( orig_to_new_substr{.share_expert.: .moe.share_expert.} ) packed_modules_mapping { qkv_proj: [ q_proj, k_proj, v_proj, ], gate_up_proj: [ gate_proj, up_proj, ], }文件2vllm/model_executor/layers/quantization/quark/quark_moe.py强制设置self.emulate为True- self.emulate ( - not current_platform.supports_mx() - or not self.ocp_mx_scheme.startswith(w_mxfp4) - ) and (self.mxfp4_backend is None or not self.use_rocm_aiter_moe) self.emulate True这些修改确保vLLM能够正确处理Step-3.5-Flash的MoE结构和MXFP4量化格式。 步骤3模型加载与推理启动完成环境准备后使用vLLM加载量化后的模型python -m vllm.entrypoints.api_server \ --model $output_dir \ --quantization quark \ --trust_remote_code \ --attention_backend ROCM_AITER_UNIFIED_ATTN \ --port 8000核心参数说明--model指定量化后的模型目录--quantization quark启用AMD-Quark量化支持--attention_backend ROCM_AITER_UNIFIED_ATTN使用AMD优化的注意力后端启动成功后您可以通过HTTP API或Web界面与模型交互。例如使用curl进行测试curl http://localhost:8000/generate \ -H Content-Type: application/json \ -d {prompt: What is the meaning of life?, max_tokens: 100}✅ 步骤4性能验证与评估为确保模型在AMD硬件上高效运行建议进行性能评估。项目提供了基于GSM8K基准的评估方法lm_eval --model vllm --model_args pretrained$MODEL_DIR,attention_backendROCM_AITER_UNIFIED_ATTN,quantizationquark,trust_remote_codeTrue --tasks gsm8k --batch_size auto根据官方测试数据该模型在GSM8K基准上达到了87.26%的准确率相比原始bf16模型89.39%保持了97.6%的精度恢复率同时显著降低了显存占用。⚠️ 步骤5常见问题解决与优化建议在部署和运行过程中可能会遇到以下问题内存访问错误确保设置环境变量QUARK_MXFP4_IMPLtriton性能不佳检查ROCM版本是否为7.1.0旧版本可能不支持MXFP4优化模型加载失败确认使用了正确的vLLM commit版本和补丁多GPU配置对于多GPU部署添加--tensor-parallel-size N参数N为GPU数量优化建议调整批处理大小以平衡吞吐量和延迟使用--gpu-memory-utilization 0.9提高GPU内存利用率对于长文本处理可调整max_seq_len参数最大支持128000 tokens 总结与资源通过以上5个步骤您可以在AMD MI350/MI355硬件上高效部署和运行Step-3.5-Flash-MXFP4模型。该模型结合了MXFP4量化技术和MoE架构在保持高精度的同时显著提升了推理效率。相关资源模型配置文件configuration_step3p5.py量化脚本step3p5_quantize_quark.pyAMD-Quark文档https://quark.docs.amd.com/latest/index.htmlvLLM文档https://docs.vllm.ai/en/latest/如果您在使用过程中遇到问题建议查阅项目README.md或联系AMD开发者获取支持。【免费下载链接】Step-3.5-Flash-MXFP4项目地址: https://ai.gitcode.com/hf_mirrors/amd/Step-3.5-Flash-MXFP4创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
5个关键步骤:在AMD硬件上高效运行Step-3.5-Flash-MXFP4模型
发布时间:2026/7/13 15:41:31
5个关键步骤在AMD硬件上高效运行Step-3.5-Flash-MXFP4模型【免费下载链接】Step-3.5-Flash-MXFP4项目地址: https://ai.gitcode.com/hf_mirrors/amd/Step-3.5-Flash-MXFP4Step-3.5-Flash-MXFP4是基于AMD MI350/MI355硬件优化的高性能语言模型通过MXFP4量化技术实现了效率与精度的平衡。本文将详细介绍在AMD平台上部署和运行该模型的完整流程帮助用户快速上手这一强大的AI工具。 准备工作环境检查与依赖安装在开始部署前请确保您的系统满足以下要求硬件要求AMD MI350/MI355 GPU支持MXFP4指令集软件环境操作系统LinuxROCm7.1.0PyTorch2.10.0Transformers4.57.6vLLM推荐使用特定commit版本de7dd634b969adc6e5f50cff0cc09c1be1711d01首先克隆项目仓库git clone https://gitcode.com/hf_mirrors/amd/Step-3.5-Flash-MXFP4 cd Step-3.5-Flash-MXFP4建议使用Docker环境以确保依赖兼容性项目推荐使用的Docker镜像为rocm/vllm-devsha256:63f1fe04d87376bb173a1e837fba8610ab2dd77039fe7c9b97195f2a89d4d463 步骤1模型量化配置与执行Step-3.5-Flash-MXFP4模型采用了AMD-Quark量化技术将权重和激活值均量化为MXFP4格式。项目提供了专用的量化脚本step3p5_quantize_quark.py执行以下命令进行量化python3 step3p5_quantize_quark.py --model_dir $MODEL_DIR \ --num_calib_data 128 \ --multi_gpu \ --trust_remote_code \ --preset mxfp4_moe_only_no_kvcache \ --output_dir $output_dir关键参数说明--preset mxfp4_moe_only_no_kvcache指定MXFP4量化方案仅对MoE层进行量化--multi_gpu启用多GPU量化加速--num_calib_data 128使用128条校准数据优化量化精度量化过程会生成MXFP4格式的模型权重保存在指定的output_dir中。 步骤2vLLM框架准备与补丁应用该模型需要使用vLLM框架进行高效推理但需要应用特定补丁以支持Step-3.5-Flash架构。按照以下步骤准备vLLM环境安装vLLMpip uninstall vllm -y git clone https://github.com/vllm-project/vllm.git cd vllm git checkout de7dd634b969adc6e5f50cff0cc09c1be1711d01 pip install -r requirements/rocm.txt python setup.py develop cd .. export QUARK_MXFP4_IMPLtriton修改vLLM源码文件文件1vllm/model_executor/models/step3p5.py添加packed_modules_mapping属性到Step3p5ForCausalLM类class Step3p5ForCausalLM(nn.Module, SupportsPP, MixtureOfExperts): hf_to_vllm_mapper WeightsMapper( orig_to_new_substr{.share_expert.: .moe.share_expert.} ) packed_modules_mapping { qkv_proj: [ q_proj, k_proj, v_proj, ], gate_up_proj: [ gate_proj, up_proj, ], }文件2vllm/model_executor/layers/quantization/quark/quark_moe.py强制设置self.emulate为True- self.emulate ( - not current_platform.supports_mx() - or not self.ocp_mx_scheme.startswith(w_mxfp4) - ) and (self.mxfp4_backend is None or not self.use_rocm_aiter_moe) self.emulate True这些修改确保vLLM能够正确处理Step-3.5-Flash的MoE结构和MXFP4量化格式。 步骤3模型加载与推理启动完成环境准备后使用vLLM加载量化后的模型python -m vllm.entrypoints.api_server \ --model $output_dir \ --quantization quark \ --trust_remote_code \ --attention_backend ROCM_AITER_UNIFIED_ATTN \ --port 8000核心参数说明--model指定量化后的模型目录--quantization quark启用AMD-Quark量化支持--attention_backend ROCM_AITER_UNIFIED_ATTN使用AMD优化的注意力后端启动成功后您可以通过HTTP API或Web界面与模型交互。例如使用curl进行测试curl http://localhost:8000/generate \ -H Content-Type: application/json \ -d {prompt: What is the meaning of life?, max_tokens: 100}✅ 步骤4性能验证与评估为确保模型在AMD硬件上高效运行建议进行性能评估。项目提供了基于GSM8K基准的评估方法lm_eval --model vllm --model_args pretrained$MODEL_DIR,attention_backendROCM_AITER_UNIFIED_ATTN,quantizationquark,trust_remote_codeTrue --tasks gsm8k --batch_size auto根据官方测试数据该模型在GSM8K基准上达到了87.26%的准确率相比原始bf16模型89.39%保持了97.6%的精度恢复率同时显著降低了显存占用。⚠️ 步骤5常见问题解决与优化建议在部署和运行过程中可能会遇到以下问题内存访问错误确保设置环境变量QUARK_MXFP4_IMPLtriton性能不佳检查ROCM版本是否为7.1.0旧版本可能不支持MXFP4优化模型加载失败确认使用了正确的vLLM commit版本和补丁多GPU配置对于多GPU部署添加--tensor-parallel-size N参数N为GPU数量优化建议调整批处理大小以平衡吞吐量和延迟使用--gpu-memory-utilization 0.9提高GPU内存利用率对于长文本处理可调整max_seq_len参数最大支持128000 tokens 总结与资源通过以上5个步骤您可以在AMD MI350/MI355硬件上高效部署和运行Step-3.5-Flash-MXFP4模型。该模型结合了MXFP4量化技术和MoE架构在保持高精度的同时显著提升了推理效率。相关资源模型配置文件configuration_step3p5.py量化脚本step3p5_quantize_quark.pyAMD-Quark文档https://quark.docs.amd.com/latest/index.htmlvLLM文档https://docs.vllm.ai/en/latest/如果您在使用过程中遇到问题建议查阅项目README.md或联系AMD开发者获取支持。【免费下载链接】Step-3.5-Flash-MXFP4项目地址: https://ai.gitcode.com/hf_mirrors/amd/Step-3.5-Flash-MXFP4创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考