
شنو هو Anima Reference Adapter؟
Anima Reference Adapter هو مجموعة ديال العقد المخصّصة فـ ComfyUI باش تولّد صورة Anima انطلاقاً من صورة مرجعية وحدة وprompt فيه غير المشهد. كيحاول يحافظ على شكون اللي باين فالصورة، بما فيه الشعر، العينين، اللباس، الإكسسوارات، وحتى شي عناصر من ستيل الرسم، مع السماح للـprompt يتحكّم فالوضعية، الخلفية، الحركة، التأطير والتركيب.
ما محتاجش تزيد اسم الشخصية، tag ديال الفنان، ولا tags مفصّلة على المظهر. هاد الشي كيخلّي الـadapter مفيد للشخصيات الأصلية وحتى للشخصيات المعروفة. النسخة الحالية إصدار تجريبي تدرّب على 300 شخصية لـ 2,000 خطوة.

هاد المثال كيوضّح طريقة الخدمة المقصودة: الهوية البصرية كتجي من الصورة المرجعية، بينما prompt بحال full body, walking, hands in pockets, city, street, night, rain كيحدّد المشهد الجديد.
المزايا الرئيسية
- التوجيه بصورة وحدة: زوّد صورة وحدة باش تنقل هوية الشخصية وبعض الخصائص ديال الستايل.
- Prompt ديال المشهد فقط: وصف الحركة، الوضعية، المكان، التأطير والإضاءة اللي بغيتي، بلا ما تعاود توصف مظهر الشخصية.
- توجيه مستقل: عدّل text CFG وتوجيه الصورة المرجعية كل واحد بوحدو.
- تصحيح APG وإعادة القياس: تحكّم فالتشبّع الزائد مع القيم القوية ديال توجيه الصورة المرجعية.
- تكامل مع ComfyUI: المشروع كيوفّر loader، عقدة reference-latent، وcustom guider.
- دعم الشخصيات الأصلية: الطريقة ما كتحتاجش اسم شخصية معروفة.
كيفاش كيخدم الـAdapter
الصورة المرجعية كتتكيّف مع الأبعاد المطلوبة للإخراج بإضافة أشرطة بيضاء، ومن بعد كيتشفّرها Qwen-Image VAE. كتولي إطار latent ثاني ونقي فـ timestep zero حدّ latent الهدف المشوّش.
إحداثيات RoPE ديال الإطار المرجعي كتتزحزح لبرّا من شبكة صورة الهدف. هاد الشي كيقلّل من النسخ المتطابق على مستوى البكسلات، وكيخلّي الوضعية والتركيب المطلوبين يختلفو على الصورة المرجعية. LoRA برتبة 32 وفيه 45.9 مليون parameter كيعلّم Anima يقرا هاد الإطار الإضافي. LoRA ديال الـadapter كيكون خدام غير ملي كتكون الصورة المرجعية موجودة.
التوجيه المنفصل للنص والصورة المرجعية كيخلّيك توازن بين الالتزام بالـprompt ونقل الهوية والستايل. التوجيه الإسقاطي التكيفي، أو APG، متوفر باش يساعد يحافظ على الألوان متحكَّم فيها ملي كيكون توجيه الصورة المرجعية مرتفع.

المتطلبات
قبل ما تثبّت العقد المخصّصة، حضّر تثبيت خدام ديال ComfyUI ومكوّنات الموديل اللي كيحتاجها Anima:
- Anima base v1.0
- Qwen3-0.6B text encoder
- Qwen-Image VAE
- Anima Reference Adapter pilot weights
مكوّنات Anima متوفرة فـ مستودع Anima ديال CircleStone Labs. أوزان الـadapter متوفرة فـ مستودع Anima Reference Adapter على Hugging Face.
التثبيت
1. ثبّت العقد المخصّصة
حلّ terminal، دخل لمجلد custom_nodes ديال ComfyUI، ونسخ المستودع:
cd ComfyUI/custom_nodes
git clone https://github.com/ElectronGirl/ComfyUI-Anima-Ref-Adapter.git2. حمّل أوزان الـadapter
حمّل anima_ref_adapter_pilot_r32.safetensors وحطّو فالمجلد التالي:

