Skip to content

Latest commit

 

History

History
210 lines (145 loc) · 14.1 KB

product_strategy-tr.md

File metadata and controls

210 lines (145 loc) · 14.1 KB

ForgeLM Ürün Stratejisi

Son Güncelleme: 2026-04-25 Amaç: ForgeLM'in pazar konumunu, farklılaşmasını, hedef kullanıcılarını ve stratejik yönünü tanımlamak.


Misyon

ForgeLM, LLM ince ayarını (fine-tuning) güvenli, denetlenebilir ve tekrarlanabilir kılar — config-tabanlı, CI/CD-uyumlu, her ortamda çalışır.


Üç Temel Sütun

1. Güvenlik Önce (Safety-First)

İnce ayar, bir modelin güvenlik özelliklerini — sessizce — bozabilir. ForgeLM, güvenlik değerlendirmesini sonradan eklenen isteğe bağlı bir özellik olarak değil, pipeline'ın birinci sınıf bir aşaması olarak ele alır.

  • Llama Guard 3 güvenlik değerlendirmesi eğitim pipeline'ının içinde çalışır; eğitim sonrası değil
  • 3 katmanlı güvenlik kapısı: ikili geçer/kalır + güven ağırlıklı skor + 14 zarar kategorisinde (S1-S14) önem analizi
  • Otomatik geri alma (auto-revert): güvenlik regresyonu tespit edilirse, çıktılar yazılmadan önce eğitim sonucu otomatik olarak reddedilir
  • Çalıştırmalar arası trend izleme: güvenlik skorları her çalıştırmada loglanır; zamanla oluşan kayan bozulma yakalanır
  • evaluation.auto_revert config alanı doğrudan YAML'a yazılır — bir güvenlik, benchmark ya da judge kapısı başarısız olduğunda çalışma eğitilmiş çıktıları silip 3 koduyla çıkabilir; CI'da kapıları uygulamak için özel script gerekmez

2. Uyumluluk Yerleşik (Compliance-Native)

AB Yapay Zekâ Yasası'nın Bölüm III, Kısım 1–3 hükümleri (Madde 6(5) hariç), Madde 6(2) / Ek III kapsamındaki yüksek riskli sistemlere 2 Aralık 2027'den, Madde 6(1) / Ek I kapsamındakilere 2 Ağustos 2028'den itibaren uygulanır ((AB) 2026/1744 sayılı Tüzük, Madde 1(40)(b)). Madde 2(2), Ek I, Kısım B mevzuatı kapsamındaki ürünlerle ilişkili Madde 6(1) sistemleri için ayrı ve sınırlı bir rejim belirler: Madde 6(1), 60a ve 102–112 uygulanır; Madde 57–59 ise yüksek riskli sistem gerekliliklerinin ilgili ürün mevzuatına dahil edildiği ölçüde uygulanır. Genel Bölüm III takvimi, tüm hükümlerinin bu Kısım B sistemlerine uygulanacağı anlamına gelmez. Diğer yükümlülükler ve geçiş hükümleri için ayrı tarihler geçerlidir. ForgeLM, uyumluluk incelemesini destekleyen dokümantasyon artefaktları üretir; bu artefaktlar hukuki uyumluluğu sağlamaz.

  • EU AI Act Madde 9-17 + Annex IV — her madde yapılandırılmış bir çıktı dosyasına karşılık gelir:
    • Mad. 9 Risk Değerlendirmesi → risk_assessment.json
    • Mad. 10 Veri Yönetişimi → data_governance_report.json
    • Mad. 11 Teknik Dokümantasyon → annex_iv_metadata.json
    • Mad. 12 Kayıt Tutma → audit_log.jsonl
    • Mad. 13 Şeffaflık → deployer_instructions.md
    • Mad. 14 İnsan Gözetimi → require_human_approval: true + çıkış kodu 4
    • Mad. 15 Doğruluk ve Sağlamlık → model_integrity.json + güvenlik değerlendirme sonuçları
  • Müdahaleye dayanıklı denetim günlüğü: SHA-256 zinciri — her kayıt bir öncekinin hash'ini içerir; silme veya değiştirme tespit edilebilir
  • İnsan onayı kapısı: Çıkış kodu 4, CI/CD orchestrator'larına "insan onayı bekleniyor" sinyali verir; nihai model final_model.staging/ dizinine iner — operatörler forgelm approve <run_id> ile promote eder (atomik rename → final_model/) veya forgelm reject <run_id> ile reddeder; her iki karar da denetim zincirine işlenir

