mirror of
https://github.com/numexai/numex_nedir.git
synced 2026-09-25 13:32:23 +00:00
81 lines
2.9 KiB
Markdown
81 lines
2.9 KiB
Markdown
|
# 🏗️ Numex Mimarisi
|
|||
|
|
|
|||
|
|
## Katmanlar
|
|||
|
|
|
|||
|
|
```mermaid
|
|||
|
|
flowchart TB
|
|||
|
|
subgraph Istemciler[İstemciler]
|
|||
|
|
W[🌐 Web / PWA]
|
|||
|
|
CX[🧩 Codex Web · IDE · VS Code]
|
|||
|
|
CLI[⌨️ CLI]
|
|||
|
|
SDK[🧰 SDK / API istemcileri]
|
|||
|
|
OK[🎓 Okul]
|
|||
|
|
HUB[📦 Hub]
|
|||
|
|
end
|
|||
|
|
subgraph Sunucu[Numex Sunucu Katmanı · Türkiye]
|
|||
|
|
AUTH[🔐 OAuth · JWT · API anahtarları · cihaz kodu]
|
|||
|
|
ROUTER[🧭 Router · plan ve profil seçimi]
|
|||
|
|
PIPE[⚡ Pipeline · Boru 1 → Motor → Boru 2A → Boru 2B]
|
|||
|
|
DET[🕵️ Detective Mode™]
|
|||
|
|
MA[🤖 Multi-Agent Orkestratör]
|
|||
|
|
DV[🔬 DeepView™]
|
|||
|
|
TOOLS[🧰 Araçlar · web arama · kod çalıştırma · belge · vision · görsel · embedding]
|
|||
|
|
end
|
|||
|
|
subgraph Core[🏛️ Numex Core · istemci tarafı ajan motoru]
|
|||
|
|
SW[Swarm Council]
|
|||
|
|
FG[FinishGate]
|
|||
|
|
SH[Self-Healing]
|
|||
|
|
MEM[Self-Evolving Memory · .numex/]
|
|||
|
|
INF[3 katmanlı çıkarım · ONNX WASM → Ollama → Bulut]
|
|||
|
|
end
|
|||
|
|
subgraph Veri[Veri & Git]
|
|||
|
|
DB[(MongoDB)]
|
|||
|
|
FORGE[(🏗️ Forge · Gitea)]
|
|||
|
|
end
|
|||
|
|
subgraph Saglayici[Model sağlayıcıları]
|
|||
|
|
LLM[Google Cloud · Azure · Anthropic · Meta · DeepSeek]
|
|||
|
|
end
|
|||
|
|
|
|||
|
|
W & SDK & OK & HUB --> AUTH --> ROUTER
|
|||
|
|
CX & CLI --> Core
|
|||
|
|
Core --> ROUTER
|
|||
|
|
ROUTER --> PIPE --> LLM
|
|||
|
|
PIPE --> DET & MA
|
|||
|
|
MA --> DV
|
|||
|
|
ROUTER --> TOOLS
|
|||
|
|
ROUTER --> DB
|
|||
|
|
HUB --> FORGE
|
|||
|
|
CX --> FORGE
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Bir isteğin yolculuğu
|
|||
|
|
|
|||
|
|
1. **Kimlik:** OAuth oturumu, JWT veya `nx_live_` API anahtarı doğrulanır.
|
|||
|
|
2. **Router:** Kullanıcının planı ve seçtiği profil (Pro/Fast/Vision/Code) tespit edilir; istek uygun
|
|||
|
|
işlem hattına yönlendirilir.
|
|||
|
|
3. **Boru 1:** Prompt güçlendirme, bağlam ekleme, uzman talimatları; `@karakter` varsa profil yüklenir.
|
|||
|
|
4. **Mod tespiti:** Kritik soru → **Detective Mode**; çok alanlı soru / 2+ `@uzman` → **DeepView /
|
|||
|
|
Multi-Agent**; araç gerekiyorsa (web, kod, belge) → **araçlar**.
|
|||
|
|
5. **AI Motor:** İş ortağı model(ler) yanıt üretir.
|
|||
|
|
6. **Boru 2A:** Türkçe düzeltme, format, ton.
|
|||
|
|
7. **Boru 2B:** Kalite kontrol ve doğrulama.
|
|||
|
|
8. **Yanıt:** Akışlı (stream) olarak istemciye; sohbet geçmişi saklanır.
|
|||
|
|
|
|||
|
|
## Ajan tarafı (Core)
|
|||
|
|
|
|||
|
|
Codex ve CLI'de ajan **kullanıcının bilgisayarında** çalışır: dosyaları okur/yazar, komut çalıştırır,
|
|||
|
|
testleri koşar. Sunucudan yalnızca model çağrısı alır. Plan → onay → uygula → **FinishGate kanıtı**
|
|||
|
|
→ hafızaya kaydet döngüsü izlenir. Proje hafızası `.numex/` klasöründe açık dosyalar olarak durur.
|
|||
|
|
|
|||
|
|
## Teknoloji yığını
|
|||
|
|
|
|||
|
|
| Katman | Teknoloji |
|
|||
|
|
|---|---|
|
|||
|
|
| Sunucu | Node.js, Express, MongoDB, Redis, JWT, Passport (Google/GitHub OAuth) |
|
|||
|
|
| Barındırma | Vercel (fra1) + Türkiye'de çift sunucu (2×256 GB RAM, SAS + NAS) |
|
|||
|
|
| Ödeme | İyzico |
|
|||
|
|
| Web arama | Serper |
|
|||
|
|
| Ajan motoru | `@numex-ai/core` — Node 22+, `node:sqlite`, ONNX WASM, Ollama, Playwright |
|
|||
|
|
| Editör | VS Code / VSCodium tabanlı Codex IDE; Monaco (Codex Web); tree-sitter |
|
|||
|
|
| Git | Gitea (Forge) |
|