heathcliff01/Kaloscope-style-adapter

Kaloscope Style Adapter

内容由你描述，风格独立掌控。

通过画师名称、加权多画师组合或参考图，为图像生成提供独立的风格条件。内容提示词描述“画什么”，风格入口决定“怎么画”：不用把画师名称反复堆进内容提示词，也可以探索不同风格之间的组合。

本仓库发布三个适配器，分别用于 Krea2 Raw、Krea2 Turbo 和 MOSS-Image-Base，并提供匹配的风格原型库、参考图编码器和 ComfyUI 工作流。

Style adapters for Krea2 Raw, Krea2 Turbo and MOSS-Image-Base. Choose an artist-name prototype, blend artist features, or use a reference image as a separate style condition. Base models and the matching ComfyUI nodes are required.

画师名称生成

选择画师名称，直接调用对应的风格原型。配套风格库覆盖 44,129 位画师；节点支持名称搜索、近似拼写与已验证别名。名称入口无需运行参考图编码器。

多画师融合

将不同画师的风格特征组合起来，探索新的视觉方向。支持 fkey, (rolua:0.8) 这样的相对权重语法；不显式写权重时采用等权组合。权重是特征混合比例，不是可感知风格百分比。

参考图生成

用一张图片提供风格条件，再用文字描述新的画面。配套 artist-v1 编码器将参考图映射为 256 维风格特征。

名称与融合图来自 Turbo，参考图分区包含 Raw 与 Turbo 输出

选择模型

模型	对应底模	Adapter 参数量	权重体积	采样起点	下载 / 模型卡
Krea Kaloscope Raw	Krea-2-Raw	13.31M	50.77 MiB	Euler 25 步	权重 · 模型卡
Krea Kaloscope Turbo	Krea-2-Turbo BF16	13.31M	50.77 MiB	Euler 8 步	权重 · 模型卡
Kaloscope MOSS	MOSS-Image-Base	7.02M	26.77 MiB	Euler 50 步	权重 · 模型卡

下载与使用

ComfyUI 推理节点： Kaloscope Style Adapter for ComfyUI。

1. 安装上述节点与相应底模、文本编码器和 VAE。
2. 下载本仓库文件，并使用 安装辅助脚本 将所选权重复制到插件所需目录：

hf download heathcliff01/Kaloscope-style-adapter --local-dir Kaloscope-style-adapter
python Kaloscope-style-adapter/install_models.py --comfyui "/path/to/ComfyUI" --variant turbo --with-encoder

--variant 可选 raw、turbo、moss 或 all。仅使用名称或名称融合时可省略 --with-encoder。

示例工作流已同步至推理节点 v3.0.0 的节点名称与接口，请先更新节点并重启 ComfyUI。安装辅助脚本将适配器放入 ComfyUI/models/kaloscope_adapters/；已安装的权重无需重新下载。

3. 重启 ComfyUI，将 workflows 中不带 _api 的 JSON 拖入界面。该目录包含 8 套 UI 工作流与对应的 8 套 API 工作流；Raw/Turbo 各含三种风格入口，MOSS 含名称与参考图入口。
4. 选择本机底模和依赖文件，参考图工作流中选择自己的图片。从 512 尺寸确认流程，再调节尺寸与强度。

版本	文本 CFG	风格 guidance	Adapter strength	采样时间表
Raw	2	3.5	1.0；固定 seed 可比较 0.8	配套分辨率调度
Turbo	1	1	1.0；固定 seed 可比较 0.8	固定 μ = 1.15
MOSS	3	6	1.0	配套 MOSS 时间表，shift = 5

原版依赖： Krea-2-Raw、Krea-2-Turbo、ComfyUI 格式 Krea2 与文本编码器/VAE、MOSS-Image-Base。Raw/Turbo 使用匹配的 Qwen Image VAE；MOSS 使用 Base 的完整 HF 目录与官方 HF 加载插件，不适用于 SFT 权重。

训练代码与推理节点

本项目的模型权重、训练实现与 ComfyUI 推理节点分别维护在以下仓库：

入口	内容
模型权重与模型卡	Raw、Turbo、MOSS 三个适配器，配套风格资源与示例工作流
训练代码	Kaloscope 适配器训练实现；配置与运行方式见该仓库 README
ComfyUI 推理节点	模型加载、画师名称与多画师融合、参考图风格生成

希望直接体验生成效果，可使用本页发布的模型与推理节点；希望研究或扩展训练流程，请查看训练代码仓库。各仓库及其依赖分别适用对应的许可条款。

配套资源与训练信息

• 画师风格原型库与名称清单：名称及名称融合所需。
• artist-v1 参考图编码器：参考图入口所需，必须使用匹配的特征空间。
• 权重校验信息与 SHA-256：核对下载文件。

Adapter 训练时冻结底模、文本编码器、VAE 与风格编码器；风格编码器此前经过单独微调，VAE 未参与 adapter 微调。三个发布文件均未合并后续 NFT 强化学习试验更新。训练配置记录约 431 万目标样本与 41,759 个画师标签；这是训练记录口径，不等于原型库覆盖数量，也不是逐项生成质量验证。

使用边界

风格库覆盖不等于每项画风均经过质量保证。参考条件、未知组合与较高风格强度可能引发面部、人体或构图不稳定；更高的风格相似度分数不必然对应更好的视觉结果。MOSS 当前不承诺与 Krea2 相同的画师区分能力。FP8、GGUF、ControlNet、编译与其他 CFG 补丁的组合尚未全面验证。

欢迎分享风格组合、可复现工作流与失败案例，帮助改进风格表现和结构稳定性。

许可与来源

本仓库按组件采用上游许可，具体见 LICENSE.md：

• Krea Kaloscope Raw / Turbo：Krea 2 Community License，包括其商业使用条件、使用政策与分发要求；它们是独立的社区适配器，不代表 Krea 官方产品或背书。
• Kaloscope MOSS：Apache-2.0。该授权不替代其余依赖的许可。
• artist-v1 编码器：DINOv3 License；配套风格特征库保留 DINOv3 来源及适用约束，见许可说明。
• ComfyUI 节点代码的许可见其代码仓库；底模、文本编码器与 VAE 仍适用各自上游条款。

发布于 2026-10-23。本仓库只分发适配器与配套风格资源，不重新分发三个底模。