Hub documentation

Spaces'te Dash

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Spaces'te Dash

Dash Open Source ile, JavaScript gerektirmeden, saf Python kullanarak dizüstü bilgisayarınızda veri uygulamaları oluşturabilirsiniz.

Açık kaynakla bir örnek uygulama oluşturarak Dash ile tanışın. Dash uygulamanız departman veya şirket genelinde kullanım için hazır olduğunda Dash Enterprise ile ölçeklendirin. Ya da girişiminizi baştan Dash Enterprise ile başlatarak geliştirici verimliliği kazanımlarını ve Plotly ekibinin yerinde hızlandırmasını açığa çıkarın.

Spaces'te Dash'i Dağıt

Spaces'te Dash ile başlamak için aşağıdaki düğmeye tıklayın:

Bu işlem, Plotly’nin Dash Docker şablonunu kullanarak Space’inizin oluşturulmasını başlatacaktır. İşlem başarılı olursa, Dash şablon uygulamasına benzer bir uygulama görmelisiniz.

Dash uygulamanızı özelleştirme

Daha önce Dash ile hiç geliştirme yapmadıysanız, 20 dakikada Dash eğitimimizle başlamanızı öneririz.

Bir Dash Space oluşturduğunuzda, başlamanıza yardımcı olacak birkaç ana dosya alırsınız:

1. app.py

Bu, projenizin çekirdek mantığını tanımlayan ana uygulama dosyasıdır. Dash uygulamaları genellikle modüller olarak yapılandırılır ve isteğe bağlı olarak yerleşimi, geri çağrıları ve verileri layout.py gibi diğer dosyalara ayırabilirsiniz.

app.py dosyasının içinde şunu göreceksiniz:

  1. from dash import Dash, html Uygulamamızı tanımlamak için Dash nesnesini ve projemizi birleştirmek için yapı taşları sağlayan html kütüphanesini içe aktarıyoruz.

  2. app = Dash() Burada uygulamamızı tanımlıyoruz. Layout, server ve callbacks, app nesnesine bağlanır.

  3. server = app.server Burada, uygulamayı üretim ortamında çalıştırmak için kullanılan server değişkenimizi tanımlıyoruz.

  4. app.layout = Başlangıç uygulaması yerleşimi, Dash bileşenlerinden oluşan bir liste, tek bir Dash bileşeni veya bunlardan birini döndüren bir işlev olarak tanımlanır.

    app.layout, projenizdeki geri çağrılar ve diğer mantık tarafından tek sayfa uygulaması olarak güncellenecek olan başlangıç yerleşiminizdir.

  5. if __name__ == '__main__': app.run(debug=True) Projenizi yerel olarak python app.py ile çalıştırıyorsanız, app.run(...) çalıştırılır ve projeniz üzerinde çalışmak için sıcak yeniden yükleme, geri bildirim grafiği ve daha fazlası gibi özelliklere sahip bir geliştirme sunucusu başlatılır.

    Üretim ortamında, üretim sınıfı bir sunucu olan gunicorn'ı öneririz. Projenizi gunicorn ile çalıştırırken hata ayıklama özellikleri etkinleştirilmez, bu nedenle bu satıra asla ulaşılmaz.

2. Dockerfile

Dash uygulaması için Dockerfile, Dash'in az sayıda sistem bağımlılığı olması nedeniyle minimaldir. Temel gereksinimler şunlardır:

  • requirements.txt içinde listelenen bağımlılıkları ( uv kullanarak) yükler
  • Güvenlik için kök olmayan bir kullanıcı oluşturur
  • Uygulamayı gunicorn app:server --workers 4 kullanarak gunicorn ile çalıştırır

Uygulamanız ek sistem bağımlılıkları, izinler veya diğer CLI bayrakları gerektiriyorsa bu dosyayı değiştirmeniz gerekebilir.

3. requirements.txt

Space, requirements.txt dosyasında listelenen bağımlılıkları otomatik olarak yükler. Bu dosyada en azından dash ve gunicorn bulunmalıdır. Uygulamanızın gerektirdiği diğer tüm paketleri de eklemeniz gerekir.

Dash Space şablonu, ihtiyaçlarınıza göre genişletebileceğiniz temel bir kurulum sağlar.

Ek Kaynaklar ve Destek

Sorun Giderme

Sorunlarla karşılaşırsanız:

  1. Not defterinizin python app.py kullanarak yerel olarak uygulama modunda çalıştığından emin olun
  2. Gerekli tüm paketlerin requirements.txt içinde listelendiğinden emin olun
  3. Port yapılandırmasının eşleştiğini doğrulayın (7860, Spaces için varsayılandır)
  4. Space günlüklerinde herhangi bir Python hatası olup olmadığını kontrol edin

Daha fazla yardım için Plotly Topluluk Forumları'nı ziyaret edebilir veya bir sorun açabilirsiniz.

Update on GitHub