ComfyUI/models/loras/anima_ref_adapter_pilot_r32.safetensors3. ثبّت Patch Sage Attention أو تجاوزو
جوج الـworkflows المرفقين كيستعملو عقدة Patch Sage Attention من ComfyUI-KJNodes. ثبّت KJNodes إلا كنت غادي تستعمل SageAttention. وإلا، اختار هاد العقدة فالـworkflow وتجاوزها باستعمال Ctrl+B.
4. عاود شغّل ComfyUI
عاود شغّل سيرفر ComfyUI من بعد تثبيت العقد والأوزان. عاود حمّل واجهة المتصفح باستعمال Ctrl+F5 باش يتسجلو العقد الجدد.
ولّد أول صورة ديالك
1. حلّ الـworkflow الأساسي
حمّل workflows/anima_ref_adapter.json من المستودع اللي نسختي لـ ComfyUI. كاين workflow ثاني، workflows/anima_ref_adapter_pag.json، فيه Anima Safe PAG، ومفيد من بعد ما يخدم الإعداد الأساسي.
2. حمّل صورة مرجعية
اختار صورة واضحة للشخصية اللي بغيتي تنقل الهوية والستايل ديالها. عقدة Anima Ref Latent كتكيّف الصورة مع أبعاد الإخراج المختارة، وكتزيد أشرطة بيضاء عند الحاجة، وكتشفّرها بـVAE. وكتنشئ حتى latent الهدف الفارغ ونسخة reference encode بنصف الحجم للـworkflows المتوافقة مع الدقة المتعددة.

3. كتب prompt فيه غير المشهد
استعمل كلمات الجودة، جنس الشخصية، solo، وtags ديال المشهد. ما تزيدش اسم الشخصية، اسم الفنان، ولا وصف للمظهر. البنية العامة ديال الـprompt هي:
masterpiece, best quality, score_7, newest, highres, absurdres, safe, <gender>, solo, <scene>مثلاً، باش تحط الشخصية المرجعية فشاطئ وقت الغروب، استعمل:
masterpiece, best quality, score_7, newest, highres, absurdres, safe, 1girl, solo, cowboy shot, looking back, smile, beach, ocean, sunsetأفكار خرين ديال البرومبتات غير للمشهد كتشمل:
الجزء الفوقاني من الجسم، جالس، شاد الكاس، كيشرب، قهوة، فالداخل، الشرجم، ضو الشمسبورتري، من الجنب، كيشوف لبعيد، زهر الكرز، بتلاتالجسم كامل، واقف، التلج، الغابة، الشتاالجزء الفوقاني من الجسم، كيقرا، شاد كتاب، مكتبة، رفوف الكتب
4. طبّق الإعدادات الموصى بها
بالنسبة للموديل الأساسي، بدا بهاد القيم:
- نوع بيانات الحساب:
bf16عبرModelComputeDtype - السامبلر: Euler
- الخطوات: من 28 حتى 30
- المجدول:
simple - Text CFG:
4.5 - توجيه المرجع: من
4.5حتى6 - التصحيح:
apg، ولاrescaleمع phi0.5 - إزاحة المرجع: خلّي
ref_offset_hفالقيمة ديال التدريب ديالو وهي1.0

استعمل
bf16بلاصةfp16. حسب توثيق المشروع، Anima كيوقع ليه overflow فـ fp16.
5. دخل الـworkflow فالطابور
تأكد باللي الموديل، وVAE، ومرمّز النص، وصورة المرجع، وأوزان الـadapter، والبرومبت مربوطين مزيان. دخل البرومبت فالطابور باش تولّد الصورة المستهدفة.
فهم الـCustom Nodes
Anima Ref Adapter Loader
هاد النود كيربط adapter LoRA مع MODEL ديال Anima. خلّي ref_offset_h فـ 1.0، وهي القيمة اللي تستعملات فالتدريب.
Anima Ref Latent
هاد النود كيحضّر الـlatents ديال المرجع والهدف. ككيّف صورة المرجع وكيضيف ليها letterbox، وكيفكودها بـVAE، وكيصاوب encode بنص الحجم، وكيرجع latent خاوي بالحجم المختار للإخراج.
Anima Ref Guider

