Buckets:
| <meta charset="utf-8" /><meta name="hf:doc:metadata" content="{"title":"Diffusers'a nasıl katkıda bulunulur 🧨","local":"how-to-contribute-to-diffusers-","sections":[{"title":"Genel Bakış","local":"overview","sections":[{"title":"1. GitHub Tartışmaları'nda veya Discord'da soru sormak ve yanıtlamak","local":"1-asking-and-answering-questions-on-github-discussions-or-on-discord","sections":[],"depth":3},{"title":"2. GitHub sorunları sekmesinde yeni sorunlar açma","local":"2-opening-new-issues-on-the-github-issues-tab","sections":[{"title":"2.1. Yeniden üretilebilir, minimal hata raporları","local":"21-reproducible-minimal-bug-reports","sections":[],"depth":4},{"title":"2.2. Özellik istekleri","local":"22-feature-requests","sections":[],"depth":4},{"title":"2.3 Geri bildirim","local":"23-feedback","sections":[],"depth":4},{"title":"2.4 Teknik sorular","local":"24-technical-questions","sections":[],"depth":4},{"title":"2.5 Yeni bir model, zamanlayıcı veya hattı ekleme önerisi","local":"25-proposal-to-add-a-new-model-scheduler-or-pipeline","sections":[],"depth":4}],"depth":3},{"title":"3. GitHub sorunları sekmesindeki sorunlara yanıt verme","local":"3-answering-issues-on-the-github-issues-tab","sections":[],"depth":3},{"title":"4. “Good first issue” düzeltme","local":"4-fixing-a-good-first-issue","sections":[],"depth":3},{"title":"5. Dokümantasyona katkıda bulunun","local":"5-contribute-to-the-documentation","sections":[],"depth":3},{"title":"6. Hub'da bir pipeline veya model yayınlayın","local":"6-publish-a-pipeline-or-model-on-the-hub","sections":[],"depth":3},{"title":"7. Eğitim örneklerine katkıda bulunun","local":"7-contribute-to-training-examples","sections":[],"depth":3},{"title":"8. “İyi ikinci sorun”u düzeltme","local":"8-fixing-a-good-second-issue","sections":[],"depth":3},{"title":"9. Diffusers MVP sorunu üstlenmek","local":"9-taking-on-a-diffusers-mvp-issue","sections":[],"depth":3},{"title":"10. Boru hatları, modeller ve zamanlayıcılar ekleme","local":"10-adding-pipelines-models-schedulers","sections":[{"title":"Yeni model veya pipeline desteği yayınlandığında","local":"when-new-model-or-pipeline-support-is-released","sections":[],"depth":4},{"title":"mekanizmadan kopyalandı","local":"copied-from-mechanism","sections":[],"depth":4}],"depth":3}],"depth":2},{"title":"İyi bir sorun nasıl yazılır","local":"how-to-write-a-good-issue","sections":[],"depth":2},{"title":"İyi bir PR nasıl yazılır","local":"how-to-write-a-good-pr","sections":[],"depth":2},{"title":"PR açma","local":"how-to-open-a-pr","sections":[{"title":"Testler","local":"tests","sections":[],"depth":3},{"title":"Fork edilmiş main'in upstream (HuggingFace) main ile senkronize edilmesi","local":"syncing-forked-main-with-upstream-huggingface-main","sections":[],"depth":3},{"title":"Stil kılavuzu","local":"style-guide","sections":[],"depth":3}],"depth":2},{"title":"Yapay zeka ajanlarıyla kodlama","local":"coding-with-ai-agents","sections":[{"title":"Yapay zeka destekli ve ajan tabanlı katkılar","local":"ai-assisted-and-agentic-contributions","sections":[],"depth":3}],"depth":2}],"depth":1}"/> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/entry/start.1gaXe03k.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/chunks/BObs6oQO.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/chunks/DPnyVmXs.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/entry/app.BwdYRbCn.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/chunks/DSGUT_OW.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/chunks/C045MWWx.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/chunks/6tuJ3nyi.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/chunks/DsnmJJEf.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/nodes/0.CornNeQR.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/chunks/IaDvMxLQ.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/nodes/304.D7A4xAiG.js" rel="modulepreload"> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/chunks/bKdwVYpU.js" rel="modulepreload"> | |
| <!--110sasa--><meta name="hf:doc:metadata" content="{"title":"How to contribute to Diffusers 🧨","local":"how-to-contribute-to-diffusers-","sections":[{"title":"Overview","local":"overview","sections":[{"title":"1. Asking and answering questions on GitHub Discussions or on Discord","local":"1-asking-and-answering-questions-on-github-discussions-or-on-discord","sections":[],"depth":3},{"title":"2. Opening new issues on the GitHub issues tab","local":"2-opening-new-issues-on-the-github-issues-tab","sections":[{"title":"2.1. Reproducible, minimal bug reports","local":"21-reproducible-minimal-bug-reports","sections":[],"depth":4},{"title":"2.2. Feature requests","local":"22-feature-requests","sections":[],"depth":4},{"title":"2.3 Feedback","local":"23-feedback","sections":[],"depth":4},{"title":"2.4 Technical questions","local":"24-technical-questions","sections":[],"depth":4},{"title":"2.5 Proposal to add a new model, scheduler, or pipeline","local":"25-proposal-to-add-a-new-model-scheduler-or-pipeline","sections":[],"depth":4}],"depth":3},{"title":"3. Answering issues on the GitHub issues tab","local":"3-answering-issues-on-the-github-issues-tab","sections":[],"depth":3},{"title":"4. Fixing a “Good first issue”","local":"4-fixing-a-good-first-issue","sections":[],"depth":3},{"title":"5. Contribute to the documentation","local":"5-contribute-to-the-documentation","sections":[],"depth":3},{"title":"6. Publish a pipeline or model on the Hub","local":"6-publish-a-pipeline-or-model-on-the-hub","sections":[],"depth":3},{"title":"7. Contribute to training examples","local":"7-contribute-to-training-examples","sections":[],"depth":3},{"title":"8. Fixing a “Good second issue”","local":"8-fixing-a-good-second-issue","sections":[],"depth":3},{"title":"9. Taking on a Diffusers MVP issue","local":"9-taking-on-a-diffusers-mvp-issue","sections":[],"depth":3},{"title":"10. Adding pipelines, models, schedulers","local":"10-adding-pipelines-models-schedulers","sections":[{"title":"When new model or pipeline support is released","local":"when-new-model-or-pipeline-support-is-released","sections":[],"depth":4},{"title":"Copied from mechanism","local":"copied-from-mechanism","sections":[],"depth":4}],"depth":3}],"depth":2},{"title":"How to write a good issue","local":"how-to-write-a-good-issue","sections":[],"depth":2},{"title":"How to write a good PR","local":"how-to-write-a-good-pr","sections":[],"depth":2},{"title":"How to open a PR","local":"how-to-open-a-pr","sections":[{"title":"Tests","local":"tests","sections":[],"depth":3},{"title":"Syncing forked main with upstream (HuggingFace) main","local":"syncing-forked-main-with-upstream-huggingface-main","sections":[],"depth":3},{"title":"Style guide","local":"style-guide","sections":[],"depth":3}],"depth":2},{"title":"Coding with AI agents","local":"coding-with-ai-agents","sections":[{"title":"AI-assisted and agentic contributions","local":"ai-assisted-and-agentic-contributions","sections":[],"depth":3}],"depth":2}],"depth":1}"/><!----> | |
| <link href="/docs/diffusers/v0.43.0/en/_app/immutable/assets/0.tn0RQdqM.css" rel="modulepreload"> <!--[--><!--[0--><!--[--><!--[0--><!--[--><p></p> <div class="items-center shrink-0 min-w-[100px] max-sm:min-w-[50px] justify-end ml-auto flex" style="float: inline-end; margin-inline-start: 10px; display: inline-flex; position: relative; z-index: 10;"><div dir="ltr" class="inline-flex rounded-md max-sm:rounded-sm"><button class="inline-flex items-center gap-1 h-7 max-sm:h-7 px-2 max-sm:px-1.5 text-sm font-medium text-gray-800 border border-r-0 rounded-l-md max-sm:rounded-l-sm border-gray-200 bg-white hover:shadow-inner dark:border-gray-850 dark:bg-gray-950 dark:text-gray-200 dark:hover:bg-gray-800" aria-live="polite"><span class="inline-flex items-center justify-center rounded-md p-0.5 max-sm:p-0 hover:text-gray-800 dark:hover:text-gray-200"><svg class="sm:size-3.5 size-3" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----></span> <span dir="auto">Copy page</span></button> <button class="inline-flex items-center justify-center w-6 max-sm:w-5 h-7 max-sm:h-7 disabled:pointer-events-none text-sm text-gray-500 hover:text-gray-700 dark:hover:text-white rounded-r-md max-sm:rounded-r-sm border border-l transition border-gray-200 bg-white hover:shadow-inner dark:border-gray-850 dark:bg-gray-950 dark:text-gray-200 dark:hover:bg-gray-800" aria-haspopup="menu" aria-expanded="false" aria-label="Open copy menu"><svg class="transition-transform text-gray-400 overflow-visible sm:size-3.5 size-3 rotate-0" width="1em" height="1em" viewBox="0 0 12 7" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L6 6L11 1" stroke="currentColor"></path></svg><!----></button></div> <!--[-1--><!--]--></div><!----> <!--[0--><h1 class="relative group"><a id="how-to-contribute-to-diffusers-" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#how-to-contribute-to-diffusers-"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->Diffusers'a nasıl katkıda bulunulur 🧨<!----></span></h1><!--]--><!----> <blockquote class="tip"><p>Bir yapay zeka ajanı kullanarak katkıda bulunuyorsanız, beklentilerimizi ve yönergelerimizi içeren <a href="#ai-assisted-and-agentic-contributions">Yapay zeka destekli ve ajan tabanlı katkılar</a> bölümünü okuduğunuzdan emin olun.</p></blockquote> <p>Açık kaynak topluluğundan gelen katkıları ❤️ çok seviyoruz! Herkes davetlidir ve kodun ötesinde her türlü katılım –soru yanıtlama, başkalarına yardım etme, iletişim kurma ve dokümantasyonu iyileştirme gibi– topluluk için son derece değerli ve takdir edilmektedir. Bu yüzden cesaret edin ve bu işe gönül veriyorsanız topluluğa katılın!</p> <p>Herkese, herkese açık Discord kanalımızda 👋 diyerek başlaması önerilir. Difüzyon modellerindeki son trendleri tartışır, sorular sorar, kişisel projelerimizi sergiler, katkıları konusunda birbirimize yardımcı olur veya sadece takılırız ☕. <a href="https://Discord.gg/G7tWnz98XR"><img alt="Join us on Discord" src="https://img.shields.io/discord/823813159592001537?color=5865F2&logo=discord&logoColor=white"/></a></p> <p>Katkıda bulunmak için hangi yolu seçerseniz seçin, açık, misafirperver ve nazik bir topluluğun parçası olmayı hedefliyoruz. Lütfen <a href="https://github.com/huggingface/diffusers/blob/main/CODE_OF_CONDUCT.md" rel="nofollow">davranış kurallarımızı</a> okuyun ve etkileşimleriniz sırasında bunlara saygı göstermeye özen gösterin. Ayrıca, projemizi yönlendiren <a href="https://huggingface.co/docs/diffusers/conceptual/ethical_guidelines" rel="nofollow">etik ilkelerle</a> de tanışmanızı önerir ve şeffaflık ve sorumluluk ilkelerine uymanızı rica ederiz.</p> <p>Topluluktan gelen geri bildirimleri son derece değerli buluyoruz; bu nedenle, kütüphanenin iyileştirilmesine yardımcı olabilecek değerli bir geri bildiriminiz olduğunu düşünüyorsanız sesinizi çıkarmaktan çekinmeyin - her mesaj, yorum, sorun ve çekme isteği (PR) okunur ve değerlendirilir.</p> <!--[1--><h2 class="relative group"><a id="overview" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#overview"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->Genel Bakış<!----></span></h2><!--]--><!----> <p>Soruları yanıtlamaktan çekirdek kütüphaneye yeni difüzyon modelleri eklemeye kadar birçok farklı şekilde katkıda bulunabilirsiniz.</p> <p>Aşağıda, artan zaman yükümlülüğüne göre sıralanmış, katkıda bulunmanın farklı yollarına bir genel bakış sunuyoruz. Bunların tümü topluluk için değerlidir.</p> <ul><li><ol><li><a href="https://github.com/huggingface/diffusers/discussions" rel="nofollow">GitHub Tartışmaları</a> veya <a href="https://discord.gg/G7tWnz98XR" rel="nofollow">Discord</a> üzerinde soru sormak ve yanıtlamak.</li></ol></li> <li><ol start="2"><li><a href="https://github.com/huggingface/diffusers/issues/new/choose" rel="nofollow">GitHub Sorunlar sekmesinde</a> yeni sorunlar açma.</li></ol></li> <li><ol start="3"><li><a href="https://github.com/huggingface/diffusers/issues" rel="nofollow">GitHub Sorunlar sekmesindeki</a> sorunlara yanıt verme.</li></ol></li> <li><ol start="4"><li>“Good first issue” etiketiyle işaretlenmiş basit bir sorunu düzeltin, bkz. <a href="https://github.com/huggingface/diffusers/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22" rel="nofollow">burası</a>.</li></ol></li> <li><ol start="5"><li><a href="https://github.com/huggingface/diffusers/tree/main/docs/source" rel="nofollow">Belgelere</a> katkıda bulunun.</li></ol></li> <li><ol start="6"><li>Bir pipeline veya modeli <a href="../modular_diffusers/overview">Modular Diffusers</a> ile uzak kod olarak Hub'da yayınlayın.</li></ol></li> <li><ol start="7"><li><a href="https://github.com/huggingface/diffusers/tree/main/examples" rel="nofollow">örnekler</a> projesine katkıda bulunun.</li></ol></li> <li><ol start="8"><li>“Good second issue” etiketiyle işaretlenmiş, daha zor bir sorunu çözün, bkz. <a href="https://github.com/huggingface/diffusers/issues?q=is%3Aopen+is%3Aissue+label%3A%22Good+second+issue%22" rel="nofollow">burası</a>.</li></ol></li> <li><ol start="9"><li><a href="https://github.com/huggingface/diffusers/issues/12635" rel="nofollow">Diffusers MVP program</a>’dan bir sorun üstlenin.</li></ol></li> <li><ol start="10"><li>Kütüphaneye yeni bir pipeline, model veya scheduler ekleyin. Bu katkı için genellikle model yazarlarıyla doğrudan çalışırız; topluluk katkıcısı olarak bunun yerine Hub'da (6) başlayın. Açık <a href="https://github.com/huggingface/diffusers/issues?q=is%3Aopen+is%3Aissue+label%3A%22New+pipeline%2Fmodel%22" rel="nofollow">“New Pipeline/Model”</a> ve <a href="https://github.com/huggingface/diffusers/issues?q=is%3Aopen+is%3Aissue+label%3A%22New+scheduler%22" rel="nofollow">“New scheduler”</a> sorunlarını inceleyin ve önce <a href="https://huggingface.co/docs/diffusers/main/en/conceptual/philosophy" rel="nofollow">Design Philosophy</a> bölümünü okuyun.</li></ol></li></ul> <p>Daha önce belirtildiği gibi, <strong>tüm katkılar topluluk için değerlidir</strong>. | |
| Aşağıda, her bir katkıyı biraz daha ayrıntılı olarak açıklayacağız.</p> <p>4'ten 10'a kadar olan katkılar için, Hub üzerinde barındırılan 6 hariç, bir PR açmanız gerekecektir. Bunun nasıl yapılacağı <a href="#how-to-open-a-pr">Opening a pull request</a> başlığında ayrıntılı olarak açıklanmıştır.</p> <!--[2--><h3 class="relative group"><a id="1-asking-and-answering-questions-on-github-discussions-or-on-discord" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#1-asking-and-answering-questions-on-github-discussions-or-on-discord"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->1. GitHub Tartışmaları'nda veya Discord'da soru sormak ve yanıtlamak<!----></span></h3><!--]--><!----> <p>Diffusers kütüphanesiyle ilgili herhangi bir soru veya yorum <a href="https://github.com/huggingface/diffusers/discussions" rel="nofollow">GitHub Tartışmaları</a> veya <a href="https://discord.gg/G7tWnz98XR" rel="nofollow">Discord</a> üzerinden sorulabilir. Bu tür sorular ve yorumlar şunları içerir (ancak bunlarla sınırlı değildir):</p> <ul><li>Bilgi paylaşma amacıyla eğitim veya çıkarım deneylerinin raporlanması</li> <li>Kişisel projelerin sunumu</li> <li>Resmi olmayan eğitim örneklerine yönelik sorular</li> <li>Proje önerileri</li> <li>Genel geri bildirim</li> <li>Makale özetleri</li> <li>Diffusers kütüphanesinin üzerine inşa edilen kişisel projelerde yardım istemek</li> <li>Genel sorular</li> <li>Difüzyon modellerine ilişkin etik sorular</li> <li>…</li></ul> <p>GitHub Tartışmaları'nda veya Discord'da sorulan her soru, topluluğun bilgiyi kamuya açık şekilde paylaşmasını aktif olarak teşvik eder ve gelecekte aynı soruyu soran bir başlangıç seviyesindeki kullanıcıya çok yardımcı olabilir. Lütfen aklınıza takılan her soruyu sormaktan çekinmeyin. | |
| Aynı ruhla, bu tür soruları yanıtlayarak topluluğa çok büyük bir katkıda bulunuyorsunuz; çünkü bu sayede herkesin öğrenmesi için bilgiyi kamuya açık şekilde belgelemiş olursunuz.</p> <p><strong>Lütfen</strong> bir soru sormaya veya yanıtlamaya ne kadar çok emek harcarsanız, kamuya açık olarak belgelenen bilginin kalitesinin de o kadar yüksek olacağını aklınızda bulundurun. Aynı şekilde, iyi kurgulanmış ve iyi yanıtlanmış sorular herkese erişilebilir yüksek kaliteli bir bilgi veritabanı oluştururken, kötü kurgulanmış sorular veya yanıtlar kamuya açık bilgi veritabanının genel kalitesini düşürür. | |
| Kısacası, yüksek kaliteli bir soru veya yanıt <em>kesin</em>, <em>kısa</em>, <em>ilgili</em>, <em>anlaşılması kolay</em>, <em>erişilebilir</em> ve <em>iyi biçimlendirilmiş/iyi kurgulanmış</em> olmalıdır. Daha fazla bilgi için <a href="#how-to-write-a-good-issue">Nasıl iyi bir issue yazılır</a> bölümüne göz atmanızı öneririz.</p> <p><strong>Kanallar hakkında NOT</strong>: <a href="https://github.com/huggingface/diffusers/discussions" rel="nofollow"><em>GitHub Discussions</em></a> arama motorları tarafından indekslenir ve her thread'e bağlantı verilebilir, bu nedenle orada paylaşılan sorular ve yanıtlar, aynı sorunu yaşayan sonraki kişi için bulunabilir kalmaya devam eder. | |
| Buna karşılık, <em>Discord</em> hızlı gidip gelmeli iletişimi teşvik eden sohbet benzeri bir formata sahiptir. | |
| Sorunuza Discord'da yanıt almanız muhtemelen daha az zaman alacak olsa da, sorunuz zamanla görünmez hale gelir ve bir süre önce paylaşılan bilgileri bulmak çok daha zordur. Bu nedenle, kalıcı olması amaçlanan soru ve yanıtlar için GitHub Discussions'ı öneririz. Discord'daki bir sohbet ilginç bir sonuca ulaşırsa, gelecekteki okuyucuların bulabilmesi için sonucu bir tartışma olarak paylaşın.</p> <!--[2--><h3 class="relative group"><a id="2-opening-new-issues-on-the-github-issues-tab" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#2-opening-new-issues-on-the-github-issues-tab"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->2. GitHub sorunları sekmesinde yeni sorunlar açma<!----></span></h3><!--]--><!----> <p>🧨 Diffusers kütüphanesi, karşılaştıkları sorunları bize bildiren kullanıcılar sayesinde sağlam ve güvenilirdir. Bu nedenle bir sorun bildirdiğiniz için teşekkür ederiz.</p> <p>Unutmayın, GitHub sorunları, Diffusers kütüphanesiyle doğrudan ilgili teknik sorular, hata bildirimleri, özellik talepleri veya kütüphane tasarımıyla ilgili geri bildirimler için ayrılmıştır.</p> <p>In a nutshell, this means that everything that is <strong>not</strong> related to the <strong>code of the Diffusers library</strong> (including the documentation) should <strong>not</strong> be asked as an issue, but rather on <a href="https://github.com/huggingface/diffusers/discussions" rel="nofollow">GitHub Discussions</a> or <a href="https://discord.gg/G7tWnz98XR" rel="nofollow">Discord</a>.</p> <p><strong>Yeni bir sorun açarken aşağıdaki yönergeleri göz önünde bulundurun</strong>:</p> <ul><li>Sorunuzun daha önce sorulup sorulmadığını aradığınızdan emin olun (GitHub'da Issues altında arama çubuğunu kullanın).</li> <li>Lütfen asla yeni bir sorunu başka (ilgili) bir sorun üzerinde bildirmeyin. Başka bir sorunla yüksek derecede ilgiliyse, yine de yeni bir sorun açın ve ilgili soruna bağlantı verin.</li> <li>Sorunuzun İngilizce olarak yazıldığından emin olun.</li> <li>Sorunun en yeni Diffusers sürümüne güncelleyerek çözülebileceğini kontrol edin. Sorununuzun paylaşımından önce, <code>python -c "import diffusers; print(diffusers.__version__)"</code> komutunun en son Diffusers sürümünden yüksek veya eşit olduğundan emin olun.</li> <li>Yeni bir sorun açmak için harcadığınız çabanın artmasıyla, alacağınız yanıtın kalitesinin ve Diffusers sorunlarının genel kalitesinin de artacağını unutmayın.</li></ul> <p>Yeni sorunlar genellikle şunları içerir.</p> <!--[3--><h4 class="relative group"><a id="21-reproducible-minimal-bug-reports" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#21-reproducible-minimal-bug-reports"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->2.1. Yeniden üretilebilir, minimal hata raporları<!----></span></h4><!--]--><!----> <p>Bir hata raporu her zaman yeniden üretilebilir bir kod parçası içermeli ve mümkün olduğunca minimal ve öz olmalıdır. | |
| Bu, daha ayrıntılı olarak şunu ifade eder:</p> <ul><li>Hatalı davranışı mümkün olduğunca daraltın, <strong>tüm kod dosyanızı olduğu gibi yapıştırmayın</strong>.</li> <li>Kodunuzu biçimlendirin.</li> <li>Diffusers'a bağımlı olanlar hariç, harici kütüphaneler dahil etmeyin.</li> <li><strong>Her zaman</strong> ortamınızla ilgili gerekli tüm bilgileri sağlayın; bunun için kabuğunuzda <code>diffusers-cli env</code> komutunu çalıştırabilir ve ekranda görünen bilgileri soruna kopyalayıp yapıştırabilirsiniz.</li> <li>Sorunu açıklayın. Okuyucu sorunun ne olduğunu ve neden bir sorun olduğunu bilmiyorsa, onu çözemeyecektir.</li> <li><strong>Her zaman</strong> okuyucunun sorununuzu olabildiğince az eforla yeniden üretebileceğinden emin olun. Kod parçanız eksik kütüphaneler veya tanımsız değişkenler nedeniyle çalıştırılamıyorsa, okuyucu size yardımcı olamaz. Yeniden üretilebilir kod parçanızın olabildiğince minimal olduğundan ve basit bir Python kabuğuna kopyala-yapıştır edilebildiğinden emin olun.</li> <li>Sorununuzun yeniden oluşturulması için bir model ve/veya veri seti gerekiyorsa, okuyucunun bu modele veya veri setine erişebildiğinden emin olun. Modelinizi veya veri setinizi kolayca indirilebilir hale getirmek için her zaman <a href="https://huggingface.co" rel="nofollow">Hub</a> üzerinden yükleyebilirsiniz. Sorununuzun yeniden oluşturulmasını olabildiğince zahmetsiz kılmak için modelinizi ve veri setinizi mümkün olan en küçük boyutta tutmaya çalışın.</li></ul> <p>Daha fazla bilgi için <a href="#how-to-write-a-good-issue">Nasıl iyi bir sorun yazılır</a> bölümüne göz atın.</p> <p>Bir hata raporu açmak için <a href="https://github.com/huggingface/diffusers/issues/new?assignees=&labels=bug&projects=&template=bug-report.yml" rel="nofollow">buraya</a> tıklayabilirsiniz.</p> <!--[3--><h4 class="relative group"><a id="22-feature-requests" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#22-feature-requests"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->2.2. Özellik istekleri<!----></span></h4><!--]--><!----> <p>Dünya çapında bir özellik isteği aşağıdaki noktaları ele alır:</p> <ol><li>Önce motivasyon:</li></ol> <ul><li>Kütüphaneyle ilgili bir sorun/rahatsızlıkla ilgili mi? Öyleyse lütfen nedenini açıklayın. Sorunu gösteren bir kod parçası paylaşmak en iyisidir.</li> <li>Bir proje için ihtiyaç duyacağınız bir şeyle ilgili mi? Bunu duymaktan memnuniyet duyarız!</li> <li>Üzerinde çalıştığınız ve topluluğa fayda sağlayabileceğini düşündüğünüz bir şey mi? | |
| Harika! Size ne sorunu çözdüğünü anlatın.</li></ul> <ol start="2"><li>Özelliği açıklayan <em>tam bir paragraf</em> yazın;</li> <li>Gelecekteki kullanımını gösteren bir <strong>kod parçası</strong> sağlayın;</li> <li>Eğer bu bir makaleyle ilgiliyse, lütfen bir bağlantı ekleyin;</li> <li>Yararlı olabileceğini düşündüğünüz ek bilgileri (çizimler, ekran görüntüleri vb.) ekleyin.</li></ol> <p>Bir özellik isteği açmak için <a href="https://github.com/huggingface/diffusers/issues/new?assignees=&labels=&template=feature_request.md&title=" rel="nofollow">buraya</a> tıklayabilirsiniz.</p> <!--[3--><h4 class="relative group"><a id="23-feedback" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#23-feedback"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->2.3 Geri bildirim<!----></span></h4><!--]--><!----> <p>Kütüphane tasarımı hakkındaki geri bildirimler ve tasarımın neden iyi veya iyi olmadığına dair açıklamalar, çekirdek bakım sorumlularının kullanıcı dostu bir kütüphane oluşturmasında onlara büyük ölçüde yardımcı olur. Mevcut tasarım felsefesinin arkasındaki felsefeyi anlamak için lütfen <a href="https://huggingface.co/docs/diffusers/conceptual/philosophy" rel="nofollow">buraya</a> göz atın. Belirli bir tasarım seçiminin mevcut tasarım felsefesiyle uyumlu olmadığını düşünüyorsanız, nedenini ve nasıl değiştirilmesi gerektiğini lütfen açıklayın. Belirli bir tasarım seçimi, kullanım senaryolarını kısıtladığı için tasarım felsefesine fazla bağlıysa, nedenini ve nasıl değiştirilmesi gerektiğini açıklayın. | |
| Belirli bir tasarım seçimi sizin için çok faydalıysa, lütfen bir not bırakın; bu, gelecekteki tasarım kararları için harika bir geri bildirimdir.</p> <p>Geri bildirimle ilgili bir sorun <a href="https://github.com/huggingface/diffusers/issues/new?assignees=&labels=&template=feedback.md&title=" rel="nofollow">burada</a> açabilirsiniz.</p> <!--[3--><h4 class="relative group"><a id="24-technical-questions" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#24-technical-questions"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->2.4 Teknik sorular<!----></span></h4><!--]--><!----> <p>Teknik sorular, kütüphanenin belirli kodunun neden belirli bir şekilde yazıldığına veya kodun belirli bir bölümünün ne işe yaradığına dairdir. Lütfen ilgili koda bağlantı verin ve bu kod bölümünün neden anlaşılması güç olduğunu açıklayan ayrıntıları belirtin.</p> <p>Teknik bir soruyla ilgili bir sorun <a href="https://github.com/huggingface/diffusers/issues/new?assignees=&labels=bug&template=bug-report.yml" rel="nofollow">burada</a> açabilirsiniz.</p> <!--[3--><h4 class="relative group"><a id="25-proposal-to-add-a-new-model-scheduler-or-pipeline" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#25-proposal-to-add-a-new-model-scheduler-or-pipeline"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->2.5 Yeni bir model, zamanlayıcı veya hattı ekleme önerisi<!----></span></h4><!--]--><!----> <p>Diffusion model topluluğu, Diffusers kütüphanesinde görmek istediğiniz yeni bir model, pipeline veya scheduler yayınladıysa, lütfen aşağıdaki bilgileri sağlayın:</p> <ul><li>Diffüzyon hattının, modelinin veya zamanlayıcısının kısa tanımı ve makaleye veya halka açık sürüme bağlantı.</li> <li>Açık kaynaklı uygulaması/uygulamalarından herhangi birine bağlantı.</li> <li>Eğer mevcutlarsa, model ağırlıklarına bağlantı.</li></ul> <p>Ayrıca, bulabiliyorsanız, bileşenin (model, zamanlayıcı, boru hattı vb.) orijinal yazarını GitHub kullanıcı adıyla etiketlemeyi unutmayın.</p> <p>Modeli Diffusers'a kendiniz eklemek istiyorsanız, <a href="#6-publish-a-pipeline-or-model-on-the-hub">Hub'da bir pipeline veya model yayımlama</a> ve <a href="#10-adding-pipelines-models-schedulers">Pipeline, model ve scheduler ekleme</a> konularına bakın.</p> <p>Bir model/pipeline/scheduler için talep oluşturmak için <a href="https://github.com/huggingface/diffusers/issues/new?assignees=&labels=New+model%2Fpipeline%2Fscheduler&template=new-model-addition.yml" rel="nofollow">buraya</a> tıklayabilirsiniz.</p> <!--[2--><h3 class="relative group"><a id="3-answering-issues-on-the-github-issues-tab" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#3-answering-issues-on-the-github-issues-tab"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->3. GitHub sorunları sekmesindeki sorunlara yanıt verme<!----></span></h3><!--]--><!----> <p>GitHub'daki sorunlara yanıt vermek Diffusers hakkında bazı teknik bilgi gerektirebilir, ancak yanıtınızın %100 doğru olduğundan emin olmasanız bile herkesi denemeye teşvik ediyoruz. | |
| Bir soruna yüksek kaliteli bir yanıt vermek için bazı ipuçları:</p> <ul><li>Mümkün olduğunca kısa ve minimal olun.</li> <li>Konudan sapmayın. Soruna verilen yanıt, yalnızca ve yalnızca o soruyla ilgili olmalıdır.</li> <li>İddianızı kanıtlayan veya destekleyen kod, makale veya diğer kaynaklara bağlantılar ekleyin.</li> <li>Kodla yanıt verin. Sorunun cevabı basit bir kod parçasıysa veya sorunun nasıl çözülebileceğini gösteriyorsa, lütfen tamamen yeniden üretilebilir bir kod parçası sağlayın.</li></ul> <p>Ayrıca, birçok sorun genellikle konuyla alakasız, diğer sorunların tekrarı veya ilgisiz olma eğilimindedir. Bu tür sorunlara yanıt vermeniz, sorunun yazarını daha kesin olmaya teşvik etmeniz, tekrarlanan soruna bağlantı vermeniz veya onları <a href="https://github.com/huggingface/diffusers/discussions" rel="nofollow">GitHub Discussions</a> veya <a href="https://discord.gg/G7tWnz98XR" rel="nofollow">Discord</a> yönlendirmeniz, bakımcılar için büyük bir kolaylık sağlar.</p> <p>Yayımlanan hata raporunun doğru olduğunu ve kaynak kodda bir düzeltme gerektirdiğini doğruladıysanız, lütfen sonraki bölümlere göz atın.</p> <p><a href="#6-publish-a-pipeline-or-model-on-the-hub">6</a> hariç tüm katkılar için bir PR açmanız gerekir. <a href="https://github.com/huggingface/diffusers/pull/15179/changes#how-to-open-a-pr" rel="nofollow">Opening a pull request</a> bölümü bunu nasıl yapacağınızı açıklar.</p> <!--[2--><h3 class="relative group"><a id="4-fixing-a-good-first-issue" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#4-fixing-a-good-first-issue"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->4. “Good first issue” düzeltme<!----></span></h3><!--]--><!----> <p><em>İlk iyi sorunlar</em>, <a href="https://github.com/huggingface/diffusers/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22" rel="nofollow">İlk iyi sorun</a> etiketiyle işaretlenir. Genellikle, sorun, çözümü daha kolay hale getirmek için olası bir çözümün nasıl görünmesi gerektiğini zaten açıklar. | |
| Sorun kapatılmamışsa ve bu sorunu çözmeyi denemek istiyorsanız, sadece “Bu sorunu denemek istiyorum.” mesajını bırakabilirsiniz. Genellikle üç senaryo vardır:</p> <ul><li>a.) Sorun açıklaması zaten bir düzeltme öneriyor. Bu durumda ve çözüm size mantıklı geliyorsa, düzeltmek için bir PR veya taslak PR açabilirsiniz.</li> <li>b.) Sorun açıklaması bir düzeltme önermez. Bu durumda, soruna bir yorum olarak kendi düzeltmenizi önerin. Yaklaşımı açıklayan birkaç cümle yeterlidir. Bir PR açmadan önce Diffusers ekibinden birinin bunu onaylamasını bekleyin.</li> <li>c.) Sorunu düzeltmek için zaten açık bir PR var, ancak sorun henüz kapatılmamış. PR bayatlamışsa, basitçe yeni bir PR açabilir ve bayatlamış PR'a bağlantı verebilirsiniz. Sorunu düzeltmek isteyen orijinal katkıda bulunan kişi artık devam etmek için zaman bulamadığında PR'lar sık sık bayatlar. Bu, açık kaynak dünyasında sıkça görülür ve çok normaldir. Bu durumda, topluluk mevcut PR'ın bilgisinden yararlanarak konuya yeniden el atmanızdan çok memnun olacaktır. Zaten bir PR varsa ve aktifse, önerilerde bulunarak, PR'ı inceleyerek veya PR'a katkıda bulunup bulunamayacağınızı sorarak yazarına yardımcı olabilirsiniz.</li></ul> <!--[2--><h3 class="relative group"><a id="5-contribute-to-the-documentation" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#5-contribute-to-the-documentation"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->5. Dokümantasyona katkıda bulunun<!----></span></h3><!--]--><!----> <p>İyi bir kütüphanenin <strong>her zaman</strong> iyi bir dokümantasyonu vardır! Resmi dokümantasyon, kütüphanenin yeni kullanıcıları için genellikle ilk temas noktalarından biridir ve bu nedenle dokümantasyona katkıda bulunmak <strong>son derece değerli bir katkıdır</strong>.</p> <p>Kütüphaneye katkıda bulunmanın birçok biçimi olabilir:</p> <ul><li>Yazım veya dilbilgisi hatalarını düzeltme.</li> <li>Docstring'in hatalı biçimlendirmesini düzeltin. Resmi belgelerin tuhaf göründüğünü veya bir bağlantının bozuk olduğunu fark ederseniz, bunu düzeltmek için biraz zaman ayırmanızdan çok memnun oluruz.</li> <li>Bir docstring girdi veya çıktı tensörünün şeklini veya boyutlarını düzeltin.</li> <li>Anlaşılmaz veya hatalı olan belgeleri netleştirin.</li> <li>Güncel olmayan kod örneklerini güncelleyin.</li> <li>Belgeleri başka bir dile çevirme.</li></ul> <p><a href="https://huggingface.co/docs/diffusers/index" rel="nofollow">resmi Diffusers doküman sayfasında</a> görüntülenen her şey resmi dokümantasyonun bir parçasıdır ve ilgili <a href="https://github.com/huggingface/diffusers/tree/main/docs/source" rel="nofollow">dokümantasyon kaynağında</a> düzeltilebilir veya ayarlanabilir.</p> <p>Belgelerdeki değişikliklerin yerel olarak nasıl doğrulanacağına dair <a href="https://github.com/huggingface/diffusers/tree/main/docs" rel="nofollow">bu sayfaya</a> göz atın.</p> <!--[2--><h3 class="relative group"><a id="6-publish-a-pipeline-or-model-on-the-hub" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#6-publish-a-pipeline-or-model-on-the-hub"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->6. Hub'da bir pipeline veya model yayınlayın<!----></span></h3><!--]--><!----> <p><a href="../modular_diffusers/overview">Modular Diffusers</a> ile bir pipeline, herhangi bir Hub deposunda uzak kod olarak barındırılabilir. Herkes, Diffusers sürümünü beklemeden <code>from_pretrained(..., trust_remote_code=True)</code> ile yükleyebilir. Yeni bir pipeline veya model getiren bir topluluk katkıcısıysanız, buradan başlayın. Bir pipeline yayınlamak için özel bloklara, bir model yayınlamak için özel modellere bakın.</p> <p>Eşleşen <a href="https://github.com/huggingface/diffusers/issues/new?assignees=&labels=New+model%2Fpipeline%2Fscheduler&template=new-model-addition.yml" rel="nofollow">model request</a> altında bize bildirin (yoksa bir tane açın): uygulamanız hakkında geri bildirim veriyor ve beğendiklerimizi <a href="https://huggingface.co/collections/diffusers-modular/community-modular-diffusers-blocks" rel="nofollow">Community Modular Diffusers Blocks</a> koleksiyonumuzda öne çıkarıyoruz. Ardından modelin kütüphanede nasıl destekleneceğine karar veriyoruz: sürümünüzü upstream edebilir, yazarlarla resmi bir sürüm üzerinde çalışabilir veya insanları doğrudan sürümünüze yönlendirebiliriz. Süreç boyunca karşılaştığınız zorlukları da bize bildirin: kafa karıştırıcı API'ler, eksik dokümantasyon, hatalar. Bu geri bildirim, pipeline kadar bizim için değerlidir.</p> <!--[2--><h3 class="relative group"><a id="7-contribute-to-training-examples" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#7-contribute-to-training-examples"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->7. Eğitim örneklerine katkıda bulunun<!----></span></h3><!--]--><!----> <p>Diffusers örnekleri, <a href="https://github.com/huggingface/diffusers/tree/main/examples" rel="nofollow">examples</a> dizininde yer alan eğitim betikleri koleksiyonudur.</p> <p>İki tür eğitim örneğini destekliyoruz:</p> <ul><li>Resmî eğitim örnekleri</li> <li>Araştırma eğitim örnekleri</li></ul> <p>Araştırma eğitim örnekleri <a href="https://github.com/huggingface/diffusers/tree/main/examples/research_projects" rel="nofollow">examples/research_projects</a> konumunda yer alırken resmi eğitim örnekleri, <code>research_projects</code> ve <code>community</code> klasörleri hariç olmak üzere <a href="https://github.com/huggingface/diffusers/tree/main/examples" rel="nofollow">examples</a> altındaki tüm klasörleri içerir. | |
| Resmi eğitim örnekleri Diffusers’ın ana bakımcıları tarafından, araştırma eğitim örnekleri ise topluluk tarafından sürdürülmektedir. | |
| Kütüphanenin Hub üzerinde küçük bir resmi ve topluluk pipeline setini canlı tutmasının nedeni de budur: difüzyon modelleri için olası tüm eğitim yöntemlerini ana bakımcıların sürdürmesi mümkün değildir. | |
| Diffusers ana bakımcıları ve topluluk, belirli bir eğitim paradigmasını çok deneysel veya yeterince popüler bulmazsa, ilgili eğitim kodu <code>research_projects</code> klasörüne konmalı ve yazar tarafından sürdürülmelidir.</p> <p>Hem resmi eğitim hem de araştırma örnekleri, bir veya birden fazla eğitim betiği, <code>requirements.txt</code> dosyası ve <code>README.md</code> dosyası içeren bir dizinden oluşur. Kullanıcının eğitim örneklerinden yararlanabilmesi için depoyu klonlaması gerekir:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->git <span class="hljs-built_in">clone</span> https://github.com/huggingface/diffusers<!----></pre></div><!----> <p>ve eğitim için gerekli tüm ek bağımlılıkları yüklemek için:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!----><span class="hljs-built_in">cd</span> diffusers | |
| pip install -r examples/<your-example-folder>/requirements.txt<!----></pre></div><!----> <p>Dolayısıyla bir örnek eklerken, <code>requirements.txt</code> dosyası, örnek eğitim betiğinin çalıştırılabilmesi için gerekli tüm pip bağımlılıklarını tanımlamalıdır. Örneğin, <a href="https://github.com/huggingface/diffusers/blob/main/examples/dreambooth/requirements.txt" rel="nofollow">DreamBooth <code>requirements.txt</code> dosyasına</a> bakabilirsiniz.</p> <p>Diffusers kütüphanesinin eğitim örnekleri aşağıdaki felsefeye uymalıdır:</p> <ul><li>Örnekleri çalıştırmak için gerekli tüm kod, tek bir Python dosyasında bulunmalıdır.</li> <li>Örnek, <code>python <your-example>.py --args</code> komutuyla komut satırından çalıştırılabilmelidir.</li> <li>Örnekler basit tutulmalı ve Diffusers'ın eğitim için nasıl kullanılacağına dair <strong>bir örnek</strong> niteliği taşımalıdır. Örnek betiklerinin amacı, son derece özel mantık eklemeksizin bilinen eğitim şemalarını yeniden üretmek olup en ileri düzeyde difüzyon modelleri oluşturmaktan <strong>uzaktır</strong>. Bu noktanın bir yan ürünü olarak örneklerimiz, iyi eğitim materyalleri olarak da hizmet etmeye çalışır.</li></ul> <p>Örnek katkıda bulunmak için, örneklerin nasıl görünmesi gerektiğine dair bir fikir edinmek amacıyla <a href="https://github.com/huggingface/diffusers/blob/main/examples/dreambooth/train_dreambooth.py" rel="nofollow">dreambooth</a> gibi mevcut örnekleri incelemeniz şiddetle tavsiye edilir. | |
| Katkıda bulunanların, Diffusers ile sıkı bir şekilde entegre olduğu için <a href="https://github.com/huggingface/accelerate" rel="nofollow">Accelerate kütüphanesinden</a> faydalanmasını kesinlikle öneririz. | |
| Bir örnek betiği çalışmaya başladığında, örneğin tam olarak nasıl kullanılacağını açıklayan kapsamlı bir <code>README.md</code> dosyası eklediğinizden emin olun. Bu README şunları içermelidir:</p> <ul><li>Burada gösterildiği gibi örnek betiği çalıştırmak için örnek bir komut <a href="https://github.com/huggingface/diffusers/tree/main/examples/dreambooth#running-locally-with-pytorch" rel="nofollow">burada</a>.</li> <li>Kullanıcının ne bekleyebileceğini gösteren bazı eğitim sonuçlarına (günlükler, modeller vb.) <a href="https://api.wandb.ai/report/patrickvonplaten/xm6cd5q5" rel="nofollow">buradaki</a> bağlantı.</li> <li>Resmî olmayan/araştırma amaçlı bir eğitim örneği ekliyorsanız, <strong>lütfen unutmayın</strong> ki bu eğitim örneğini sizin sürdürdüğünüzü belirten bir cümle eklemeniz gerekir; git kullanıcı adınız <a href="https://github.com/huggingface/diffusers/tree/main/examples/research_projects/intel_opts#diffusers-examples-with-intel-optimizations" rel="nofollow">burada</a> gösterildiği gibi yer almalıdır.</li></ul> <p>Resmi eğitim örneklerine katkıda bulunuyorsanız, <a href="https://github.com/huggingface/diffusers/blob/main/examples/dreambooth/test_dreambooth.py" rel="nofollow">examples/dreambooth/test_dreambooth.py</a> gibi bir test dosyasını ilgili klasöre eklemeyi de unutmayın. Bu, resmi olmayan eğitim örnekleri için gerekli değildir.</p> <!--[2--><h3 class="relative group"><a id="8-fixing-a-good-second-issue" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#8-fixing-a-good-second-issue"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->8. “İyi ikinci sorun”u düzeltme<!----></span></h3><!--]--><!----> <p><em>İyi ikinci sorunlar</em>, <a href="https://github.com/huggingface/diffusers/issues?q=is%3Aopen+is%3Aissue+label%3A%22Good+second+issue%22" rel="nofollow">İyi ikinci sorun</a> etiketiyle işaretlenir. Genellikle <a href="https://github.com/huggingface/diffusers/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22" rel="nofollow">İyi ilk sorunlardan</a> çözümü daha karmaşıktır, açıklama düzeltme konusunda daha az yönlendirme sunar ve kütüphanenin makul düzeyde anlaşılmasını gerektirir.</p> <p>İyi bir ikinci sorunu ele almakla ilgileniyorsanız, soruya ilişkin görüşünüzü ve aklınızdaki yaklaşımı birkaç cümleyle bir yorum olarak paylaşın ve PR açmadan önce bir bakımcıdan onay alın. Sorun için zaten bir PR açılmışsa ancak birleştirilmediyse, yeni bir şey önermeden önce nedenini anlamak için inceleyin.</p> <!--[2--><h3 class="relative group"><a id="9-taking-on-a-diffusers-mvp-issue" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#9-taking-on-a-diffusers-mvp-issue"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->9. Diffusers MVP sorunu üstlenmek<!----></span></h3><!--]--><!----> <p><a href="https://github.com/huggingface/diffusers/issues/12635" rel="nofollow">Diffusers MVP program</a>, en çok yardıma ihtiyaç duyduğumuz sorunları listeler. Bunlar Good second issue'lar gibi çalışır ancak daha zordur ve daha fazla zaman alır; program, bu sorunları üstlenen katkıda bulunanları ödüllendirir. PR açmadan önce yaklaşımınızı bir yorum olarak paylaşın ve bir bakımcıdan onay alın. Programın ayrıca bir <a href="https://github.com/huggingface/diffusers/issues/14529" rel="nofollow">ideas track</a> bölümü vardır: Diffusers'ın etkisini artıracak tek bir fikri, birkaç cümleyle ve uygulama detayları olmadan bize iletin.</p> <!--[2--><h3 class="relative group"><a id="10-adding-pipelines-models-schedulers" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#10-adding-pipelines-models-schedulers"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->10. Boru hatları, modeller ve zamanlayıcılar ekleme<!----></span></h3><!--]--><!----> <blockquote class="tip"><p>Eğer modelin yazarıysanız, entegrasyonu sizinle koordine edebilmemiz için lütfen bizimle iletişime geçin: bir özellik isteği açın veya zaten açık bir istek varsa yorum bırakın.</p> <p>Bir topluluk katkıcısıysanız, önce bir Hub deposuyla başlayın, <a href="#6-publish-a-pipeline-or-model-on-the-hub">Hub'da bir pipeline veya model yayımlama</a> bölümüne bakın ve upstream etmeye ilgi duyduğunuzu ilgili özellik isteğinin altında bize bildirin.</p></blockquote> <p>Pipelines, modeller ve zamanlayıcılar, Diffusers kütüphanesinin en önemli parçalarıdır. | |
| Son teknoloji difüzyon teknolojilerine kolay erişim sağlarlar ve bu sayede topluluğun güçlü üretken yapay zekâ uygulamaları oluşturmasına olanak tanır.</p> <p>Yeni bir model, pipeline veya scheduler ekleyerek, Diffusers'a dayanan herhangi bir kullanıcı arayüzü için yeni ve güçlü bir kullanım senaryosu etkinleştirebilir; bu, tüm üretken yapay zeka ekosistemi için büyük bir değer taşıyabilir.</p> <!--[3--><h4 class="relative group"><a id="when-new-model-or-pipeline-support-is-released" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#when-new-model-or-pipeline-support-is-released"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->Yeni model veya pipeline desteği yayınlandığında<!----></span></h4><!--]--><!----> <p>Bir sürüme yeni bir model veya hattın dahil edilmesi, entegrasyonu Diffusers ekibiyle önceden koordine etmeniz durumunda mümkündür. Bize Diffusers deposunda bir sorun (issue) açarak veya <code>diffusers@huggingface.co</code> adresine e-posta göndererek ulaşabilirsiniz.</p> <p>Bir model veya pipeline çekme isteği birleştirildiğinde bir sürüm otomatik olarak yapılmaz. Bir sürüm öncesinde, bakımcılar önce entegrasyonun tamamlandığını ve sürüm testlerinin geçtiğini kontrol eder.</p> <p>Yeni model veya pipeline desteği genellikle bir sonraki küçük sürüme eklenir. Entegrasyon <code>main</code> dalına birleştirilir ve sürüm dalı bu daldan oluşturulur. Sürüm, yalnızca model veya pipeline entegrasyonu değil, önceki sürümden bu yana birleştirilen tüm değişiklikleri içerir.</p> <p>Sürüm notları, yeni modeli veya hattı vurgular ve sürümde yer alan diğer değişiklikleri de özetler. Yama sürümleri genellikle mevcut bir sürümdeki düzeltmeler için ayrılmıştır.</p> <p>Diffusers, üç bileşenin tamamı için birkaç açık özellik isteğine sahiptir - eklemek istediğiniz belirli bileşeni henüz bilmiyorsanız, bunlara göz atabilirsiniz:</p> <ul><li><a href="https://github.com/huggingface/diffusers/issues?q=is%3Aopen+is%3Aissue+label%3A%22New+pipeline%2Fmodel%22" rel="nofollow">Model veya pipeline</a></li> <li><a href="https://github.com/huggingface/diffusers/issues?q=is%3Aopen+is%3Aissue+label%3A%22New+scheduler%22" rel="nofollow">Zamanlayıcı</a></li></ul> <p>Üç bileşenden herhangi birini eklemeden önce, bu üç bileşenden herhangi birinin tasarımını daha iyi anlayabilmek için <a href="philosophy">Felsefe kılavuzu</a>nu okumanız şiddetle tavsiye edilir. Tasarım felsefemizden önemli ölçüde sapan model, zamanlayıcı veya pipeline eklemelerini birleştiremeyeceğimizi lütfen dikkate alın; çünkü bu durum API tutarsızlıklarına yol açacaktır. Bir tasarım seçimiyle temel düzeyde katılmıyorsanız, belirli bir tasarım kalıbı/tasarım seçiminin kütüphanenin her yerinde değiştirilip değiştirilmeyeceği ve tasarım felsefemizin güncellenip güncellenmeyeceği tartışılabilmesi için bunun yerine bir <a href="https://github.com/huggingface/diffusers/issues/new?assignees=&labels=&template=feedback.md&title=" rel="nofollow">Geri bildirim sorunu</a> açın. Kütüphane genelindeki tutarlılık bizim için çok önemlidir.</p> <p>Lütfen PR'ye orijinal kod tabanına/makaleye giden bağlantıları eklediğinizden emin olun ve mümkünse orijinal yazarı PR üzerinden doğrudan bilgilendirin; böylece ilerlemeyi takip edebilir ve sorularla ilgili yardımcı olabilirler.</p> <p>PR'de emin değilseniz veya takılı kaldıysanız, ilk inceleme veya yardım istemek için bir mesaj bırakmaktan çekinmeyin.</p> <!--[3--><h4 class="relative group"><a id="copied-from-mechanism" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#copied-from-mechanism"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->mekanizmadan kopyalandı<!----></span></h4><!--]--><!----> <p>Herhangi bir pipeline, model veya scheduler kodu eklerken kavranması gereken benzersiz ve önemli bir özellik, <code># Copied from</code> mekanizmasıdır. Diffusers kod tabanının her yerinde bu mekanizmayı göreceksiniz ve bunun kullanılma nedeni, kod tabanının anlaşılmasını ve sürdürülmesini kolay tutmaktır. <code># Copied from</code> mekanizmasıyla işaretlenen kod, kopyalandığı kodla birebir aynı olmak zorundadır. Bu sayede <code>make fix-copies</code> komutunu her çalıştırdığınızda değişiklikleri birçok dosya arasında güncellemek ve yaymak kolaylaşır.</p> <p>Örneğin, aşağıdaki kod örneğinde <a href="/docs/diffusers/v0.43.0/tr/api/pipelines/stable_diffusion/img2img#diffusers.pipelines.stable_diffusion.StableDiffusionPipelineOutput">StableDiffusionPipelineOutput</a> orijinal kodu temsil ederken <code>AltDiffusionPipelineOutput</code>, <code># Copied from</code> mekanizmasını kullanarak onu kopyalar. Tek fark, sınıf önekini <code>Stable</code>’den <code>Alt</code>’e değiştirmektir.</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-py "><!----><span class="hljs-comment"># Copied from diffusers.pipelines.stable_diffusion.pipeline_output.StableDiffusionPipelineOutput with Stable->Alt</span> | |
| <span class="hljs-keyword">class</span> <span class="hljs-title class_">AltDiffusionPipelineOutput</span>(<span class="hljs-title class_ inherited__">BaseOutput</span>): | |
| <span class="hljs-string">""" | |
| Output class for Alt Diffusion pipelines. | |
| Args: | |
| images (`List[PIL.Image.Image]` or `np.ndarray`) | |
| List of denoised PIL images of length `batch_size` or NumPy array of shape `(batch_size, height, width, | |
| num_channels)`. | |
| nsfw_content_detected (`List[bool]`) | |
| List indicating whether the corresponding generated image contains "not-safe-for-work" (nsfw) content or | |
| `None` if safety checking could not be performed. | |
| """</span><!----></pre></div><!----> <p>Daha fazla bilgi edinmek için <a href="https://huggingface.co/blog/transformers-design-philosophy#4-machine-learning-models-are-static" rel="nofollow">~Don’t~ Repeat Yourself*</a> blog yazısının bu bölümünü okuyun.</p> <!--[1--><h2 class="relative group"><a id="how-to-write-a-good-issue" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#how-to-write-a-good-issue"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->İyi bir sorun nasıl yazılır<!----></span></h2><!--]--><!----> <p><strong>Sorununuz ne kadar iyi yazılırsa, hızlı çözülme olasılığı o kadar yüksek olur.</strong></p> <ol><li>Sorunuz için doğru şablonu kullandığınızdan emin olun. <em>Bug Report</em>, <em>Feature Request</em>, <em>Feedback about API Design</em>, <em>New model/pipeline/scheduler addition</em> veya boş bir sorun arasında seçim yapabilirsiniz. <a href="https://github.com/huggingface/diffusers/issues/new/choose" rel="nofollow">a new issue</a> açarken doğru olanı seçtiğinizden emin olun. Kullanım soruları bir sorunda değil, <a href="https://github.com/huggingface/diffusers/discussions" rel="nofollow">GitHub Discussions</a> bölümünde yer almalıdır.</li> <li><strong>Net olun</strong>: Sorunuza uygun bir başlık verin. Sorun açıklamanızı olabildiğince basit bir şekilde ifade etmeye çalışın. Bir sorun bildirdiğinizde ne kadar isabetli olursanız, sorunun anlaşılması ve potansiyel olarak çözülmesi o kadar az zaman alır. Tek bir sorun için bir sorun açtığınızdan ve birden fazla sorun için tek bir sorun açmadığınızdan emin olun. Birden fazla sorun bulduysanız, basitçe birden fazla sorun açın. Sorununuz bir hata ise, hangi hata olduğunu olabildiğince net belirtmeye çalışın - sadece “diffusers’da hata” yazmamalısınız.</li> <li><strong>Tekrarlanabilirlik</strong>: Tekrarlanabilir bir kod parçası yoksa çözüm de yoktur. Bir hata ile karşılaşırsanız, bakıcıların hatayı <strong>tekrarlayabilmesi</strong> gerekir. Sorunu yeniden oluşturmak için bir Python yorumcısına kopyala-yapıştır edilebilecek bir kod parçası içerdiğinden emin olun. Kod parçanızın çalıştığından, <em>yani</em> eksik importlar veya görsellere eksik bağlantılar olmadığından emin olun. Sorunuz, tam olarak aynı hata mesajını yeniden oluşturmak için herhangi bir değişiklik yapılmadan kopyala-yapıştır edilebilecek bir hata mesajı <strong>ve</strong> bir kod parçası içermelidir. Sorunuz, okuyucunun erişemeyeceği yerel model ağırlıkları veya yerel veriler kullanıyorsa, sorun çözülemez. Verilerinizi veya modelinizi paylaşamıyorsanız, sahte bir model veya sahte veriler oluşturmaya çalışın.</li> <li><strong>Minimalist</strong>: Okuyucunun sorunu en kısa sürede anlayabilmesi için mümkün olduğunca kısa tutarak ona yardımcı olmaya çalışın. Soruyla ilgili olmayan tüm kodu / bilgiyi kaldırın. Bir hata bulduysanız, sorunu göstermek için en basit kod örneğini oluşturmaya çalışın; bir hata bulduğunuzda tüm iş akışınızı soruya yapıştırmayın. Örneğin, bir model eğitiyor ve eğitim sırasında bir noktada hata alıyorsanız, hatanın eğitim kodunun hangi kısmından kaynaklandığını anlamaya ve bunu birkaç satırla yeniden üretmeye çalışın. Tam veri setleri yerine sahte (dummy) veriler kullanmaya çalışın.</li> <li><strong>Bağlam</strong>: Hata ile karşılaştığınızda veya özelliğe ihtiyaç duyduğunuzda üzerinde çalıştığınız şeyi bize anlatın; örneğin Diffusers üzerine kurulu bir uygulama, bir araştırma projesi veya kütüphanedeki hataları bulmak için çalıştırdığınız bir ajan. Bir-iki cümle yeterlidir ve projeye bir bağlantı eklemeniz memnuniyetle karşılanır. Aynı anda ele alabileceğimizden daha fazla sorun ve PR alıyoruz, bu nedenle bağlam, önceliklendirmeyi etkiye göre yapmamıza yardımcı olur.</li> <li>Bağlantılar ekleyin. Belirli bir adlandırma, yöntem veya modelden bahsediyorsanız, okuyucunun ne kastettiğinizi daha iyi anlayabilmesi için bir bağlantı sağladığınızdan emin olun. Belirli bir PR veya issue'dan bahsediyorsanız, bunu ilgili issue'unuza bağladığınızdan emin olun. Okuyucunun ne konuştuğunuzu bildiğini varsaymayın. Issue'unuza ne kadar çok bağlantı eklerseniz o kadar iyi olur.</li> <li>Biçimlendirme. Sorununuzun düzgün biçimlendirildiğinden emin olun; kodu Python kod sözdizimiyle, hata mesajlarını ise normal kod sözdizimiyle biçimlendirin. Daha fazla bilgi için <a href="https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax" rel="nofollow">resmî GitHub biçimlendirme belgelerini</a> inceleyin.</li> <li>Sorunuzu çözülecek bir talep olarak değil, iyi yazılmış bir ansiklopedinin güzel bir maddesi olarak düşünün. Eklenen her sorun, herkese açık bilgiye bir katkıdır. İyi yazılmış bir sorun ekleyerek yalnızca geliştiricilerin sorununuzu çözmesini kolaylaştırmakla kalmaz, aynı zamanda topluluğun kütüphanenin belirli bir yönünü daha iyi anlamasına da yardımcı olursunuz.</li></ol> <!--[1--><h2 class="relative group"><a id="how-to-write-a-good-pr" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#how-to-write-a-good-pr"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->İyi bir PR nasıl yazılır<!----></span></h2><!--]--><!----> <ol><li>Her zaman bir sorundan (issue) başlayın. Çekme isteğinizin (pull request) ele aldığı sorunu bulun, kimse açmadıysa bir tane açın ve kod yazmadan önce bakımcılara (maintainer) yanıt verme fırsatı verin. Bizim için en iyi işe yarayan iş akışı, bir sorun açmak, ardından çözümün tartışılması ve bu tartışmaya dayalı olarak bir PR açmaktır. Bu, zamanımızı en etkili sorunlara odaklamamızı, kod var olmadan önce kapsamda anlaşmamızı ve tekrarlanan işten kaçınmamızı sağlar. PR açıklamasında sorun numarasını belirtin (ör. <code>Fixes #1234</code>) ki ikisi birbirine bağlansın.</li> <li>Bir bukalemun gibi olun. Mevcut tasarım kalıplarını ve sözdizimini anlayın ve kod eklemelerinizin mevcut kod tabanına kusursuz bir şekilde entegre olmasını sağlayın. Mevcut tasarım kalıplarından veya kullanıcı arayüzlerinden önemli ölçüde sapan pull request'ler birleştirilmeyecektir.</li> <li>Lazer gibi odaklanın. Bir pull request tek bir sorunu ve yalnızca o sorunu çözmelidir. “Bunu eklerken başka bir sorunu da düzeltelim” tuzağına düşmemeye dikkat edin. Birden fazla, birbirinden bağımsız sorunu aynı anda çözen pull request’leri incelemek çok daha zordur.</li> <li>Tekil durumlar değil, kalıpları düzeltin. Tek bir sorun birçok dosyaya yayılabilir: Aynı hata kod tabanında tekrarlıyorsa, tüm örnekleri arayın ve hepsini tek bir PR ile, net ve sistematik bir kapsamla (ör. “tüm zamanlayıcılarda değiştirilebilir varsayılanları düzelt”) düzeltin; her örnek için ayrı bir PR açmak yerine.</li> <li>Çekme isteğinizin başlığı, katkısının bir özeti olmalıdır. Devam eden bir işi belirtmek için başlığın başına <code>[WIP]</code> öneki ekleyin; bu, tekrarlanan işleri önler ve birleştirilmeye hazır olanlardan PR'ı ayırır.</li> <li>Metninizi <a href="#how-to-write-a-good-issue">İyi bir sorun nasıl yazılır</a> başlığında açıklandığı gibi formüle etmeye ve biçimlendirmeye çalışın.</li> <li>PR açmadan önce kendi diff'inizi gözden geçirin. Bir gözden geçirenin yapacağı gibi okuyun ve bulduklarınızı düzeltin. <a href="https://github.com/huggingface/diffusers/blob/main/.ai/skills/self-review/SKILL.md" rel="nofollow"><code>self-review</code></a> becerisini çalıştırmayı şiddetle öneririz: bu beceri, <code>@claude</code> CI gözden geçireninin kullandığı aynı değerlendirme ölçütünü uygular. Ajanınızı <a href="#coding-with-ai-agents">Yapay zeka ajanlarıyla kodlama</a> başlıklı bölümde anlatıldığı gibi yapılandırın ve <a href="#ai-assisted-and-agentic-contributions">Yapay zeka destekli ve ajan tabanlı katkılar</a> başlıklı bölümü takip edin. Açıklama kısmında, bilerek olduğu gibi bıraktığınız bulguları belirtin; böylece gözden geçiren, bunların bir ihmal değil bilinçli bir tercih olduğunu anlar.</li> <li>Mevcut testlerin geçtiğinden emin olun.</li> <li>Yüksek kapsamlı testler ekleyin. Kalite testi yoksa birleştirme yapılmaz.</li></ol> <ul><li>Yeni <code>@slow</code> testleri ekliyorsanız, <code>RUN_SLOW=1 python -m pytest tests/test_my_new_model.py</code> komutuyla geçtiklerinden emin olun. | |
| CircleCI yavaş testleri çalıştırmaz, ancak GitHub Actions her gece çalıştırır!</li></ul> <ol start="10"><li>Tüm genel yöntemler, markdown ile iyi çalışan bilgilendirici docstring'ler içermelidir. Örnek için <a href="https://github.com/huggingface/diffusers/blob/main/src/diffusers/pipelines/latent_diffusion/pipeline_latent_diffusion.py" rel="nofollow"><code>pipeline_latent_diffusion.py</code></a> dosyasına bakın.</li> <li>Hızla büyüyen depoyu göz önünde bulundurarak, depoyu önemli ölçüde ağırlaştıracak dosyaların eklenmediğinden emin olmak önemlidir. Buna görseller, videolar ve diğer metin dışı dosyalar dahildir. Bu dosyaları yerleştirmek için <a href="https://huggingface.co/hf-internal-testing" rel="nofollow"><code>hf-internal-testing</code></a> veya <a href="https://huggingface.co/datasets/huggingface/documentation-images" rel="nofollow">huggingface/documentation-images</a> gibi hf.co üzerinde barındırılan bir <code>dataset</code> kullanmayı tercih ediyoruz. | |
| Harici bir katkıda bulunuyorsanız, görselleri PR'ınıza ekleyebilir ve görsellerinizin bu veri setine taşınması için bir Hugging Face üyesinden rica edebilirsiniz.</li></ol> <!--[1--><h2 class="relative group"><a id="how-to-open-a-pr" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#how-to-open-a-pr"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->PR açma<!----></span></h2><!--]--><!----> <p>Kod yazmadan önce, aynı şey üzerinde zaten çalışılıp çalışılmadığından emin olmak için mevcut PR'ları veya sorunları aramanızı şiddetle tavsiye ederiz. Emin değilseniz, geri bildirim almak için bir sorun açmak her zaman iyi bir fikirdir.</p> <p>🧨 Diffusers'a katkıda bulunabilmek için temel düzeyde <code>git</code> bilgisi gereklidir. <code>git</code> kullanması en kolay araç değildir ancak en kapsamlı kılavuza sahiptir. Bir kabukta <code>git --help</code> yazın ve keyfini çıkarın. Kitapları tercih ediyorsanız, <a href="https://git-scm.com/book/en/v2" rel="nofollow">Pro Git</a> çok iyi bir başvuru kaynağıdır.</p> <p>Katkıda bulunmaya başlamak için bu adımları izleyin (<a href="https://github.com/huggingface/diffusers/blob/83bc6c94eaeb6f7704a2a428931cf2d9ad973ae9/setup.py#L270" rel="nofollow">desteklenen Python sürümleri</a>):</p> <ol><li><p>Depoyu, sayfasındaki ‘Fork’ düğmesine tıklayarak <a href="https://github.com/huggingface/diffusers" rel="nofollow">forklayın</a>. Bu işlem, kodun bir kopyasını GitHub kullanıcı hesabınız altında oluşturur.</p></li> <li><p>Fork'unuzu yerel diskinize klonlayın ve temel depoyu uzak (remote) olarak ekleyin:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ git <span class="hljs-built_in">clone</span> git@github.com:<your GitHub handle>/diffusers.git | |
| $ <span class="hljs-built_in">cd</span> diffusers | |
| $ git remote add upstream https://github.com/huggingface/diffusers.git<!----></pre></div><!----></li> <li><p>Geliştirme değişikliklerinizi tutmak için yeni bir dal oluşturun:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ git checkout -b a-descriptive-name-for-my-changes<!----></pre></div><!----></li></ol> <p><code>main</code> dalında <strong>çalışmayın</strong>.</p> <ol start="4"><li><p>Sanal bir ortamda aşağıdaki komutu çalıştırarak bir geliştirme ortamı oluşturun:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ pip install -e <span class="hljs-string">".[dev]"</span><!----></pre></div><!----></li></ol> <p>Depoyu zaten klonladıysanız, kütüphanedeki en son değişiklikleri almak için <code>git pull</code> yapmanız gerekebilir.</p> <ol start="5"><li>Özellikleri dalınızda geliştirin.</li></ol> <p>Özellikler üzerinde çalışırken, test paketinin geçtiğinden emin olmalısınız. Değişikliklerinizin etkilediği testleri şu şekilde çalıştırmalısınız:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ pytest tests/<TEST_TO_RUN>.py<!----></pre></div><!----> <p>Testleri çalıştırmadan önce, test için gerekli bağımlılıkları yüklediğinizden emin olun. Bunu şu komutla yapabilirsiniz:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ pip install -e <span class="hljs-string">".[test]"</span><!----></pre></div><!----> <p>Ayrıca tam test paketini aşağıdaki komutla da çalıştırabilirsiniz, ancak Diffusers önemli ölçüde büyüdüğü için makul bir sürede sonuç üretmek artık güçlü bir makine gerektirir. Komut şu şekildedir:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ make <span class="hljs-built_in">test</span><!----></pre></div><!----> <p>🧨 Diffusers, kaynak kodunu tutarlı biçimde biçimlendirmek için <code>black</code> ve <code>isort</code> araçlarına dayanır. Değişikliklerinizi yaptıktan sonra, otomatikleştirilemeyen otomatik stil düzeltmelerini ve kod doğrulamalarını tek seferde şu komutla uygulayın:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ make style<!----></pre></div><!----> <p>🧨 Diffusers ayrıca kodlama hatalarını kontrol etmek için <code>ruff</code> ve birkaç özel betik kullanır. Kalite kontrolü CI'de çalıştırılır; ancak aynı kontrolleri şu komutla da çalıştırabilirsiniz:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ make quality<!----></pre></div><!----> <p>Değişikliklerinizden memnun kaldığınızda, değiştirilen dosyaları <code>git add</code> ile ekleyin ve değişikliklerinizi yerel olarak kaydetmek için <code>git commit</code> ile bir commit oluşturun:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ git add modified_file.py | |
| $ git commit -m <span class="hljs-string">"A descriptive message about your changes."</span><!----></pre></div><!----> <p>Kodunuzun kopyasını orijinal depoyla düzenli olarak senkronize etmek iyi bir fikirdir. Bu sayede değişiklikleri hızla dikkate alabilirsiniz:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ git pull upstream main<!----></pre></div><!----> <p>Değişiklikleri hesabınıza şu komutu kullanarak gönderin:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ git push -u origin a-descriptive-name-for-my-changes<!----></pre></div><!----> <ol start="6"><li><p>Memnun kaldığınızda, GitHub'daki fork'unuzun web sayfasına gidin. Değişikliklerinizi proje yöneticilerine inceleme için göndermek için ‘Pull request’e tıklayın.</p></li> <li><p>Bakımcıların sizden değişiklikler istemesi normaldir. Bu durum çekirdek katkıda bulunanlara da olur! Herkesin Pull request içindeki değişiklikleri görebilmesi için yerel dalınızda çalışın ve değişiklikleri forkunuza gönderin. Değişiklikler pull request içinde otomatik olarak görünecektir.</p></li></ol> <!--[2--><h3 class="relative group"><a id="tests" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#tests"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->Testler<!----></span></h3><!--]--><!----> <p>Kütüphanenin davranışını ve çeşitli örnekleri test etmek için kapsamlı bir test paketi dahildir. Kütüphane testleri <a href="https://github.com/huggingface/diffusers/tree/main/tests" rel="nofollow">tests klasöründe</a> bulunabilir.</p> <p><code>pytest</code> ve <code>pytest-xdist</code> daha hızlı olduğu için tercih ediyoruz. Deponun kök dizininden, kütüphane için <code>pytest</code> ile testleri çalıştırmak için:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ python -m pytest -n auto --dist=loadfile -s -v ./tests/<!----></pre></div><!----> <p>Aslında <code>make test</code> tam olarak bu şekilde uygulanır!</p> <p>Çalıştığınız özelliği test etmek için daha küçük bir test seti belirleyebilirsiniz.</p> <p>Varsayılan olarak yavaş testler atlanır. Çalıştırmak için <code>RUN_SLOW</code> ortam değişkenini <code>yes</code> olarak ayarlayın. Bu işlem, gigabaytlarca model indirecektir — yeterli disk alanına ve iyi bir internet bağlantısına sahip olduğunuzdan ya da bolca sabrınız olduğundan emin olun!</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ RUN_SLOW=<span class="hljs-built_in">yes</span> python -m pytest -n auto --dist=loadfile -s -v ./tests/<!----></pre></div><!----> <p><code>unittest</code> tam olarak desteklenmektedir, bununla testleri çalıştırmanın yolu şudur:</p> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ python -m unittest discover -s tests -t . -v | |
| $ python -m unittest discover -s examples -t examples -v<!----></pre></div><!----> <!--[2--><h3 class="relative group"><a id="syncing-forked-main-with-upstream-huggingface-main" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#syncing-forked-main-with-upstream-huggingface-main"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->Fork edilmiş main'in upstream (HuggingFace) main ile senkronize edilmesi<!----></span></h3><!--]--><!----> <p>Yukarıdaki PR'lere referans notları ekleyen ve bu PR'lere dahil olan geliştiricilere gereksiz bildirimler gönderen üst akış deposuna istek göndermekten kaçınmak için, çatal bir depoda ana dalı senkronize ederken lütfen şu adımları izleyin:</p> <ol><li>Mümkün olduğunda, fork edilmiş depoda bir dal ve PR kullanarak upstream ile senkronize olmaktan kaçının. Bunun yerine, doğrudan fork edilmiş main dalına birleştirin.</li> <li>Bir PR kesinlikle gerekiyorsa, dalınızı kontrol ettikten sonra aşağıdaki adımları kullanın:</li></ol> <div class="code-block relative "><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5 text-gray-600 " title="code excerpt" type="button"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg><!----> <div class=" absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0 "><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent;"></div> Kopyalandı</div><!----></button><!----></div> <pre class="language-bash "><!---->$ git checkout -b your-branch-for-syncing | |
| $ git pull --squash --no-commit upstream main | |
| $ git commit -m <span class="hljs-string">'<your message without GitHub references>'</span> | |
| $ git push --set-upstream origin your-branch-for-syncing<!----></pre></div><!----> <!--[2--><h3 class="relative group"><a id="style-guide" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#style-guide"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->Stil kılavuzu<!----></span></h3><!--]--><!----> <p>Belge dizeleri için 🧨 Diffusers, <a href="https://google.github.io/styleguide/pyguide.html" rel="nofollow">Google stili</a>ni uygular.</p> <!--[1--><h2 class="relative group"><a id="coding-with-ai-agents" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#coding-with-ai-agents"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->Yapay zeka ajanlarıyla kodlama<!----></span></h2><!--]--><!----> <p>Depo, AI-ajan yapılandırmasını <a href="https://github.com/huggingface/diffusers/tree/main/.ai" rel="nofollow"><code>.ai/</code></a> içinde tutar; bu yapılandırma ayrıca bir ajan eklentisi olarak da yayınlanır, böylece talep üzerine görev becerileri tek adımda kurulur.</p> <ul><li><strong>Katkıda bulunanlar için salt okunur</strong> — <code>.ai/</code> ana bakım sorumluları tarafından yönetilir. Lütfen PR'ınızda <code>.ai/</code> altındaki dosyaları (veya kök düzeyindeki <code>AGENTS.md</code> / <code>CLAUDE.md</code> sembolik bağlantılarını, ya da kurulu <code>.agents/skills</code> / <code>.claude/skills</code> dizinlerini) düzenlemeyin. Eksik veya hatalı bir şey fark ederseniz bir sorun (issue) açın veya PR'da belirtin; bir bakım sorumlusu güncelleyecektir.</li> <li><strong>Guidelines</strong> — <code>.ai/AGENTS.md</code> kök dizindeki <code>AGENTS.md</code> / <code>CLAUDE.md</code> sembolik bağlantıları aracılığıyla her ajan oturumuna yüklenir; <code>.ai/references/</code> altındaki referans kılavuzları, bir bağlantı izlendiğinde ihtiyaç halinde okunur: <ul><li><a href="https://github.com/huggingface/diffusers/blob/main/.ai/AGENTS.md" rel="nofollow"><code>.ai/AGENTS.md</code></a> — üst düzey kodlama yönergeleri</li> <li><a href="https://github.com/huggingface/diffusers/blob/main/.ai/references/models.md" rel="nofollow"><code>.ai/references/models.md</code></a> — dikkat deseni, model uygulama kuralları, yaygın sözleşmeler</li> <li><a href="https://github.com/huggingface/diffusers/blob/main/.ai/references/pipelines.md" rel="nofollow"><code>.ai/references/pipelines.md</code></a> — pipeline kuralları</li> <li><a href="https://github.com/huggingface/diffusers/blob/main/.ai/references/modular.md" rel="nofollow"><code>.ai/references/modular.md</code></a> — modüler pipeline kuralları ve dönüştürme kontrol listesi</li> <li><a href="https://github.com/huggingface/diffusers/blob/main/.ai/references/testing.md" rel="nofollow"><code>.ai/references/testing.md</code></a> — zorunlu test katmanları, tester karışımları, sahte bileşen kuralları</li> <li><a href="https://github.com/huggingface/diffusers/blob/main/.ai/references/review-rules.md" rel="nofollow"><code>.ai/references/review-rules.md</code></a> — inceleyicilerin aradığı şeyler</li></ul></li> <li><strong>Skills</strong> (altında <a href="https://github.com/huggingface/diffusers/tree/main/.ai/skills" rel="nofollow"><code>.ai/skills/</code></a>, belirli görevler için isteğe bağlı olarak yüklenir: <ul><li><code>model-integration</code> — diffusers'a yeni bir model veya pipeline eklemek (dosya yapısı, entegrasyon kontrol listesi, test düzeni, ağırlık dönüşümü)</li> <li><code>self-review</code> — bir PR açmadan önce değişikliklerinizi proje kurallarına göre gözden geçirin</li> <li><code>diffusers-cli</code> — terminalden pipeline çalıştırma ve şemaları inceleme</li> <li><code>custom-blocks</code> — Hub için bir <code>ModularPipelineBlocks</code> alt sınıfını paketleme</li></ul></li></ul> <p>Hangi yolu seçerseniz seçin, başlamadan önce aracınızın kendi kurulumunu doğrulamasını isteyin — <code>python utils/check_ai.py</code> kılavuzların ve becerilerin tutarlı olduğunu kontrol eder, <code>diffusers-cli skills list</code> ise aracın gerçekten hangi becerilere sahip olduğunu gösterir.</p> <!--[2--><h3 class="relative group"><a id="ai-assisted-and-agentic-contributions" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#ai-assisted-and-agentic-contributions"><span><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg><!----></span></a> <span><!---->Yapay zeka destekli ve ajan tabanlı katkılar<!----></span></h3><!--]--><!----> <p>Diffusers'a katkıda bulunmak için yapay zeka ajanları memnuniyetle karşılanır. Ajanınızı Diffusers <a href="https://github.com/huggingface/diffusers/blob/main/.ai/AGENTS.md" rel="nofollow">ajan kılavuzu</a> ile yapılandırmanızı ve <code>model-integration</code> ile <code>self-review</code> gibi ilgili görevlere özel becerileri kullanmanızı öneririz. Yukarıda belirtildiği gibi eklentiyi (veya bireysel becerileri) yükleyin, ardından kılavuza göre katkınızı kapsamlandırın, uygulayın, test edin ve gözden geçirin. PR'ınızdaki değişiklikleri anlama, test etme ve sürdürme sorumluluğu size aittir.</p> <p>Yapay zeka destekli katkılar memnuniyetle karşılanır, ancak inceleme yükünü yönetilebilir tutmak için koordine edilmiş, kapsamı belirlenmiş ve doğrulanmış olmalıdır. Bu yönergeleri takip etmeyen PR'lar, ayrıntılı inceleme yapılmadan kapatılabilir.</p> <ul><li><strong>PR açmadan önce koordinasyon sağlayın.</strong> Bir issue bulun veya açın, benzer PR'leri (açık olanları ve yakın zamanda kapatılanları) inceleyin ve PR açmadan önce bir bakıcının (maintainer) o issue üzerinde açık bir onay vermesini bekleyin. Bu, kapsamı tartışmamıza, tekrarlanan işleri önlememize ve yaklaşımı onaylamamıza olanak tanır.</li> <li><strong>Desenleri düzeltin, tek seferlik durumları değil.</strong> Tekrarlayan bir sorun fark ederseniz, kod tabanında benzer örnekleri arayın ve tekil örnekler için birçok sorun veya PR açmak yerine, net ve sistematik bir kapsamla (ör. “tüm zamanlayıcılarda değiştirilebilir varsayılanları düzelt”) <em>tek</em> bir sorun açın.</li> <li><strong>Açmadan önce kendi kendine inceleme.</strong> <a href="https://github.com/huggingface/diffusers/blob/main/.ai/skills/self-review/SKILL.md" rel="nofollow"><code>self-review</code></a> becerisini çalıştırın — bu beceri, <code>@claude</code> CI inceleyicisinin kullandığı aynı ölçüt olan <a href="https://github.com/huggingface/diffusers/blob/main/.ai/references/review-rules.md" rel="nofollow"><code>.ai/references/review-rules.md</code></a> dosyasına göre diff'inizi inceler — ve raporladıklarını ele alın; bu bir yardımcıdır, yetkili değildir ve yanılabilir. Size mantıklı gelen engelleyici sorunlara odaklanın ve mümkün olduğunca ölü/kullanılmayan kodu temizleyin. Bir öneriyle katılmıyorsanız, PR açıldıktan sonra inceleyicinin tartışması için bırakmanız sorun değildir — paylaştığınız notlar (aşağıda) inceleyiciye bunun bilinçli bir karar olduğunu söyler.</li> <li><strong>Kendi inceleme notlarınızı paylaşın.</strong> Gönderdiğiniz diff'i yansıtan tur olan nihai kendi inceleme raporunu, PR'da açıklamada veya bir yorum olarak, bilerek düzeltmediğiniz bulguları ve nedenlerini de içerecek şekilde paylaşın. Bu, inceleyicinin nelerin zaten kontrol edildiğini ve hangi kararların bilinçli verildiğini görmesini sağlar ve genellikle birkaç tur ileri geri tartışmasını önler.</li> <li><strong>PR iletişiminizi kısa tutun.</strong> Bir gözden geçirmenin PR'ınızda okuduğu her şey — açıklama, commit mesajları, yorumlar ve yanıtlar, kod yorumları — bir insan tarafından kolayca anlaşılabilir olmalıdır. Metni ajanınız hazırladıysa, sadece göz atmayın. Metni okuyun ve ajanı, kendinizin de yazacağı mantıklı ve kısa bir ifadeye dönüştürmesi için revize etmesini isteyin. Yayınladığınız her şeyin yazarı sizsiniz.</li> <li><strong>Include in the PR description:</strong> <ul><li>Bir bakıcının (maintainer) çalışmayı onayladığı soruna veya tartışmaya giden <strong>koordinasyon bağlantısı</strong>.</li> <li>Çalıştırdığınız <strong>test komutları</strong> ve sonuçları (yalnızca “testler geçiyor” değil, ilgili çıktıyı yapıştırın).</li> <li>Yukarıda açıklandığı gibi, <strong>kendi inceleme notlarınız</strong> (veya bunları içeren PR yorumuna bir bağlantı).</li></ul></li></ul> <p>Bir model yazarıysanız veya bir modeli resmi olarak bakımını yapan bir ekibin parçasıysanız, yeni bir model entegrasyonu için ajan kullanmanızı öneririz. Deponun <a href="https://github.com/huggingface/diffusers/blob/main/.ai/AGENTS.md" rel="nofollow">önerilen kurulumunu</a> izleyin ve <a href="https://github.com/huggingface/diffusers/blob/main/.ai/skills/model-integration/SKILL.md" rel="nofollow"><code>model-integration</code></a> becerisini kullanın. Bir PR açmadan önce kapsamı bakım sorumlularıyla koordine edin — bkz. <a href="#10-adding-pipelines-models-schedulers">Pipeline, model ve zamanlayıcı ekleme</a>.</p> <a class="!text-gray-400 !no-underline text-sm flex items-center not-prose mt-4" href="https://github.com/huggingface/diffusers/blob/main/docs/source/en/conceptual/contribution.md" target="_blank"><svg class="mr-1" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M31,16l-7,7l-1.41-1.41L28.17,16l-5.58-5.59L24,9l7,7z"></path><path d="M1,16l7-7l1.41,1.41L3.83,16l5.58,5.59L8,23l-7-7z"></path><path d="M12.419,25.484L17.639,6.552l1.932,0.518L14.351,26.002z"></path></svg><!----> <span><span class="underline">Update</span> on GitHub</span></a><!----> <p></p><!--]--><!----><!--]--><!--]--><!--]--> <!--[-1--><!--]--><!--]--> | |
| <script> | |
| { | |
| __sveltekit_ywq9g6 = { | |
| base: "/docs/diffusers/v0.43.0/en", | |
| assets: "/docs/diffusers/v0.43.0/en" | |
| }; | |
| const element = document.currentScript.parentElement; | |
| Promise.all([ | |
| import("/docs/diffusers/v0.43.0/en/_app/immutable/entry/start.1gaXe03k.js"), | |
| import("/docs/diffusers/v0.43.0/en/_app/immutable/entry/app.BwdYRbCn.js") | |
| ]).then(([kit, app]) => { | |
| kit.start(app, element, { | |
| node_ids: [0, 304], | |
| data: [null,null], | |
| form: null, | |
| error: null | |
| }); | |
| }); | |
| } | |
| </script> | |
Xet Storage Details
- Size:
- 127 kB
- Xet hash:
- 61eede4518e5169a8cc0a8dd3845c7212a6768e12d64670da10dcc52c8c51a8c
·
Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.