omnichar/OmniChar

这是什么？

核心功能

• 01便携的 .char 文件打包参考照片、身份特征与锁定的角色描述。
• 02在 NVIDIA 显卡上本地生成与训练 LoRA，并支持 CPU 运行。
• 03支持 FLUX.1、FLUX.2、Krea 2、Z-Image Turbo、MiniMax H3 和 LTX-2.5。
• 04通过 fal 调用托管模型，并可将同一角色应用于 API 请求。
• 05提供 ComfyUI 自定义节点，读取同一种 .char 格式。
• 06每次生成结果都会根据与角色的一致性获得评分。

适用场景

• 在一系列图片或短片中保持同一角色的一致性。
• 在本地使用自己的照片或视频片段训练 LoRA，无需云端步骤。
• 使用 MiniMax H3 或 LTX-2.5 生成带同步声音的角色视频。
• 在 ComfyUI 工作流与独立工作室之间共享同一个角色文件。

快速上手

1. 1

   克隆代码仓库

   git clone https://github.com/omnichar/OmniChar
2. 2

   进入 core 目录

   cd OmniChar/core
3. 3

   安装全部组件(macOS/Linux)

   ./webui.sh --install --extra all
4. 4

   启动网页界面并打开 http://127.0.0.1:8848

   ./webui.sh

使用前须知

• !需要 Python 3.11+；本地生成需要性能足够的 GPU，Krea 2 推理至少需要约 40GB 显存的显卡。
• !Apple Silicon 和 AMD ROCm 等硬件路径尚未经过充分测试。
• !托管模型依赖外部 API，并非完全在本地运行。

标签

常见问题

OmniChar 是什么？

开源 AI 角色工作室与 .char 文件格式，可在不同图像和视频模型间保持角色一致。 Omnichar 用于构建 AI 角色，让同一角色在不同镜头和模型中保持相同的脸部、身材、服装与声音。角色被打包成一个可移植的 .char 文件，其中包含参考照片、身份特征、锁定的角色描述，也可以附带一段声音。生成既可以在本地 NVIDIA 显卡上运行，也可以通过 ComfyUI 的配套节点使用，或通过 fal 调用托管模型。

OmniChar 可以免费使用吗？用的什么许可证？

OmniChar 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

OmniChar 还在维护吗？

活跃维护中。OmniChar 最近一次提交是在 2026年10月16日。

OmniChar 适合用来做什么？

在一系列图片或短片中保持同一角色的一致性。 在本地使用自己的照片或视频片段训练 LoRA，无需云端步骤。 使用 MiniMax H3 或 LTX-2.5 生成带同步声音的角色视频。 在 ComfyUI 工作流与独立工作室之间共享同一个角色文件。

OmniChar 怎么安装和运行？

克隆代码仓库: git clone https://github.com/omnichar/OmniChar 进入 core 目录: cd OmniChar/core 安装全部组件(macOS/Linux): ./webui.sh --install --extra all 启动网页界面并打开 http://127.0.0.1:8848: ./webui.sh

在哪里获取 OmniChar？

源代码和安装说明在 GitHub 上：https://github.com/omnichar/OmniChar