## 💰 Üçüncü Taraf Ücretsiz Katmanlarda Ayda ~1,62B Token
> **Kendi sağlayıcı hesaplarınızı getirin.** Bu, OmniRoute'tan verilen bir token hibesi değil, ayrı ayrı uygun üçüncü taraf ücretsiz katmanlar genelinde tahmini bir toplamdır. Kaydolun, gerektiğinde kimlik bilgilerini alın ve kullanabildiğiniz sağlayıcıları bağlayın; her sağlayıcı kendi limitlerini, kullanılabilirliğini ve koşullarını kontrol eder.
>
> Ücretsiz katmanları elle üst üste yığmak zahmetlidir — düzinelerce SDK, düzinelerce hız limiti ve elinizde gerçekte ne kadar olduğuna dair hiçbir fikir yok. OmniRoute, **34 yinelenen havuz anahtarında 467 ücretsiz katman girişini** kataloglar ve token başlığını, **yayınlanmış pozitif aylık bütçeye sahip 17 havuz ile beş model başına Groq sınırından** hesaplar, paylaşılan havuz bazında yinelenenleri kaldırır. Yalnızca bölgesel kimlik doğrulamasından sonra açılan kotalar (bugün: ModelScope) ayrı olarak gösterilir, bölgesel kimlik doğrulamasının arkasında +~6M yer alır ve başlığa asla eklenmez. Sonuç panoda görünür kalır (`/dashboard/free-tiers`).
> Canlı `/dashboard/free-tiers` sayfasının animasyonlu özeti. Tam metodoloji (havuz yinelenmesinin giderilmesi, kredi katmanları, sağlayıcı koşulları): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Bu rakamlar iki haftada bir canlı katalogla yeniden denetlenir ve **iki yöne de hareket eder** — bir sağlayıcı ücretsiz katmanı sonlandırır ve sayı düşer; yeni biri gelir ve sayı yükselir. Kataloğun gerçekte hesapladığını yayınlarız, asla yukarı yuvarlanmış en iyi durumu değil.
⭐ OMNIROUTE para tasarrufu yapmanıza ve işinizi kolaylaştırmanıza yardımcı olduysa depoya yıldız verin.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Topluluğa katılın
**👋 Bakımcıyı takip edin — yeni sağlayıcıları, sürümleri ve ipuçlarını ilk siz öğrenin:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Sorular, sağlayıcı ipuçları, yol haritası ve destek → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway Büyümeye Devam Ediyor
## 🆓 Kurun, bir sağlayıcı bağlayın, ardından tek bir uç nokta üzerinden yönlendirin
```bash
# Bir sağlayıcı bağladıktan sonra OmniRoute anahtarınızı Dashboard → Endpoints bölümünden kopyalayın:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` uygun bir rotaya ihtiyaç duyar. Yeni bir kurulumda uygun anahtarsız hedef bulunmayabilir ve anahtarsız bir sağlayıcı üçüncü taraf istemcileri reddedebilir. Kiro dahil `tos: avoid` olarak işaretlenmiş sağlayıcılar varsayılan olarak otomatik yönlendirmeden hariç tutulur; bir hesap bağlamak bu ayarı geçersiz kılmaz. Sağlayıcı seçmeden önce [Ücretsiz Katmanlar Kılavuzu](docs/getting-started/FREE-TIERS-GUIDE.md) sayfasına bakın.📦 **Python, Node.js, PHP ve cURL** için kopyala-yapıştır hızlı başlangıç betikleri → [`examples/quickstart/`](examples/quickstart/)
# 💥 Vaat
# 🤔 Neden OmniRoute?
## 🤝 Açık Kaynak Dostlarımız Tarafından Destekleniyor
> **Açık Kaynak Dostu olarak katılmak ister misiniz?** Bunlar, açık kaynağı destekleyen ve OmniRoute'un ilerlemesine yardımcı olan şirketlerdir — ve bize verdikleri her token'ın nereye gittiğini herkese açıkça belirtiyoruz. İletişime geçin: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Bu projeyi desteklediği için kurucu Açık Kaynak Dostumuz Kimi (Moonshot AI)'ye teşekkür ederiz! Kimi, açık ağırlıklı K2 ve K3 model ailelerinin arkasındaki yapay zeka laboratuvarıdır — Kimi K3, 1M token bağlam penceresi, yerel görüntü işleme ve sınır seviyesi kodlama yeteneklerini kapalı model fiyatlarının çok altında sunar ve Claude Code, Codex ve OmniRoute'un desteklediği her kodlama aracıyla kutudan çıktığı gibi çalışır.
Kimi'nin desteği neleri güçlendiriyor: Kimi'nin API kredileri, OmniRoute'un yapay zeka onaylı yayın hattını — her çekme isteğini yayınlanmadan önce inceleyen *Kimi K3 destekli birleştirme doğrulama* aşamasını — ve günlük özellik geliştirmeyi destekler. Birinci sınıf Kimi desteği her iki yolla da sağlanır: doğrudan Kimi API'si (kimi-k3) ve Kimi Code kodlama planı (OAuth ve API anahtarı). OmniRoute aynı zamanda Kimi'nin destek programındaki ilk Brezilya açık kaynak projesidir. %15 ek krediyle bir Kimi API anahtarı alın →
Cheaper Inference cheaperinference.com
Bu projeyi desteklediği için OmniRoute Açık Kaynak Dostu Cheaper Inference'a teşekkür ederiz! Cheaper Inference, 42 sınır modelini — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ve MiniMax — tek bir OpenAI uyumlu uç nokta arkasında yeniden satan, her isteği en ucuz uygun sağlayıcıya yönlendiren ve model üreticisinin liste fiyatının üzerinde asla ücret almayan, maliyet sıralamalı bir ağ geçididir.
OmniRoute'da birinci sınıf destek: Sohbet Tamamlamaları, yerel /v1/responses uç noktası, görüntü işleme, araç çağırma ve 3 görüntü modeli (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model> olarak erişilebilir). Bir API anahtarı alın →
aff=omniroute etiketli bağlantılar iş ortağı bağlantılarıdır. Projeyi sizin için ek maliyet olmadan finanse ederler. 🎟️ Satış Ortakları Promosyonu — sponsor olmadığımız sağlayıcılardan ücretsiz kayıt kuponları (genişletmek için tıklayın)Bu bölüm yalnızca yönlendirme/kupon kodları içindir. Sponsorlu ortaklıklar yukarıdaki **🤝 Açık Kaynak Dostlarımız Tarafından Destekleniyor** bölümünde yer almaktadır. OmniRoute'un burada listelenen sağlayıcılarla herhangi bir sponsorluğu veya ortaklığı yoktur — bunlar herkesin kullanabileceği herkese açık kuponlardır.
AgentRouter agentrouter.org
AgentRouter — satış ortağı kaydı · kayıtta 100$ ücretsiz kredi (ücretsiz sunucu, daha yüksek gecikme süresi bekleyin — test için en iyisi, üretim için değil). OmniRoute'da v3.8.50'den beri birinci sınıf destek: Sohbet Tamamlamaları, Anthropic uyumlu kablo formatı ve OpenAI uyumlu yol. Mevcut modeller arasında claude-opus-4-8, claude-opus-5, gpt-5.6-sol ve daha fazlası bulunur. 100$'ınızı alın →
⚠️ Satış ortağı bağlantısı — OmniRoute'un bu sağlayıcıyla herhangi bir sponsorluğu veya ortaklığı yoktur.
OmniRoute kullanıcılarına fayda sağlayan cömert bir ücretsiz kayıt kuponu sunan başka bir sağlayıcı biliyor musunuz? Bir sorun açın, buraya ekleyelim.
## 🎯 Kombolar — Amiral Gemisi
> **Kombo**, OmniRoute'un **otomatik olarak** yönlendirme yaptığı bir model zinciridir. Kota biterse, bir sağlayıcı arızalanırsa veya maliyetler yükselirse kombo, uygun durumdaki bir sonraki sağlıklı modele geçebilir. 🛡️
### ⚡ Sıfır yapılandırma — yalnızca `auto` kullanın
Kombo oluşturmanız gerekmez. Modelinizi `auto` (veya bir varyantı) olarak ayarlayın; OmniRoute, bağlı sağlayıcılarınızdan canlı olarak puanlanan sanal bir kombo oluşturur:
Model kimliği
Neyi optimize eder
auto
🎯 Dengeli varsayılan (LKGP — son iyi sağlayıcınıza bağlı kalır)
auto/coding
🧑💻 Kod üretimi için kalite öncelikli ağırlıklar
auto/fast
⚡ Önce en düşük gecikme
auto/cheap
💰 Önce token başına en ucuz seçenek
auto/subscription
🎟️ Yalnızca hâlihazırda ücretini ödediğiniz abonelik kotası — kapalı biçimde başarısız olur, asla faturalandırılabilir bir geri dönüş kullanmaz (kılavuz)
auto/thrifty
🪜 Önce plan kotası, ardından en ucuz ücretli seçeneklere her seferinde bir basamak — sıfırlandıktan sonra tekrar plana döner (kılavuz)
auto/offline
🔋 Önce en fazla kota / hız sınırı kapasitesi
auto/smart
🔭 Kalite önceliği + daha iyi modeller keşfetmek için %10 keşif
auto/lkgp
📌 Son bilinen iyi sağlayıcıya açıkça bağlı kalma
auto/chaos
🧪 Bir model paneline paralel dağıtım (sağlayıcı başına bir model, varsayılan olarak 5), tek bir yanıt döndürür; hata enjeksiyonu değil, panel modeli başına bir yukarı akış çağrısıdır
##
### 🔀 Ya da kendiniz oluşturun — 20 yönlendirme stratejisi
**20** stratejinin tamamı — her kombo adımında istediğiniz gibi karıştırıp eşleştirin:
#
Strateji
Ne yapar
1
priority
İlk hedef öncelikli sıralı liste — bir sonrakine geçmeden önce her birini tüketir 🥇
2
fill-first
Devam etmeden önce her hedefin kotasını tamamen doldurur
3
weighted
Hedef başına ağırlığa göre ağırlıklı rastgele seçim
4
round-robin
Hedefler arasında sırayla döngü kurar
5
p2c
İki seçenekten birini seçme gücüne dayalı rastgele yük dengeleme
6
least-used
Mevcut yükü en düşük olan hedefi seçer
7
random
Eşit olasılıklı rastgele seçim (yinelenenler kaldırılır)
8
strict-random
Tekrarları kaldırmadan rastgele seçim 🎲
9
cost-optimized
Canlı katalog fiyatlandırmasına göre istek başına $ maliyetini en aza indirir 💸
10
headroom
En fazla kalan kotaya sahip hedefi seçer
11
quota-weighted
Kotası tükenen hesapları atlar, ardından kalan kota ÷ devam eden yük oranına göre seçim yapar — mevcut konuşmalar aynı hedefe sabitlenmiş olarak kalır ⚖️
12
reset-window
Kota penceresi en kısa sürede sıfırlanacak hedefi tercih eder
13
reset-aware
Kota sıfırlama zamanına göre sıralar — önce kısa pencereler 📊
14
context-relay
Uzun konuşmalar için bağlamı hedefler arasında aktarır 🧠
15
context-optimized
Mevcut bağlam boyutuna en uygun hedefi seçer
16
cache-optimized
Yeniden kullanılabilir her istem önekini aynı hesaba sabitler — istem önbelleği isabetlerini en üst düzeye çıkarır 🎯
17
lkgp
Son Bilinen İyi Yol — son başarılı sağlayıcıya sabitler, ardından yedek olarak kurallara döner
18
auto
Her bağlantı genelinde 16 faktörlü canlı puanlama 🤖
19
fusion
Bir model paneline dağıtır + bir hakem tek bir yanıt sentezler 🧬
20
pipeline
Adımları zincirler — her hedefin çıktısı bir sonrakini besler 🔗
Auto-Combo motoru, her adayı **16 faktöre** göre puanlar (sağlık, kota, maliyet, gecikme, göreve uygunluk, kalite, oturum kullanılabilirliği…) — bkz. [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Dayanıklılık yerleşik olarak sunulur (3 bağımsız katman)
📖 [Auto-Combo Motoru](docs/routing/AUTO-COMBO.md) · [Dayanıklılık Kılavuzu](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute'u Farklı Kılan Nedir
📊 Tam metodoloji ve 9router, OpenRouter, CLIProxyAPI ile LiteLLM karşısındaki özellik bazında ayrıntılar → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 OmniRoute'u Destekleyin
OmniRoute, MIT lisanslıdır ve açık olarak sürdürülmektedir. Size zaman veya para tasarrufu sağlıyorsa, bağımsız kalmasını nasıl sağlayabileceğinizi buradan görebilirsiniz — size en uygun yöntemi seçin. Sponsorluk yönlendirme önceliğini asla etkilemez; sıralamayı değil, görünürlüğü sağlar.
⚠️ Her coini yalnızca gösterilen ağ üzerinden gönderin — yanlış ağda göndermek fonların kaybolmasına neden olabilir.
🐛 Bir hata mı buldunuz veya geri bildiriminiz mi var? Bir [Tartışma (Discussion)](https://github.com/diegosouzapw/OmniRoute/discussions) açın.
Geliştirici notları: Proje, geliştirici kolaylığı sağlamak amacıyla npm install/postinstall sırasında yerel bir .env dosyası oluşturabilir. Bu dosya kasıtlı olarak .gitignore aracılığıyla yoksayılır (bkz. .gitignore) ve kesinlikle commit edilmemelidir — yanlışlıkla commit edilirse, açığa çıkan sırları yenileyin ve dosyayı geçmişten kaldırın. Yerel ortam dosyalarını ve sırları yönetmeyle ilgili rehberlik için docs/DEVELOPER-ENVIRONMENT.md dosyasına bakın.
## 📡 OmniRoute Radar
Belgelenmiş, havuz bazında yinelenenleri ayıklanmış yukarıdaki katalogdan sunulan ana ücretsiz katman miktarı **~1,62 milyar token/ay** olarak devam etmektedir. Geçici sağlayıcı kayıt kredileri, ilk ayı ayrıca **~2,22 milyara** çıkarabilir. Radar, OmniRoute sürümleri arasında ücretsiz modellerin kullanılabilirliği hakkında daha güncel bilgiler isteyenler için isteğe bağlı, imzalı bir katalog katmanıdır; topluluk kataloğu ve mevcut tüm ücretsiz özellikler ücretsiz kalmaya devam eder.
Destekçiler, canlı kataloğa ve ek sağlayıcı fırsatlarına erişebilir. Bunun ayrı ve değişken üst sınırı, sağlayıcıların kullanılabilirliğine bağlı olarak **ayda en fazla yaklaşık 3 milyar token** düzeyindedir. Bu üst sınır garanti edilmez: sağlayıcılar kotaları, uygunluk koşullarını, modelleri veya bölgeleri istedikleri zaman değiştirebilir.
Radar isteğe bağlıdır ve yalnızca GET kullanır. OmniRoute istemcisi istemleri, trafiği, sağlayıcı yapılandırmasını, kullanım telemetrisini veya yerel duyuru kapatma durumunu yüklemez. Uygunluk koşulları ve güncel katalog hakkında bilgi edinmek için **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** adresini ziyaret edin.
## ✨ Yenilikler
> **v3.8.20 → v3.8.53** arasındaki son öne çıkanlar. Tüm geçmiş: [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ `quota-weighted` yönlendirme** — 20. combo stratejisi tükenmiş hesapları atlar, ardından kalanlar arasından kalan kota ÷ devam eden yük oranına göre seçim yapar ve mevcut konuşmaları sabit tutar. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Headless modu** — `omniroute serve --headless` (veya `OMNIROUTE_HEADLESS=1`) yalnızca `/v1/*` proxy motorunu çalıştırır; dashboard ve yalnızca dashboard'a özgü alt sistemler kapalıdır. → [Headless Mode](docs/guides/HEADLESS.md)
- **🔎 Model keşfi** — `/v1/models` yetenek, bağlam, tür ve metne göre filtreleme yapar; `POST /v1/models/query` ise aynı anahtar başına görünürlükle kısa, deterministik bir kısa liste döndürür. → [API Reference](docs/reference/API_REFERENCE.md)
- **🔑 Anahtar başına yönlendirme kontrolü** — bir API anahtarını `forcedModel` ile tek bir modele veya combo'ya sabitleyin; bir anahtarın modellerini ve combo'larını atomik olarak ekleyin veya kaldırın (`/api/keys/{id}/access`). → [API Reference](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Daha ayrıntılı PII kontrolleri** — tür bazında seçim, 20'ye kadar doğrulanmış özel maskeleme deseni ve tür bazında algılama sayaçları; maskelemenin kendisi opt-in olarak kalır. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 dil** — dashboard, doküman yansıları ve CLI; `npm run i18n:add-locale` tek komutla her yere bir dil ekler. → [i18n Guide](docs/guides/I18N.md)
- **🎛️ OmniConductor** — ajan filonuza gelen A2A delegasyonu, Agent Card üzerinde Conductor yetenekleri ve Faro bas-konuş sesli sohbeti içeren bir dashboard paneli. → [A2A Server](docs/frameworks/A2A-SERVER.md)
- **🛂 Uyarlanabilir kabul ve aşırı yük koruması** — ağır sohbet istekleri 503 dönmek yerine kuyruğa alınır; bağlantı başına atomik RPM kayan kiralar kullanılır. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Kanonik `/v1/models` sıralaması** — her sağlayıcı için sağlayıcıya göre gruplanmış tek bitişik blok (combo'lar önce sabitlenir), her katalog kaynağında kararlı. → [API Reference](docs/reference/API_REFERENCE.md)
- **🗜️ Sıkıştırma sağlamlaştırması** — varsayılan açık şişme koruması, DE / FR / JA + Çince (wényán) için Caveman paketleri, Gradle ve .NET için RTK filtreleri. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Dürüst sabit ücret maliyeti** — abonelik / kodlama planı sağlayıcıları maliyet analizlerinde **$0** gösterir; bütçe, kota ve yönlendirme tahmin etmeye devam eder. → [API Reference](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share yönlendirme** — paylaşılan bir hesabın kotasını havuzdaki anahtarlar arasında adil şekilde böler; boşta kalan dilimler ödünç verilecek şekilde iş-koruyucu çalışır. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Tek komutla CLI/ajan kurulumu** — 15 kayıtlı `setup-*` komutu; `omniroute run` 7 CLI'yi başlatır (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` etkileşimli sağlayıcı+model seçici ve bağlam başına favorilerle 11 hedefi destekler. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Uzak mod** — kapsamlı token'larla (`connect` / `contexts` / `tokens`) uzak bir OmniRoute'u yönetin + VPS kurulumları için bir `antigravity` OAuth yardımcısı. → [Remote Mode](docs/guides/REMOTE-MODE.md)
- **🧭 Daha akıllı otomatik yönlendirme** — `auto/:` combo'ları, **Fusion** (model paneli + hakem), görev farkındalıklı yönlendirme, istek başına model / mod / USD bütçesi geçersiz kılmaları. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Takılabilir sıkıştırma** — 12 birleştirilebilir motor + Compression Studios: LLMLingua-2, iki katmanlı Ultra, omniglyph, adım başına sadakat kapısı, GCF v3.2, sürükle-yeniden sırala düzenleyici. → [Compression](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Şeffaf MITM şifre çözme (TPROXY)** — proxy ortam değişkenlerini yok sayan CLI'leri yakalar; SNI başına CA + güven deposu yükleyicisi sunar. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Her yerde maliyet telemetrisi** — her uç noktada `X-OmniRoute-*` maliyet/kullanım başlıkları, cache-HIT tasarruf başlığı, anahtar başına USD harcama kotaları. → [API Reference](docs/reference/API_REFERENCE.md)
- **🧠 Kontrol sizde olan bellek** — varsayılan olarak kapalı, opt-in int8 vektör niceleme + tipli azalma, istek başına `x-omniroute-no-memory`. → [Memory](docs/frameworks/MEMORY.md)
- **🛡️ Güvenlik** — her LLM rotasında prompt enjeksiyonu koruması (red-team paketi), opt-in kimlik bilgisi maskeleme koruması (her iki yönde sızan API anahtarlarını/gizli değerleri redakte eder), ücretsiz DuckDuckGo son çare web araması ve dashboard için isteğe bağlı bir OIDC giriş kapısı (parola ile giriş her zaman kullanılabilir kalır). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ Yeni uç noktalar** — `/v1/ocr` (Mistral OCR) ve `/v1/audio/translations` (Whisper tarzı) medya yüzeyini tamamlıyor. → [API Reference](docs/reference/API_REFERENCE.md)
- **🎨 Görsel / video / ses üretimi** — medya için tek API: xAI Grok Imagine ve Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind ve ElevenLabs gibi konuşma sağlayıcıları. → [API Reference](docs/reference/API_REFERENCE.md)
- **🌍 Dağıtım ve operasyonlar** — ters proxy `basePath`, tarayıcı dili otomatik algılama, anahtar başına cihaz izleme, root'suz MITM güveni, zh-TW yerelleştirmesi. → [Environment](docs/reference/ENVIRONMENT.md)
- **🤝 Daha fazla sağlayıcı ve ajan** — bulut ajanları (Codex Cloud, Cursor, Devin, Jules), tarayıcı + OAuth girişli Grok Build (xAI), birinci sınıf Ollama kartı, Claude Opus 5 ve Sonnet 5, Kimi resmi ortaklığı (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… ve yenilenmiş **375 sağlayıcılı katalog**. → [Providers](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Yönlendirme şeffaflığı** — her yanıt, onu sunan stratejiyi/sağlayıcıyı/gecikmeyi belirten bir `X-OmniRoute-Decision` başlığı taşır; yeni `cache-optimized` combo stratejisi + Auto-Combo `cacheAffinity` faktörü, tekrarlanan istekleri önbelleğe alınmış öneki tutan bağlantıya geri yönlendirir ve salt okunur `/v1/auto-combo/{channel}/candidates` uç noktası bir `auto/*` kanalının canlı aday havuzunu ortaya koyar. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Yerel performans ve altyapı** — tek tıkla yerel Redis, Cloudflare Workers / Deno Deploy relay dağıtıcıları, denetimli gömülü hizmetler olarak Bifrost ve Mux. → [Gömülü Hizmetler](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Ayrıca kutuda** — eklenti çerçevesi + pazaryeri, Omni/Agent/GitHub beceri çerçeveleri, Obsidian kasası entegrasyonu (22 MCP aracı), OpenAI uyumlu Batch ve Files API'leri, anlamsal yanıt önbelleği, lider tablolarıyla oyunlaştırma, ACP ajan keşfi (15 yerleşik ajan), BigQuery'ye zamanlanmış günlük dışa aktarımı, `auto/chaos` paralel çok modelli fan-out, bir Telegram bot köprüsü, uygulama içi sürüm yöneticisi ve LMArena-ELO ücretsiz sağlayıcı sıralamaları. → [Belgeler](docs/README.md)
## 🤖 Uyumlu CLI'lar ve Kodlama Ajanları
> Tek bir yapılandırma — `http://localhost:20128/v1` — ile **tüm** yapay zekâ IDE'leri veya CLI'ları ücretsiz ve düşük maliyetli modellerde çalışır.
＋ ayrıca şunlarla da çalışır · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · OpenAI uyumlu tüm araçlar
📖 37 aracın tamamı için araç başına kurulum (27 CLI Code + 10 CLI Agent) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode eklentisi → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**Desteklenen herhangi bir CLI'ı OmniRoute üzerinden tek komutla başlatın** — hiçbir yapılandırma dosyası yazılmaz,
kimlik bilgileri işlem başına enjekte edilir, Qwen/Gemini ise tek kullanımlık, yalıtılmış bir ana dizin kullanır:
```bash
omniroute run claude --model openai/gpt-5.4 # Claude Code
omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI
omniroute run aider --model glm/glm-5.2 -- --message "reply OK"
omniroute run goose --model glm/glm-5.2
omniroute run opencode --model glm/glm-5.2 -- run "reply OK"
omniroute run qwen --model glm/glm-5.2 -- -p "reply OK"
omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK"
# Alternatif olarak sağlayıcı+modeli etkileşimli biçimde seçin ve aracın kendi yapılandırmasını yazın:
omniroute configure codex # ayrıca: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Her komut etkin uzak bağlama (`omniroute connect `) uyar; `--dry-run`,
çalıştırmadan tam ortam değişkenlerini/argümanları önizler ve `--api-key-env NAME`, gizli bilgileri
kabuk geçmişinizin dışında tutar. → [CLI Entegrasyonları](docs/guides/CLI-INTEGRATIONS.md)
> Kanonik sohbet, medya, arama, yerel, bulut ajanı ve sistem koleksiyonları genelinde **375 kayıtlı sağlayıcı**, bunların arasında **`hasFree: true` keşif meta verisini taşıyan 153 sağlayıcı** bulunuyor. Sohbet modeli kayıt defteri **239 sağlayıcı / 3.059 farklı sağlayıcı-model çifti / 1.475 ham model kimliği**ni kapsıyor; ayrı ücretsiz bütçe kataloğunda ise **467 model başına satır**, **34 yinelenen havuz** ve **51 yinelenen/anahtarsız sonsuza dek ücretsiz sağlayıcı** yer alıyor. Bunlar tasarım gereği farklı paydalardır; tanımlar ve havuz tekilleştirmeli hesaplamalar [Sağlayıcı Referansı](docs/reference/PROVIDER_REFERENCE.md) ve [Ücretsiz Katmanlar](docs/reference/FREE_TIERS.md) belgelerinde bulunur.
### 🏢 Tüm büyük laboratuvarlar — tek bir uç nokta üzerinden
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…ve 350+ daha fazlası — her simge, panonun sağlayıcı kataloğundan canlı olarak çözümlenir. 📖 [Sağlayıcı Referansı](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Sonsuza Dek Ücretsiz — $0, kart yok
OpenCode Zen DeepSeek V4, Nemotron 3 Token sınırı yok
Kilo Code Otomatik yönlendirici, Tencent Hy3 Sonsuza kadar ücretsiz
Requesty GPT-OSS 120B, Nemotron Sonsuza kadar ücretsiz
SiliconFlow DeepSeek V3.2 / R1 Ücretsiz katman
Z.AI GLM GLM-4.7 / 4.5-Flash Sonsuza kadar ücretsiz
Baidu ERNIE ERNIE 4.0 Sonsuza kadar ücretsiz
Qoder AI Qwen3-Max, Kimi-K2 Sınırsız ÜCRETSİZ
Pollinations GPT, Llama, Claude Anahtar gerekmez
Cloudflare AI 50+ model Günde 10K nöron
NVIDIA NIM GLM, MiniMax ~40 RPM ücretsiz
Cerebras GLM 4.7, GPT-OSS Tek seferlik 5$ kredi; kart gerekli
OpenRouter :ücretsiz modeller +$10 → daha yüksek RPM
📖 Tam makine tarafından okunabilir katalog → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ OmniRoute Nerede Çalışır — Her Yerde
> Aynı uygulama, sizin makineniz, sizin kurallarınız. Global npm kurulumundan Termux aracılığıyla **telefonunuza** kadar.
Platform
Kurulum
Öne Çıkanlar
📦 npm (global)
npm install -g omniroute
Tek komut, her işletim sistemi
🐳 Docker
docker run … diegosouzapw/omniroute
Çoklu mimari desteği: AMD64 + ARM64
🖥️ Masaüstü (Electron)
npm run electron:build
Yerel pencere + sistem tepsisi — Windows / macOS / Linux
🎩 Menü çubuğu (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
Sunucuyu denetler ve otomatik günceller — macOS
💪 ARM
yerel arm64
Raspberry Pi, ARM sunucuları, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
Telefonunuzda 7/24 çalışır, root gerektirmez
📲 PWA
"Ana Ekrana Ekle"
Tam ekran, çevrimdışı, tarayıcıdan kurulabilir
🧩 OpenCode eklentisi
@omniroute/opencode-provider
Yerel OpenCode entegrasyonu
🤖 VS Code Copilot Chat
OmniCopilot uzantısını kurun
Tüm OmniRoute modelleri yerel Copilot Chat seçicisinde — kararlı sürüm ve Insiders
### 🧩 Yeni: VS Code'un yerel Copilot Chat'i içinde OmniRoute
> Yeni bir kenar çubuğu veya sohbet arayüzü yok — OmniRoute'un sunduğu her model, doğrudan
> **zaten kullandığınız Copilot Chat model seçicisinde** görünür. VS Code 1.122 sürümünden itibaren sağlayıcı modelleri,
> GitHub oturumu veya Copilot aboneliği olmadan çalışır — ajan modu, araç çağırma ve görsel desteği
> ücretsizdir.
**[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** uzantısını kurun, uzantıyı
OmniRoute sunucunuza yönlendirin (varsayılan: `localhost:20128`), ardından Copilot Chat → model seçici
→ **Modelleri Yönet…** → **OmniRoute** yolunu izleyin.
Düzenleyicinin içinden: **Uzantılar** görünümünü açın, **"OmniRoute"** araması yapın ve **Kur** düğmesine tıklayın
— her iki mağazada da aynı şekilde çalışır. Kaynak kod, sorunlar ve yayımlama prosedürü
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) adresindedir.
📖 [VS Code Copilot Chat rehberi](docs/guides/VSCODE-COPILOT.md) — kurulum, seçicide gösterilenler, sekme içinde kontrol paneli, sorun giderme
### 🎩 Yeni: OmniRouteTray — menü çubuğunuzda yaşayan ağ geçidiniz
> `omniroute serve` her zaman açık olduğunda en iyi şekilde çalışır. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> bunu macOS için kurup unutabileceğiniz bir menü çubuğu uygulamasına dönüştürür: sunucuyu başlatır, yeniden
> başlatmalar boyunca çalışır durumda tutar, yerinde günceller ve canlı token bütçenizi tek tıklamayla erişilebilir kılar — **açık
> terminal penceresi bırakmanız veya `npm install -g omniroute` kurulumuyla uğraşmanız gerekmez.**
[Tauri v2](https://v2.tauri.app/) ile oluşturulmuştur (yuvarlama hatası kadar küçük bir Rust çekirdeği);
kendi imzalı Node 24 çalışma zamanıyla birlikte gelir ve uygulamaya ait bir OmniRoute kurulumunu yönetir, böylece global
`node`/`bun` kurulumunuzla asla çakışmaz. **Mevcut `~/.omniroute/` yapılandırmanızı ve veritabanınızı paylaşır** — yani bu,
zaten çalıştırdığınız aynı OmniRoute'tur, yalnızca şapka takmıştır. 🎩
Ne Yapar?
Nasıl?
🟢 Sunucuyu denetler
omniroute serve işlemini başlatır; zaten çalışan bir örneği çoğaltmak yerine onu devralır
📊 Canlı kullanımı bir bakışta gösterir
Sağlayıcı kota çubukları, sıfırlama geri sayımlarıyla Claude oturum/haftalık limitleri, 30 günlük maliyet dökümü
🔄 Yerinde otomatik günceller
Aşamalı kurulum, atomik geçiş, hata durumunda geri alma — her zaman en yeni sürümde
🚀 Oturum açıldığında başlar
Oturum açılışında isteğe bağlı başlatma; yalnızca sistem tepsisinde çalışır, dock simgesi yoktur
🩺 Tanılama ve günlükler
Tek tıklamayla tanılama ve sunucu günlüklerine erişim
```sh
brew install --cask zoispag/tap/omniroute-tray
```
İndirmeyi mi tercih ediyorsunuz? En son .dmg dosyasını
Sürümler sayfasından edinin. Kaynak kod, sorunlar ve derleme
belgeleri zoispag/omniroute-tray adresinde yer alır.
💛 @zoispag tarafından geliştirilen bir topluluk projesidir — resmi bir OmniRoute sürümü değildir.
> OmniRoute, sunucunun ötesinde **80'den fazla komuta** sahip **eksiksiz bir komut satırı kokpitidir**; ayrıca açık ajan protokolleri sayesinde bir yapay zekâ ajanı onu **kendi başına** yönetebilir.
### ⌨️ Gerçek bir CLI (yalnızca `start` değil)
```bash
omniroute # ağ geçidini + panoyu sunar (port 20128)
omniroute chat # etkileşimli TUI sohbet istemcisi (eğik çizgi komutları: /model /combo /skill /memory)
omniroute setup # rehberli ilk çalıştırma sihirbazı
omniroute doctor # sağlayıcıları, portları ve yerel bağımlılıkları tanılar
```
### 🛰️ Uzak mod — CLI'ı burada, OmniRoute'u bir VPS'te çalıştırın
OmniRoute bir sunucuda mı? **Aynı CLI** ile dizüstü bilgisayarınızdan yönetin. Kapsamlı bir erişim belirteciyle
bir kez oturum açın; ardından her komut uzak sunucuyu hedefler.
```bash
omniroute connect 192.168.0.15 # parola → kapsamlı belirteç, bağlam olarak kaydedilir
omniroute models # ← UZAK sunucu üzerinde çalışır
omniroute configure codex # ← uzak bir model seçer, yerel bir Codex profili yazar
omniroute tokens create --name ci --scope read # diğer makineler için daha dar kapsamlı belirteçler oluşturur
omniroute contexts use default # ← yerel sunucuya geri döner
```
Belirteçler `read` / `write` / `admin` olarak kapsamlandırılır; süreç başlatan rotalar yalnızca geri döngü arabiriminden erişilebilir kalır.
📖 [Uzak Mod](docs/guides/REMOTE-MODE.md)
### 🤝 Bir ajan bağlayın — OmniRoute'u kendisi yönetsin
OmniRoute'u **MCP**, **A2A**, bir **REST API**, **webhook'lar** veya bir **uzak CLI** üzerinden erişime açın — yetenekli herhangi bir ajan (veya kendi kodunuz) tüm ağ geçidinin anahtarlarına sahip olur: yönlendirme, sağlayıcılar, kombinasyonlar, önbellek, sıkıştırma, bellek — üstelik otonom olarak. Aşağıdaki HTTP uç noktaları `http://localhost:20128` altında sunulur.
Arayüz
Uç nokta / komut
Kullanım amacı
🧰 MCP (stdio)
omniroute --mcp
Claude Desktop, Cursor veya herhangi bir MCP istemcisine bağlayın
İstek / kota olaylarını Slack, Discord, Telegram veya herhangi bir URL'ye gönderin
🛰️ Uzak CLI
omniroute connect
Uzak bir örneği kapsamlı erişim belirteçleriyle yönetin
```bash
# Claude Code'a MCP üzerinden eksiksiz OmniRoute araç setini verin:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP Sunucusu](docs/frameworks/MCP-SERVER.md) · [A2A Sunucusu](docs/frameworks/A2A-SERVER.md) · [Ajan Protokolleri](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ %15–95 Token Tasarrufu — Otomatik
### 📖 Nasıl çalışır — işlem hattı, mimari ve tasarruf hesabı
Varsayılan katmanlı kombinasyon `RTK → Caveman` şeklinde çalışır. İkisi de aynı araç/bağlam yükü üzerinde etki ettiğinde tasarruf katlanır:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Kod blokları, URL'ler, JSON ve yapılandırılmış veriler **her zaman korunur** — koruma motoru tarafından.
> **Az token işi görürken neden çok token kullanasınız?** Her istek OmniRoute'un sıkıştırma işlem hattından **şeffaf biçimde** geçer — istemci tarafında hiçbir değişiklik gerekmez. Artık sırayla çalışan ve her yönlendirme kombinasyonuna göre karıştırılıp eşleştirilebilen **12 birleştirilebilir motordan oluşan bir yığın** söz konusu — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) ve [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) fikirleri üzerine inşa edilmiştir.
### 🧱 12 motorlu yığın
Motorlar işlem hattı sırasına göre çalışır; her biri bağımsız olarak açılıp kapatılabilir ve kombinasyon başına yapılandırılabilir:
#
Motor
Ne yapar
1
Session-Dedup
Turlar arasında tekrarlanan içeriği atar (içerik adresli, turlar arası)
2
CCR
Büyük blokları erişim işaretçileri arkasında arşivler, talep üzerine getirir
3
Lite
Boşluk + görsel URL'si kırpma (gecikme açısından hafif temel)
4
RTK
Akıllı araç sonucu filtreleme, tekilleştirme ve kısaltma (komut farkında)
5
Responses Tool Output
Shell/yama/arama/derleme çıktıları için önce kayıpsız JSON + sınırlı tanılama sıkıştırması (Responses API)
Son kullanıcı sorgusuna göre çıkarımcı cümle puanlama
8
Caveman
Kural tabanlı düz metin sıkıştırma (çıktıda ~%65–75)
9
Aggressive
Özetleme + eski turların aşamalı olarak eskimesi
10
LLMLingua-2
MobileBERT ONNX ile ML anlamsal budama — koda güvenli, asenkron
11
Ultra
İsteğe bağlı küçük model (SLM) katmanıyla sezgisel token budama
12
OmniGlyph
Doğrudan Anthropic hattında ölçülen Claude Fable 5 için deneysel bağlam-görsel kodlama; GPT 5.6 dönüştürücüleri sağlayıcı makbuzları beklenirken fail-closed kalır. Dört sıkıştırma profili (varsayılan olarak agresif, dengeli, kodlamaya güvenli, doğrudan geçiş) (en agresif; isteğe bağlı)
Kod blokları, URL'ler ve yapılandırılmış veriler **her zaman baytı baytına korunur**. **Tek tıkla hazır ayarlar** motorları birleştirir:
Mod
Tasarruf
En uygun olduğu durum
🪶 Lite
~%15
Her zaman açık güvenli varsayılan
🪨 Standart (Caveman)
~%30
Günlük kodlama
⚡ Aggressive
~%50
Uzun, araç yoğun oturumlar
🔥 Ultra
~%75
Maksimum tasarruf
🧰 RTK
%60–90
Shell/test/derleme/git çıktısı
🔗 Katmanlı (RTK → Caveman)
%78–95
Karma istemler + araç günlükleri
**Gerçek örnek — Standart mod:**
> **Önce (69 token):** _"React bileşeninizin yeniden render edilmesinin nedeni büyük olasılıkla her render döngüsünde yeni bir nesne referansı oluşturmanızdır. Bir nesneyi prop olarak satır içi geçirdiğinizde, React'in sığ karşılaştırması onu her seferinde farklı bir nesne olarak görür ve bu da yeniden render'ı tetikler. Nesneyi memoize etmek için useMemo kullanmanızı öneririm."_
>
> **Sonra (19 token):** _"Her render'da yeni nesne ref'i. Satır içi nesne prop = yeni ref = yeniden render. useMemo ile sar."_
>
> **Aynı yanıt. %72 daha az token. Sıfır doğruluk kaybı.** ✅
**PT-BR örneği — [Troglodita](https://github.com/leninejunior/troglodita) modu:**
> **Önce (42 token):** _"Sorun, her render döngüsünde yeni bir nesne referansı oluşturulduğu için bileşenin yeniden render edilmesidir. useMemo kullanmanızı öneririm."_
>
> **Sonra (12 token):** _"Yeniden render: her döngüde yeni ref (satır içi nesne yeniden oluşturuluyor). `useMemo` kullanın."_
>
> **Aynı yanıt. ~%70 daha az token. Teknik doğruluk korundu.** ✅
### 🎚️ Motorların ötesi — çıktı stilleri, uyarlanabilir ayar ve istek bazında kontrol
Yukarıdaki 12 motor, içeri **gireni** küçültür. Üç ek katman ise **nasıl**, **ne zaman** ve dışarı **ne çıktığını** şekillendirir:
- **🪄 Çıktı Stilleri** _(çıktı ekseni yönlendirmesi)_ — deterministik, önbellekle uyumlu yanıt şekillendirme talimatları ekler; birlikte kullanılabilir ve her biri `lite` / `full` / `ultra` yoğunluğundadır. Bir stil eklemek, kayıt defterine tek satırlık bir giriş yapmaktan ibarettir:
- **Özlü anlatım** — dolgu ifadelerini / tanımlıkları / ihtiyatlı ifadeleri kaldırır; teknik özü eksiksiz korur.
- **Daha az kod** — "tembel kıdemli geliştirici" YAGNI yaklaşımı: çalışan en küçük değişiklik, istenmeyen hiçbir iskelet yapı yok.
- **At kuyruğu (tembel kıdemli geliştirici)** — YAGNI merdiveninde ilerler, kök nedeni düzeltir, çalışan en küçük farkı oluşturur.
- **DEHB'im var (önce eylem)** — sıradaki eylem başta gelir, adımlar numaralandırılır, tek bir somut sonraki adım sunulur, giriş yapılmaz.
- **Özlü CJK (文言)** — klasik Çince, son derece özlü stil (yerel ayara göre yalnızca `zh` için etkinleştirilir).
- **🎯 Uyarlanabilir bağlam bütçesi** _(ayar)_ — tek bir açık/kapalı token eşiği yerine, modelin bağlam penceresine **sığdırmak** için yalnızca gerektiği kadar en ucuz ve en az kayıplı motorları kademeli olarak devreye alır. İlke: `reserve-output` (varsayılan, modelden haberdar) · `percentage` · `absolute`. Mod: `floor` (sığmayı garanti eder) · `replace-autotrigger` (açık seçiminiz önceliklidir) · `off` (eski eşik).
- **🎛️ Sıkıştırmaya nerede karar verilir** _(öncelik, yüksek → düşük)_ — istek bazında `x-omniroute-compression` başlığı › yönlendirme kombinasyonu geçersiz kılma ayarı › etkin adlandırılmış profil › uyarlanabilir / otomatik tetikleyici › panel varsayılanı › kapalı. Uygulanan plan, yanıtta `X-OmniRoute-Compression: ; source=` başlığıyla geri bildirilir.
Token eşiğine göre otomatik tetiklemeyi, uyarlanabilir ayarı, sabitlenmiş adlandırılmış bir profili, istek bazında tek seferlik bir ayarı veya her yönlendirme kombinasyonu için bir işlem hattını kullanın — iş yüküne hangisi uygunsa. İsteğe bağlı çevrimdışı **değerlendirme düzeneği** (`npm run eval:compression`), bir değişikliği kullanıma almadan önce sabitlenmiş bir derlem üzerinde doğruluk ile tasarruf arasındaki dengeyi puanlar.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Hızlı Başlangıç
**1) Kurun ve çalıştırın**
```bash
npm install -g omniroute
omniroute
```
> 💡 `npm warn ERESOLVE` veya eş bağımlılık uyarıları mı görüyorsunuz? [Bunlar zararsızdır](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **npm 11 veya sonraki bir sürümünü mü kullanıyorsunuz?** npm, izin verilmedikçe paket yaşam döngüsü betiklerini engelleyebilir. OmniRoute'un `postinstall` betiği (`node scripts/build/postinstall.mjs`), yerel çalışma zamanı dosyalarını hazırlamak için gereklidir. Genel kurulum sırasında npm uyarısında adı geçen paketlere izin verin. OmniRoute 3.8.53 tarafından bildirilen paket kümesi için:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Bu izin listesini gelecekteki genel kurulumlarda yeniden kullanmak için bir kez yapılandırın, ardından normal şekilde kurun:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Bağımlılık listesi sürümler arasında değişebilir; npm farklı bir liste bildirirse bu uyarıdaki paket adlarını kullanın. Bir pakete izin vermek, kurulum betiklerinin çalışmasına olanak tanır.
> **Gemini Web veya başka bir web çerezi sağlayıcısı mı kullanıyorsunuz?** npm paketi
> Playwright'ı içerir ancak Chromium ikili dosyasını içermez. İlk web sağlayıcısı isteğini yapmadan önce
> [Playwright Chromium kurulumu](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> notuna bakın.
Kontrol paneli: `http://localhost:20128` · API: `http://localhost:20128/v1`.
**2) Kendi hesabınızı kullanarak uygun bir sağlayıcı bağlayın**
Kontrol Paneli → **Sağlayıcılar** → mevcut koşulları ve kotası kullanım amacınıza uygun bir sağlayıcı seçin → API anahtarını ekleyin veya hesap akışını tamamlayın. Ücretsiz katmanlar kayıt, onay veya ödeme yöntemi gerektirebilir. [Ücretsiz Katmanlar Kılavuzu'nu](docs/getting-started/FREE-TIERS-GUIDE.md) inceleyin; anahtarsız kullanılabilirlik garanti edilmez ve `tos: avoid` olarak işaretlenmiş sağlayıcılar varsayılan olarak `auto` kapsamı dışında tutulur.
**3) Kodlama aracınızı yönlendirin**
```txt
Temel URL: http://localhost:20128/v1
API Anahtarı: [Kontrol Paneli → Uç Noktalar bölümünden kopyalayın]
Model: auto (uygun bağlantılar arasında yönlendirir — veya sağlayıcı/model seçin)
```
**4) Çalıştığını doğrulayın**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Bağlı modellerinizin listelendiğini görmelisiniz. 🎉 Hepsi bu — kodlamaya başlayın; OmniRoute sizin için otomatik yönlendirme ve geri dönüş işlemlerini gerçekleştirir.
İstemciniz özel başlıklar gönderemiyorsa OmniRoute, token içeren uyumluluk takma adları da sunar:
```txt
OpenAI kataloğu: http://localhost:20128/vscode/YOUR_KEY/
OpenAI modelleri: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI sohbeti: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI yanıtları: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama sohbeti: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama etiketleri: http://localhost:20128/vscode/YOUR_KEY/api/tags
```
Bunları yalnızca `Authorization: Bearer ...` ekleyemeyen istemciler için kullanın. Başlıkla kimlik doğrulama tercih edilen yöntem olmaya devam eder.
## 📦 Daha fazla kurulum yöntemi — Docker, kaynak kod, pnpm, Arch
**🐳 Docker**
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
`:latest` etiketi **yayımlanmış** en yüksek kararlı SemVer sürümünü takip eder. Git `main` dalını takip etmez. GitOps için `:X.Y.Z` sürümünü sabitleyin. Bkz. [Docker Sürüm Kanalları](docs/guides/DOCKER_GUIDE.md#release-channels). İmaj **`OMNIROUTE_MEMORY_MB=1024`** değerini sabitler. Bu, pano ve hafif bir sohbet için yeterlidir. **Kodlama ajanları** (Claude Code, Codex, Grok, vb.'den gelen `POST /v1/responses`), çok daha büyük bir V8 heap alanına ihtiyaç duyar; aksi takdirde iki örtüşen uzun bağlam altında süreç ~12 GiB seviyesinde `FATAL ERROR` verir. Konteyneri heap boyutunun üzerinde boyutlandırın (yerel arabellekler V8'in dışında yer alır):
| İş Yükü | Heap (`-e OMNIROUTE_MEMORY_MB`) | Konteyner (`--memory`) |
| ---------------------------------- | ------------------------------- | ---------------------- |
| Pano / hafif sohbet | `1024` (imaj varsayılanı) | ≥2 g |
| Tek bir kodlama ajanı | `8192` | ≥10 g |
| İki eşzamanlı uzun `/v1/responses` | `10240`–`12288` | ≥12–16 g |
```bash
docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \
-e OMNIROUTE_MEMORY_MB=8192 --memory=10g \
-p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest
```
Tam tablo: [Docker Kılavuzu — çalışma zamanı RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Ön sürüm Docker kanalı:** `diegosouzapw/omniroute:next` ve
> `diegosouzapw/omniroute:next-web` geçerli varsayılan `release/v*`
> dalını takip eder. Bu değişken etiketler yalnızca yayımlanmamış düzeltmeleri test etmek içindir ve
> **üretim ortamı için desteklenmez**. Bkz.
> [Docker Sürüm Kanalları](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
Standart `bun install` ve genel kurulum (`bun install -g omniroute`), Bun çalışma zamanı algılamasıyla desteklenir:
- **Yerleşik `bun:sqlite`**: OmniRoute, Bun altında çalışırken Bun'ın yerleşik `bun:sqlite` sürücüsünü kullanır; Node.js altında `better-sqlite3` veya `sql.js`'e geri döner.
- **Otomatik Webpack paketleyici seçimi**: Geliştirme (`bun run dev`) ve üretim derlemeleri (`bun run build`), Bun'ı otomatik olarak algılar ve yerel V8 bağlama uyumsuzluklarını önlemek için Turbopack yerine Webpack'i seçer.
- **Özel Bun Dockerfile**: Yerel Bun üretim dağıtımları için çok aşamalı `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# Bun ile kurun ve çalıştırın
bun install
bun run dev
```
**🛠️ Kaynak koddan**
```bash
cp .env.example .env && npm install
PORT=20128 npm run dev
```
**📦 pnpm**
```bash
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute
```
**🐧 Arch Linux (AUR)**
```bash
yay -S omniroute-bin && systemctl --user enable --now omniroute.service
```
**🔧 Nix (Flake)**
```bash
# Nix flakes kullanarak
nix develop
npm run dev
# Veya devbox kullanarak
devbox run npm run dev
```
📖 [Docker Kılavuzu](docs/guides/DOCKER_GUIDE.md) — Compose profilleri, Caddy HTTPS, Cloudflare tünelleri.
**🦭 Podman**
```bash
# 1. Bind-mount veri dizinini hazırlayın
mkdir -p data
# 2. Yalnızca Linux + yerel rootless Podman (asla uzak Podman Machine istemcisi değil):
podman unshare chown 1000:1000 ./data
# 3. Çalışma zamanı ipucunu ayarlayın, yerel Compose imajını derleyin ve başlatın
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
macOS veya Windows üzerinde Podman uzak bir Podman Machine kullanır: `podman unshare` adımını atlayın ve
[topolojiye özel veri dizini rehberini](contrib/podman/README.md#data-directory-permissions-by-topology) izleyin.
📖 [Podman Kılavuzu](contrib/podman/README.md) — Compose derlemeleri, Podman Machine ve
Linux/systemd Quadlet kurulumu.
**⚡ Daha hızlı / daha hafif kurulum (yerel derlemeyi atlayın)**
Yerel SQLite motoru (`better-sqlite3`) **isteğe bağlı** bir bağımlılıktır; bu nedenle genel bir
kurulum asla kaynak koddan derlemeyi beklemez: platformunuza/Node sürümünüze uygun önceden derlenmiş bir ikili dosya olduğunda onu kullanır, aksi takdirde şeffaf bir şekilde saf JS motoruna
(Node 22+ üzerinde `node:sqlite`, aksi halde paketlenmiş `sql.js` WASM) geri döner — derleme araçları gerekmez.
Kurulum sonrası yerel ısınmayı tamamen atlamak için (CI, headless veya yavaş makineler):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 de bunu atlar
```
En hızlı kurulumlar için **pnpm** tercih edin (içerik adresli depolama + hard linkler — yukarıya bakın).
Panosuz, headless bir çalışma zamanı için Docker `base` profilini (yukarıda) veya
[Termux kılavuzunu](docs/guides/TERMUX_GUIDE.md) kullanın. CLI ve web panosu aynı port üzerinde
aynı süreç tarafından sunulur, bu nedenle bugün için ayrı bir yalnızca CLI paketi bulunmamaktadır.
Node.js test çalıştırıcısı + Vitest — 7.800+ izlenen test dosyası genelinde 56.000+ statik test bildirimi (birim, entegrasyon, E2E, güvenlik, ekosistem)
Platformlar
Masaüstü (Electron) · Android (Termux) · PWA (herhangi bir tarayıcı)
CI/CD
GitHub Actions — sürümde otomatik npm yayını + Docker Hub
7,800+ izlenen test dosyasındaki 56,000+ statik test bildirimi için test kapsamı stratejisi
# ⭐ En Çok Katkıda Bulunanlar
> OmniRoute, tutkulu bir açık kaynak topluluğu tarafından şekillendiriliyor. Bu kişiler, projenin kalitesini, kararlılığını ve erişimini doğrudan etkileyen olağanüstü katkılarda bulundular. **Teşekkürler.**
### Birleştirilen pull request'lere göre harici katkıda bulunanlar
Sayım, canlı release/v3.8.52 ucu 656f01cb43 ile 2026-10-18 15:09:09 UTC tarihinde alınmıştır. Sayfalanmış GitHub GraphQL sayımı 9,191 birleştirilmiş PR içermektedir: 3,834'ü depo sahibi, 229'u Dependabot, 6'sı diğer botlar/uygulamalar ve 835 farklı katkıda bulunandan 5,122 harici PR. "Değişen satırlar", GitHub ekleme + silme değeridir ve oluşturulmuş dosyaları, lockfile'ları, katalogları, çevirileri ve dokümantasyonu içerir; yazılan LOC değil, churn'dür. 49 PR, 500,000 satırın üzerinde GitHub diff'i bildirmektedir (örneğin #13399, tek bir sağlayıcı eklemesi, 2,347 değişen dosya listeler), bu da yukarıdaki birkaç toplamı şişirmektedir. Eşitlikler birlikte sıralanır.
### GitHub tarafından atfedilen commit'ler
2026-10-18 14:44:45 UTC itibarıyla yeniden kontrol edildi: release/v3.8.52 varsayılan dalı için deponun Contributors API'si tarafından bildirilen GitHub'a atfedilen commit'ler. API 849 kimlik döndürdü (429 kullanıcı, 2 bot, 418 anonim); bu tablo bakımcıyı, botları ve anonim kimlikleri hariç tutar ve sıralama eşitliklerini korur. Yukarıdaki birleştirilmiş PR sıralamasından da aşağıdaki Git meta verisi sayımından da farklıdır.
> 🙏 Bu katkıda bulunanların özellikleri, hata düzeltmeleri ve altyapı iyileştirmeleri, OmniRoute'u güvenilir ve zengin özellikli kılan şeyin **temel bir parçasıdır**. Her pull request, her test senaryosu ve her i18n çeviri dosyası önemlidir. Açık kaynak, onlar gibi insanlar tarafından inşa edilir.
---
## 💖 Sponsorlar
OmniRoute'u kendi ceplerinden finanse eden insanlara gönülden teşekkür ederiz — her katkı projenin ücretsiz, bağımsız ve gelişmeye devam etmesini sağlıyor.
… ve gizli kalmayı tercih eden diğerleri 💛Herkese açık GitHub Sponsorları, GitHub Sponsors GraphQL API aracılığıyla 2026-10-18 tarihinde yeniden doğrulandı: toplam 14 sponsorluktan 11'i herkese açık (6 aktif, 5 geçmiş). Yukarıdaki aktif etiketleri GitHub'ın isActive durumu belirler; geçmişteki herkese açık tek seferlik destekçilere teşekkür edilmeye devam edilirken özel sponsorlar anonim kalır. Ko-fi, Buy Me a Coffee, Liberapay, PIX ve kripto bağışları, herkese açık sponsor kayıtları bulunmadığından listelenmemiştir.💖 Sponsor olun → — bağışlanan her dolar OmniRoute'un ücretsiz ve bağımsız kalmasını sağlar.
## 👥 900+ Katkıda Bulunan
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
2026-10-18 tarihinde etkin release/v3.8.52 dalının en son ad160ab2d1 işlemi (6.826 commit) üzerinde denetlendi: 993 normalleştirilmiş gerçek kişi Git kimliği — 707'si commit yazarı olarak (bakımı yapan kişi dâhil), 286'sı ise yalnızca açık Co-authored-by satırlarında yer alıyor. Sayımda .mailmap uygulanır, e-posta adresleri büyük/küçük harf ayrımı yapılmadan karşılaştırılır, sayısal ve düz GitHub noreply adresleri yalnızca aynı kullanıcı adını kodladıklarında birleştirilir, 26 bot/aracı/hizmet/yer tutucu kimliği hariç tutulur ve sıradan e-posta adresleri yalnızca görünen adları eşleştiği için birleştirilmez. 2026-08-24 tarihli denetimde 639 kimlik yayımlanmıştı; bu yöntem söz konusu denetimin temel ac02c5b42f işlemi üzerinde yeniden çalıştırıldığında 619 sonucu veriyor, dolayısıyla artış daha esnek bir yöntemden değil, yeni katkıda bulunanlardan kaynaklanıyor.
### Nasıl Katkıda Bulunulur?
1. Depoyu forklayın
2. **Etkin** `release/vX.Y.Z` dalının en son işleminden dallanın (`main` dalından değil) — bkz. [Dallanma ve Sürüm Modeli](docs/ops/BRANCHING_MODEL.md)
3. Özellik dalınızı oluşturun (`git checkout -b feat/amazing-feature`)
4. Değişikliklerinizi commit edin (`git commit -m 'feat: add amazing feature'`)
5. Dalınıza gönderin (`git push origin feat/amazing-feature`)
6. **taban = ilgili `release/vX.Y.Z` dalı** olacak şekilde bir Pull Request açın
Ayrıntılı yönergeler için [CONTRIBUTING.md](CONTRIBUTING.md) dosyasına bakın.
### Yeni Bir Sürüm Yayımlama
```bash
# Bir sürüm oluşturun — npm publish otomatik olarak gerçekleşir
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Yıldızlar
## 🌍 StarMapper
## 🙏 Teşekkürler
OmniRoute, devlerin omuzları üzerinde yükseliyor. **[9router](https://github.com/decolua/9router)** projesinin bir fork'u ve Go projesi **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**'nin TypeScript portu olarak başladı. Ardından aşağıdaki her alt sistem, bunu daha önce gerçekleştirmiş bir açık kaynak projesinden ilham aldı. Her biri OmniRoute'un somut bir parçasını şekillendirdi. Bu, hepsine teşekkürümüzdür. 🙏
> ⭐ yıldız sayıları 18 Ekim 2026 tarihinde GitHub'ın REST API'si üzerinden doğrulanmıştır — gidip bu projelere bir yıldız verin. Sayılar, belirli bir tarihte alınmış tam bir anlık görüntüdür ve doğal olarak değişecektir.
### 🧬 Köken ve ağ geçidi
Herkese açık fiyatlandırma veri kümesiyle maliyet izleme senkronizasyonumuzu besleyen ve sağlayıcı normalleştirme modeliyle yönlendirme yaklaşımımıza yön veren yapay zekâ ağ geçidi.
Tarayıcı oturumu, yanıt çerçeveleme, kullanım ve web araması adaptörleri dâhil olmak üzere, projeye dâhil edilen ChatGPT Web → Codex Responses köprüsüne uyarlanan MIT lisanslı kaynak.
Grok model eşlemeleri, sahte TypeError üreten Statsig oluşturucusu, istek ve cihaz varsayılanları ile NDJSON yanıt işleyicisi, OmniRoute'un Grok Web yürütücüsüne önemli ölçüde uyarlandı.
TQZHR ve grok2api-merged üzerinden aktarılan Grok yükü ve cihaz varsayılanları, Statsig oluşturucusu ve result.response işleyicisinin temelindeki MIT lisanslı kaynak.
grok2api-merged tarafından proxy havuzu katmanı için kaynak gösterilen dolaylı bir kaynak; OmniRoute bu köken bildirimini korur ancak sınırlı kapsamlı Grok Web yürütücüsünde bir proxy havuzu portu bulunduğunu iddia etmez.
Özgün Grok Web uygulaması, HTTP/tarayıcı üst kaynak tasarımından yararlandı; doğrudan HTTP yolu GrokProxy'den türetildiği için bağımsız bir kod portu olduğu iddia edilmez.
Viral olan "az token işe yararken neden çok token kullanasın" projesi — mağara adamı konuşması felsefesi, standart sıkıştırma modumuza ve 30'dan fazla dolgu/yoğunlaştırma kuralımıza güç veriyor.
Yüksek performanslı komut çıktısı sıkıştırması — RTK motorumuza, JSON filtreleme DSL'imize, ham çıktı kurtarmaya ve katmanlı RTK → Caveman işlem hattına ilham verdi.
İstem sıkıştırma araştırması (LLMLingua / LLMLingua-2) — asenkron, kod açısından güvenli ve hata durumunda çalışmayı sürdüren llmlingua motorumuza ilham verdi.
PT-BR token sıkıştırması — Brezilya Portekizcesi dil bilgisine göre ayarlanmış gereksiz yineleme azaltımı ve dolgu ifadeleri kaldırma özellikleriyle pt-BR dil paketimize güç veriyor.
Viral olan "tembel kıdemli geliştirici" YAGNI kodlayıcı becerisi — less-code Çıktı Stilimize ilham verdi: _üretilen_ kodu azaltan, çalışan en küçük değişikliğe yönlendirme (Caveman'in özlü düzyazısının çıktı eksenindeki kardeşi).
İçerik duyarlı, dosya türü başına çıktı sıkıştırması ve hatayı dikkate alan vazgeçme yaklaşımı — tür başına yönlendirmemizi ve minimum kazançta atlama yöntemimizi doğruladı.
Rust sütunlu JSON + içerik adresli geri alma + mesajlar arası tekilleştirme — headroom/ccr/session-dedup motor tasarımımızı ve önbellek kararlılığı sağlayan "sıkıştırılmış biçim konumdan bağımsızdır" değişmezini doğruladı.
Kodlama asistanı ↔ LLM trafiğinin MITM ile yakalanması/analizi, ilk Traffic Inspector gereksinimlerini şekillendirdi. Daha önce türetilmiş dört modül — SSE birleştirme, konuşma normalizasyonu, gizli bilgi maskeleme ve başlık temizleme — genel protokol standartlarına dayalı, bağımsız clean-room uygulamalarıyla değiştirildi. İki ana makine geçiş yüzeyi (passthrough.ts ve _internal/bypass.cjs), bağımsız olarak sınıflandırılan OmniRoute'a özgü uygulamalar olarak kalmaktadır; bu değişiklik kapsamında yeniden yazılmamışlardır.
İşlem başına şeffaf proxy yönlendirmesi — çökmeye karşı güvenli MITM kapatma mekanizmamıza, soket boşta kalma zaman aşımlarına, /proc işlem ilişkilendirmesine ve TPROXY yakalamaya ilham verdi.
### 📚 Model verileri, gözlemlenebilirlik ve kullanıcı arayüzü
Yapay zekâ modeli teknik özellikleri, fiyatlandırmaları ve yeteneklerinden oluşan açık veritabanı — model kataloğumuzla yerel olarak senkronize edildi.
Güvenlik tercihlerimize yön veren, varsayılan olarak güvenli kütüphanelerden oluşan özenle seçilmiş bir liste (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
İstek tekilleştirmeye, acil durumlarda sıfır maliyetli yedek çözüme, takılabilir Auto-Combo stratejilerine ve çok dilli niyet sınıflandırmasına ilham verdi.
Hesap duyarlı model yeniden eşlemesi, yürütülebilir dosya yolu doğrulaması ve plan etiketi davranışı, OmniRoute'un Antigravity çalışma zamanını şekillendirdi.
Grok Build kota yüzeyini belirledi; ardından OmniRoute, canlı aktarım biçimini bağımsız olarak doğrulayıp düzeltti.
## 📄 Lisans
MIT Lisansı - ayrıntılar için [LICENSE](LICENSE) dosyasına bakın.
---
**[⬆ Başa dön](#-omniroute)** · Açık kaynaklı yapay zeka topluluğu için ❤️ ile geliştirildi.
OmniRoute v3.8.53 · Node ≥22.22.2 · MIT Lisansı · omniroute.online
> Canlı `/dashboard/free-tiers` sayfasının animasyonlu özeti. Tam metodoloji (havuz yinelenmesinin giderilmesi, kredi katmanları, sağlayıcı koşulları): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Bu rakamlar iki haftada bir canlı katalogla yeniden denetlenir ve **iki yöne de hareket eder** — bir sağlayıcı ücretsiz katmanı sonlandırır ve sayı düşer; yeni biri gelir ve sayı yükselir. Kataloğun gerçekte hesapladığını yayınlarız, asla yukarı yuvarlanmış en iyi durumu değil.
```bash
# Bir sağlayıcı bağladıktan sonra OmniRoute anahtarınızı Dashboard → Endpoints bölümünden kopyalayın:
curl http://localhost:20128/v1/chat/completions \
-H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
`auto` uygun bir rotaya ihtiyaç duyar. Yeni bir kurulumda uygun anahtarsız hedef bulunmayabilir ve anahtarsız bir sağlayıcı üçüncü taraf istemcileri reddedebilir. Kiro dahil `tos: avoid` olarak işaretlenmiş sağlayıcılar varsayılan olarak otomatik yönlendirmeden hariç tutulur; bir hesap bağlamak bu ayarı geçersiz kılmaz. Sağlayıcı seçmeden önce [Ücretsiz Katmanlar Kılavuzu](docs/getting-started/FREE-TIERS-GUIDE.md) sayfasına bakın.
📦 **Python, Node.js, PHP ve cURL** için kopyala-yapıştır hızlı başlangıç betikleri → [`examples/quickstart/`](examples/quickstart/)
> **Kombo**, OmniRoute'un **otomatik olarak** yönlendirme yaptığı bir model zinciridir. Kota biterse, bir sağlayıcı arızalanırsa veya maliyetler yükselirse kombo, uygun durumdaki bir sonraki sağlıklı modele geçebilir. 🛡️
### ⚡ Sıfır yapılandırma — yalnızca `auto` kullanın
Kombo oluşturmanız gerekmez. Modelinizi `auto` (veya bir varyantı) olarak ayarlayın; OmniRoute, bağlı sağlayıcılarınızdan canlı olarak puanlanan sanal bir kombo oluşturur:
📖 [Auto-Combo Motoru](docs/routing/AUTO-COMBO.md) · [Dayanıklılık Kılavuzu](docs/architecture/RESILIENCE_GUIDE.md)
📊 Tam metodoloji ve 9router, OpenRouter, CLIProxyAPI ile LiteLLM karşısındaki özellik bazında ayrıntılar → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
Key (random): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix copia-e-cola:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Yetkilendirme](docs/architecture/AUTHZ_GUIDE.md) · [Güvenlik Önlemleri](docs/security/GUARDRAILS.md) · [Uyumluluk](docs/security/COMPLIANCE.md)
Varsayılan katmanlı kombinasyon `RTK → Caveman` şeklinde çalışır. İkisi de aynı araç/bağlam yükü üzerinde etki ettiğinde tasarruf katlanır:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Kod blokları, URL'ler, JSON ve yapılandırılmış veriler **her zaman korunur** — koruma motoru tarafından.
> **Az token işi görürken neden çok token kullanasınız?** Her istek OmniRoute'un sıkıştırma işlem hattından **şeffaf biçimde** geçer — istemci tarafında hiçbir değişiklik gerekmez. Artık sırayla çalışan ve her yönlendirme kombinasyonuna göre karıştırılıp eşleştirilebilen **12 birleştirilebilir motordan oluşan bir yığın** söz konusu — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) ve [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) fikirleri üzerine inşa edilmiştir.
### 🧱 12 motorlu yığın
Motorlar işlem hattı sırasına göre çalışır; her biri bağımsız olarak açılıp kapatılabilir ve kombinasyon başına yapılandırılabilir:
