llamafactory 0.6.3 缺少cli？版本对比与安装指南

2026-06-01阅读 0热度 0

其他

先说结论：你碰到的问题几乎不可能是操作不当，而是版本设计本身的差异——v0.6.3 尚未将 `llamafactory-cli` 注册为入口脚本，因此安装后自然找不到对应的可执行文件。 ![llamafactory 0.6.3 没有 llamafactory-cli](http://img.318050.com/uploads/20260601/17803094256a1d5db16cd1d222386373.webp) ### 一、为什么 0.6.3 不包含 `llamafactory-cli` LLaMA Factory 在 0.6.x 阶段的项目名称仍是 `llmtuner`。无论你查 `pyproject.toml` 还是 `setup.py`，都会发现：包名明确是 `llmtuner`，而 `console_scripts` 字段里压根没有 `llamafactory-cli` 的配置。这个命令是直到 0.8+ 版本才统一整合进去的。回看你安装时输出的消息： ``` Successfully installed llmtuner-0.6.3 ``` 注意到了吗？你实际安装的是 `llmtuner`，而不是后来改名的 `llamafactory`。因此当你尝试执行 `llamafactory-cli` 时，系统报 “No such file or directory” 是完全合理的——0.6.3 本来就没有这条命令。 ### 二、为什么 0.8.3 能正常安装并调用从 0.8+ 开始，项目正式更名为 `llamafactory`。更关键的是，`setup.py` 中新增了一行关键配置： ```python console_scripts = ["llamafactory-cli = llamafactory.cli:main"] ``` 有了这行配置，安装时系统才会自动生成名为 `llamafactory-cli` 的可执行文件。所以你切换到 v0.8.3 后能直接调用它，原因就在于此。 ### 三、0.6.3 的正确用法（绕过 `llamafactory-cli`）在 0.6.3（即 `llmtuner`）时代，标准做法是直接通过 Python 调用脚本。具体如下： ```bash # 先进入源码根目录 cd ~/llama-factory # 训练（等价于后续版本的 llamafactory-cli train） python src/train_bash.py examples/train_lora/xxx.yaml # 启动聊天 python src/cli_demo.py ``` 操作十分直接，功能也完全够用。 ### 四、你现在有两条可行路径 **第一条：继续使用 0.6.3（适配 DTK / triton）** 那么请彻底忘记 `llamafactory-cli`，直接用上面介绍的 `python src/train_bash.py ...` 方式即可。一切照常运行，功能无损。 **第二条：升级到 0.8.3+（可获得 `llamafactory-cli`）** 升级后确实能享受命令行工具，但有一个前提：必须先验证你的 `triton-2.1.0+das1.0` 是否兼容 0.8.x 版本。务必在升级前做一次兼容性测试，否则可能引入新的麻烦。 ### 五、一句话总结 - 0.6.3 = `llmtuner` → 无 `llamafactory-cli` - 0.8.3+ = `llamafactory` → 有 `llamafactory-cli` - 问题不在你，完全是版本差异所致。如果需要，我可以直接提供一份 0.6.3 环境下常用的启动命令（训练/聊天/导出），复制粘贴即可使用。

llamafactory 0.6.3 缺少cli？版本对比与安装指南

相关阅读

最新教程

最新资讯