İçeriğe geç
Pazar, 15 Kasım 2026Yapay zekâ · sade Türkçe · denenmiş@yapaytu
YAPAYTU

WebGPT kurulumu: tarayıcıda yerel model nasıl çalıştırılır?

WebGPT kurulumu için gerekenleri öğren; model dosyalarını Git LFS ile indir, sunucuyu aç ve WebGPU hatalarını kontrol ederek tarayıcıda metin üretmeyi dene.

Yapay TU Editör · 5 dk okuma
WebGPT kurulumu ve hata çözümleri
Kısa cevap

WebGPT kurulumu için 0hq/WebGPT deposunu Git LFS ile indirip proje klasöründe yerel bir HTTP sunucusu başlatmalısın. WebGPU destekleyen tarayıcıda yerel adresi açarak örnek modeli yükleyebilir ve metin üretebilirsin. Bu proje, modelin tarayıcıda nasıl çalıştığını öğrenmeye yönelik bir uygulamadır.

WebGPT kurulumu arıyorsan önce indireceğin projeyi netleştir: buradaki adımlar GitHub'daki 0hq/WebGPT deposu için. Bu uygulama, bilgisayarındaki grafik işlemciyi tarayıcı üzerinden kullanarak örnek dil modelleriyle metin üretmeni sağlıyor. Kurulumun tamamlandığını anlamak için sayfanın açılmasıyla yetinmeyip model dosyalarının yüklendiğini ve metnin devamının üretildiğini kontrol etmelisin.

WebGPT nedir, ne için kullanılır?

WebGPT, HTML ve JavaScript ile yazılmış, dil modelinin tarayıcıda çalışabildiğini gösteren bir eğitim projesidir. WebGPU ise tarayıcının grafik işlemci üzerinde hesaplama yapmasını sağlayan arayüzdür.

Örneğin sayfadaki metin kutusuna bir hikâyenin başlangıcını yazıp modelin devamını üretmesini isteyebilirsin. Yazı tarihinde depoda Shakespeare metinleriyle hazırlanmış bir örnek model ve GPT-2 örneği bulunuyor. Modelin verdiğin metni nasıl sürdürdüğünü görmek için bunları kullanabilirsin; doğru bilgi veren bir araştırma asistanı beklentisiyle başlama.

Üretim sırasında model, verdiğin metnin sonuna yeni parçalar ekliyor. Arayüzde çıktı uzunluğunu token (modelin metni böldüğü parçalar) sayısıyla belirliyorsun. Token rehberindeki örnekler, bu sayının neden kelime sayısından farklı olduğunu anlamana yardımcı olur. Üretimin kodda nasıl ilerlediğini incelemek istersen model.js dosyasındaki generate işlevine bakabilirsin.

WebGPT kurulumu için neler gerekiyor?

Git, Git LFS, Python 3 ve WebGPU'ya erişebilen bir tarayıcıyla başlayabilirsin. Git proje dosyalarını indirir; Git LFS büyük dosyaları yönetmek için kullanılan eklentidir. Python'ı burada yalnızca proje klasörünü tarayıcıya sunmak için kullanacaksın.

Önce terminalde araçların erişilebilir olduğunu kontrol et:

bash
git --version
git lfs version
python3 --version

git lfs tanınmıyorsa Git LFS'nin resmi sayfasından işletim sistemine uygun kurulumu tamamla. Windows'ta Python komutu py olarak çalışıyorsa sonraki sunucu komutunda python3 yerine py kullanabilirsin. Komut bulunamıyorsa ilgili aracın kurulumunu tamamlayıp terminali yeniden aç.

Tarayıcı tarafında Chrome'un resmi WebGPU sorun giderme belgesini esas al. Depodaki README eski Chrome sürümlerinden ve Canary'den söz ediyor. Cihazındaki desteği chrome://gpu sayfasından kontrol et; burada WebGPU'nun donanım hızlandırmasıyla çalışıp çalışmadığını görebilirsin. Destek kontrolünden geçmeden büyük model dosyalarını indirmeyi ertele.

WebGPT nasıl indirilir ve başlatılır?

Depoyu klonla, Git LFS dosyalarını indir ve index.html dosyasının bulunduğu klasörde yerel sunucuyu başlat. Terminali projeyi saklamak istediğin klasörde açıp şu sırayla ilerle:

bash
git lfs install
git clone https://github.com/0hq/WebGPT.git
cd WebGPT
git lfs pull
python3 -m http.server 8000 --bind 127.0.0.1

Sunucu çalışırken terminali açık bırak ve tarayıcıda http://localhost:8000 adresine git. Sayfada WebGPU GPT Model Demo başlığını görmelisin. Python belgesine göre sunucu varsayılan olarak bulunduğun klasördeki dosyaları sunar; --bind 127.0.0.1 seçeneği dinlemeyi yerel adresle sınırlar. İşin bittiğinde terminalde Ctrl+C ile sunucuyu durdurabilirsin.

Git LFS pull belgesi, bu komutun gerekli büyük dosyaları indirip çalışma klasörüne yerleştirdiğini açıklıyor. WebGPT'de bu adımı atlama: depodaki .bin ve .json dosyaları LFS ile izleniyor. Model dosyasının yerinde yalnızca dosyanın kimliğini tarif eden küçük bir metin kalmışsa uygulama onu model olarak okuyamaz.

GitHub'daki indirme seçeneklerini ilk kez kullanıyorsan ZIP ve Releases rehberine bakabilirsin. WebGPT için yukarıdaki Git LFS akışını takip et; elindeki arşivin model verilerini içerdiğini dosya uzantısından çıkaramazsın.

WebGPT ile ilk metin nasıl üretilir?

Önce Load Shakespeare Model düğmesiyle örnek modeli yükle, ardından Generate Text düğmesiyle metin üretimini başlat. Yazı tarihindeki arayüz kodunda düğmeler bu adlarla yer alıyor. Model yüklendiğinde prompt kutusuna örnek bir metin ve üretim ayarları geliyor.

İlk denemede hazır metni koruyup Number of tokens alanını 20 yapabilirsin. Bu, kısa bir kontrol için seçebileceğin örnek çıktı miktarıdır. Generate Text sonrasında kutudaki yazının uzayıp uzamadığına bak. Üretilen metni okuyabiliyorsan dosya yükleme ve üretim adımlarını geçmişsin demektir.

Sonraki denemede GPT-2 örneğini kullanmak istersen Destroy Cache düğmesine basıp Load GPT2 117M Model seçeneğini aç. Prompt kutusuna şu başlangıcı yazabilirsin:

text
The old library was empty when I opened the door.
On the table, I found a letter that began with these words:

Bu, bir metin tamamlama denemesidir; çıktıdaki olaylar kurgu olarak değerlendirilmelidir. Türkçe soru sorup beklentine uymayan bir cevap aldığında doğrudan kurulumun bozuk olduğu sonucuna varma. Yükleme hatasını, modelin ürettiği metnin niteliğinden ayrı incele. Arayüzdeki daha büyük model düğmeleri ayrıca indirme gerektirdiği belirtilen seçeneklerdir; ilk kontrol için onlara geçmen gerekmiyor.

WebGPT çalışmıyorsa neyi kontrol etmelisin?

Önce tarayıcının WebGPU erişimini, ardından dosya indirmelerini ve sunucunun doğru klasörden çalıştığını kontrol et. Geliştirici araçlarındaki Console sekmesi hata metnini, Network sekmesi ise dosya isteklerinin sonucunu gösterir.

Belirti Yapacağın kontrol
navigator.gpu bulunamıyor Sayfayı http://localhost:8000 üzerinden açtığını ve tarayıcının WebGPU desteklediğini kontrol et.
requestDevice çevresinde hata var chrome://settings/system içindeki grafik hızlandırma ayarına ve chrome://gpu bilgilerine bak.
params_gpt.json okunamıyor Dosyanın LFS işaretçisi olarak kalıp kalmadığını ve isteğin 404 dönüp dönmediğini incele.
Ana sayfa yerine klasör listesi açılıyor Sunucuyu index.html dosyasının bulunduğu WebGPT klasöründe yeniden başlat.
Address already in use hatası çıkıyor Sunucu komutunda 8000 yerine 8001 kullan; tarayıcı adresini de aynı porta göre değiştir.

Chrome belgesi, navigator.gpu erişimiyle kullanılabilir bir grafik işlemciye erişimin ayrı kontroller olduğunu açıklıyor. WebGPT'nin ana sayfasındaki destek mesajı ilkini kontrol ediyor; model kodu yükleme sırasında ayrıca grafik işlemciye erişmeye çalışıyor. Dolayısıyla destek mesajını görmek, modelin çalışacağına tek başına kanıt sayılmaz.

