帮助文档 / 安装与故障排除
Linux(社区版)
由 @joshuaswarren 贡献(PR #94)。 通过 Pinokio 运行的 macOS 是受支持的平台;这个目标由社区维护, 不在发布检查的范围内。欢迎反馈问题。
安装
在应用根目录运行:
bash scripts/linux/install.sh # engine venv, omarchy-mlx wheel pinned by sha256
bash scripts/linux/install_h3.sh # optional: the Hailuo H3 engine
./run_panel.sh
omarchy-mlx wheel 是第三方构建;安装程序在安装它之前,会校验它固定的发布版 sha256。 模型像在 Mac 上一样,从面板里下载。
Linux 上的 Hailuo H3
在 Linux 上,H3 可以使用完整的 Q8 DiT 包,而不需要 bf16 主文件。两个配置文件
和所有已索引的分片都必须存在;仅有一个 .built_ok 标记是不够的。macOS 仍然需要
bf16 主文件来发现安装。
在 Omarchy 上的实测
Apple Silicon 上的 Linux 使用带 Vulkan 后端的 MLX,而不是 Metal。这些是不同引擎的独立运行,不是对机器或“最佳/快速”控件的比较。每个输出都经过人工查看。
| 机器 | 引擎和设置 | 实际输出 | 原生任务耗时 | 峰值内存 | 驱动来源 |
|---|---|---|---|---|---|
| 14 英寸 M2 Max MacBook Pro | FLUX.2-klein-4B,原生队列,浏览器在另一台机器上 | 512x512 PNG | 58.3 s | 未记录 | 运行时未捕获 |
| 14 英寸 M2 Max MacBook Pro | H3 原生界面,草稿,快速(3 步),种子 42,640x384 | 73 帧,1280x720 导出,时长 3.042 s | 1610.79 s | 未记录 | 未捕获;二进制哈希见下 |
| 16 英寸 M1 Max MacBook Pro | LTX 原生队列,8 步,种子 42 | 9 帧,256x128,时长 0.375 s | 181.26 s | 报告为 31.1G,无交换 | 69bde15340 |
LTX 这一行使用的是未发布的诊断运行时。已发布的 0.7.32 wheel 无法运行它的 uint8 Take 运算,安装程序固定的版本保持不变。请求的高度 160 在 64 像素的画布网格上会变成 128。队列还把四步的请求规范成了八步;所以这不是四步的耗时。
H3 这次运行有一段经过查看的 45 秒录像,记录了提示词、“最佳/快速”控件和做好的片段。“最佳”与“快速”的耗时对比,要等机器恢复并还原 H3 权重后再做。
驱动来源:
LTX, 16-inch M1 Max MacBook Pro
source commit 69bde153405cf02d52b0c9810307a0c7d0085d52
package omarchy-mlx-vulkan-omarchy 1:26.2.4.git69bde15340-2
driver sha256 40282811c6e14ef991f72936bb675008cb4d6b3199b1785bc34c7976ab89c425
kernel 7.1.12-2-12.6-sep-ARCH
H3, 14-inch M2 Max MacBook Pro
source commit not captured; this run predates the package above
driver sha256 a70fb890552f5282ac6ee91b6800d310de9759fe7d18232a48dcbeb31db7c6af
kernel 7.1.12-2-12.6-sep-ARCH 来源:docs/LINUX.md,位于公开仓库。发布前已针对本网站审阅。译自英文原文。建议修改。