symbol-lora / README.md
sssmartmita's picture
Polish model card and refresh examples
1536140 verified
|
Raw
History Blame Contribute Delete
7.95 kB
---
base_model: circlestone-labs/Anima
base_model_relation: adapter
pipeline_tag: text-to-image
tags:
- lora
- anima
- comfyui
- safetensors
- character-lora
license: other
license_name: circlestone-labs-non-commercial-license
license_link: https://huggingface.co/circlestone-labs/Anima/blob/main/LICENSE.md
---
<div align="center">
<picture>
<img src="assets/symbol-logo.png" width="46%" alt="Symbol v1.0">
</picture>
<h1>Symbol v1.0</h1>
<p><strong>Anima Character LoRA</strong></p>
<p>
<code>Trigger: Symbol</code>
·
<code>LoRA strength: 1.0</code>
·
<code>Safetensors</code>
</p>
<p>
<a href="https://huggingface.co/circlestone-labs/Anima">Anima Base v1.0</a>
·
<a href="examples/PROMPTS.md">完整样图参数</a>
·
<a href="PROVENANCE.md">角色来源</a>
</p>
</div>
---
`Symbol` 是一位发色独特、蓝眼睛的原创二次元女孩,她经常穿着那件蓝色夹克,看上去对一切都保持乐观✌。
本仓库发布的是 **Symbol 单角色 LoRA**,适用于
[Anima Base v1.0](https://huggingface.co/circlestone-labs/Anima)。
该角色源于一张由网友 AI 生成的头像。发布者在获得二次创作授权后,对角色进行了重新设计、补全、精修、错误修复与多角度扩展,形成了现在的角色设定。
训练内容覆盖原设服装、多种换装,以及一套可通过提示词调用的单丸子头替代发型。
更完整的来源说明见 [PROVENANCE.md](PROVENANCE.md)。
> 理论上本模型可生成成人向内容;Symbol 被设定为成年虚构角色。
## 快速开始
| 项目 | 推荐值 |
| --- | --- |
| 模型文件 | [`symbol-v1.0.safetensors`](https://huggingface.co/sssmartmita/symbol-lora/resolve/main/symbol-v1.0.safetensors) |
| Trigger | `Symbol`(请保持这个大小写形式) |
| LoRA strength | `1.0` |
| 基模 | [`circlestone-labs/Anima`](https://huggingface.co/circlestone-labs/Anima) / `anima-base-v1.0.safetensors` |
<details>
<summary><strong>文件校验信息</strong></summary>
- LoRA SHA-256:`32B6CFDD1A7390BE1259798FA77E5B647F7E136DD7CA3F50ED798C9A0C97EE14`
- 基模 SHA-256:`BD43B7CFFE1ED1153D9C41E7BEB2F18CB1273EAFBAA3AF3EDD6A173DC90A006E`
</details>
## 安装
`.safetensors` 文件放入:
```text
ComfyUI/models/loras/
```
在 ComfyUI 中使用 `Load LoRA Model Only` / `LoraLoaderModelOnly` 加载,强度先从
`1.0` 开始。该 LoRA 只修改模型侧,仍需按 Anima 官方方式加载 Qwen3 文本编码器
和 Qwen Image VAE。
## 提示词
最小角色调用:
```text
newest, safe, 1girl, Symbol, solo
```
原设服装(按镜头中实际可见范围或穿搭需要选用,不必每次全部填写):
```text
stud earrings, blue jacket, white shirt, black shirt, key necklace,
black shorts, fingerless gloves, loose socks, high tops
```
替代丸子头:
```text
hair bun, single hair bun, hair up, sidelocks
```
经过本版本验证的基础设置:
- CFG:`4.5`
- Sampler:`dpmpp_2m_sde_gpu`
- Scheduler:`beta57`
- LoRA strength:`1.0`
发布样图同时包含 `768×1024 / 30 steps` 后放大与原生
`1024×1536``1024×800 / 60 steps` 两组设置。尺寸、steps、seed 和完整 prompt
请以 [examples/PROMPTS.md](examples/PROMPTS.md) 的逐图记录为准。
`beta57` 和本仓库样图使用的 FLS Sampler 属于可选自定义节点,并不是 LoRA 的
硬依赖。使用其他采样器时,请参照 Anima Base 的官方建议自行验证。
<details>
<summary><strong>起步推荐负向提示</strong></summary>
```text
oldest, low quality, score_1, score_2, score_3, watermark, logo, text,
bad anatomy, bad hands, bad feet, extra fingers, missing fingers,
distorted face, blurry, extra limbs, missing limbs, broken accessories
```
</details>
## 示例
### 原设与场景
| 原设正面 | 三分之四视角 | 公交站场景 | 海边场景 |
| --- | --- | --- | --- |
| ![](examples/original-front.png) | ![](examples/original-three-quarter.png) | ![](examples/original-outfit-bus-stop.png) | ![](examples/original-outfit-seaside.png) |
### 发型变化
| 替代丸子头 | 丸子头晨间场景 |
| --- | --- |
| ![](examples/alternative-bun.png) | ![](examples/alternative-bun-morning.png) |
### 换装测试
| 婚纱换装 | 职业装换装 |
| --- | --- |
| ![](examples/wedding-dress-meadow.png) | ![](examples/office-outfit.png) |
完整 prompt、seed 与生成参数见 [examples/PROMPTS.md](examples/PROMPTS.md)。当前展示的
八张样图中,四张经过 RTX Video Super Resolution 2× 放大,四张为原生尺寸输出;
放大器不包含在 LoRA 中,也不是使用 LoRA 的必要条件。
## 局限性
- 为保护角色服装细节,本 lora 使用较激进的训练配方(rank 64、学习率 `4e-5`、880 updates),
因此有较强的角色先验,**哪怕 tag 为空,也能召回 Symbol**,因此可能不适合绘制其它角色,
在部分场景中可能出现角色特征、画风或服装先验过强的现象。
- 角色没有经过冻结和系统训练的“原设内衣”或“原设贴身衣物”设计。在内衣、
贴身衣物及换装过渡场景中,具体样式主要受 prompt、基模和 seed 影响,不应将
随机输出视为角色 Canon。
- 徽章、项链、腰链、青色垂带等小型或有左右归属的配件,仍有概率错位、缺失、
重复、左右翻转或附着到错误衣层;遮挡、严格侧面、背面和极端透视下概率更高。
- 多层服装、复杂姿势、手部互动、多人画面、极端镜头和复杂遮挡尚未进行系统的
跨 seed 评估,仍可能出现常见生成问题。
- `Symbol` 同时是常见英文词;理论上在大量普通“符号/标志”语义与角色同时出现时,
可能产生轻微语义交叠。
- 角色鞋上的具体装饰、印花暂无经过强一致性训练,其生成结果可能带有随机性。
- 仅验证 Anima Base v1.0。其他 Anima 分支、量化版本、合并模型或后续版本可能
产生不同结果。
- LoRA 的输出具有随机性。示例图只表示已观察到的能力,不构成对任意 prompt、
seed、采样器或工作流的质量保证。
## 训练摘要
- 数据:101 张图片与 101 份同名 caption,一一配对;
- Trigger:每份 caption 中恰好一次 `Symbol`
- Resolution:1024,启用 buckets;
- Repeats:4;batch 1;gradient accumulation 4;
- Rank / alpha:64 / 32;network dropout:0.05;
- Optimizer:AdamW;LR:`4e-5`;constant scheduler;0 warmup;
- DiT-only LoRA;BF16;seed `20260725`
- 880 optimizer updates;每 80 steps 保存;
- Trainer:`sd-scripts v0.10.5`,commit
`a1b48df430a3690aeb5c9b6e7b19025afe8fb518`
- 版本:Symbol v1.0;对应内部训练 checkpoint step880;
- step880:840 个 finite tensor;记录的最终 `avr_loss=0.0535`
完整参数见 [training/TRAINING.md](training/TRAINING.md)。
说明见 [DATASET.md](DATASET.md)。
## License and notices
本 LoRA 是 Anima 的衍生模型,使用与分发受 CircleStone Labs Non-Commercial
License 及适用的 NVIDIA Open Model License 条款约束。请阅读本仓库中的
[LICENSE.md](LICENSE.md)、[NOTICE.md](NOTICE.md) 和 [licenses/](licenses/)。
---
## English summary
Symbol is an original adult fictional anime character with short blue-to-pink gradient hair
and blue eyes. This repository contains the Symbol v1.0 character LoRA for Anima Base v1.0;
the public weight corresponds to internal training checkpoint step880. Use the exact trigger
`Symbol` at strength `1.0`. The model covers
the default outfit, outfit changes, and an optional single-bun hairstyle. It may generate
adult content. Small asymmetric accessories, strict side views, complex clothing layers,
hands, occlusion, and multi-person scenes may be inconsistent. Training images are not
included in this weights release.