
RFC: CTranslate2 not being maintained
快速结论:此 Issue 主要是一个讨论帖,核心问题是 CTranslate2 (CT2) 上游库缺乏维护,导致 faster-whisper 用户面临依赖冲突(尤其是 CUDA 和 Python 版本)以及 pkg_resources 弃用警告。最终解决方案是社区成员接手维护,并计划在 CT2 仓库中推进关键 PR 的合并与发布。如果遇到 CUDA 或 Python 版本兼容性问题,优先检查 CT2 仓库的进展或尝试自行编译。
问题场景
用户在使用 Faster Whisper 进行语音转文字时,其底层依赖 CTranslate2 库因缺乏维护,产生了与 PyTorch、CUDA 等环境的依赖冲突,并收到 pkg_resources 弃用警告。此 Issue 是一个公开讨论,旨在确认 CT2 维护状态并探索后续路径。
报错原文
UserWarning: pkg_resources is deprecated as an API. See https://setuptools.pypa.io/en/latest/pkg_resources.html. The pkg_resources package is slated for removal as early as 2025-11-30. Refrain from using this package or pin to Setuptools<81
原因分析
可能原因:
- CTranslate2 仓库的原开发团队(Systran)已全部离开,项目处于无人主动维护状态。Issue 发起者从与项目密切相关的知情人士处获得了此信息。
- 由于缺乏维护,CT2 无法及时适配新的 CUDA SDK、Python 版本以及 PyTorch 更新,导致在较新的环境中安装或运行时出现依赖冲突。此外,CT2 中仍在使用已弃用的
pkg_resourcesAPI。 - 社区讨论中出现两种方向:一是在 CT2 基础上继续维护,仅保留 Whisper 相关功能以简化工作;二是直接 fork 并移除非 Whisper 部分,但此举可能限制社区贡献。最终,社区决定在现有 CT2 仓库中继续维护,并由有 C++ 经验的贡献者提供支持。
环境排查
- 确认 CTranslate2 的版本(如 OpenNMT/CTranslate2)。
- 确认 PyTorch、CUDA 以及 Python 版本,查看是否有已知的兼容性问题。
- 检查是否触发了
pkg_resources弃用警告,以及 setuptools 版本(例如setuptools<81可临时绕过)。
解决步骤
注意:此 Issue 不包含具体的代码修复命令,而是指向了社区协作的解决方案。以下步骤基于讨论结论整理。
- 确认 CT2 维护状态:查看 CTranslate2 #1922 以获取管理员权限转移及后续维护计划的最新进展。
- 关注关键 PR:以下两个 PR 对于 faster-whisper 至关重要,可主动测试并提供反馈:
- 临时处理 pkg_resources 警告:在环境中将
setuptools锁定到 81 以下版本(例如setuptools<81),但这仅为权宜之计。 - 尝试自行编译:如果遇到 CUDA 包与 PyTorch 的冲突,可考虑从源码编译 CTranslate2,以匹配本地的 CUDA 环境。具体编译步骤可参考 CT2 官方文档。
验证方法
确认 faster-whisper 能够正常安装并运行,不再出现因 CT2 版本不匹配导致的导入错误或运行时错误。同时,检查 pkg_resources 警告是否已消除,或确认安装了上游修复后的 CT2 新版本。



![[Bug]: Broken Images (404 Not Found) in Discussion #557](https://www.chat-gpts.plus/wp-content/uploads/2026/06/4033-20608001-768x403.jpg)