OmniRoute/docs/i18n/tr

🚀 OmniRoute — Ücretsiz AI Ağ Geçidi

💰 Aylık ~1.51 Milyar Ücretsiz Token

Ücretsiz katmanları elle birleştirmek zahmetlidir — düzinelerce SDK, düzinelerce hız sınırı ve elinizde gerçekte ne kadar kota olduğuna dair hiçbir fikir olmaması. OmniRoute, 42 sağlayıcı havuzunda / 495 modelde yer alan belgelenmiş ücretsiz katmanları tek bir dürüst sayıda toplar ve bunu panoda canlı olarak gösterir (/dashboard/free-tiers).

Canlı /dashboard/free-tiers sayfasının animasyonlu özeti. Tam metodoloji (havuz tekilleştirme, kredi katmanları, sağlayıcı şartları): docs/reference/FREE_TIERS.md.

_{Bu rakamlar canlı kataloğa göre iki haftada bir yeniden denetlenir ve her iki yönde de değişir — bir sağlayıcı ücretsiz katmanı sonlandırırsa sayı düşer; yeni biri gelirse yükselir. Asla yuvarlanmış iyimser senaryoları değil, kataloğun gerçekten hesapladığı değerleri yayımlıyoruz.}

⭐ OMNIROUTE paradan tasarruf etmenize ve işinizi kolaylaştırmanıza yardımcı olduysa depoya yıldız verin.

💬 Topluluğa katılın

👋 Geliştiriciyi takip edin — yeni sağlayıcılara, sürümlere ve ipuçlarına ilk siz ulaşın:

Sorular, sağlayıcı ipuçları, yol haritası ve destek → Discord · Telegram · WhatsApp 🌍 Global / 🇧🇷 Brezilya

📈 Ağ Geçidi Büyümeye Devam Ediyor

	v3.8.49	v3.8.50	v3.8.51+
🌐 Sağlayıcılar	290	342	kuyrukta dahası var
🧠 Belgelenmiş modeller	1185	1202	—
🖼️ Modalite Köprüsü (Modality Bridge)	—	🆕 vision	video
📡 Radar ücretsiz kataloğu	—	🆕 isteğe bağlı	—
⚖️ Kota duyarlı zamanlama	—	—	🔭 sırada
📊 Kota telemetrisi	—	—	🔭 sırada

→ Yol Haritası — v3.9.0 LTS hedefine doğru ilerliyor

🧩 Kullanılabilirlik

🚀 Başlangıç	🚀 Hızlı Başlangıç	📦 Kurulum	🆓 Sıfır Yapılandırma
💡 Öğrenin	💥 Vaat	🤔 Neden OmniRoute	🏆 Fark Yaratanlar
⚙️ Özellikler	🎯 Kombolar	🌐 Sağlayıcılar	🔌 CLI & MCP
	🗜️ Sıkıştırma	🖥️ Nerede Çalışır	🔒 Gizlilik
👀 İnceleyin	🎬 İş Başında	✨ Yenilikler	🤖 Uyumlu CLI'lar
💚 Destek	💚 Destek / Bağış	💬 Topluluk	💖 Sponsorlar
📦 Proje	🛠️ Teknoloji Yığını	📖 Belgeler	👥 Katkıda Bulunanlar

🌐 43 dilde

🆓 Kurduğunuz anda çalışır — anahtar yok, yapılandırma yok

# Fresh install, zero credentials — `auto` already works:
curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

_{Belirli bir ücretsiz arka uç mu tercih ediyorsunuz? Doğrudan çağırın, örn. oc/… (OpenCode Free) veya felo/… (Felo). Ardından auto modeline geçin ve seçimi OmniRoute'a bırakın.}

_{📦 Python, Node.js, PHP ve cURL için kopyala-yapıştır hızlı başlangıç betikleri → examples/quickstart/}

💥 Vaat

🤔 Neden OmniRoute?

🤝 Açık Kaynak Dostlarımız Tarafından Desteklenmektedir

Açık Kaynak Dostu olarak katılmak ister misiniz? Bunlar açık kaynağı destekleyen ve OmniRoute'un gelişimine güç katan şirketlerdir — ve bize sağladıkları her tokenın nereye gittiğini kamuoyuna açıkça belirtiyoruz. İletişime geçin: diegosouza.pw@outlook.com

Kimi Moonshot AI

Bu projeyi destekleyen kurucu Açık Kaynak Dostumuz Kimi'ye (Moonshot AI) teşekkür ederiz! Kimi, açık ağırlıklı K2 ve K3 model ailelerinin arkasındaki yapay zeka laboratuvarıdır — Kimi K3, 1 milyon tokenlık bağlam penceresi, yerel görüntü yeteneği (vision) ve kapalı model fiyatlarının çok altında öncü düzeyde kodlama performansı sunar; Claude Code, Codex ve OmniRoute'un sunduğu tüm kodlama araçlarıyla kutudan çıktığı gibi çalışır. Kimi desteğinin sağladıkları: Kimi'nin API kredileri, OmniRoute'un yapay zeka ile doğrulanan sürüm hattına —her çekme isteğini (PR) yayımlanmadan önce inceleyen Kimi K3 destekli birleştirme doğrulama aşamasına— ve günlük özellik geliştirmelerine güç verir. Birinci sınıf Kimi desteği her iki kanalda da sunulur: doğrudan Kimi API (kimi-k3) ve Kimi Code kodlama planı (OAuth ve API anahtarı). OmniRoute ayrıca Kimi'nin destek programındaki ilk Brezilya açık kaynak projesidir. %15 ekstra kredili Kimi API anahtarı alın →

Cheaper Inference cheaperinference.com

Bu projeyi destekleyen OmniRoute Açık Kaynak Dostu Cheaper Inference'a teşekkürler! Cheaper Inference, tek bir OpenAI uyumlu uç nokta arkasında 42 öncü modeli (Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ve MiniMax) maliyete göre sıralayan bir ağ geçididir; her isteği model üreticisinin liste fiyatının üzerinde asla ücretlendirmeden en ucuz uygun sağlayıcıya yönlendirir. OmniRoute'ta birinci sınıf destek: Chat Completions, yerel /v1/responses uç noktası, vision, araç çağırma ve 3 görsel modeli (cheaperinference/<model> olarak erişilebilen grok-imagine, nano-banana-pro, nano-banana-2). API anahtarı alın →

_{aff=omniroute etiketli bağlantılar ortaklık bağlantılarıdır. Size hiçbir ek maliyet getirmeden projeyi finanse eder.}

_{🎟️ Ortaklık Promosyonları — 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 tavsiye/kupon kodları içindir. Sponsorlu ortaklıklar yukarıdaki 🤝 Açık Kaynak Dostlarımız Tarafından Desteklenmektedir bölümünde yer alır. OmniRoute'un burada listelenen sağlayıcılarla hiçbir sponsorluğu veya ortaklığı yoktur — bunlar herkesin kullanabileceği kamuya açık kuponlardır.}

AgentRouter agentrouter.org

AgentRouter — ortaklık kaydı · Kayıtta 100$ ücretsiz kredi (ücretsiz sunucu, daha yüksek gecikme süresi bekleyin — üretim için değil, test için en iyisidir). v3.8.50 sürümünden itibaren OmniRoute'ta birinci sınıf destek: Chat Completions, 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ı yer alır. 100$'ınızı hemen alın → ⚠️ Ortaklık bağlantısı — OmniRoute'un bu sağlayıcıyla hiçbir sponsorluğu veya ortaklığı yoktur.

_{OmniRoute kullanıcılarına fayda sağlayan cömert bir ücretsiz kayıt kuponuna sahip başka bir sağlayıcı biliyor musunuz? Bir issue açın, buraya ekleyelim.}

🎯 Kombolar — Amiral Gemisi

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. 🛡️

⚡ Sıfır yapılandırma — sadece auto kullanın

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ı

🔀 Veya kendinizinkini oluşturun — 19 yönlendirme stratejisi

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.}

🧱 Dayanıklılık yerleşiktir (3 bağımsız katman)

_{📖 Auto-Combo Motoru · Dayanıklılık Kılavuzu}

🏆 OmniRoute'u Farklı Kılan Nedir

_{📊 9router, OpenRouter, CLIProxyAPI ve LiteLLM'e karşı tam metodoloji ve özellik bazında detaylar → 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.

⭐ 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

_{⚠️ 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) 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

Ana ücretsiz katman başlığı, yukarıdaki belgelenmiş ve havuz tekilleştirmesi yapılmış katalogdan aylık ~1.53 milyar token olarak kalmaya devam eder. Geçici sağlayıcı kayıt kredileri ilk ayı ayrıca ~2.15 milyar token seviyesine çıkarabilir. Radar, OmniRoute sürümleri arasında daha güncel ücretsiz model kullanılabilirliği 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ğu ve ek sağlayıcı fırsatlarını alabilir. Ayrı ve değişken tavanı, sağlayıcı kullanılabilirliğine bağlı olarak ayda en fazla yaklaşık 3 milyar token düzeyindedir. Bu tavan bir garanti değildir: sağlayıcılar kotaları, uygunlukları, modelleri veya bölgeleri istedikleri zaman değiştirebilir.

Radar isteğe bağlıdır (opt-in) ve yalnızca GET istekleri yapar. OmniRoute istemcisi istemleri, trafiği, sağlayıcı yapılandırmasını, kullanım telemetrisini veya yerel duyuru kapatma durumunu asla yüklemez (upload etmez). Uygunluk ve mevcut katalog hakkında bilgi edinmek için: radar.omniroute.online/planos.

✨ Yenilikler

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/models sı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 run sıfır yapılandırma yazarak 7 CLI'yı (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) başlatır; omniroute configure bağ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 bir antigravity OAuth 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, Freepik, Adobe Firefly, Microsoft Designer, Segmind, EdgeTTS. → 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-Decision başlığı taşır, yeni bir cache-optimized kombo stratejisi + Auto-Combo cacheAffinity faktörü yinelenen istekleri önbelleğe alınmış öneki tutan bağlantıya geri yönlendirir ve salt okunur bir /v1/auto-combo/{channel}/candidates uç noktası bir auto/* 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

🤖 Uyumlu CLI'lar ve Kodlama Ajanları

Tek bir yapılandırma — http://localhost:20128/v1 — ve her yapay zeka destekli IDE veya CLI, ücretsiz ve düşük maliyetli modeller üzerinde ç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	Agent Deck

＋ ayrıca şunlarla da çalışır · Kiro · Command Code · Antigravity · Windsurf · AMP · herhangi bir OpenAI uyumlu araç

_{📖 34 aracın tümü için araç bazında kurulum (26 CLI Kodlama + 8 CLI Ajanı) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode eklentisi → @omniroute/opencode-provider}

Desteklenen herhangi bir CLI'yı OmniRoute üzerinden tek bir komutla başlatın — hiçbir yapılandırma dosyası yazılmaz, kimlik bilgileri süreç başına enjekte edilir, Qwen/Gemini tek kullanımlık yalıtılmış bir ana dizin alı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 cline continue kilo

Her komut aktif uzak bağlama (omniroute connect <host>) uyar, --dry-run çalıştırmadan tam ortamı/argümanları önizler ve --api-key-env NAME sırları kabuk geçmişinizin dışında tutar. → CLI Entegrasyonları

🌐 349 AI Sağlayıcısı — 90+ Ücretsiz

Açık kaynaklı herhangi bir yönlendiricinin en eksiksiz kataloğu: 349 sağlayıcı, ücretsiz katmanı olan 90+ sağlayıcı, sonsuza kadar ücretsiz 56 sağlayıcı.

🏢 Her büyük laboratuvar — 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 220+ fazlası — her simge panonun sağlayıcı kataloğundan canlı olarak çözümlenir. 📖 Sağlayıcı Referansı}

🆓 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 gerekmez	Cloudflare AI 50+ model 10K nöron/gün	NVIDIA NIM GLM, MiniMax ~40 RPM ücretsiz	Cerebras GLM 4.7, GPT-OSS 1M token/gün	OpenRouter :free modeller +$10 → daha yüksek RPM

📖 Tam makine tarafından okunabilir katalog → docs/reference/PROVIDER_REFERENCE.md

🖥️ OmniRoute Nerede Çalışır — Her Yerde

Aynı uygulama, sizin makineniz, sizin kurallarınız. Genel bir npm kurulumundan Termux ile telefonunuza kadar.

Platform	Kurulum	Öne Çıkanlar
📦 npm (global)	npm install -g omniroute	Tek komut, tüm işletim sistemleri
🐳 Docker	docker run … diegosouzapw/omniroute	Çoklu mimari AMD64 + ARM64
🖥️ Masaüstü (Electron)	npm run electron:build	Yerel pencere + sistem tepsisi — Windows / macOS / Linux
💪 ARM	yerel arm64	Raspberry Pi, ARM sunucuları, Apple Silicon
📱 Android (Termux)	pkg install nodejs && npx -y omniroute	Telefonunuzda çalışır, 7/24, root gerekmez
📲 PWA	"Ana Ekrana Ekle"	Tam ekran, çevrimdışı, tarayıcıdan yüklenebilir
🧩 OpenCode eklentisi	@omniroute/opencode-provider	Yerel OpenCode entegrasyonu
🤖 VS Code Copilot Chat	OmniCopilot eklentisini kurun	Yerel Copilot Chat seçicisinde her OmniRoute modeli — stable ve Insiders
🛠️ Kaynak koddan	npm install && npm run dev	Geliştirin, katkıda bulunun

_{📖 Docker Kılavuzu · Masaüstü · Termux · PWA · OpenCode}

🧩 Yeni: VS Code'un yerel Copilot Chat'i içinde OmniRoute

Yeni bir kenar çubuğu yok, yeni bir 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'den bu yana, sağlayıcı modelleri GitHub oturumu veya Copilot aboneliği olmadan çalışır — ajan modu, araç çağırma ve vision, ücretsiz olarak.

OmniCopilot eklentisini kurun, OmniRoute sunucunuza yönlendirin (varsayılan: localhost:20128), ardından Copilot Chat → model seçici → Modelleri Yönet… (Manage Models…) → OmniRoute yolunu izleyin.

Mağaza	Bağlantı	Şunlarla çalışır
🧩 VS Code Marketplace	Kurun →	VS Code — stable ve Insiders
🔓 Open VSX Registry	Kurun →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Düzenleyicinin içinden: Uzantılar (Extensions) görünümünü açın, "OmniRoute" araması yapın, Kur (Install) butonuna tıklayın — her iki mağazada da aynı şekilde çalışır. Kaynak kod, sorun bildirimleri ve yayınlama rehberi: diegosouzapw/OmniCopilot.

_{📖 VS Code Copilot Chat kılavuzu — kurulum, seçicinin gösterdikleri, sekmede pano, sorun giderme}

🔒 Gizli ve Önce Yerel (Local-First)

_{📖 Yetkilendirme · Güvenlik Önlemleri · Uyumluluk}

🔌 Tam CLI + A2A ve MCP

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)

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.

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}

