## 💰 Üçüncü Taraf Ücretsiz Katmanlarında Aylık ~1,62B Token
> **Kendi sağlayıcı hesaplarınızı kullanın.** Bu, OmniRoute tarafından verilen bir token hibesi değil, ayrı ayrı uygun olduğunuz üçüncü taraf ücretsiz katmanlarının tahmini toplamıdır. Kaydolun, gerektiğinde kimlik bilgilerini edinin ve kullanabildiğiniz sağlayıcıları bağlayın; her sağlayıcı kendi limitlerini, kullanılabilirliğini ve koşullarını belirler.
>
> Ücretsiz katmanları elle bir araya getirmek zahmetlidir — onlarca SDK, onlarca hız sınırı ve gerçekte ne kadar hakkınız olduğuna dair hiçbir fikir yoktur. OmniRoute, **35 yinelenen havuz anahtarı genelinde 489 ücretsiz katman girdisini** kataloglar ve token başlığını, paylaşılan havuza göre tekilleştirilmiş biçimde, **yayımlanmış pozitif aylık bütçeye sahip 17 havuz ile model başına beş Groq sınırından** hesaplar. Yalnızca bölgesel kimlik kontrolünden sonra açılan kotalar (şu anda: ModelScope) ayrı gösterilir; bölgesel kimlik doğrulamasının ardında +~6M bulunur ve bunlar hiçbir zaman başlıktaki toplama dahil edilmez. Sonuç, kontrol panelinde (`/dashboard/free-tiers`) görünür durumda kalır.
> Canlı `/dashboard/free-tiers` sayfasının animasyonlu özeti. Tam metodoloji (havuz tekilleştirme, kredi katmanları, sağlayıcı koşulları): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Bu rakamlar, canlı katalogla karşılaştırılarak iki haftada bir yeniden denetlenir ve **her iki yönde de değişir** — bir sağlayıcı ücretsiz katmanını sonlandırırsa sayı düşer; yenisi eklenirse yükselir. Yuvarlanarak yükseltilmiş en iyi olasılığı değil, her zaman kataloğun gerçekten hesapladığı değeri yayımlarız.
⭐ OMNIROUTE para tasarrufu yapmanıza ve işinizi kolaylaştırmanıza yardımcı olduysa repoya 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
**👋 Sorumluyu 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)**
## 📈 Ağ Geçidi 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":"Merhaba!"}]}'
```
`auto` için uygun bir rota gerekir. Yeni bir kurulumda uygun anahtarsız hedef bulunmayabilir ve anahtarsız bir sağlayıcı üçüncü taraf istemcileri reddedebilir. OpenCode Free ve Kiro dahil olmak üzere `tos: avoid` olarak işaretlenen sağlayıcılar, varsayılan olarak otomatik yönlendirmenin dışında tutulur; bir hesap bağlamak bu ayarı geçersiz kılmaz. Bir sağlayıcı seçmeden önce [Ücretsiz Katmanlar Kılavuzu'na](docs/getting-started/FREE-TIERS-GUIDE.md) bakın.📦 **Python, Node.js, PHP ve cURL** için kopyalayıp yapıştırabileceğiniz 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ı başarısız olursa veya maliyetler yükselirse kombo, uygun ve sağlıklı bir sonraki 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/offline
🔋 Önce en fazla kota / hız sınırı kapasitesi
auto/smart
🔭 Daha iyi modeller keşfetmek için kalite önceliği + %10 keşif
auto/lkgp
📌 Bilinen son 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 tane, varsayılan olarak 5), tek bir yanıt döndürür; hata enjeksiyonu değil, paneldeki model başına bir üst akış çağrısıdır
##
### 🔀 Veya kendiniz oluşturun — 19 yönlendirme stratejisi
**19** stratejinin tamamı — her kombo adımında 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ü oluşturur
5
p2c
İki seçenekli rastgele yük dengeleme
6
least-used
Mevcut yükü en düşük olan hedefi seçer
7
random
Tekdüze 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
reset-window
Kota penceresi en kısa sürede sıfırlanacak hedefi tercih eder
12
reset-aware
Kota sıfırlama zamanına göre sıralar — önce kısa pencereler 📊
13
context-relay
Uzun konuşmalar için bağlamı hedefler arasında aktarır 🧠
14
context-optimized
Mevcut bağlam boyutuna en uygun hedefi seçer
15
cache-optimized
Yeniden kullanılabilir her istem ön ekini aynı hesaba sabitler — istem önbelleği isabetlerini en üst düzeye çıkarır 🎯
16
lkgp
Bilinen Son İyi Yol — son başarılı sağlayıcıya sabitlenir, ardından kurallara geri döner
17
auto
Her bağlantı genelinde 16 faktörlü canlı puanlama 🤖
18
fusion
Bir model paneline dağıtım yapar + bir değerlendirici tek bir yanıt sentezler 🧬
19
pipeline
Adımları zincirler — her hedefin çıktısı bir sonrakini besler 🔗
Auto-Combo motoru her adayı **16 faktöre** (sağlık, kota, maliyet, gecikme, göreve uygunluk, kalite, oturum kullanılabilirliği…) göre puanlar — bkz. [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Dayanıklılık yerleşik olarak sunulur (3 bağımsız katman)
📖 [Otomatik Kombinasyon Motoru](docs/routing/AUTO-COMBO.md) · [Dayanıklılık Kılavuzu](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 OmniRoute'u Farklı Kılan Nedir
📊 9router, OpenRouter, CLIProxyAPI ve LiteLLM ile karşılaştırmalı tam metodoloji ve ö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.50** arasındaki son öne çıkanlar. Tam geçmiş [`CHANGELOG.md`](CHANGELOG.md) dosyasında.
- **🎛️ OmniConductor** — aracı filonuza gelen A2A yetkilendirmesi, Agent Card üzerinde Conductor becerileri ve Faro bas-konuş sesli sohbet içeren bir pano paneli. → [A2A Sunucusu](docs/frameworks/A2A-SERVER.md)
- **🛂 Uyarlanabilir kabul ve aşırı yük koruması** — yoğun sohbet istekleri 503 hatası vermek yerine sıraya alınır; bağlantı başına atomik RPM kayan kiralamaları kullanılır. → [Dayanıklılık Kılavuzu](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Standart `/v1/models` sıralaması** — sağlayıcı başına, sağlayıcıya göre gruplandırılmış tek ve kesintisiz bir blok (kombinasyonlar ilk sıraya sabitlenir); tüm katalog kaynaklarında kararlıdır. → [API Referansı](docs/reference/API_REFERENCE.md)
- **🗜️ Sıkıştırma güçlendirmeleri** — varsayılan olarak etkin genişletme koruması, DE / FR / JA + Çince (wényán) için Caveman paketleri, Gradle ve .NET için RTK filtreleri. → [Sıkıştırma](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Gerçekçi sabit ücret maliyeti** — abonelik / kodlama planı sağlayıcıları, maliyet analizlerinde **$0** olarak gösterilir; bütçe, kota ve yönlendirme tahminleri sürdürülür. → [API Referansı](docs/reference/API_REFERENCE.md)
- **⚖️ Quota-Share yönlendirmesi** — paylaşılan bir hesabın kotasını havuzlanmış anahtarlar arasında adil biçimde bölüştürür ve iş koruyucu yapısı sayesinde boşta kalan payları kullandırır. → [Dayanıklılık Kılavuzu](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Tek komutla CLI/aracı kurulumu** — kayıtlı 13 `setup-*` komutu; `omniroute run`, 7 CLI'ı (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) başlatır; `omniroute configure`, etkileşimli sağlayıcı+model seçici ve bağlam başına favorilerle 10 hedefi destekler. → [CLI Entegrasyonları](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Uzak mod** — kapsamlı belirteçlerle (`connect` / `contexts` / `tokens`) uzaktaki bir OmniRoute'u yönetin; VPS kurulumları için bir `antigravity` OAuth yardımcısı da sunulur. → [Uzak Mod](docs/guides/REMOTE-MODE.md)
- **🧭 Daha akıllı otomatik yönlendirme** — `auto/:` kombinasyonları, **Fusion** (model paneli + hakem), göreve duyarlı 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** — birleştirilebilir 12 motor + Compression Studios: LLMLingua-2, iki katmanlı Ultra, omniglyph, adım başına doğruluk geçidi, GCF v3.2, sürükleyerek yeniden sıralama düzenleyicisi. → [Sıkıştırma](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Şeffaf MITM şifre çözme (TPROXY)** — proxy ortam değişkenlerini yok sayan CLI'ları, SNI başına CA + güven deposu yükleyicisiyle yakalayın. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Her yerde maliyet telemetrisi** — her uç noktada `X-OmniRoute-*` maliyet/kullanım başlıkları, önbellek HIT tasarruf başlığı, anahtar başına USD harcama kotaları. → [API Referansı](docs/reference/API_REFERENCE.md)
- **🧠 Kontrolünüzdeki bellek** — varsayılan olarak kapalıdır; isteğe bağlı int8 vektör niceleme + tür tabanlı azalma ve istek başına `x-omniroute-no-memory`. → [Bellek](docs/frameworks/MEMORY.md)
- **🛡️ Güvenlik** — her LLM rotasında istem enjeksiyonu koruması (red-team paketi), isteğe bağlı kimlik bilgisi maskeleme koruması (sızdırılan API anahtarlarını/gizli bilgileri her iki yönde de sansürler), son çare olarak ücretsiz DuckDuckGo web araması ve pano için isteğe bağlı OIDC oturum açma geçidi (parolayla oturum açma her zaman kullanılabilir kalır). → [Korumalar](docs/security/GUARDRAILS.md)
- **🖼️ Yeni uç noktalar** — `/v1/ocr` (Mistral OCR) ve `/v1/audio/translations` (Whisper tarzı) medya kapsamını tamamlıyor. → [API Referansı](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 Referansı](docs/reference/API_REFERENCE.md)
- **🌍 Dağıtım ve operasyonlar** — ters proxy `basePath`, tarayıcı dilini otomatik algılama, anahtar başına cihaz takibi, root gerektirmeyen MITM güveni, zh-TW yerelleştirmesi. → [Ortam](docs/reference/ENVIRONMENT.md)
- **🤝 Daha fazla sağlayıcı ve aracı** — bulut aracıları (Codex Cloud, Cursor, Devin, Jules), tarayıcı + OAuth oturum açma özellikli Grok Build (xAI), birinci sınıf Ollama kartı, Claude Opus 5 ve Sonnet 5, Kimi resmî ortaklığı (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… ve yenilenmiş **352 sağlayıcılı katalog**. → [Sağlayıcılar](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Yönlendirme şeffaflığı** — her yanıt, hizmeti sunan stratejiyi/sağlayıcıyı/gecikmeyi belirten bir `X-OmniRoute-Decision` başlığı taşır; yeni `cache-optimized` kombinasyon stratejisi + Auto-Combo `cacheAffinity` faktörü, yinelenen istekleri önbelleğe alınmış öneki barındıran bağlantıya geri yönlendirir ve salt okunur `/v1/auto-combo/{channel}/candidates` uç noktası, bir `auto/*` kanalının canlı aday havuzunu sunar. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Yerel performans ve altyapı** — tek tıklamayla yerel Redis, Cloudflare Workers / Deno Deploy aktarıcı dağıtıcıları, denetimli gömülü hizmetler olarak Bifrost ve Mux. → [Gömülü Hizmetler](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Pakete dâhil diğer özellikler** — eklenti çerçevesi + pazar yeri, Omni/Agent/GitHub beceri çerçeveleri, Obsidian kasa entegrasyonu (22 MCP aracı), OpenAI uyumlu Batch ve Files API'leri, anlamsal yanıt önbelleği, liderlik tablolarıyla oyunlaştırma, ACP aracı keşfi (yerleşik 15 aracı), BigQuery'ye zamanlanmış günlük dışa aktarımı, `auto/chaos` paralel çok modelli dağıtım, 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.
**Desteklenen herhangi bir CLI'ı OmniRoute üzerinden tek komutla başlatın** — hiçbir yapılandırma dosyası yazılmaz,
kimlik bilgileri işlem bazında enjekte edilir, Qwen/Gemini geçici ve 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"
# Veya sağlayıcı+modeli etkileşimli olarak seçip aracın kendi yapılandırmasını yazın:
omniroute configure codex # ayrıca: claude opencode qwen aider goose gemini cline continue kilo
```
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)
> Standart sohbet, medya, arama, yerel, bulut aracısı ve sistem koleksiyonlarında **372 kayıtlı sağlayıcı** bulunur; bunların **154'ü `hasFree: true` keşif meta verisini taşır**. Sohbet modeli kayıt defteri **237 sağlayıcıyı / 3.009 farklı sağlayıcı-model çiftini / 1.443 ham model kimliğini** kapsar; ayrı ücretsiz bütçe kataloğunda ise **model başına 491 satır**, **35 yenilenen havuz** ve **54 yenilenen/anahtarsız, sonsuza kadar ücretsiz sağlayıcı** bulunur. Bunların paydaları tasarım gereği farklıdır; tanımlar ve havuz tekilleştirmeli hesaplamalar [Sağlayıcı Referansı](docs/reference/PROVIDER_REFERENCE.md) ile [Ücretsiz Katmanlar](docs/reference/FREE_TIERS.md) belgelerinde yer alır.
### 🏢 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 330'dan fazlası — tüm simgeler doğrudan panonun sağlayıcı kataloğundan yüklenir. 📖 [Sağlayıcı Referansı](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Sonsuza Kadar Ücretsiz — $0, kart gerekmez
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 gerektirmez
Cloudflare AI 50+ model Günde 10 bin nöron
NVIDIA NIM GLM, MiniMax ~40 RPM ücretsiz
Cerebras GLM 4.7, GPT-OSS Tek seferlik 5 $ kredi; kart gerekli
OpenRouter :free modeller +10 $ → daha yüksek RPM
📖 Makine tarafından okunabilir tam 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.
> Sunucunun ötesinde, OmniRoute **80'den fazla komuta** sahip **kapsamlı bir komut satırı kokpitidir**; ayrıca bir yapay zeka ajanının onu **kendi başına** yönetebilmesi için açık ajan protokollerine sahiptir.
### ⌨️ 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 (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ı denetler
```
### 🛰️ Uzak mod — CLI'ı burada, OmniRoute'u bir VPS üzerinde çalıştırın
OmniRoute bir sunucuda mı kurulu? Dizüstü bilgisayarınızdan **aynı CLI** ile yönetin. Kapsamlı bir erişim tokenıyla bir kez oturum açın; ardından her komut uzak sunucuyu hedefler.
```bash
omniroute connect 192.168.0.15 # şifre → kapsamlı token, bağlam olarak kaydedilir
omniroute models list # ← UZAK sunucuya karşı ç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ı tokenlar üretir
omniroute contexts use default # ← yerel sunucuya geri döner
```
Tokenlar `read` / `write` / `admin` kapsamlarına sahiptir; süreç başlatan rotalar yalnızca yerel döngüde (loopback) kalır.
📖 [Uzak Mod](docs/guides/REMOTE-MODE.md)
### 🤝 Bir ajan bağlayın — ve OmniRoute'un kendisini yönetsin
OmniRoute'u **MCP**, **A2A**, bir **REST API**, **webhook'lar** veya bir **uzak CLI** üzerinden kullanıma açın — yetenekli herhangi bir ajan (veya kendi kodunuz) tüm ağ geçidinin anahtarlarını alır: yönlendirme, sağlayıcılar, kombolar, önbellek, sıkıştırma, bellek — tamamen özerk bir şekilde. 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
🌊 MCP (HTTP)
/api/mcp/stream
Uzak MCP — 110 araç, 33 kapsam, eksiksiz denetim kaydı
Olayları (kullanım, kota, hatalar, yönlendirme) URL'nize iletin
🛰️ Uzak CLI
omniroute connect <host>
Kapsamlı erişim tokenlarıyla uzak bir örneği yönetin
```bash
# Claude Code'a MCP üzerinden tam 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)
## 🗜️ Tokenlardan %15–95 Tasarruf Edin — Otomatik Olarak
### 📖 Nasıl çalışır — işlem hattı, mimari ve tasarruf hesabı
Varsayılan yığın kombinasyonu `RTK → Caveman` çalıştırır. Her ikisi de aynı araç/bağlam yükü üzerinde işlem yaptığında tasarruflar bileşik hâle gelir:
```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 koruma motoru tarafından **her zaman korunur**.
> **Az sayıda token yeterliyken neden çok sayıda token kullanasınız?** Her istek OmniRoute'un sıkıştırma işlem hattından **şeffaf biçimde** geçer — istemci tarafında değişiklik gerekmez. Artık bu, sırayla çalışan ve her yönlendirme kombinasyonu için farklı şekillerde eşleştirilebilen **birleştirilebilir 12 motordan oluşan bir yığındır** — [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) projelerindeki fikirleri temel alır.
### 🧱 12 motorlu yığın
Motorlar işlem hattı sırasıyla çalışır; her biri bağımsız olarak açılıp kapatılabilir ve her kombinasyon için yapılandırılabilir:
#
Motor
Ne yapar?
1
Session-Dedup
Turlar arasında yinelenen içeriği kaldırır (içerik adresli, turlar arası)
2
CCR
Büyük blokları, gerektiğinde getirilen erişim işaretçilerinin arkasında arşivler
3
Lite
Boşlukları ve görsel URL'lerini kırpar (düşük gecikmeli temel seçenek)
4
RTK
Akıllı araç sonucu filtreleme, yinelenenleri kaldırma ve kırpma (komut duyarlı)
5
Responses Tool Output
Kabuk/yama/arama/derleme çıktıları için önce kayıpsız JSON + sınırlı tanılama sıkıştırması (Responses API)
6
Headroom
Projeye dahil edilmiş bir GCF kodeği aracılığıyla JSON dizilerinin kayıpsız tablo biçiminde sıkıştırılması (~%30)
7
Relevance
Son kullanıcı sorgusuna göre çıkarımsal cümle puanlaması
Eski turların özetlenmesi ve aşamalı olarak yaşlandırılması
10
LLMLingua-2
MobileBERT ONNX aracılığıyla makine öğrenimi tabanlı anlamsal budama — kod açısından güvenli, eşzamansız
11
Ultra
İsteğe bağlı küçük model (SLM) katmanıyla sezgisel token budama
12
OmniGlyph
Doğrudan Anthropic bağlantısında ölçümlenmiş Claude Fable 5 için deneysel görüntü olarak bağlam kodlaması; GPT 5.6 dönüştürücüleri, sağlayıcı kanıtları gelene kadar güvenli biçimde kapalı kalır. Dört sıkıştırma profili (varsayılan agresif, dengeli, kodlama açısından güvenli, doğrudan geçiş) (en agresif; etkinleştirme gerektirir)
Kod blokları, URL'ler ve yapılandırılmış veriler bayt düzeyinde eksiksiz olarak **her zaman korunur**. **Tek tıklamalı ön ayarlar** motorları birleştirir:
Mod
Tasarruf
En uygun kullanım
🪶 Lite
~%15
Her zaman açık, güvenli varsayılan
🪨 Standard (Caveman)
~%30
Günlük kodlama
⚡ Aggressive
~%50
Araç kullanımının yoğun olduğu uzun oturumlar
🔥 Ultra
~%75
Maksimum tasarruf
🧰 RTK
%60–90
Kabuk/test/derleme/git çıktısı
🔗 Stacked (RTK → Caveman)
%78–95
Karma istemler + araç günlükleri
**Gerçek örnek — Standard modu:**
> **Önce (69 token):** _"React bileşeninizin yeniden işlenmesinin nedeni muhtemelen her işleme döngüsünde yeni bir nesne referansı oluşturmanızdır. Satır içi bir nesneyi prop olarak ilettiğinizde React'in yüzeysel karşılaştırması bunu her seferinde farklı bir nesne olarak görür ve bu da yeniden işlemeyi tetikler. Nesneyi önbelleğe almak için useMemo kullanmanızı öneririm."_
>
> **Sonra (19 token):** _"Her işlemede yeni nesne referansı. Satır içi nesne prop'u = yeni referans = yeniden işleme. useMemo ile sarmalayın."_
>
> **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 ötesinde — çıktı stilleri, uyarlanabilir kadran ve istek bazında kontrol
Yukarıdaki 12 motor, **girdiyi** küçültür. Üç ek katman ise çıktının **nasıl**, **ne zaman** ve ne şekilde üretileceğini belirler:
- **🪄 Çıktı Stilleri** _(çıktı ekseninde yönlendirme)_ — deterministik, önbellekle uyumlu yanıt biçimlendirme talimatları ekler; birlikte kullanılabilir ve her biri `lite` / `full` / `ultra` yoğunluğunda uygulanabilir. Yeni bir stil eklemek, kayıt defterine tek satır eklemek kadar kolaydır:
- **Kısa ve öz anlatım** — dolgu ifadelerini / tanımlıkları / ihtiyatlı ifadeleri çıkarır; teknik içeriği eksiksiz ve doğru tutar.
- **Daha az kod** — "tembel kıdemli geliştirici" YAGNI yaklaşımı: çalışan en küçük değişiklik, istenmeyen ek yapılandırma yok.
- **At kuyruğu (tembel kıdemli geliştirici)** — YAGNI basamaklarını çıkar, temel nedeni düzelt, çalışan en küçük farkı üret.
- **DEHB'im var (önce eylem)** — sonraki eylem başta gelir, adımlar numaralandırılır, tek bir somut sonraki adım verilir, giriş yapılmaz.
- **Kısa CJK (文言)** — klasik Çince, son derece kısa stil (`zh` yerel ayarıyla sınırlıdır).
- **🎯 Uyarlanabilir bağlam bütçesi** _(kadran)_ — tek bir açık/kapalı token eşiği yerine, modelin bağlam penceresine **sığmak için** yalnızca gerektiği kadar en ucuz ve en az kayıplı motorları kademeli olarak devreye alır. Politika: `reserve-output` (varsayılan, modele duyarlı) · `percentage` · `absolute`. Mod: `floor` (sığmayı garanti eder) · `replace-autotrigger` (açık seçiminiz önceliklidir) · `off` (eski eşik).
- **🎛️ Sıkıştırmanın nerede belirlendiği** _(öncelik, yüksek → düşük)_ — istek bazında `x-omniroute-compression` üst bilgisi › yönlendirme kombinasyonu geçersiz kılması › etkin adlandırılmış profil › uyarlanabilir / otomatik tetikleme › panel varsayılanı › kapalı. Uygulanan plan, yanıtta `X-OmniRoute-Compression: ; source=` üst bilgisiyle geri bildirilir.
Token eşiğine göre otomatik tetiklemeyi kullanın, uyarlanabilir kadranı açın, adlandırılmış bir profili sabitleyin, istek bazında tek seferlik bir ayar belirleyin veya her yönlendirme kombinasyonuna bir işlem hattı atayın — iş yükünüze hangisi uyuyorsa. İsteğe bağlı çevrimdışı **değerlendirme sistemi** (`npm run eval:compression`), bir değişikliği kullanıma almadan önce sabitlenmiş bir külliyat ü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ü 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 belirtilen paketlere izin verin. OmniRoute 3.8.51 tarafından bildirilen paket grubu 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 listeyi 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 göndermeden ö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** → güncel koşulları ve kotası kullanım senaryonuza 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](docs/getting-started/FREE-TIERS-GUIDE.md) belgesini inceleyin; anahtarsız kullanılabilirlik garanti edilmez ve `tos: avoid` olarak işaretlenen 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 üst bilgiler 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. Üst bilgiyle 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.
Devre kesici, üstel geri çekilme, ani istek yığılmasını önleme, otomatik kombinasyonla kendi kendini iyileştirme
Günlükleme
pino — istek bağlamı içeren yapılandırılmış JSON günlükleri
Test
Node.js test çalıştırıcısı + Vitest — takip edilen 5.100'den fazla test dosyasında 39.000'den fazla statik test bildirimi (birim, entegrasyon, E2E, güvenlik, ekosistem)
Platformlar
Masaüstü (Electron) · Android (Termux) · PWA (herhangi bir tarayıcı)
5.100'den fazla izlenen test dosyasındaki 39.000'den fazla statik test bildirimi için test kapsamı stratejisi
# ⭐ En Çok Katkıda Bulunanlar
> OmniRoute, tutkulu bir açık kaynak topluluğu tarafından şekillendirilmektedir. Bu kişiler, projenin kalitesini, kararlılığını ve erişimini doğrudan etkileyen olağanüstü katkılarda bulunmuştur. **Teşekkür ederiz.**
### Birleştirilen pull request sayısına göre harici katkıda bulunanlar
Birleştirmeler 2026-08-24 05:26:03 UTC tarihine kadar olmak üzere, canlı release/v3.8.50 dalının dafb4ae808 ucunda dondurulmuştur. Sayfalandırılmış GitHub GraphQL sayımı, birleştirilmiş 5.911 PR içermektedir: 2.707'si depo sahibi, 179'u Dependabot ve 3.025'i 535 farklı katkıda bulunandan gelen harici PR'lerdir. “Değiştirilen satır”, GitHub eklemeleri + silmeleri ifade eder ve oluşturulan dosyaları, kilit dosyalarını, katalogları, çevirileri ve belgeleri içerir; yazılmış LOC değil, değişim hacmidir. Kesim noktasındaki eşitlikler korunmuştur.
### GitHub'a atfedilen commit'ler
backryun 🥇 GitHub tarafından ilişkilendirilen 220 commit
Paijo 🥈 GitHub tarafından ilişkilendirilen 219 commit
Randi 🥉 GitHub tarafından ilişkilendirilen 108 commit
Ravi Tharuma 🏅 GitHub tarafından ilişkilendirilen 81 commit
Chris 🏅 GitHub tarafından ilişkilendirilen 70 commit
Markus Hartung 🏅 GitHub tarafından ilişkilendirilen 69 commit · 6. sırayı paylaşıyor
2026-08-24 06:14:31 UTC tarihinde yeniden kontrol edildi: Deponun Katkıda Bulunanlar API'si tarafından varsayılan release/v3.8.50 dalı için bildirilen GitHub tarafından ilişkilendirilmiş commit'ler. API 525 kimlik (415 kullanıcı, 2 bot, 108 anonim) döndürdü; bu tablo bakım sorumlusunu, botları ve anonim kimlikleri hariç tutar ve sıralamadaki beraberlikleri korur. Hem yukarıdaki birleştirilmiş PR sıralamasından hem de aşağıdaki 639 kişilik Git meta verisi sayımından 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 unsurların **temel bir parçasıdır**. Her pull request, her test vakası ve her i18n çeviri dosyası önemlidir. Açık kaynak, onlar gibi insanlar tarafından oluşturulur.
---
## 💖 Sponsorlar
OmniRoute'u kendi bütçelerinden finanse eden kişilere içtenlikle teşekkür ederiz — her katkı projenin ücretsiz, bağımsız ve gelişmeye devam etmesini sağlar.
…ve gizli kalmayı tercih eden diğerleri 💛💖 Sponsor olun → — her bir dolar OmniRoute'un ücretsiz ve bağımsız kalmasını sağlar.
## 👥 320+ Katkıda Bulunan
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
### Nasıl Katkıda Bulunulur
1. Depoyu forklayın
2. **Aktif** `release/vX.Y.Z` dalından (`main` değil) bir dal oluşturun — bkz. [Dallanma ve Sürüm Modeli](docs/ops/BRANCHING_MODEL.md)
3. Özellik dalınızı oluşturun (`git checkout -b feat/harika-ozellik`)
4. Değişikliklerinizi commit edin (`git commit -m 'feat: harika ozellik ekle'`)
5. Dalınıza push edin (`git push origin feat/harika-ozellik`)
6. **Hedef dal = 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 yayını otomatik olarak gerçekleşir
gh release create v3.8.2 --title "v3.8.2" --generate-notes
```
## 📊 Yıldızlar
## 🌍 StarMapper
## 🙏 Teşekkürler
OmniRoute devlerin omuzlarında yükselmektedir. **[9router](https://github.com/decolua/9router)** projesinin bir çatalı ve Go projesi **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**'nin bir TypeScript uyarlaması olarak başladı — ve oradan itibaren aşağıdaki her alt sistem, oraya ilk ulaşan bir açık kaynak projesinden ilham aldı. Her biri OmniRoute'un somut bir parçasını şekillendirdi. Hepsine teşekkür ederiz. 🙏
> ⭐ Temmuz 2026 itibarıyla yıldız sayıları — bu projelere de bir yıldız verin.
### 🧬 Köken ve ağ geçidi
Kamuya açık fiyatlandırma veri seti maliyet takibi senkronizasyonumuzu besleyen ve sağlayıcı normalizasyon modeli yönlendirmemize rehberlik eden yapay zeka ağ geçidi.
Viral olan "az token işi görüyorsa neden çok token kullanasınız" projesi — mağara adamı dili felsefesi standart sıkıştırma modumuza ve 30'dan fazla dolgu/yoğunlaştırma kuralımıza güç verir.
Yüksek performanslı komut çıktısı sıkıştırması — RTK motorumuza, JSON filtre 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 güvenli, başarısızlık durumunda açık (fail-open) llmlingua motorumuza ilham verdi.
PT-BR token sıkıştırması — pt-BR dil paketimize güç verir: Brezilya Portekizcesi gramerine göre ayarlanmış anlatım bozukluğu azaltma ve dolgu sözcük temizleme.
Viral olan "tembel kıdemli geliştirici" YAGNI kodlama yeteneği — less-code Çıktı Stilimize ilham verdi: _üretilen_ kodu azaltan çalışan en küçük değişiklik yönlendirmesi (Caveman'in kısa düz yazısının çıktı eksenindeki eşleniği).
### 🧩 Kompakt formatlar, token araştırmaları ve kod duyarlı araçlar
İlk olarak tablosal sıkıştırma aşamamıza ilham verdi; artık sıfır bağımlılıklı, kayıpsız genel profil kodlayıcısı doğrudan Headroom codec'i olarak yerleşik olarak (vendored) sunulmaktadır (MIT, SPDX işaretli), daha sonraki sayısal alan ve sayı uyumsuzluğu doğruluk düzeltmeleriyle birlikte.
Hata duyarlı vazgeçme özelliğine sahip içerik duyarlı, dosya türü başına çıktı sıkıştırması — tür başına dağıtımımızı ve minimum kazanç atlamamızı doğruladı.
Rust sütunlu JSON + içerik adresli geri getirme + mesajlar arası tekilleştirme — headroom/ccr/session-dedup motor tasarımımızı ve önbellek kararlı "sıkıştırılmış form konumdan bağımsızdır" kuralımızı doğruladı.
Kodlama asistanı ↔ LLM trafiğinin MITM yakalaması/analizi — Trafik Denetçimiz bunun SSE birleştirmesini, konuşma normalizasyonunu, ana bilgisayar doğrudan geçişini ve sır maskelemesini uyarladı (MIT).
Süreç bazında şeffaf proxy yönlendirmesi — çökmeye dayanıklı MITM kapatma, soket boşta kalma zaman aşımları, /proc süreç atıfı ve TPROXY yakalamamıza ilham verdi.
### 📚 Model verileri, gözlemlenebilirlik ve arayüz
Istio servis ağı (service-mesh) gözlemlenebilirliği — Yönlendirme/Kombo Stüdyosundaki devre kesici rozetlerimize ve hata kenarı görsellerimize ilham verdi.
Güvenlik tercihlerimize rehberlik eden, varsayılan olarak güvenli kütüphanelerin derlenmiş listesi (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
### 🧭 Tamamlayıcı araçlar
Proje
⭐
OmniRoute'a nasıl ilham verdi
## 📄 Lisans
MIT Lisansı - ayrıntılar için [LICENSE](LICENSE) dosyasına bakın.
---
**[⬆ Başa dön](#-omniroute--ücretsiz-ai-ağ-geçidi)** · Açık kaynaklı yapay zeka topluluğu için ❤️ ile geliştirildi.
OmniRoute v3.8.49 · Node ≥22.22.2 · MIT Lisansı · omniroute.online
> Canlı `/dashboard/free-tiers` sayfasının animasyonlu özeti. Tam metodoloji (havuz tekilleştirme, kredi katmanları, sağlayıcı koşulları): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Bu rakamlar, canlı katalogla karşılaştırılarak iki haftada bir yeniden denetlenir ve **her iki yönde de değişir** — bir sağlayıcı ücretsiz katmanını sonlandırırsa sayı düşer; yenisi eklenirse yükselir. Yuvarlanarak yükseltilmiş en iyi olasılığı değil, her zaman kataloğun gerçekten hesapladığı değeri yayımlarız.
```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":"Merhaba!"}]}'
```
`auto` için uygun bir rota gerekir. Yeni bir kurulumda uygun anahtarsız hedef bulunmayabilir ve anahtarsız bir sağlayıcı üçüncü taraf istemcileri reddedebilir. OpenCode Free ve Kiro dahil olmak üzere `tos: avoid` olarak işaretlenen sağlayıcılar, varsayılan olarak otomatik yönlendirmenin dışında tutulur; bir hesap bağlamak bu ayarı geçersiz kılmaz. Bir sağlayıcı seçmeden önce [Ücretsiz Katmanlar Kılavuzu'na](docs/getting-started/FREE-TIERS-GUIDE.md) bakın.
📦 **Python, Node.js, PHP ve cURL** için kopyalayıp yapıştırabileceğiniz 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ı başarısız olursa veya maliyetler yükselirse kombo, uygun ve sağlıklı bir sonraki 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:
📖 [Otomatik Kombinasyon Motoru](docs/routing/AUTO-COMBO.md) · [Dayanıklılık Kılavuzu](docs/architecture/RESILIENCE_GUIDE.md)
📊 9router, OpenRouter, CLIProxyAPI ve LiteLLM ile karşılaştırmalı tam metodoloji ve ö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 yığın kombinasyonu `RTK → Caveman` çalıştırır. Her ikisi de aynı araç/bağlam yükü üzerinde işlem yaptığında tasarruflar bileşik hâle gelir:
```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 koruma motoru tarafından **her zaman korunur**.
> **Az sayıda token yeterliyken neden çok sayıda token kullanasınız?** Her istek OmniRoute'un sıkıştırma işlem hattından **şeffaf biçimde** geçer — istemci tarafında değişiklik gerekmez. Artık bu, sırayla çalışan ve her yönlendirme kombinasyonu için farklı şekillerde eşleştirilebilen **birleştirilebilir 12 motordan oluşan bir yığındır** — [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) projelerindeki fikirleri temel alır.
### 🧱 12 motorlu yığın
Motorlar işlem hattı sırasıyla çalışır; her biri bağımsız olarak açılıp kapatılabilir ve her kombinasyon için yapılandırılabilir:
