Genel Bakış

Docker çoğu kullanıcı için tercih edilen kurulum yoludur, ancak yerel LibreChat geliştirmesi için npm kullanılmalıdır. Uygulamayı doğrudan makinenizde çalıştırmak daha hızlı geri bildirim, daha net hata ayıklama ve her değişiklikten sonra konteynerleri yeniden oluşturmaya gerek kalmadan monorepo çalışma alanlarına doğrudan erişim sağlar.

Önerilen Araç Zinciri

npm tabanlı geliştirme için bu araç zincirini kullanın:

Araç	Sürüm
Node.js	`v24.16.0`
npm	`v11.16.0`
MongoDB	Atlas veya Community Server

Node 24, LibreChat'in ESM-only paketlerle CommonJS birlikte çalışabilirliği, WebCrypto ve Fetch API için çalışma zamanı gereksinimlerini karşılar. Eğer terminaliniz hala daha eski bir Node sürümü bildiriyorsa, bağımlılıkları yüklemeden önce LibreChat deposundan nvm use 24.16.0 komutunu çalıştırın.

Doğru Çalışma Alanında Çalışın

LibreChat bir monorepo'dur. Değiştirdiğiniz davranışın sahibi olan en küçük çalışma alanını seçin:

Çalışma Alanı	Kullanım Amacı
`/packages/api`	Yeni backend TypeScript servisleri, denetleyicileri ve paylaşılan sunucu mantığı
`/api`	Eski Express sunucu entegrasyonu; değişiklikleri minimum düzeyde tutun
`/packages/data-schemas`	Veritabanı modelleri, şemaları ve veritabanına özgü paylaşılan mantık
`/packages/data-provider`	Paylaşılan API tipleri, endpoint'ler, sorgu anahtarları ve veri servisi fonksiyonları
`/client`	React uygulama kodu
`/packages/client`	Paylaşılan frontend yardımcı programları

Günlük Komutlar

Komut	Amaç
`npm run smart-reinstall`	Gerektiğinde bağımlılıkları yükler ve derlenmiş çalışma alanlarını oluşturur
`npm run reinstall`	Node/npm sürümlerini değiştirdikten sonra veya bağımlılık durumu şüpheli olduğunda temiz kurulum yapar
`npm run backend:dev`	Dosya izleme özelliğiyle arka ucu başlatır
`npm run frontend:dev`	`3090` numaralı bağlantı noktasında ön uç geliştirme sunucusunu başlatır
`npm run build:data-provider`	API/tür değişikliklerinden sonra paylaşılan data-provider kodunu yeniden derler
`npm run build`	Turborepo aracılığıyla tüm derlenmiş çalışma alanlarını oluşturur

Geliştirme Kaynakları

Depolar (repositories), çatallar (forks), dallar (branches) ve çekme istekleri (pull requests) konusunda yeniyseniz, GitHub'ın iş birliğine dayalı geliştirme kılavuzu ile başlayın.
Bir PR açmadan önce Katkıda Bulunanlar Kılavuzu'nu okuyun.
Tam yerel kurulum akışı için Contributor Setup bölümünü kullanın.
Çalışma alanı sınırları, içe aktarma sırası, tipleme, test etme ve frontend kuralları için Code Standards and Conventions kullanın.