🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW
Ücretsiz katmanları elle bir araya getirmek zahmetlidir — onlarca SDK, onlarca hız sınırı ve gerçekte ne kadar kotanız olduğuna dair hiçbir fikir yok. OmniRoute, 35 yinelenen havuz anahtarında 489 ücretsiz katman girdisini kataloglar ve token başlığını, yayımlanmış pozitif aylık bütçeye sahip 17 havuz ile modele özel beş Groq sınırından, ortak havuzları tekilleştirerek hesaplar. Yalnızca bölgesel kimlik doğrulamasından sonra kullanılabilen kotalar (bugün için: ModelScope) ayrı gösterilir; bölgesel kimlik doğrulamasının arkasındaki +~6M hiçbir zaman başlıktaki toplama dahil edilmez. Sonuç kontrol panelinde (
/dashboard/free-tiers) görünür kalır.
Canlı
/dashboard/free-tierssayfasının animasyonlu özeti. Tam metodoloji (havuz tekilleştirme, kredi katmanları, sağlayıcı koşulları): 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 artırılmış en iyi senaryoyu 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.
👋 Bakım sorumlusunu takip edin — yeni sağlayıcılardan, sürümlerden ve ipuçlarından ilk siz haberdar olun:
Sorular, sağlayıcı ipuçları, yol haritası ve destek → Discord · Telegram · WhatsApp 🌍 Global / 🇧🇷 Brezilya / Portal
| v3.8.49 | v3.8.50 | v3.8.51+ |
|
|---|---|---|---|
| 🌐 Sağlayıcılar | 290 | 357 | daha fazlası sırada |
| 🧠 Benzersiz sohbet modeli kimlikleri | 1185 | 1312 | — |
| 🖼️ Modalite Köprüsü | — | 🆕 görsel + ses + video | — |
| 📡 Radar ücretsiz kataloğu | — | 🆕 isteğe bağlı | — |
| ⚖️ Kota duyarlı zamanlama | — | 🆕 Quota-Share | — |
| 📊 Kota telemetrisi | — | 🆕 canlı | — |
→ Yol Haritası — v3.9.0 LTS sürümüne doğru ilerliyor
| 🚀 Başlangıç | 🚀 Hızlı Başlangıç | 📦 Kurulum | 🆓 Sıfır Yapılandırma |
| 💡 Öğrenin | 💥 Vaat | 🤔 Neden OmniRoute? | 🏆 Fark Yaratan Özellikler |
| ⚙️ Özellikler | 🎯 Kombolar | 🌐 Sağlayıcılar | 🔌 CLI ve MCP |
| 🗜️ Sıkıştırma | 🖥️ Nerede Çalışır? | 🔒 Gizli | |
| 👀 Görün | 🎬 Çalışırken | ✨ Yenilikler | 🤖 Uyumlu CLI'lar |
| 💚 Destek | 💚 Destek / Bağış | 💬 Topluluk | 💖 Sponsorlar |
| 📦 Proje | 🛠️ Teknoloji Yığını | 📖 Belgeler | 👥 Katkıda Bulunanlar |
# Yeni kurulum, sıfır kimlik bilgisi — `auto` zaten çalışıyor:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'Belirli bir ücretsiz arka ucu mu tercih ediyorsunuz? oc/… (OpenCode Free) adresini doğrudan çağırın. Ardından auto'ya geçin ve OmniRoute'un seçmesine izin verin.
📦 Python, Node.js, PHP ve cURL için kopyala-yapıştır hızlı başlangıç betikleri → examples/quickstart/
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
|
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 →
|
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.
Bir kombo, OmniRoute'un otomatik olarak yönlendirme yaptığı model zinciridir. Kota bittiğinde, sağlayıcı çöktüğünde veya maliyetler fırladığında — kombo sessizce bir sonraki modele geçer. OmniRoute'u kesintisiz kılan şey budur. 🛡️
Oluşturulacak bir kombo yok. 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 ID | Neyi optimize eder |
|---|---|
auto | 🎯 Dengeli varsayılan (LKGP — son başarılı sağlayıcınıza sadık kalır) |
auto/coding | 🧑💻 Kod üretimi için kalite öncelikli ağırlıklar |
auto/fast | ⚡ Öncelikli olarak en düşük gecikme süresi |
auto/cheap | 💰 Öncelikli olarak token başına en ucuz model |
auto/offline | 🔋 Öncelikli olarak en fazla kota / hız sınırı payı olan model |
auto/smart | 🔭 Kalite öncelikli + daha iyi modeller keşfetmek için %10 keşif payı |
Tüm 19 strateji — kombo adımı başına karıştırın ve eşleştirin:
| # | Strateji | Ne yapar |
|---|---|---|
| 1 | priority |
İlk hedeften sıralı liste — 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öner |
| 5 | p2c |
İki seçenekli güç (power-of-two-choices) rastgele yük dengeleme |
| 6 | least-used |
Mevcut yükü en düşük olan hedefi seçer |
| 7 | random |
Tekdüze rastgele seçim (tekilleştirilmiş) |
| 8 | strict-random |
Tekrarları tekilleştirmeden rastgele seçim 🎲 |
| 9 | cost-optimized |
Canlı katalog fiyatlandırması üzerinden istek başına maliyeti ($) en aza indirir 💸 |
| 10 | headroom |
En çok kalan kotası olan hedefi seçer |
| 11 | reset-window |
Kota penceresi en erken sıfırlanacak hedefi tercih eder |
| 12 | reset-aware |
Kota sıfırlama süresine göre sıralar — kısa pencereler önce 📊 |
| 13 | context-relay |
Uzun konuşmalarda bağlamı hedefler arasında devreder 🧠 |
| 14 | context-optimized |
Mevcut bağlam boyutu için en uygun modeli seçer |
| 15 | cache-optimized |
Her yeniden kullanılabilir istem önekini aynı hesaba sabitler — istem önbelleği (prompt-cache) isabetlerini maksimize eder 🎯 |
| 16 | lkgp |
Son Bilinen İyi Yol (Last-Known-Good Path) — son başarılı hedefe bağlı kalır |
| 17 | auto |
Tüm bağlantılar arasında 14 faktörlü canlı puanlama 🤖 |
| 18 | fusion |
Bir model paneline paralel dağıtır + bir hakem model tek bir nihai yanıt sentezler 🧬 |
| 19 | pipeline |
Adımları birbirine bağlar — her hedefin çıktısı sonrakini besler 🔗 |
Auto-Combo motoru her adayı 14 faktör üzerinden puanlar (sağlık, kota, maliyet, gecikme, başarı oranı, tazelik…) — bkz. docs/routing/AUTO-COMBO.md.
📖 Auto-Combo Motoru · Dayanıklılık Kılavuzu
📊 Tam metodoloji ve özellik bazında detay vs 9router, OpenRouter, CLIProxyAPI & LiteLLM → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md
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.
| ⭐ Depoya yıldız verin | Ücretsizdir — görünürlüğe gerçekten yardımcı olur | OmniRoute'a Yıldız Verin |
| 🐙 GitHub Sponsors | Tek seferlik veya aylık · sıfır platform komisyonu | github.com/sponsors/diegosouzapw |
| ☕ Ko-fi | Hızlı tek seferlik bahşiş, bağışçı için kayıt gerekmez | ko-fi.com/diegosouzapw |
| 🧋 Buy Me a Coffee | Küçük, samimi bir jest | buymeacoffee.com/diegosouzapw |
| 🖐 Liberapay | Tekrarlayan · kar amacı gütmeyen · açık kaynak | liberapay.com/diegosouzapw |
| 🇧🇷 PIX (Brezilya) | Anında, masrafsız | anahtar ve QR aşağıda |
| ₿ Kripto | BTC · ETH · USDT-TRC20 · USDC-Solana | adresler aşağıda |
🇧🇷 PIX — anında, masrafsız (Brezilya)
Key (random): 5d865059-bc44-483a-962d-43ceb80126eb
Pix copia-e-cola:
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
₿ Kripto — BTC · ETH · USDT-TRC20 · USDC-Solana (genişletmek için tıklayın)
| ₿ BTC | Bitcoin (SegWit) | bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd |
| Ξ ETH | Ethereum (ERC20) | 0x64Cf6B68A6Ff34288e89172950a2d00102337a84 |
| ₮ USDT | Tron (TRC20) | TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2 |
| $ USDC | Solana | 2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu |
🐛 Bir hata mı buldunuz veya geri bildiriminiz mi var? Bir Tartışma (Discussion) 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.
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 adresini ziyaret edin.
v3.8.20 → v3.8.50 sürümlerinden öne çıkan yenilikler. Tam geçmiş için:
CHANGELOG.md.
- 🎛️ OmniConductor — Ajan filonuza gelen A2A yetkilendirmesi, Agent Card üzerinde Conductor yetenekleri ve Faro bas-konuş sesli sohbet içeren pano paneli. → A2A Sunucusu
- 🛂 Uyarlanabilir kabul ve aşırı yük koruması — Ağır sohbet istekleri 503 hatası vermek yerine kuyruğa alınır; bağlantı başına atomik RPM kayan kiralamaları uygulanır. → Dayanıklılık Kılavuzu
- 🗂️ Standart
/v1/modelssıralaması — Sağlayıcı başına tek bir bitişik sağlayıcı gruplu blok (kombolar en başa sabitlenir), tüm katalog kaynaklarında kararlıdır. → API Referansı - 🗜️ Sıkıştırma güçlendirmesi — Varsayılan olarak açık şişirme koruması (inflation guard), DE / FR / JA + Çince (wényán) için Caveman paketleri, Gradle ve .NET için RTK filtreleri. → Sıkıştırma
- 💸 Dürüst sabit maliyet — Abonelik / kodlama planı sağlayıcıları maliyet analizlerinde $0 olarak okunur; bütçe, kota ve yönlendirme tahmin yapmaya devam eder. → API Referansı
- ⚖️ Kota Paylaşımlı (Quota-Share) yönlendirme — Paylaşılan bir hesabın kotasını havuzdaki anahtarlar arasında adil bir şekilde böler; boşta kalan dilimlerin ödünç verilmesini sağlar. → Dayanıklılık Kılavuzu
- 🤖 Tek komutla CLI/ajan kurulumu —
setup-*12'den fazla kodlama aracını yapılandırır;omniroute runsıfır yapılandırma yazarak 7 CLI'yı (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) başlatır;omniroute configurebağlam başına favorilere sahip etkileşimli bir sağlayıcı+model seçicisidir. → CLI Entegrasyonları - 🛰️ Uzak mod — Kapsamlı erişim tokenlarıyla (
connect/contexts/tokens) uzak bir OmniRoute'u yönetin + VPS kurulumları için birantigravityOAuth yardımcısı. → Uzak Mod - 🧭 Daha akıllı otomatik yönlendirme —
auto/<kategori>:<katman>komboları, Fusion (model paneli + hakem), görev duyarlı yönlendirme, istek başına model / mod / USD bütçesi geçersiz kılmaları. → Auto-Combo - 🗜️ Eklenebilir sıkıştırma — 12 birleştirilebilir motor + Sıkıştırma Stüdyoları: LLMLingua-2, iki katmanlı Ultra, omniglyph, adım başına doğruluk kapısı, GCF v3.2, sürükle-bırak sıralama düzenleyicisi. → Sıkıştırma
- 🕵️ Şeffaf MITM şifre çözme (TPROXY) — SNI başına CA + güven deposu yükleyicisiyle proxy ortam değişkenlerini yoksayan CLI'ları yakalayın. → MITM/TPROXY
- 💸 Her yerde maliyet telemetrisi — Her uç noktada
X-OmniRoute-*maliyet/kullanım başlıkları, önbellek İSABETİ (cache-HIT) tasarruf başlığı, anahtar başına USD harcama kotaları. → API Referansı - 🧠 Kontrol ettiğiniz bellek — Varsayılan olarak kapalı, isteğe bağlı int8 vektör niceleme + tipli sönümleme, istek başına
x-omniroute-no-memory. → Bellek - 🛡️ Güvenlik — Her LLM rotasında istem enjeksiyonu koruması (red-team paketi), isteğe bağlı kimlik bilgisi maskeleme koruması (her iki yönde de sızan API anahtarlarını/gizli bilgileri sansürler), ücretsiz DuckDuckGo son çare web araması ve pano için isteğe bağlı OIDC giriş kapısı (şifreyle giriş her zaman kullanılabilir kalır). → Güvenlik Önlemleri (Guardrails)
- 🖼️ Yeni uç noktalar —
/v1/ocr(Mistral OCR) ve/v1/audio/translations(Whisper tarzı) medya yüzeyini tamamlar. → API Referansı - 🎨 Görsel / video / ses üretimi — Medya için tek bir API: xAI Grok Imagine ve Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind ve ElevenLabs gibi konuşma sağlayıcıları. → API Referansı
- 🌍 Dağıtım ve operasyonlar — Ters proxy
basePath, tarayıcı dili otomatik algılama, anahtar başına cihaz takibi, root gerektirmeyen MITM güveni, zh-TW yerelleştirmesi. → Ortam Değişkenleri - 🤝 Daha fazla sağlayıcı ve ajan — Cursor Cloud Agent, tarayıcı + OAuth girişiyle Grok Build (xAI), Ollama birinci sınıf kartı, Claude Opus 5 ve Sonnet 5, Kimi resmi ortaklığı (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… ve yenilenen 350 sağlayıcılı katalog. → Sağlayıcılar
- 📡 Yönlendirme şeffaflığı — Her yanıt, isteğe hizmet veren stratejiyi/sağlayıcıyı/gecikmeyi belirten bir
X-OmniRoute-Decisionbaşlığı taşır, yeni bircache-optimizedkombo stratejisi + Auto-CombocacheAffinityfaktörü yinelenen istekleri önbelleğe alınmış öneki tutan bağlantıya geri yönlendirir ve salt okunur bir/v1/auto-combo/{channel}/candidatesuç noktası birauto/*kanalının canlı aday havuzunu gösterir. → Auto-Combo - ⚡ Yerel performans ve altyapı — Tek tıkla yerel Redis, Cloudflare Workers / Deno Deploy röle dağıtıcıları, denetlenen yerleşik servisler olarak Bifrost ve Mux. → Gömülü Servisler
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.
Claude Code |
Codex CLI |
Cline |
Kilo Code |
Zoo Code |
Continue |
Aider |
ForgeCode |
jcode |
DeepSeek TUI |
CodeWhale |
OpenCode |
Factory Droid |
Copilot CLI |
Cursor CLI |
Smelt |
Pi |
Grok Build |
Hermes Agent |
OpenClaw |
Goose |
Open Interpreter |
Warp AI |
deyin.ai |
📖 36 aracın tümü için araç bazında kurulum (26 CLI Code + 10 CLI Agent) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode eklentisi → @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 bazında enjekte edilir, Qwen/Gemini geçici ve yalıtılmış bir ana dizin kullanır:
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 kiloHer komut etkin uzak bağlama (omniroute connect <host>) 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ı
Standart sohbet, medya, arama, yerel, bulut aracısı ve sistem koleksiyonlarında 357 kayıtlı sağlayıcı bulunuyor; bunların 152'si
hasFree: truekeşif meta verisi taşıyor. Sohbet modeli kayıt defteri 229 sağlayıcıyı / 2.554 farklı sağlayıcı-model çiftini / 1.283 ham model kimliğini kapsıyor; ayrı ücretsiz kullanım bütçesi kataloğunda ise model başına 491 satır, 35 yenilenen havuz ve 54 yenilenen/API anahtarı gerektirmeyen, sonsuza kadar ücretsiz sağlayıcı bulunuyor. Bunlar tasarım gereği farklı paydalardır; tanımlar ve havuz tekilleştirmeli hesaplamalar Sağlayıcı Referansı ve Ücretsiz Katmanlar sayfalarında yer alır.
OpenAI |
Anthropic |
Gemini |
xAI Grok |
DeepSeek |
Mistral |
Qwen |
Meta Llama |
Groq |
NVIDIA |
MiniMax |
Cohere |
Perplexity |
HuggingFace |
Together |
Fireworks |
Cloudflare |
Baidu |
…ve 330'dan fazlası — her simge doğrudan kontrol panelinin sağlayıcı kataloğundan yüklenir. 📖 Sağlayıcı Referansı
📖 Makine tarafından okunabilir tam katalog → docs/reference/PROVIDER_REFERENCE.md
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 |
| 🛠️ Kaynak koddan | npm install && npm run dev | Üzerinde çalışın, katkıda bulunun |
📖 Docker Rehberi · Masaüstü · Menü çubuğu tepsisi · Termux · PWA · OpenCode
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 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.
| Mağaza | Bağlantı | Uyumlu Olduğu Ortamlar |
|---|---|---|
| 🧩 VS Code Marketplace | Kur → | VS Code — kararlı sürüm ve Insiders |
| 🔓 Open VSX Registry | Kur → | Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro… |
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 adresindedir.
📖 VS Code Copilot Chat rehberi — kurulum, seçicide gösterilenler, sekme içinde kontrol paneli, sorun giderme
omniroute serveher zaman açık olduğunda en iyi şekilde çalışır. OmniRouteTray 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 veyanpm install -g omniroutekurulumuyla uğraşmanız gerekmez.
Tauri v2 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 |
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.
📖 Yetkilendirme · Güvenlik Önlemleri · Uyumluluk
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.
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ı denetlerOmniRoute 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.
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önerTokenlar read / write / admin kapsamlarına sahiptir; süreç başlatan rotalar yalnızca yerel döngüde (loopback) kalır.
📖 Uzak Mod
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ı |
| 📡 MCP (SSE) | /api/mcp/sse | Akışlı MCP taşıması |
| 🤝 A2A | /.well-known/agent.json | Ajandan ajana (Agent-to-agent), JSON-RPC 2.0 + SSE, 6 yetenek |
| 🌐 REST API | /v1/* | OpenAI uyumlu — sohbet, embeddings, görseller, ses, OCR |
| 🔔 Webhook'lar | /api/webhooks | 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 |
# 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 · A2A Sunucusu · Ajan Protokolleri
Varsayılan katmanlı kombo RTK → Caveman çalıştırır. Her ikisi de aynı araç/bağlam yükü üzerinde çalıştığında, tasarruflar katlanarak artar:
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 token işi görüyorsa neden çok token kullanasınız? Her istek OmniRoute'un sıkıştırma hattından şeffaf bir şekilde geçer — istemci değişikliği gerekmez. Artık sırayla çalışan ve yönlendirme kombosu başına karıştırılıp eşleştirilebilen 12 birleştirilebilir motordan oluşan bir yığındır — RTK, Caveman (⭐ 90K+), LLMLingua-2 ve Troglodita (PT-BR) fikirleri üzerine inşa edilmiştir.
Motorlar işlem hattı sırasına göre çalışır; her biri bağımsız olarak açılıp kapatılabilir ve kombo başına yapılandırılabilir:
| # | Motor | Ne yapar |
|---|---|---|
| 1 | Session-Dedup | Turlar arasında tekrarlanan içerikleri çıkarır (içerik adresli, turlar arası) |
| 2 | CCR | Büyük blokları geri getirme işaretçilerinin arkasında arşivler, talep üzerine getirir |
| 3 | Lite | Boşluklar + görsel URL'lerini kırpar (düşük gecikmeli temel hat) |
| 4 | RTK | Akıllı araç sonucu filtreleme, tekilleştirme ve kırpma (komut duyarlı) |
| 5 | Responses Tool Output | Kabuk/yama/arama/derleme çıktıları için kayıpsız öncelikli JSON + sınırlı tanısal sıkıştırma (Responses API) |
| 6 | Headroom | Yerleşik bir GCF codec'i aracılığıyla JSON dizilerinin kayıpsız tablosal sıkıştırılması (~%30) |
| 7 | Relevance | Son kullanıcı sorgusuna göre çıkarımsal cümle puanlaması |
| 8 | Caveman | Kural tabanlı düz yazı sıkıştırması (çıktıda ~%65–75) |
| 9 | Aggressive | Özetleme + eski turların kademeli yaşlandırılması |
| 10 | LLMLingua-2 | MobileBERT ONNX aracılığıyla ML anlamsal budama — kod güvenli, asenkron |
| 11 | Ultra | İsteğe bağlı küçük model (SLM) katmanıyla sezgisel token budama |
| 12 | OmniGlyph | Doğrudan Anthropic kablosu üzerindeki ölçülen Claude Fable 5 için deneysel görüntü olarak bağlam kodlama; GPT 5.6 dönüştürücüleri sağlayıcı dekontları beklenirken kapalı kalır. Dört sıkıştırma profili (agresif varsayılan, dengeli, kodlama güvenli, doğrudan geçiş) (en agresif; isteğe bağlı) |
Kod blokları, URL'ler ve yapılandırılmış veriler her zaman byte düzeyinde kusursuz korunur. Tek tıkla hazır önayarlar 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 | Uzun araç yoğun oturumlar |
| 🔥 Ultra | ~%75 | Maksimum tasarruf |
| 🧰 RTK | %60–90 | Kabuk/test/derleme/git çıktısı |
| 🔗 Katmanlı (RTK → Caveman) | %78–95 | Karışık istemler + araç günlükleri |
Gerçek örnek — Standard mod:
Önce (69 token): "The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."
Sonra (19 token): "New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."
Aynı yanıt. %72 daha az token. Sıfır doğruluk kaybı. ✅
PT-BR örneği — Troglodita modu:
Antes (42 tokens): "O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo."
Depois (12 tokens): "Re-render: ref nova cada ciclo (objeto inline recriado). Usar
useMemo."Mesma resposta. ~70% menos tokens. Precisão técnica intacta. ✅
Yukarıdaki 12 motor içeri giren metni küçültür. Üç ek katman ise nasıl, ne zaman ve neyin çıkacağını şekillendirir:
- 🪄 Çıktı Stilleri (çıktı ekseninde yönlendirme) — deterministik, önbellek güvenli yanıt şekillendirme talimatları enjekte eder; birleştirilebilir, her biri
lite/full/ultrayoğunluğundadır. Yeni bir stil eklemek tek satırlık bir kayıt işlemidir:- Terse prose — dolgu sözcükleri / makaleleri / tereddütlü ifadeleri çıkarır; teknik içeriği eksiksiz korur.
- Less code — "tembel kıdemli geliştirici" YAGNI yaklaşımı: istenmeyen iskele kodları olmadan çalışan en küçük değişiklik.
- Terse CJK (文言) — klasik Çince ultra kısa stil (
zhdiline kilitli).
- 🎯 Uyarlanabilir bağlam bütçesi (kadran) — tek bir açık/kapalı token eşiği yerine, yalnızca modelin bağlam penceresine sığması için gereken en ucuz ve en kayıpsız motorları kademeli olarak devreye sokar. İlke:
reserve-output(varsayılan, model duyarlı) ·percentage·absolute. Mod:floor(uyumu garanti eder) ·replace-autotrigger(açık seçiminiz kazanır) ·off(eski eşik). - 🎛️ Sıkıştırmaya nerede karar verilir (öncelik sırası, yüksekten düşüğe) — istek başına
x-omniroute-compressionbaşlığı › yönlendirme kombosu geçersiz kılma › aktif adlandırılmış profil › uyarlanabilir / otomatik tetikleyici › panel varsayılanı › kapalı. Uygulanan planX-OmniRoute-Compression: <mode>; source=<source>yanıt başlığında geri döndürülür.
Token eşiğine göre otomatik tetikleyin, uyarlanabilir kadranı açın, adlandırılmış bir profil sabitleyin, istek başına tek seferlik ayarlayın veya yönlendirme kombosu başına bir işlem hattı atayın — iş yüküne hangisi uyuyorsa. İsteğe bağlı bir çevrimdışı değerlendirme aracı (npm run eval:compression), bir değişikliği yayımlamadan önce sabit bir külliyat üzerinde doğruluk ile tasarrufu puanlar.
📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md
1) Kurun ve çalıştırın
npm install -g omniroute
omniroute💡
npm warn ERESOLVEveya eş bağımlılık (peer-dep) uyarıları mı görüyorsunuz? Zararsızdırlar.
Pano: http://localhost:20128 · API: http://localhost:20128/v1.
2) ÜCRETSİZ bir sağlayıcı bağlayın (kayıt gerekmez)
Pano → Sağlayıcılar (Providers) → Kiro AI (ücretsiz Claude, hesap başına aylık ~50 kredi) veya OpenCode Free (kimlik doğrulama yok) bağlayın → tamamlandı.
3) Kodlama aracınızı yönlendirin
Base URL: http://localhost:20128/v1
API Key: [Pano → Uç Noktalar sayfasından kopyalayın]
Model: auto (sıfır yapılandırmalı akıllı yönlendirme — veya herhangi bir sağlayıcı/model)4) Çalıştığını doğrulayın
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"Bağlı modellerinizi listelenmiş olarak görmelisiniz. 🎉 İşte bu kadar — kodlamaya başlayın, gerisini OmniRoute otomatik yönlendirsin ve gerektiğinde diğerine geçsin.
İstemciniz özel başlıklar (custom headers) gönderemiyorsa, OmniRoute belirteçli uyumluluk takma adları da sunar:
OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/
OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models
OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions
OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses
Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat
Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tagsBunları yalnızca Authorization: Bearer ... ekleyemeyen istemciler için kullanın. Başlık kimlik doğrulaması tercih edilen mod olmaya devam eder.
🐳 Docker
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ı. İ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 |
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:latestTam tablo: Docker Kılavuzu — çalışma zamanı RAM.
Ön sürüm Docker kanalı:
diegosouzapw/omniroute:nextvediegosouzapw/omniroute:next-webgeçerli varsayılanrelease/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ı.
🥟 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şikbun:sqlitesürücüsünü kullanır; Node.js altındabetter-sqlite3veyasql.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 .).
# Bun ile kurun ve çalıştırın
bun install
bun run dev🛠️ Kaynak koddan
cp .env.example .env && npm install
PORT=20128 npm run dev📦 pnpm
pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute🐧 Arch Linux (AUR)
yay -S omniroute-bin && systemctl --user enable --now omniroute.service🔧 Nix (Flake)
# Nix flakes kullanarak
nix develop
npm run dev
# Veya devbox kullanarak
devbox run npm run dev📖 Docker Kılavuzu — Compose profilleri, Caddy HTTPS, Cloudflare tünelleri.
🦭 Podman
# 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 --buildmacOS veya Windows üzerinde Podman uzak bir Podman Machine kullanır: podman unshare adımını atlayın ve
topolojiye özel veri dizini rehberini izleyin.
📖 Podman Kılavuzu — 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):
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 de bunu atlarEn 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 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.
Sosyal medya verileri (2026-08-17) · YT: 741 | TT: 137 | IG: 124 · Tazelik (gün): YT 0 · TT 14 · IG 15
Tam sıralama (v > 0, en yüksek erişim):
| #1 | #2 | #3 | #4 | #5 |
|---|---|---|---|---|
| nick_saraev — Instagram — 1.628.910 | milesreevesai — TikTok — 620.400 | Vaibhav Sisinty — YouTube — 373.084 | Nick Automates — YouTube Shorts — 207.714 | midudev — TikTok — 177.800 |
| #6 | #7 | #8 | #9 | #10 |
|---|---|---|---|---|
| theopenstack — Instagram — 155.453 | t.ghoush.ai — TikTok — 152.800 | Valency Labs — YouTube — 135.974 | Asati — YouTube — 126.130 | Vaibhav Sisinty — YouTube — 122.672 |
Doğrulama metrikleri: 1002 takip edilen video · 7.069.190 bilinen görüntüleme · 595 profil/kanal · 13+ dil · 13+ içerik üreticisi.
🎬 OmniRoute hakkında bir video mu çektiniz? Bağlantıyla birlikte bir issue veya discussion açın — burada yer verelim.
Her şey tek bir yerde — geliştiriciyi takip edin, toplulukla sohbet edin veya bir issue açın.
| Kanal | Nerede / Nasıl |
|---|---|
| 💼 LinkedIn — geliştiriciyi takip edin | linkedin.com/in/diegosouzapw |
| 🐙 GitHub — sürümler ve ipuçları için | @diegosouzapw |
| 💬 Discord | discord.gg/U47eFqAXCn |
| t.me/omnirouteOficial | |
| 🟢 WhatsApp — 🌍 Global | gruba katılın |
| 🟢 WhatsApp — 🇧🇷 Brezilya | gruba katılın |
| 🌍 Web Sitesi | omniroute.online |
| 📦 Kaynak Kod | github.com/diegosouzapw/OmniRoute |
| 🐛 Hata Bildirimi | issue açın — npm run system-info çıktısını ekleyin |
| 🤝 Katkıda Bulunun | CONTRIBUTING.md · Dallanma ve Sürüm Modeli · bir good first issue seçin |
| 💚 Projeyi Destekleyin | Destekleme yolları ↑ · GitHub Sponsors |
| Katman | Teknoloji |
|---|---|
| Çalışma zamanı | Node.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27 |
| Dil | TypeScript 6.0 — src/ ve open-sse/ genelinde %100 TypeScript (v2.0'dan beri çekirdekte sıfır any) |
| Çatı | Next.js 16 + React 19 + Tailwind CSS 4 |
| Veritabanı | better-sqlite3 (SQLite, WAL günlükleme) + LowDB (JSON eski sistem) — 122 alan modülü, 190 migrasyon |
| Bellek | SQLite FTS5 tam metin + int8 ile nicemlenmiş vektör gömmeleri, türü belirlenmiş azalma |
| Şemalar | Zod 4 — MCP araç G/Ç doğrulaması + API sözleşmeleri |
| Protokoller | MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE) |
| Akış | Sunucu Gönderimli Olaylar (SSE) + WebSocket köprüsü (/v1/ws) |
| Sıkıştırma | 12 motorlu işlem hattı — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph |
| Kimlik doğrulama ve güvenlik | OAuth 2.0 (PKCE) + JWT + API Anahtarları + MCP kapsamlı kimlik doğrulama · bekleyen veriler için AES-256-GCM · DOMPurify |
| Gizlilik | wreq-js — JA3 / JA4 TLS parmak izi taklidi, 3 seviyeli proxy |
| Dayanıklılık | Devre kesici, üstel geri çekilme, yoğun istek yığılmasını önleme, otomatik kombinasyonlu kendi kendini iyileştirme |
| Günlükleme | pino — istek bağlamıyla 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ı) |
| CI/CD | GitHub Actions — sürüm yayımlandığında otomatik npm yayını + Docker Hub |
| Bağlantılar | Web sitesi · npm · Docker Hub |
| Belge | Açıklama |
|---|---|
| Kullanıcı Kılavuzu | Sağlayıcılar, kombinasyonlar, CLI entegrasyonu, dağıtım |
| Kurulum Kılavuzu | Tüm kurulum yöntemleri, CLI aracı yapılandırmaları, protokol kurulumu, zaman aşımı ayarları |
| CLI Araçları Kılavuzu | Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo ve Copilot için araca özel kurulum |
| Uzak Mod | Kapsamlı erişim belirteçleri aracılığıyla dizüstü bilgisayarınızın CLI'ından uzaktaki bir OmniRoute'u (VPS) yönetin |
| Claude Code Yapılandırması | launch ve model başına profillerle Claude Code'u OmniRoute'a (yerel/uzak) yönlendirin |
| Hızlı Başlangıç | 3 adımda kurulum → bağlantı → yapılandırma |
| Belge | Açıklama |
|---|---|
| Docker Kılavuzu | Docker çalıştırma, Compose profilleri, Caddy HTTPS, tüneller, imaj etiketleri |
| Podman Kılavuzu | Quadlet systemd entegrasyonu, podman-compose, SELinux |
| VM Dağıtımı | Eksiksiz kılavuz: VM + nginx + Cloudflare kurulumu |
| Fly.io Dağıtımı | Kalıcı depolama ile Fly.io'ya dağıtım |
| Termux Kılavuzu | OmniRoute'u Termux aracılığıyla Android'de çalıştırın |
| PWA Kılavuzu | Progresif Web Uygulaması kurulumu, önbelleğe alma, mimari |
| Kaldırma Kılavuzu | Tüm kurulum yöntemleri için temiz kaldırma |
| Ortam Yapılandırması | Tüm .env değişkenleri ve referansları |
| Belge | Açıklama |
|---|---|
| Mimari | Sistem mimarisi, veri akışı ve iç işleyiş |
| Sıkıştırma Kılavuzu | 7 seçenekli işlem hattı: kapalı / hafif / standart / agresif / ultra / RTK / yığınlı |
| RTK Sıkıştırması | Komut çıktısı sıkıştırması, filtreler, güven, doğrulama, ham çıktı kurtarma |
| Sıkıştırma Motorları | Caveman, RTK, yığınlı işlem hatları, pano/API/MCP arayüzleri |
| Sıkıştırma Kuralları Biçimi | Caveman ve RTK filtreleri için JSON kural paketi şemaları |
| Sıkıştırma Dil Paketleri | Dil algılama ve Caveman kural paketi yazımı |
| Dayanıklılık Kılavuzu | Devre kesiciler, bekleme süreleri, kuyruk, yoğun istek yığını önleme, TLS sahteciliği |
| Otomatik Kombinasyon Motoru | 16 faktörlü puanlama, mod paketleri, kendi kendini iyileştirme |
| Proxy Kılavuzu | 3 seviyeli proxy sistemi, 1proxy pazaryeri, kayıt defteri CRUD işlemleri |
| Ücretsiz Katmanlar | Birleştirilmiş dizin: belgelenmiş 35 yinelenen havuz / kataloglanmış 489 ücretsiz katman girdisi |
| Özellik Galerisi | Ekran görüntüleriyle görsel pano turu |
| Kod Tabanı Dokümantasyonu | Yeni başlayanlara uygun kod tabanı tanıtımı |
| Belge | Açıklama |
|---|---|
| API Referansı | Örneklerle birlikte tüm uç noktalar |
| OpenAPI Belirtimi | OpenAPI 3.0 belirtimi |
| MCP Sunucusu | 110 MCP aracı, IDE yapılandırmaları, Python/TS/Go istemcileri |
| MCP Sunucusu Kılavuzu | MCP kurulumu, aktarımlar ve araç referansı |
| A2A Sunucusu | JSON-RPC 2.0 protokolü, beceriler, akış, görev yönetimi |
| A2A Sunucusu Kılavuzu | A2A aracı kartı, görevler, beceriler ve akış |
| Belge | Açıklama |
|---|---|
| Katkıda Bulunma | Geliştirme kurulumu ve yönergeleri |
| Dallanma ve Sürüm Modeli | PR'lerin hedeflediği yer (release/*) ile main ve etiketlerin anlamı |
| Değişiklik Günlüğü | Sürüm bazında eksiksiz yayın geçmişi |
| Güvenlik Politikası | Güvenlik açıklarını bildirme ve güvenlik uygulamaları |
| i18n Kılavuzu | 42 dil desteği, çeviri iş akışı, RTL |
| Sürüm Kontrol Listesi | Sürüm öncesi doğrulama adımları |
| Kapsama Planı | 5.100'den fazla izlenen test dosyasındaki 39.000'den fazla statik test bildirimi için test kapsamı stratejisi |
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.
| Sıra | Katkıda Bulunan | Birleştirilen PR'ler | ~Değiştirilen satır |
|---|---|---|---|
| 1 | backryun | 190 | 227,977 |
| 2 | oyi77 | 180 | 407,678 |
| 3 | rdself | 145 | 80,663 |
| 4 | JxnLexn | 128 | 387,049 |
| 5 | KooshaPari | 101 | 125,747 |
| 6 | herjarsa | 88 | 230,872 |
| 7 | RaviTharuma | 79 | 55,106 |
| 8 | maxmad64bis | 69 | 394,715 |
| 9 | artickc | 59 | 33,260 |
| 10 | HouMinXi | 51 | 47,334 |
| 10 | chirag127 | 51 | 5,153 |
| 12 | xz-dev | 50 | 245,976 |
| 13 | hartmark | 47 | 52,185 |
| 14 | rqzbeh | 39 | 143,181 |
| 15 | dhaern | 34 | 19,559 |
| 16 | Dingding-leo | 33 | 1,986 |
| 17 | NomenAK | 32 | 13,854 |
| 18 | MumuTW | 30 | 16,953 |
| 19 | benzntech | 29 | 11,641 |
| 20 | pacocartones | 24 | 9,331 |
| 20 | Prudhvivuda | 24 | 6,312 |
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.
|
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 |
|
Dizzle 🏅 GitHub tarafından ilişkilendirilen 69 commit · 6. sırayı paylaşıyor |
Jan Leon 🏅 GitHub tarafından ilişkilendirilen 64 commit |
zenobit 🏅 GitHub tarafından ilişkilendirilen 62 commit |
Bob.Hou 🏅 GitHub tarafından ilişkilendirilen 51 commit · 10. sırayı paylaşıyor |
Xiangzhe 🏅 GitHub tarafından ilişkilendirilen 51 commit · 10. 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.
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.
![]() Prof. Igor Morais 💛 Sponsor |
![]() longtao 💛 Sponsor |
…ve gizli kalmayı tercih eden diğerleri 💛
💖 Sponsor olun → — her bir dolar OmniRoute'un ücretsiz ve bağımsız kalmasını sağlar.
- Depoyu forklayın
- Aktif
release/vX.Y.Zdalından (maindeğil) bir dal oluşturun — bkz. Dallanma ve Sürüm Modeli - Özellik dalınızı oluşturun (
git checkout -b feat/harika-ozellik) - Değişikliklerinizi commit edin (
git commit -m 'feat: harika ozellik ekle') - Dalınıza push edin (
git push origin feat/harika-ozellik) - Hedef dal = ilgili
release/vX.Y.Zdalı olacak şekilde bir Pull Request açın
Ayrıntılı yönergeler için CONTRIBUTING.md dosyasına bakın.
# 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-notesOmniRoute devlerin omuzlarında yükselmektedir. 9router projesinin bir çatalı ve Go projesi 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.
| Proje | ⭐ | OmniRoute'a nasıl ilham verdi |
|---|---|---|
| 9router | 22.7k | Bu çatalın üzerine inşa edildiği orijinal proje — çok modlu API'ler ve tam bir TypeScript yeniden yazımı ile burada genişletildi. |
| CLIProxyAPI | 43.6k | Bu JavaScript / TypeScript uyarlamasına ilham veren Go uygulaması. |
| LiteLLM | 54.0k | 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. |
| Proje | ⭐ | OmniRoute'a nasıl ilham verdi |
|---|---|---|
| Caveman | 90.8k | 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. |
| RTK – Rust Token Killer | 71.8k | 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. |
| headroom | 60.1k | Geri döndürülebilir bağlam sıkıştırması (SmartCrusher) — headroom motorumuza ve ccr geri getirme işaretçisi modeline ilham verdi. |
| LLMLingua | 6.5k | İ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. |
| llmlingua-2-js | 30 | LLMLingua motorumuz için çalışan iş parçacığı (worker-thread) arka ucu olarak kullanılan JS/ONNX portu (MobileBERT / XLM-RoBERTa). |
| Troglodita | 26 | 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. |
| ponytail | 86.0k | 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). |
| Proje | ⭐ | OmniRoute'a nasıl ilham verdi |
|---|---|---|
| TOON | 24.9k | Token-Oriented Object Notation — sütunlu, başlık artı satırlar modeli tablosal sıkıştırma aşamamızı şekillendirdi. |
| GCF – Graph Compact Format | 22 | İ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. |
| token-optimizer-mcp | 444 | Brotli/SQLite önbelleği + oturum başına bağlam deltası — session-dedup motorumuza ilham verdi. |
| token-savior | 1.1k | Bash çıktısı sıkıştırması + MCP profilleri — sıkıştırmadan vazgeçme disiplinimize ve MCP araç bildirimi küçültmesine ilham verdi. |
| token-saver | 117 | 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ı. |
| token-optimizer | 1.7k | "Hayalet tokenları bulun" — boşaltma + kurtarılabilir tanıtıcı modeli CCR boşaltma düşüncemizi besledi. |
| TokenMizer | 16 | Oturum grafiği + turlar arası satır tekilleştirme taslağı session-dedup tasarımımızı besledi. |
| OmniCompress | 3 | 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ı. |
| mcp-compressor | 98 | MCP araç şeması/açıklama sıkıştırması — MCP araç bildirimi kardinalite azaltmamızı besledi. |
| RepoMapper | 187 | Aider tarzı depo haritası sıralaması — depo haritası / getirme sıralaması keşfimizi besledi. |
| quiet-shell-mcp | 4 | MCP üzerinden bildirimsel kabuk çıktısı azaltma — bildirimsel bash çıktısı sıkıştırmamızı doğruladı. |
| ts-morph | 6.1k | TypeScript Compiler API araç seti — dize, şablon ve regex sabit değerlerini koruyan ayrıştırıcı tabanlı yorum satırı temizlememize ilham verdi. |
| Proje | ⭐ | OmniRoute'a nasıl ilham verdi |
|---|---|---|
| Mem0 | 61.2k | Evrensel bellek katmanı — yazma/okuma sınırı olarak proxy modeli bellek mimarimizi şekillendirdi. |
| Letta (MemGPT) | 23.9k | Kademeli belleğe sahip durum bilgisi tutan ajanlar — Bağlam Kontrolü ve Kurtarma (CCR) kademeli modelimize ilham verdi. |
| WFGY | 1.8k | 16 tekrarlayan RAG/LLM hata modunun ProblemMap sınıflandırması — sorun giderme kılavuzumuzdaki paylaşılan terminoloji. |
| Proje | ⭐ | OmniRoute'a nasıl ilham verdi |
|---|---|---|
| llm-interceptor | 49 | 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). |
| ProxyBridge | 5.5k | 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. |
| Proje | ⭐ | OmniRoute'a nasıl ilham verdi |
|---|---|---|
| models.dev | 6.0k | Yapay zeka modeli özellikleri, fiyatlandırması ve yeteneklerinin açık veritabanı — model kataloğumuzla yerel olarak senkronize edilir. |
| React Flow / xyflow | 37.7k | Gerçek zamanlı Sıkıştırma Stüdyomuzu ve Kombo/Yönlendirme Stüdyomuzu destekleyen düğüm tabanlı grafik kütüphanesi. |
| LangGraph | 37.6k | LangGraph Studio'nun canlı iş akışı grafiği görselleştirmesi, Stüdyolarımızın gerçek zamanlı basamaklı görünümüne ilham verdi. |
| Langfuse | 31.4k | İzleme → aralık → üretim gözlemlenebilirlik modeli Sıkıştırma Stüdyosu şelale görünümümüzü şekillendirdi. |
| Kiali | 3.6k | Istio servis ağı (service-mesh) gözlemlenebilirliği — Yönlendirme/Kombo Stüdyosundaki devre kesici rozetlerimize ve hata kenarı görsellerimize ilham verdi. |
| lobe-icons | 2.2k | Panomuz genelinde sağlayıcı simgelerini oluşturan yapay zeka/LLM marka logoları. |
| Proje | ⭐ | OmniRoute'a nasıl ilham verdi |
|---|---|---|
| awesome-secure-defaults | 710 | 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). |
| Proje | ⭐ | OmniRoute'a nasıl ilham verdi |
|---|
MIT Lisansı - ayrıntılar için LICENSE dosyasına bakın.
⬆ Başa dön · Açık kaynaklı yapay zeka topluluğu için ❤️ ile geliştirildi.
OmniRoute v3.8.49 · Node ≥22.22.2 · MIT Lisansı · omniroute.online



