Upload folder using huggingface_hub

README.md

@@ -0,0 +1,56 @@
+---
+license: unknown
+base_model: Qwen/Qwen-Image-2512
+tags:
+- text-to-image
+- lora
+- korean-typography
+- qwen-image
+- diffsynth-studio
+pipeline_tag: text-to-image
+---
+
+# Qwen-Image-2512 Korean Text Rendering LoRA
+
+`Qwen/Qwen-Image-2512` DiT를 대상으로 한 LoRA 어댑터로, 이미지 안에 정확한 한글 텍스트를 렌더링하는 능력을 개선하기 위해 학습했습니다. 베이스 모델 가중치는 전부 고정(frozen)하고 어댑터만 학습했습니다 (adapter-only).
+
+> ⚠️ **이 저장소만으로는 사용할 수 없습니다.** `adapter_model.safetensors`는 LoRA
+> **델타(차이값)만** 담고 있고, 원본 가중치를 포함하지 않습니다. 실제 추론에는 아래 베이스
+> 모델을 별도로 받아 함께 로드해야 합니다:
+> - [`Qwen/Qwen-Image-2512`](https://huggingface.co/Qwen/Qwen-Image-2512) — transformer(DiT)
+> - [`Qwen/Qwen-Image`](https://huggingface.co/Qwen/Qwen-Image) — text_encoder, vae
+
+## 학습 데이터
+
+atomic_text(원자 텍스트) + atomic_text_new(신규 원자 텍스트) + infographic(인포그래픽,
+1.5~4배 반복 샘플링) 조합, 총 45,482행(train) / 478행(validation)으로 학습했습니다.
+
+- `atomic_text`: 9,667 노출
+- `atomic_text_new`: 27,287 노출
+- `infographic`: 8,528 노출 (원본 2,246장을 반복 샘플링해 비중 보정)
+
+**공개 데이터셋과의 차이**: 같은 계보의 데이터를 정리해
+[`fasoo/korean-text-rendering-data`](https://huggingface.co/datasets/fasoo/korean-text-rendering-data)
+로 별도 공개했지만, 이 체크포인트의 실제 학습 레시피와 완전히 동일하지는 않습니다.
+
+## 사용 방법 (DiffSynth-Studio)
+
+```python
+from diffsynth import ModelManager, QwenImagePipeline
+
+model_manager = ModelManager()
+model_manager.load_models([
+    # Qwen/Qwen-Image-2512:transformer, Qwen/Qwen-Image:text_encoder, Qwen/Qwen-Image:vae
+])
+pipe = QwenImagePipeline.from_model_manager(model_manager)
+pipe.load_lora(pipe.dit, "adapter_model.safetensors")
+
+image = pipe(prompt='KR-Atomic-Text, ... Place the Korean text "무작위 표집" ...')
+```
+
+정확한 로딩 인자(`model_id_with_origin_paths` 등)는 베이스 모델 구성에 따라 달라질 수 있습니다.
+
+## 라이선스 관련 주의
+
+- 베이스 모델(`Qwen/Qwen-Image-2512`, `Qwen/Qwen-Image`)의 라이선스 조건이 이 어댑터에도
+  적용됩니다 — 사용 전 확인하세요.

adapter_model.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:66f8e6d26f05301d7e773ea4ba1f2905b137963edf649a23a0bebeebd87a1a3b
+size 472047184

training_metadata.json

@@ -0,0 +1,22 @@
+{
+  "base_model": {
+    "transformer": "Qwen/Qwen-Image-2512",
+    "text_encoder": "Qwen/Qwen-Image",
+    "vae": "Qwen/Qwen-Image"
+  },
+  "lora": {
+    "rank": 32,
+    "target": "dit",
+    "base_weights": "frozen (adapter-only)"
+  },
+  "training_data": {
+    "hf_dataset": "https://huggingface.co/datasets/fasoo/korean-text-rendering-data",
+    "recipe_rows": 45482,
+    "validation_rows": 478,
+    "composition": {
+      "atomic_text": 9667,
+      "atomic_text_new": 27287,
+      "infographic (repeat x4)": 8528
+    }
+  }
+}