Dosya sorununda weights/better_shakespeare/params_gpt.json dosyasını bir metin düzenleyicide açabilirsin. Model ayarları yerine version https://git-lfs.github.com/spec/v1 ile başlayan birkaç satır varsa gerçek içerik henüz yerleşmemiştir. Proje klasöründe git lfs pull komutunu yeniden çalıştır ve indirme hatası veriyorsa önce o hatayı çöz.

Bizim yorumumuz

Bizce WebGPT'yi, tarayıcıda dil modeli çalıştırmayı merak eden bir öğrenci veya geliştirici için küçük bir öğrenme projesi olarak seçmelisin. İlk oturumda hazır modeli yükleyip tek bir metnin devamını üretmek yeterli bir hedef. Sonraki adımda model.js içindeki yükleme işlemini açarak tarayıcının hangi dosyaları istediğini izleyebilirsin. Böylece karşılaştığın hata mesajını kodda belirli bir işlemle eşleştirmeye başlarsın.

Kaynak koduyla model verisinin farklı biçimde indirilmesi, bizce ayrıca üzerinde durmaya değer. Örneğin HTML sayfası açılırken modelin yüklenmemesi durumunda tarayıcının dosya isteklerine bakabilirsin. Başarısız olan isteği bulup Git LFS çıktısıyla karşılaştır. Bu kontrol sırasını başka açık kaynak model projelerinde de bir başlangıç yöntemi olarak kullanabilirsin.

Amacın Türkçe ders notlarınla sohbet etmek veya günlük yazı işlerini yürütmekse bizce bu projeye ayıracağın süreyi sınırlamalısın. Bilgisayarda yerel yapay zekâ çalıştırma rehberimiz böyle bir kullanım için değerlendirebileceğin başka bir başlangıç sunuyor. WebGPT'ye devam edeceksen bir sonraki denemede yalnızca çıktı uzunluğunu değiştirip sonucu kaydetmeni öneririz. Modeli, başlangıç metnini ve ayarları aynı anda değiştirdiğinde hangi değişikliğin sonucu etkilediğini ayırmak zorlaşır. Her denemeye verdiğin promptu ve seçtiğin ayarı ekleyerek kendin için küçük bir çalışma kaydı tutabilirsin.

Kurulum adımları ve arayüz adları yazı tarihinde, 9 Kasım 2026'da WebGPT kaynak kodu, Git LFS, Python ve Chrome'un yukarıda bağlantıları verilen resmi belgelerinden kontrol edildi. Kullandığın kopyada farklı bir hata varsa konsoldaki tam mesajı ilgili projenin hata kayıtlarında ara.

Bu yazı sponsorlu değildir.

Sık sorulanlar

WebGPT kurulumu için API anahtarı gerekiyor mu?

Bu rehberdeki 0hq/WebGPT örneğinde API anahtarı girmen gerekmiyor. Model dosyaları indirildikten sonra hesaplama tarayıcının WebGPU bağlantısı üzerinden cihazında yapılıyor.

WebGPT neden model yüklemiyor?

Önce Git LFS dosyalarının gerçekten indiğini ve sunucuyu index.html dosyasının bulunduğu klasörde başlattığını kontrol et. Tarayıcı konsolunda WebGPU hatası varsa grafik hızlandırma ayarını ve chrome://gpu sayfasını incele.

WebGPT için Chrome Canary şart mı?

Canary kurmak tek başına bir gereklilik veya çözüm değil. Chrome'un resmi belgesine göre tarayıcı desteği, güvenli bağlam ve erişilebilir bir grafik işlemci gerekiyor; yerel denemeyi http://localhost üzerinden yapabilirsin.

WebGPT ile Türkçe sohbet edebilir miyim?

Depodaki örnekler Shakespeare metni ve GPT-2 üzerinden metin üretmeye yönelik. Bunları Türkçe sohbet asistanı kalitesi vaat eden modeller olarak değerlendirme; önce örnek İngilizce metnin devamını üretmeyi dene.

#webgpt#webgpu#yerel-yapay-zeka#github
E-bülten

Haftada bir e-posta. Sadece işe yarayanlar.

Haftanın en iyi yapay zekâ araçları ve yeni rehberler. İstediğin an tek tıkla çık.

Adresine bir onay e-postası gelir. Aydınlatma metni
Sıradaki yazı Open WebUI nedir? Kendine ait ChatGPT kurmanın en kolay yolu

Bunları da okuyun