hunyuanimage-gguf

קוד פתוח

calcuisother2025-09-09

gguf
gguf-node
text-to-image

גרסת GGUF מכווצת למודל יצירת התמונות של Hunyuan שמאפשרת להריץ אותו מקומית בתוך ComfyUI בלי לחנוק את החומרה. פתרון מתאים למי שמחפש רינדור מהיר בפחות צעדים.

969 GBמשקל הקבצים
15,034הורדות בחודש
85לייקים

מה זה

הפרויקט הזה מביא איתו המרות שונות של מודל יצירת התמונות Hunyuan בפורמט GGUF, שמיועד בעיקר לחיבור ישיר לתוך ComfyUI דרך gguf-node ייעודי. במקום להוריד מודל מונוליתי כבד אחד, מקבלים כאן מאגר עצום שמחולק לקבצי משקלים שונים, כולל גרסאות מזוקקות וגרסאות קלות שרצות בפחות משאבים.

המודל הרגיל דורש בין 12 ל־15 צעדים לקבלת תוצאה טובה, בעוד שהגרסה המזוקקת מסוגלת לייצר תמונה ב־8 צעדים בלבד. גרסת הלייט מפיקה תוצאה זהה למודל המקורי אבל מהירה ממנו פי שניים עד שלושה, וגרסה קלה יותר בשם lite v2.2 מציגה איכות של 80 עד 90 אחוז מהמקור תוך חיסכון של 60 עד 70 אחוז בזמן הטעינה, בהרצה של 10 צעדים בלבד.

מתאים ל

יצירת תמונות מהירה
גרסת הלייט מייצרת תמונות ב־8 צעדים בלבד ובמהירות כפולה מהמודל הרגיל.
חידוד תמונות פגומות
מודל ה־refiner מאפשר לטעון פלט מטושטש מגרסאות מכווצות ולחדד אותו.
הרצה מקומית ב־ComfyUI
התאמה מלאה לזרימת עבודה מבוססת צמתים בעזרת תוסף GGUF ייעודי.

איפה זה נופל

ההתקנה דורשת התעסקות ידנית עם כמה רכיבים נפרדים, מה שמגדיל את הסיכוי לתקלות תאימות בין גרסאות דרייברים וכרטיסים שונים. יש בעיית שחרור זיכרון VRAM ידועה בהרצות חוזרות עם מקודד הטקסט הרגיל, שמחייבת לעיתים מעבר לקובץ אחר. בנוסף, מודל ה־refiner מוגדר עדיין כבדיקת הרצה ראשונית בלבד לחידוד תמונות מטושטשות, כך שלא כדאי לבנות עליו לפרויקט קריטי.

שאלות
נפוצות

איזה קבצים חייבים להוריד כדי שהמערכת תעבוד?

מעבר לקובץ המודל הראשי, חובה להוריד את שני מקודדי הטקסט שצוינו, byt5-sm ו־qwen2.5-vl, ובנוסף את קובץ ה־VAE התואם. בלי כל הרכיבים האלה ComfyUI לא יוכל לייצר תמונה.

באיזו גרסה כדאי לבחור להרצה יומיומית?

למי שמחפש תוצאה מאוזנת, גרסת lite v2 או המודל המזוקק ייתנו תוצאה מעולה ב־8 צעדים. גרסת lite v2.2 חוסכת עוד יותר זמן טעינה במחיר פשרה קלה באיכות.

איך מריצים

כדי להריץ את זה תצטרכו להוריד את קובץ המודל הרצוי לתיקיית המודלים של ComfyUI, ובנוסף להוריד שני מקודדי טקסט, byt5-sm במשקל 127 מגה בייט ו־qwen2.5-vl-7b ששוקל קצת מעל 5 גיגה בייט, לצד רכיב VAE ייעודי בשם pig. החיבור נעשה דרך תוסף ייעודי של GGUF בסביבת העבודה.

אם הכרטיס הגרפי שלכם לא משחרר זיכרון VRAM אחרי כמה הרצות, היוצר ממליץ לעבור למקודד safetensors בפורמט fp8. אם אין לכם חומרה ייעודית עם מספיק זיכרון תצוגה כדי להחזיק במקביל את מקודד הטקסט והמודל עצמו, התקנה מקומית תהיה מסורבלת מאוד ועדיף לפנות ל־API חיצוני.

ollama run hf.co/calcuis/hunyuanimage-gguf:Q5_K_M

איזו גרסה

אותו מודל בכמה רמות דחיסה. ככל שהמספר נמוך יותר הקובץ קטן יותר ורץ על פחות זיכרון, והתשובות נהיות פחות מדויקות. רוב האנשים רוצים את הגדולה ביותר שנכנסת להם בזיכרון.

הקבצים

98 קבצים במאגר, 969 GB סך הכול. הקישורים מובילים ישירות ל־Hugging Face.

הרישיון

הרישיון מוגדר כ־other ולא כרישיון קוד פתוח סטנדרטי. המשמעות היא שאין הרשאה ברורה ומיידית לשימוש מסחרי, וצריך לבדוק היטב את תנאי הרישיון המקוריים של המודל לפני שמפיצים אותו כחלק ממוצר.

הרישיון המלא בעמוד המודל ↗