Lightricks/LTX-Desktop

LTX Desktop – 是什么

LTX Desktop 是一个开源桌面应用程序，可使用 LTX 品牌的生成模型来生成和编辑视频（及图像）。它在强大的 Windows/Linux NVIDIA GPU 或 Apple Silicon Mac 上本地运行，当硬件不足时会自动降级到付费云 API。

---

核心功能

功能	工作方式
文本生成视频	输入提示；本地 LTX 2.5 Fast（默认）或 LTX 2.3 Fast 模型生成视频。
图像生成视频 / 音频生成视频	相同模型可接受图像或音频片段作为额外条件。
视频编辑（重拍 / 延长）	仅旧版 LTX 2.3 Fast 模型支持本地“重拍”编辑；新版 LTX 2.5 Pro 版本通过云 API 实现。
文本生成图像 & 图像生成图像	使用相同后端集成图像生成/编辑功能。
LoRA 支持	从内置库或您自己的 .safetensors 文件加载 LoRA 适配器（风格/主题微调）——仅支持本地视频生成。
提示增强	通过本地模块或 Gemini API 进行目录感知的提示重写，以优化提示。
视频编辑 UI	基于时间线的编辑器，用于组装、裁剪和填充生成片段的空白。

---

本地模式 vs. API 模式

平台	何时获得 本地生成	何时获得 仅 API
Windows + CUDA GPU（≥16 GB VRAM）	下载模型权重并在 GPU 上运行。	若缺少 GPU、VRAM < 16 GB 或驱动未知 → 需要 LTX API 密钥。
Linux + CUDA GPU（≥16 GB VRAM）	与 Windows 相同。	相同降级。
macOS Apple Silicon（≥15 GB 空闲 RAM）	在 Apple 的 MPS 后端上运行。	空闲 RAM 不足或 Intel Mac → 仅 API。

在仅 API 模式下，您仍可生成视频，但受限于云服务提供的分辨率/时长，且必须为 Fast 或 Pro 套餐付费。

---

快速上手

1. 从仓库的 Releases 页面下载安装程序。
2. 运行安装程序——它将创建基于 Electron 的 UI 和 Python FastAPI 后端。
3. 首次启动时，可能需要登录 Hugging Face 以接受受保护的 2.5 模型权重的许可协议。
4. 在 Settings → API 中配置一个免费的 LTX API 密钥（用于云文本编码和可选的云生成）。
5. 在 UI 中选择 Local 或 API 模式；应用将自动检测硬件和空闲 RAM。

所有应用数据（设置、下载的模型、日志）均存储在标准 OS 数据文件夹中：

• Windows: %LOCALAPPDATA%\LTXDesktop\
• macOS: ~/Library/Application Support/LTXDesktop/
• Linux: ~/.local/share/LTXDesktop/

---

开发与贡献

仓库分为三个层级：

• Renderer – React + TypeScript UI (frontend/)。
• Electron – 原生窗口、文件对话框和进程管理 (electron/)。
• Backend – 与 GPU 和外部 API 通信的 Python FastAPI 服务器 (backend/)。

贡献者快速入门：

# 安装 Node、uv、Python 3.13+、Git
pnpm setup:dev   # 安装依赖、创建虚拟环境、构建 UI
pnpm dev         # 以开发模式启动 Electron + 后端

还存在用于调试、类型检查、运行后端测试和性能验证的额外脚本。

---

许可与隐私

• 代码 – Apache-2.0。
• 模型权重 – 从 Hugging Face 单独下载；各自携带独立许可证。
• 遥测 – 可选的匿名使用统计（应用版本、平台、随机 ID）。可在 Settings → Anonymous Analytics 中禁用。

---

哪些人可能用得上？

• 需要仅桌面工作流、快速视频原型设计且不向云端发送数据的创作者。
• 在视频扩散模型上实验 LoRA 适配器的研究人员。
• 希望使用单一 UI 实现文本到视频、图像到视频及基础视频编辑，并在硬件不足时可降级到付费 API 的团队。

---

总结：LTX Desktop 将现代视频扩散流水线打包为用户友好的 Electron 应用，既支持高端 GPU/Apple Silicon 上的完全本地生成，也提供低性能设备的云降级方案。这是一个真实、持续维护的 AI 项目。