Qwen-Image-ControlNet-Inpainting — הדגמה

קוד פתוח

InstantXapache-2.02025-09-09

gradio

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

2.1Bפרמטרים
4.0 GBמשקל הקבצים
—הורדות בחודש
74לייקים

מה זה

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

מאחורי הקלעים רץ שילוב של Qwen-Image יחד עם מודל ControlNet ייעודי ל־inpainting של InstantX שנבנה לספריית diffusers. הקוד כולל תמיכה במנגנון שיפור פרומפטים ומשתמש במודלים משלימים מסדרת Qwen לטיפול בטקסט ובתמונה, כולל האצת קשב באמצעות flash attention.

מתאים ל

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

איפה זה נופל

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

שאלות
נפוצות

האם אפשר להשתמש באפליקציה כרגע בדפדפן?

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

האם הכלי עולה כסף?

הקוד עצמו פתוח תחת רישיון חופשי וללא תשלום. עם זאת, הרצה שלו דורשת משאבי עיבוד מסוג zero-a10g. אם תריצו אותו בסביבה פרטית, העלות תהיה תלויה בתעריפי השימוש בחומרה זו.

האם אפשר להתקין ולהריץ את זה מקומית?

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

מה קורה עם התמונות שמעלים לממשק?

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

איך מריצים

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

pip install -U huggingface_hub
hf download InstantX/Qwen-Image-ControlNet-Inpainting

הקבצים

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

הרישיון

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

שימוש מסחרי
שינוי הקוד
הפצה מחדש
שימוש בפטנטים

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