hy3d-gguf

קוד פתוח

calcuisother2025-03-22

gguf
gguf-node
image-to-3d
en

הסבה של hy3d של טנסנט לפורמט GGUF מיועדת למי שרוצה לייצר מודלים בתלת-ממד מתמונות ישירות בתוך ComfyUI. החבילה מכווצת משקלים כבדים לעבודה מקומית נגישה יותר.

19.9 GBמשקל הקבצים
1,857הורדות בחודש
38לייקים

מה זה

מדובר בגרסה מכווצת ומותאמת של מודל hy3d מבית Tencent, שנועדה למשימות של הפיכת תמונה למודל תלת-ממדי. במקום להיאבק בהרצה כבדה של המודל המקורי, calcuis ארז אותו בפורמט GGUF שמקל על טעינה והרצה מקומית דרך ComfyUI, יחד עם חלוקה לרכיבי diffusion, vision ו־VAE ייעודי.

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

מתאים ל

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

איפה זה נופל

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

שאלות
נפוצות

האם אפשר להריץ את המודל ללא ComfyUI?

החבילה הזו אורגנה במיוחד עבור ComfyUI והתוסף gguf-node, כולל חלוקת קבצים ספציפית לתיקיות המערכת. אפשר תיאורטית לטעון את המשקלים בסקריפט פייתון עצמאי, אבל תצטרכו לחווט ידנית את רכיבי ה־diffusion, ה־vision וה־VAE בעצמכם ללא תיעוד מסודר מהיוצר.

האם תמונה אחת מספיקה כדי לקבל מודל תלת-ממד מוצלח?

אפשר להתחיל מתמונה אחת, אבל יוצר המאגר מציע במפורש להשתמש ב־stable-zero123 כדי לייצר מראש תמונות מזוויות נוספות. תוספת הזוויות הזו עוזרת למודל לבנות גאומטריה נכונה ומלאה יותר ולא לנחש את הצדדים הנסתרים.

איך מריצים

את ההרצה עושים בתוך ComfyUI באמצעות תוסף gguf-node. ההתקנה דורשת פיזור ידני של הקבצים: קובץ ה־gguf נכנס לתיקיית diffusion_models, רכיב ה־vision הולך ל־checkpoints, ורכיב ה־pig נכנס ל־vae. לא מדובר בהתקנה של לחיצת כפתור אחת אלא בסידור תיקיות מסודר לפי ההוראות.

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

ollama run hf.co/calcuis/hy3d-gguf:Q4_K_M

איזו גרסה

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

safetensors2.5 GB F324.5 GB BF162.2 GB F162.2 GB F162.2 GB Q8_01.2 GB Q6_K916.1 MB Q5_1837.8 MB Q5_K_M768.3 MB Q5_0768.3 MB Q4_1698.8 MB Q4_K_M629.3 MB Q4_0629.2 MB Q3_K_M481.5 MB F16428.8 MB Q2_K368.5 MB

הקבצים

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

הרישיון

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

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