3. Config-Tabanlı CI/CD

ForgeLM'in temel mimari kimliği: bir YAML dosyası bir eğitim çalışmasını eksiksiz tanımlar. İmperatif kod gerekmez, ortam değişkeni aranmaz, gizli çalışma durumu yok.

  • Tek YAML girer, ince ayarlı model + compliance kanıtları çıkar — deterministik ve sürüm kontrollü
  • Anlamlı çıkış kodları pipeline orkestrasyonu için: 0 (başarı), 1 (config/doğrulama hatası), 2 (eğitim hatası), 3 (değerlendirme/güvenlik hatası), 4 (insan onayı bekleniyor)
  • --dry-run: GPU tahsis etmeden config, veri ve model yüklemeyi tam olarak doğrular
  • Yapılandırılmış JSON çıktı: tüm değerlendirme ve compliance adımlarında aşağı akış sistemlerince parse edilebilir
  • Docker-native: GPU ve CPU için resmi çok aşamalı imajlar; çevrimdışı/izole (air-gapped) mod desteklenir
  • Git uyumlu: YAML config'ler temiz diff verir; compliance dosyaları düz JSON/Markdown

Hedef Kullanıcılar

Birincil: MLOps / Platform Mühendisleri

Profil: Otomatik eğitim pipeline'ları kurar ve yönetir; GitOps/CI ortamlarında çalışır; başsız (headless), deterministik yürütmeye ihtiyaç duyar.

ForgeLM'i neden seçerler: Anlamlı çıkış kodları doğrudan pipeline dallanma mantığına karşılık gelir. --dry-run, GPU kuyruğuna alınmadan config'i doğrular. Yapılandırılmış JSON çıktı, gözlemlenebilirlik platformlarıyla entegre olur. Webhook bildirimleri (Slack/Teams) mevcut olay yönetimi akışlarına bağlanır.

Temsili iş akışı: git push → GitHub Actions tetiklenir → forgelm --config job.yaml → çıkış kodu → dağıt veya alarm ver

İkincil: Düzenlemeye Tabi Sektörlerdeki ML Mühendisleri

Profil: Bankacılık, sağlık, savunma, kamu. Tescilli veriyi harici API'lere gönderemez. EU AI Act (AB), KVKK/BDDK (Türkiye), HIPAA (ABD) veya eşdeğer düzenlemelere tabidir. Tam denetim izleriyle şirket içi veya izole ortamda çalışmayı gerektirir.

ForgeLM'i neden seçerler: Tam EU AI Act compliance kanıt paketini otomatik üreten tek ince ayar aracı. Şirket içi Docker dağıtımı. trust_remote_code: false varsayılan. İnsan onayı kapısı (çıkış kodu 4) üretim dağıtımını erteler; nihai model final_model.staging/ dizinine iner; operatörler promote için forgelm approve <run_id>, reddetmek içinse forgelm reject <run_id> çalıştırır. SHA-256 zinciriyle denetim günlüğü kayıt tutma gereksinimlerini karşılar.

Üçüncül: Bağımsız Araştırmacılar ve Geliştiriciler

Profil: Derin altyapı bilgisi olmadan model ince ayarı yapmak ister; SFT/DPO/GRPO ile deney yapıyor; sağlam varsayılanlara ihtiyaç duyar.

ForgeLM'i neden seçerler: Sihirbaz modu (forgelm wizard) yapılandırmayı etkileşimli olarak yönlendirir. Quickstart şablonları (Faz 10.5) en yaygın ince ayar senaryoları için hazır config'ler sunar. Config-tabanlı yaklaşım, çalışmaları tekrarlanabilir ve paylaşılabilir yapar. Tek araçta 6 trainer yöntemi (SFT/DPO/SimPO/KTO/ORPO/GRPO).


ForgeLM Ne DEĞİLDİR

