安装v4.51.3-Qwen2.5-Omni-preview后无法导入QwenForCausalLM求助

问题描述 #

我正尝试安装支持Qwen2.5-Omni模型的Hugging Face Transformers版本，根据官方文档，正确的安装标签为v4.51.3-Qwen2.5-Omni-preview。但每次尝试后，pip都会安装transformers-4.52.0.dev0，导致我无法导入QwenForCausalLM或QwenTokenizer。

已尝试步骤 #

• 通过pip直接从GitHub安装：

  pip install git+https://github.com/huggingface/transformers@v4.51.3-Qwen2.5-Omni-preview
  

  结果：pip安装了transformers-4.52.0.dev0

• 克隆仓库并手动安装：

  git clone https://github.com/huggingface/transformers.git
  cd transformers
  git checkout v4.51.3-Qwen2.5-Omni-preview
  pip install .
  

  结果：仍然安装了4.52.0.dev0

• 卸载、清除缓存后重新安装：

  pip uninstall transformers -y
  pip cache purge
  pip install --no-deps --force-reinstall .
  

  结果：仍然安装了4.52.0.dev0

• Python导入测试：

  import transformers
  print(transformers.__version__)
  from transformers import QwenForCausalLM, QwenTokenizer
  

  结果：ImportError: cannot import name 'QwenForCausalLM'

遇到的错误 #

• ImportError: cannot import name 'QwenForCausalLM' from 'transformers'
• 安装v4.51.3-Qwen2.5-Omni-preview始终得到4.52.0.dev0
• 使用--upgrade会安装最新开发版本，覆盖预览标签

问题说明 #

• Qwen2.5-Omni标签基于Transformers v4.51.3，但pip将开发版本v4.52.0.dev0识别为更新版本并安装。
• 官方文档提示："此标签是Qwen2.5-Omni模型的预览版，基于主分支打标签，不遵循语义化版本规则，该模型将包含在下一个小版本v4.52.0中。"
• Pip缓存、预安装依赖以及Windows路径处理导致安装的是开发版本而非预期标签。

已尝试的临时解决方法 #

• 可编辑本地安装：

  git clone https://github.com/huggingface/transformers.git
  cd transformers
  git checkout v4.51.3-Qwen2.5-Omni-preview
  pip uninstall transformers -y
  pip install -e .
  

• 干净环境：

  • 创建专门用于Qwen2.5-Omni的全新虚拟环境。
  • 避免使用pip install --upgrade transformers。

注意事项 #

• 即使正确切换到指定标签，由于版本控制和缓存逻辑，pip仍可能将wheel重新构建为4.52.0.dev0。
• 这是Windows和pip管理环境中的常见问题。

求助需求 #

如何在Windows环境中可靠安装v4.51.3-Qwen2.5-Omni-preview标签，以确保可以导入QwenForCausalLM和QwenTokenizer？

内容的提问来源于stack exchange，提问作者Promit Dey Sarker Arjan