🤝 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ı
📡 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}

🗜️ Tokenlardan %15–95 Tasarruf Edin — Otomatik Olarak

📖 Nasıl çalışır — işlem hattı, mimari ve tasarruf matematiği

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.

🧱 12 motorlu sıkıştırma yığını

Motorlar işlem hattı sırasına göre çalışır; her biri bağımsız olarak açılıp kapatılabilir ve 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. ✅

🎚️ Motorların ötesinde — çıktı stilleri, uyarlanabilir kadran ve istek başına kontrol

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 / ultra yoğ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 (zh diline 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-compression başlığı › yönlendirme kombosu geçersiz kılma › aktif adlandırılmış profil › uyarlanabilir / otomatik tetikleyici › panel varsayılanı › kapalı. Uygulanan plan X-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

⚡ Hızlı Başlangıç

1) Kurun ve çalıştırın

npm install -g omniroute
omniroute

💡 npm warn ERESOLVE veya 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/tags

Bunları yalnızca Authorization: Bearer ... ekleyemeyen istemciler için kullanın. Başlık kimlik doğrulaması tercih edilen mod olmaya devam eder.

📦 Daha fazla kurulum yöntemi — Docker, kaynak kod, pnpm, Arch

🐳 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:latest

Tam tablo: Docker Kılavuzu — çalışma zamanı RAM.