Açıkça kapsam dışı — şimdi ve uzun vadede:

  • GUI veya web uygulaması değildir. Arayüz config dosyalarıdır. Web arayüzü isteyen kullanıcılar LLaMA-Factory veya AutoTrain kullanmalıdır. Pro CLI ücretli kullanıcılar için bir dashboard ekleyecek; açık kaynak çekirdek başsız kalır.
  • Bulut altyapı sağlayıcısı değildir. ForgeLM model eğitir — compute sağlamaz, yönetmez, faturalandırmaz. Kullanıcılar kendi GPU'larını getirir (şirket içi, RunPod, Lambda Labs, AWS vb.).
  • Model sunum veya inference platformu değildir. ForgeLM eğitilmiş adaptörler ve compliance kanıtları üretir. Dağıtım kullanıcının sorumluluğundadır; vLLM, Ollama, TGI veya llama.cpp'ye devredilir.
  • Genel ML çerçevesi değildir. Yalnızca LLM ince ayarı. Bilgisayarlı görü, klasik ML veya sıfırdan ön-eğitim (pretraining) değil.
  • Özel inference motoru değildir. Özel CUDA kernel'i veya özel quantization uygulaması yoktur. ForgeLM bu işleri bitsandbytes/AWQ/GPTQ/HQQ ve mevcut runtime'lara devreder.

Rekabet Konumu

Boyut ForgeLM LLaMA-Factory Unsloth Axolotl
Güvenlik değerlendirmesi (entegre) ✅ Llama Guard S1-S14 ❌ ❌ ❌
EU AI Act uyumluluğu ✅ Mad. 9-17 + Annex IV ❌ ❌ ❌
CI/CD-native çıkış kodları ✅ 0/1/2/3/4/5/6 Kısmi ❌ Kısmi
Web UI ❌ (kasıtlı) ✅ ✅ Studio ❌
Hız optimizasyonu Standart Standart ✅ 2-5x Standart
Config-tabanlı YAML ✅ Tam Kısmi ❌ ✅
Çok GPU ✅ DeepSpeed/FSDP ✅ ❌ ✅
Trainer yöntemleri ✅ 6 (SFT/DPO/SimPO/KTO/ORPO/GRPO) ✅ Çok Kısmi Kısmi
Regresyonda otomatik geri alma ✅ ❌ ❌ ❌
SHA-256 denetim zinciri ✅ ❌ ❌ ❌

Net konum: ForgeLM ham hızda (Unsloth) ve model çeşitliliği/GUI'da (LLaMA-Factory) geridedir. Bunlar bilinçli takaslardır. Güvenlik + uyumluluk ekseninde ForgeLM kategoriksel olarak öndedir — kademeli değil, bunu sistematik biçimde yapan tek araç olma anlamında.


Stratejik Kararlar

1. Birincil Farklılaştırıcı: Güvenlik ve Uyumluluk

Karar tarihi: 2026-03-23

Güvenlik değerlendirmesi ve compliance kanıt üretimi isteğe bağlı özellikler değildir — hedef pazar için temel değer önerisidir. ForgeLM hız veya model çeşitliliğiyle rekabet etmez; güvenilirlik ve denetlenebilirlikle rekabet eder.

Çıkarım: Her yeni büyük özellik, bu konumu güçlendirip güçlendirmediği perspektifinden değerlendirilir. Güvenlik/uyumluluk derinliğini artırmayan hız özellikleri daha düşük önceliğe sahiptir.

2. Her Zaman Config-Tabanlı — Çekirdekte Web UI Yok

Karar türü: Kalıcı mimari seçim

Config-tabanlı kimlik ForgeLM'i CI/CD-uyumlu, Git-dostu ve tekrarlanabilir kılar. Web UI, başsız pipeline-önce modeliyle bağdaşmayan durum yönetimi, kimlik doğrulama ve çok kullanıcılı oturum mantığı gerektirir. Pro CLI ücretli kullanıcılar için dashboard ekleyecek; OSS çekirdek başsız kalır.

3. İsteğe Bağlı Bağımlılıklar Extras Olarak

Ağır bağımlılıklar pyproject.toml'daki [project.optional-dependencies] altında tanımlanır: qlora, unsloth, eval, tracking, distributed, merging. Eksik olduklarında sessizce None döndürmek yerine açık yükleme ipucu içeren ImportError fırlatılır.

Gerekçe: Temel kurulum saniyeler içinde tamamlanabilir olmalıdır. Bağımlılık çakışmaları, ML araçlarında katılımı engelleyen en yaygın sorundur. İsteğe bağlı extras, kullanıcıların yalnızca ihtiyaç duydukları şeyi kurmalarına olanak tanır.

4. Özelliklerden Önce Güvenilirlik

