Teknolojiler
Neyle yapıldı, neden öyle
Her büyük seçim bir mimari karar kaydında (ADR) neden ve alternatifleriyle yazılı. Aşağıda kısa hâlleri var.
01 · Yığın
| Alan | Seçim | ADR | Neden |
|---|---|---|---|
| Çekirdek dili | Python 3.12 | 0001 | Ağır işler zaten C/C++ motorlarında (llama.cpp, faster-whisper, Piper); Python onları birbirine bağlar. |
| Yerel LLM | Ollama | 0002 | HTTP üzerinden araç çağırabilen 3–4B model; Türkçesi iyi olan qwen2.5:3b varsayılan. |
| Modülerlik | Skill eklentileri | 0003 | Her yetenek modele araç olarak verilen bir skill; tetikleyiciler modeli atlar. |
| Kendini genişletme | Onaylı skill üretimi | 0004 | Çekirdek hiç değişmez; statik kontrol, yalıtılmış test, L4 onay, git ile sürüm. |
| Mobil | İnce Android istemci | 0005 | Telefon yalnızca arayüz; LAN'da TLS, QR ile eşleşmiş cihaz token'ı. |
| Depolama | SQLite | 0006 | Tek dosya; vektörler aynı veritabanında BLOB olarak, karşılaştırma Python'da. |
| Paketleme | PyInstaller + Inno Setup | 0007 | --onedir (onefile yavaş açılıyor); kullanıcı başına kurulum, yönetici izni yok. |
| Masaüstü | Tauri 2 + Svelte | 0008 | Yerel API'ye bağlanır, çekirdeği yan süreç olarak yönetir; küçük ve yerel. |
| Bulut istemcileri | anthropic SDK + httpx REST | 0009 | Claude'un düşünme ve effort özellikleri için resmi SDK; diğerleri için sade REST, OpenAI uyumlular tek sınıf. |
| Hafıza | embeddinggemma + SQLite | 0010 | 768 boyutlu çok dilli vektör, eşik 0,45, kelime eşleşmesine geri düşme. |
| Ses | VAD + Whisper + Piper | 0011 | Ek bağımlılıksız enerji VAD'ı; CPU'da hız ve doğruluk dengesi en iyi Whisper small; en anlaşılır Türkçe ses dfki. |
| Üretilen kod | Önce onay, sonra test | 0012 | Modelin yazdığı kodun hiçbir parçası onaydan önce çalışmaz; süreç içi katmanlar yalnızca ek önlem. |
| Yol arkadaşı | Olay tabanlı zihin | 0013 | Tek beyin süreci, öncelikli olay kuyruğu, 2 işçili el, sabit anayasa ve kişilik. |
- APIFastAPI · REST + WebSocket /v1/events
- AndroidKotlin · Jetpack Compose (Material 3) · OkHttp · kotlinx.serialization · ZXing · Android Keystore · minSdk 26
- Masaüstü köprüsüRust; yalnızca /v1/ yollarına izin verir, token web arayüzüne geçmez
- Gizli anahtarlarkeyring → Windows Kimlik Bilgisi Yöneticisi
- Konuşma tanımafaster-whisper; NVIDIA varsa turbo ve cuBLAS
03 · Repo
BigOne/ ├── core/bigone/ Python çekirdek: api, brain, llm, skills, memory, │ security, voice, mind, trust, evals, cli ├── core/bigone/skills/builtin/ 28 yerleşik skill ├── apps/desktop/ Tauri 2 + Svelte masaüstü uygulaması ├── apps/android/ Kotlin + Compose telefon uygulaması ├── docs/ kullanıcı ve teknik belgeler, diyagramlar, ADR'ler ├── installer/ PyInstaller spec, Inno Setup betiği ├── scripts/ kurulum dosyası, sürüm notları, ikonlar ├── tests/ pytest └── web/site/ bu site (Astro)
04 · Testler ve ölçüm
- Pythonpytest; 94 dosyada 1.200'ü aşkın test (2026-11-13 sayımı)
- Masaüstüvitest, svelte-check, cargo test
- Senaryolarbigone eval attention (35) ve bigone eval learner (15), gerçek modellerle
- CIher push ve pull request'te lint + test (GitHub Actions)
- İş akışıönce tasarım, sonra plan, testi önce yazılan kod, sonunda bağımsız inceleme
05 · Paketleme ve sürüm
- ÇekirdekPyInstaller --onedir, CUDA kütüphaneleri olmadan ~315 MB; bigone-core.exe ve bigone-sandbox.exe
- KurulumInno Setup, tek komut: python scripts/build_installer.py → BigOne-Setup-x.y.z.exe (~108 MB)
- Kurulum yeri%LOCALAPPDATA%\Programs\BigOne, yönetici izni yok; Windows ile başlama seçeneği
- Ollamayoksa sihirbaz açıklar ve indirme sayfasını açmayı önerir; BigOne onsuz yalnızca bulutla çalışır
- Kaldırma"verilerini de sil?" diye sorar, varsayılan Hayır
- SürümvX.Y.Z etiketi → GitHub Actions: lint + test → derleme → SHA256SUMS.txt → sürüm notları; 0.x sürümleri ön sürüm
- İmzayok (0.1.0 kararı); SmartScreen "bilinmeyen yayımcı" der
06 · Komut satırı
| bigone "…" | tek komut |
| bigone serve [--voice] | tek beyin, API ve zihin |
| bigone doctor | kurulum ve sağlayıcı kontrolü |
| bigone key set|list|remove | API anahtarları |
| bigone approvals · approve · reject | bekleyen onaylar |
| bigone audit · memory · notes | denetim kaydı, hafıza, gözlem notları |
| bigone skills · skill drafts|rollback|remove | skill yönetimi |
| bigone grant add · tasks · watches | yetkiler, görevler, takipler |
| bigone voice setup|status|test | ses modelleri |
| bigone pair · devices [revoke] | telefon eşleştirme |
| bigone eval attention|learner | senaryo ölçümleri |