Ö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ı.

🥟 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 .).

# 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 --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 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 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 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.

🎬 OmniRoute İş Başında

📹 Video Rehberleri

_{Sosyal medya verileri (2026-08-17) · YT: 741 | TT: 137 | IG: 124 · Tazelik (gün): YT 0 · TT 14 · IG 15}

🎬 #1 — Instagram nick_saraev — 1.628.910 görüntüleme

🎬 #2 — YouTube Vaibhav Sisinty — 373.084 görüntüleme

🎬 #3 — YouTube Shorts Nick Automates — 207.714 görüntüleme

🎬 #4 — TikTok milesreevesai — 620.400 görüntüleme

🎬 #5 — YouTube Valency Labs — 135.974 görüntüleme

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.

📧 Topluluk ve Yardım

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
✈️ Telegram	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

---

🛠️ Teknoloji Yığını

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 bu yana çekirdekte sıfır any)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Veritabanı	better-sqlite3 (SQLite, WAL günlük kaydı) + LowDB (JSON eski) — 120 alan modülü, 159 migrasyon
Bellek	SQLite FTS5 tam metin + int8 nicelenmiş vektör embeddings, tipli sönümleme
Ş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ış (Streaming)	Server-Sent Events (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 & Güvenlik	OAuth 2.0 (PKCE) + JWT + API Anahtarları + MCP kapsamlı yetkilendirme · Dinlenmede AES-256-GCM · DOMPurify
Gizlilik (Stealth)	wreq-js — JA3 / JA4 TLS parmak izi taklidi, 3 seviyeli proxy
Dayanıklılık	Devre kesici, üstel geri çekilme, sürü önleme (anti-thundering-herd), auto-combo kendi kendini iyileştirme
Günlük Kaydı (Logging)	pino — istek bağlamına sahip yapılandırılmış JSON günlükleri
Test	Node.js test runner + Vitest — 3.300'den fazla dosyada 25.000+ test senaryosu (birim, entegrasyon, E2E, güvenlik, ekosistem)
Platformlar	Masaüstü (Electron) · Android (Termux) · PWA (tüm tarayıcılar)
CI/CD	GitHub Actions — sürümde otomatik npm yayını + Docker Hub
Bağlantılar	Web Sitesi · npm · Docker Hub

📖 Belgeler

📘 Başlarken

Belge	Açıklama
Kullanıcı Kılavuzu	Sağlayıcılar, kombolar, CLI entegrasyonu, dağıtım
Kurulum Kılavuzu	Tam kurulum yöntemleri, CLI araç yapılandırmaları, protokol kurulumu, zaman aşımı ayarı
CLI Araçları Kılavuzu	Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot için araç bazında kurulum
Uzak Mod	Kapsamlı erişim tokenlarıyla dizüstü bilgisayarınızın CLI'ından uzak bir OmniRoute'u (VPS) yönetin
Claude Code Yapılandırması	launch + model bazında profillerle Claude Code'u OmniRoute'a yönlendirin (yerel/uzak)
Hızlı Başlangıç	3 adımda kurun → bağlayın → yapılandırın

🔧 Operasyonlar ve Dağıtım

Belge	Açıklama
Docker Kılavuzu	Docker run, Compose profilleri, Caddy HTTPS, tüneller, imaj etiketleri
Podman Kılavuzu	Quadlet systemd entegrasyonu, podman-compose, SELinux
Sanal Makine (VM) Dağıtımı	Eksiksiz kılavuz: Sanal makine + nginx + Cloudflare kurulumu
Fly.io Dağıtımı	Kalıcı depolama ile Fly.io'ya dağıtım
Termux Kılavuzu	OmniRoute'u Android üzerinde Termux ile çalıştırın
PWA Kılavuzu	Progressive Web App kurulumu, önbelleğe alma, mimari
Kaldırma Kılavuzu	Tüm kurulum yöntemleri için temiz kaldırma
Ortam Yapılandırması	Eksiksiz .env değişkenleri ve referansları

🧠 Özellikler ve Mimari

Belge	Açıklama
Mimari	Sistem mimarisi, veri akışı ve dahili bileşenler
Sıkıştırma Kılavuzu	7 seçenekli işlem hattı: off / lite / standard / aggressive / ultra / RTK / stacked
RTK Sıkıştırma	Komut çıktısı sıkıştırma, filtreler, güven, doğrulama, ham çıktı kurtarma
Sıkıştırma Motorları	Caveman, RTK, katmanlı işlem hatları, pano/API/MCP yüzeyleri
Sıkıştırma Kuralları Formatı	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, sürü önleme, TLS taklidi
Auto-Combo Motoru	14 faktörlü puanlama, mod paketleri, kendi kendini iyileştirme
Proxy Kılavuzu	3 seviyeli proxy sistemi, 1proxy pazarı, kayıt CRUD işlemleri
Ücretsiz Katmanlar	90+ ücretsiz sağlayıcının birleştirilmiş dizini (42 belgelenmiş token havuzu / 495 model)
Özellikler Galerisi	Ekran görüntüleriyle görsel pano turu
Kod Tabanı Belgeleri	Yeni başlayanlar için kod tabanı incelemesi

🤖 Protokoller ve API'ler

Belge	Açıklama
API Referansı	Örneklerle tüm uç noktalar
OpenAPI Şartnamesi	OpenAPI 3.0 şartnamesi
MCP Sunucusu	109 MCP aracı, IDE yapılandırmaları, Python/TS/Go istemcileri
MCP Sunucu Kılavuzu	MCP kurulumu, taşımalar ve araç referansı
A2A Sunucusu	JSON-RPC 2.0 protokolü, yetenekler, akış, görev yönetimi
A2A Sunucu Kılavuzu	A2A ajan kartı, görevler, yetenekler ve akış

📋 Proje ve Kalite

Belge	Açıklama
Katkıda Bulunma	Geliştirme kurulumu ve yönergeleri
Dallanma ve Sürüm Modeli	PR'ların nereyi hedeflediği (release/*), main ve etiketlerin anlamı
Değişiklik Günlüğü (Changelog)	Sürüm bazında tam yayın geçmişi
Güvenlik Politikası	Güvenlik açığı bildirme ve güvenlik uygulamaları
i18n Kılavuzu	43 dil desteği, çeviri iş akışı, RTL
Sürüm Kontrol Listesi	Sürüm öncesi doğrulama adımları
Test Kapsam Planı	Test kapsamı stratejisi ve 25.000+ test paketi

⭐ Öne Çıkan 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şlardır. Teşekkür ederiz.

oyi77 🥇 213 commit • +114K satır Analitik motoru, SQL toplamaları, proxy pazarı, test kapsamı	R.D. & Randi 🥈 108 commit • +38K satır Uç noktalar sayfası, tünel entegrasyonları, Docker iş akışları, A2A durumu, sıkıştırma arayüzü	Chris Staley 🥉 70 commit • +1.8K satır SSE akış güçlendirmesi, Responses API, Gemini sayfalama, test regresyon düzeltmeleri	zenobit 🏅 62 commit • +22K satır CI/CD hattı, 33 dil için i18n, Void Linux paketi, platform düzeltmeleri	Jan Leon 🏅 58 commit • +22K satır Reasoning-effort yönlendirmesi, proxy kontrolleri, kota görünürlüğü, Live Zone sıkıştırması
backryun 🏅 53 commit • +70K satır Sağlayıcı kataloğu düzenleme — Perplexity, Kimi, Cerebras, Copilot, LMArena güncellemeleri	Chirag Singhal 🏅 46 commit • +4.8K satır Hata temizleme, MITM prefill düzeltmesi, fusion hakemi, devre kesici/429 doğruluğu	kfiramar 🏅 38 commit • +1.7K satır Codex websocket + doğrudan geçiş, yetkilendirme/karşılama, Electron güçlendirme, DB migrasyonları	Benson K B 🏅 28 commit • +9.2K satır Electron masaüstü uygulaması, otomatik güncelleyici, sürüm derleme iş akışları, platformlar arası CI	Hernan J. Ardila 🏅 25 commit • +174K satır Sıfır gecikmeli kombolar, vision-bridge otomatik yönlendirmesi, katalog bağlam uzunluğu, dayanıklılık 429 ipuçları

🙏 Bu katkıda bulunanların sunduğu özellikler, hata düzeltmeleri ve altyapı iyileştirmeleri, OmniRoute'u güvenilir ve zengin özelliklere sahip kılan temel unsurlardır. Her pull request, her test senaryosu ve her i18n çeviri dosyası değerlidir. Açık kaynak onlar gibi insanlar tarafından inşa edilir.

---

💖 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.

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.

👥 320+ Katkıda Bulunan

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
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 dosyasına bakın.

Yeni Bir Sürüm Yayımlama

# 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 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.

🧬 Köken ve ağ geçidi

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.

🗜️ Bağlam ve token sıkıştırması — motorlar

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).

🧩 Kompakt formatlar, token araştırmaları ve kod duyarlı araçlar

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.

🧠 Bellek ve RAG

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.

🛰️ Trafik denetimi, MITM ve şeffaf proxy

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.

📚 Model verileri, gözlemlenebilirlik ve arayüz

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ı.

🛡️ Güvenlik

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).

🧭 Tamamlayıcı araçlar

Proje	⭐	OmniRoute'a nasıl ilham verdi

📄 Lisans

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}