Faz 2.5 (güvenilirlik sağlamlaştırma) yeni özellik geliştirmesinden önce eklendi — ve bu model tekrarlanır. Her yeni büyük yetenek, merge edilmeden önce testler, dokümantasyon ve CI kapsamıyla birlikte gelir. "Testleri sonra eklerim" = PR hazır değil.

Çıkarım: ForgeLM çeyrek başına rakiplere göre daha az özellik sunar; ancak her özellik üretime hazır güvenilirlikle gelir. Bu tradeoff, düzenlemeye tabi sektör hedef pazarı için doğrudur.

5. EU AI Act Uyumluluğu Zaman Baskılı Hendek

EU AI Act'in uygulanabilirliği yükümlülüğe ve sisteme göre değerlendirilmelidir. Yüksek riskli sistemlere ilişkin Bölüm III tarihleri Ek III için 2 Aralık 2027, Ek I için 2 Ağustos 2028'dir; (AB) 2026/1744 sayılı Tüzük, Madde 1(40)(b) kapsamı ve istisnaları belirler. Madde 50'deki şeffaflık yükümlülükleri genel olarak 2 Ağustos 2026'dan itibaren uygulanır; Madde 111(4), 2 Ağustos 2026'dan önce piyasaya arz edilmiş, sentetik ses, görüntü, video veya metin üreten sistemlerin (genel amaçlı YZ sistemleri dahil) sağlayıcılarına Madde 50(2)'ye uyum için 2 Aralık 2026'ya kadar süre tanır; bu hükmün istisnaları saklıdır. Madde 2(2)'nin Ek I, Kısım B için belirlediği ayrı kapsam kuralı da geçerlidir. Tüm hükümlerin uygulanmaya başladığı tek bir tarih yoktur.

Çıkarım: Enterprise outreach hemen başlamalıdır, Phase 10+ tamamlanana kadar beklenemez. Compliance hendeği gerçek ama geçicidir; rakipler yürürlükten 6-12 ay içinde yanıt verecektir.


Başarı Metrikleri

Kısa Vade (Ekim 2026'ya kadar — 6 ay)

  • EU AI Act'in güncel uygulama takvimini hedeflenen dağıtıma göre değerlendirin
  • v0.4.0 (Post-Training Completion — inference handoff, chat, export) yayınlandı
  • v0.4.5 (Quickstart Katmanı — şablonlar, sihirbaz iyileştirmeleri) yayınlandı
  • 1.000+ GitHub yıldızı
  • İlk enterprise pilot sözleşmesi imzalandı (bankacılık, sağlık veya kamu sektörü)
  • YouTube Academy 5+ videoyla başlatıldı

Orta Vade (Nisan 2027'ye kadar — 12 ay)

  • 5.000+ GitHub yıldızı
  • 3+ enterprise destek sözleşmesi (Silver/Gold/Platinum katmanı)
  • $50.000–$150.000 ARR
  • ForgeLM Cloud MVP özel beta'da
  • Ücretli kullanıcılara Pro CLI alpha sunuldu
  • 3-5 aktif harici contributor

Uzun Vade (Nisan 2028'e kadar — 24 ay)

  • Güvenli, uyumlu LLM ince ayarı için standart açık kaynak araç olarak tanınma
  • 15.000+ GitHub yıldızı
  • $500.000+ ARR
  • Çok bölgeli ForgeLM Cloud genel kullanıma açıldı
  • 50+ topluluk quickstart şablonu
  • Enterprise compliance platformlarından (OneTrust, ServiceNow AI Control Tower, SAS) potansiyel satın alma ilgisi

Dokümantasyon Haritası

Belge Amaç
README.md Proje genel bakışı ve hızlı başlangıç
CONTRIBUTING.md Katkı rehberi
Yol Haritası Faz bazlı yürütme planı
Ürün Stratejisi Pazar konumu ve stratejik yön (bu belge)
Mimari Sistem tasarımı ve bileşen detayları
Yapılandırma Rehberi YAML parametre referansı
Kullanım Rehberi Eğitim nasıl çalıştırılır
Veri Hazırlama Veri seti format gereksinimleri
Standartlar Dizini Mühendislik standartları ve kurallar
Sihirbaz Modu Tasarımı Etkileşimli yapılandırma sihirbazı tasarımı
Blackwell Tasarımı GB10/Blackwell optimizasyon tasarımı

Tüm belgeler İngilizce (*.md) ve Türkçe (*-tr.md) olarak mevcuttur.