هاد النود كيخرج GUIDER اللي كيستعملو SamplerCustomAdvanced. كيوفّر تحكم منفصل فـ cfg ديال النص وref_guidance، مع تصحيح APG ولا rescale. وكيشغّل حتى patches من بعد CFG بحال PAG.
نصائح متقدمة للضبط
وازن بين الهوية والالتزام بالبرومبت
توجيه المرجع كيتحكم فشحال النتيجة غادي تتبع المرجع بقوة. القيمة 1 كتعطي conditioning ضعيف وأقل تكلفة. القيم من 4.5 حتى 6 غالباً كتحافظ على تفاصيل أكثر فالشخصية والستايل، ولكن رفع القيمة يقدر حتى يسبب saturation أقوى. APG هو التصحيح الموصى به ملي كتستعمل توجيه عالي.
استعمل LoRAs الاختيارية بالترتيب الصحيح
خاص الـLoRAs العادية يتربطو قبل Anima Ref Adapter Loader. أمثلة الـgallery استعملات Anima context-detailer LoRA تقريباً فـ 0.3 وbase-slider LoRA تقريباً فـ 0.6. هاد الإضافات اختيارية وماشي شروط ديال التثبيت.
زيد Anima Safe PAG
إلى بغيتي graph أكثر تقدماً، حلّ workflows/anima_ref_adapter_pag.json. إعداد الـgallery استعمل Anima Safe PAG فـblock 18، بسكيل 1.3 على المدة من 0.2 حتى 0.9.
استعمل Anima turbo LoRA بحذر
Anima turbo LoRA حتى هو كيخدم مع الـadapter. حمّلو قبل adapter loader، ومن بعد استعمل إعدادات الخطوات وCFG العادية ديال turbo LoRA بلاصة توصيات الموديل الأساسي. الـreference adapter راسو تدرّب على Anima base v1.0.

فضّل السامبلينغ بدقة وحدة
Euler مع 28 حتى 30 خطوة وscheduler ديال simple هو نقطة البداية الموصى بها. الـREADME كايقول باللي مرحلة نصف الدقة ديال SamplerSPEED ماشي موثوقة، حيث الـpilot adapter ما تدرّبش على إعداد السامبلينغ التدريجي هادا.
حسّن الإدخال المرجعي
استعمل مرجع باينين فيه مزيان ملامح الهوية المهمة، ولكن توقّع أن الوضعية والتركيب اللي غادي يتولدو يتبعو البرومبت أكثر من المرجع. إلا اختفى شي إكسسوار ولا نقش دقيق، رفع توجيه المرجع يقدر يعاون، مع أن الـpilot model عندو حدود معروفة فالتفاصيل الصغيرة.
الحدود الحالية
- نقل هوية الشخصية كينجح بشكل أكثر انتظاماً من نقل ستايل الرسم.
- الستايلات اللي فيها طابع زيتي قوي ممكن ما تنتاقلش مزيان.
- النقوش الصغيرة، والندوب، والحلقان، ودرجات البشرة غير المعتادة غالباً كتضيع.
- الملابس الكبيرة تقدر تبدّل اللون.
- الشخصية المرجعية تقدر من حين لآخر ترجع تبان كشي حاجة داخل المشهد.
- الـadapter تدرّب غير على صور تولدات بـAnima، وكيورث الانحيازات ديال الموديل الأساسي.
- المراجع المنفصلة للشخصية والستايل ما متوفراش فهاد الإصدار التجريبي.
خارطة الطريق كتشمل صور منفصلة للشخصية والستايل، وdataset أكبر فيه 2,000 شخصية جديدة بثلاثة ستايلات ديال الفنانين، وتحسين نقل الستايلات الزيتية والتفاصيل الدقيقة، وزوجات تدريب بنصف الدقة للـsamplers التدريجية.
الترخيص
كود نود ComfyUI موزع برخصة Apache 2.0. أوزان الـadapter مشتقة من CircleStone Model وكتستعمل CircleStone Non-Commercial License. راجع رخصة الأوزان قبل ما تستعمل العمل المولّد ولا تدمج الـadapter فشي مشروع. الـrepository كيذكر باللي المشروع ما عندوش علاقة بـCircleStone Labs وماشي مدعوم منها.
الخلاصة
كيعطي Anima Reference Adapter طريقة عملية باش تنقل شخصية لمشاهد جديدة بلا ما تكتب وسوم ديال الهوية ولا الفنان ولا المظهر. بدا بالمسار الأساسي، واستعمل bf16، وأخذ عينات Euler، وCFG بقيمة 4.5، وتوجيه المرجع بين 4.5 و6. منين يخدم المسار الأساسي مزيان، زِد APG ولا Anima Safe PAG ولا LoRAs اختيارية، مع الحفاظ على LoRAs العادية قبل محمّل الـadapter.
