# README (Türkçe) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇬🇷 [el](../el/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Ücretsiz Yapay Zekâ Geçidi **[Diego Souza](https://github.com/diegosouzapw) tarafından oluşturuldu**

OmniRoute — Kod yazmayı asla bırakmayın. Her yapay zekâ aracı → tek bir uç nokta üzerinden 388 sağlayıcı — 150+ ücretsiz —. Claude Code, Codex, Cursor, Cline, Copilot ve Antigravity ile ÜCRETSİZ Claude / GPT / Gemini; otomatik geri dönüş. RTK + Caveman yığılmış sıkıştırması %15–95 token tasarrufu sağlar (ortalama ~%89) — sınırlara asla takılmayın. 388 yapay zekâ sağlayıcısı · 150+ ücretsiz katman · ayda ~1,62 milyar ücretsiz token · 20 yönlendirme stratejisi · Başlamak için $0.

## 💰 Üçüncü Taraf Ücretsiz Katmanlarında Aylık ~1,62 Milyar Token

> **Kendi sağlayıcı hesaplarınızı kullanın.** Bu, ayrı ayrı uygun üçüncü taraf ücretsiz katmanlarının tahmini toplamıdır; OmniRoute tarafından verilen bir token tahsisi değildir. Kaydolun, gerektiğinde kimlik bilgilerinizi alın ve kullanabileceğiniz sağlayıcıları bağlayın; her sağlayıcı kendi limitlerini, kullanılabilirliğini ve koşullarını belirler. > > Ücretsiz katmanları elle birleştirmek zahmetlidir — düzinelerce SDK, düzinelerce hız sınırı ve gerçekte ne kadar hakkınız olduğunu bilmenin hiçbir yolu yoktur. OmniRoute, **34 yinelenen havuz anahtarında 465 ücretsiz katman girdisini** kataloglar ve token başlığını **yayınlanmış pozitif aylık bütçeye sahip 17 havuz ile model başına beş Groq sınırından** hesaplar; ortak havuzlar yinelenmez. Yalnızca bölgesel kimlik doğrulamasından sonra açılan kotalar (bugün: ModelScope) ayrı gösterilir, bölgesel kimlik doğrulamasının arkasında +~6M olarak belirtilir ve hiçbir zaman başlık toplamına eklenmez. Sonuç, kontrol panelinde görünür kalır (`/dashboard/free-tiers`).

OmniRoute ücretsiz katman bütçe kartı: Aylık ~1,62 milyar ücretsiz token sabit; kayıt kredileriyle ilk ayda ~2,22 milyara kadar, tek bir uç noktanın arkasında 465 kataloglanmış ücretsiz katmanı kapsayan 34 belgelenmiş yinelenen havuz anahtarından. Dürüst, havuz yinelemesiz hesaplama — yayınlanmış pozitif aylık token bütçesine sahip 17 yinelenen havuz ile model başına beş Groq sınırı dahil olmak üzere her ortak havuz yalnızca bir kez sayılır; 12 sağlayıcı koşul riski kataloğunda kaçınılması önerilen olarak işaretlenmiştir, böylece kararı siz verirsiniz. Bütçe çubuğunda Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (model başına beş sınır) ve daha küçük havuzların yanı sıra ilk ay kayıt kredileri ve token sınırı olmayan, kalıcı olarak ücretsiz sağlayıcılar ayrı gösterilir; böylece bunlar başlık toplamını hiçbir zaman şişirmez. /dashboard/free-tiers üzerinde canlı kullanılan/kalan miktar.

> Canlı `/dashboard/free-tiers` sayfasının animasyonlu özeti. Tam yöntem (havuz yinelemesinin kaldırılması, kredi katmanları, sağlayıcı koşulları): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Bu rakamlar iki haftada bir canlı kataloğa göre yeniden denetlenir ve **her iki yönde de değişir** — bir sağlayıcı ücretsiz katmanı sonlandırırsa sayı düşer; yeni bir sağlayıcı eklenirse yükselir. Kataloğun gerçekten hesapladığı değerleri yayımlarız; hiçbir zaman yukarı yuvarlanmış en iyi durumu yayımlamayız.}

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

[![Yıldızlar](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Yıldız Geçmişi Sıralaması](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Topluluğa katılın **👋 Geliştiriciyi takip edin — yeni sağlayıcıları, sürümleri ve ipuçlarını herkesten önce öğrenin:** [![Diego'yu LinkedIn'de takip edin](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![@diegosouzapw kullanıcısını GitHub'da takip edin](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Brasil](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Web sitesi](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Sorular, sağlayıcı ipuçları, yol haritası ve destek → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Geçit Büyümeye Devam Ediyor

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | ------------------------------------ | :----------------------: | :---------: | :-------------------: | | 🌐 Sağlayıcılar | 352 | **358** | 388 | | 🧠 Benzersiz sohbet model kimlikleri | 1320 | **1374** | 1491 | | 🖼️ Modality Bridge | 🆕 görüntü + ses + video | ✓ | ✓ | | 📡 Radar ücretsiz kataloğu | 🆕 isteğe bağlı | ✓ | ✓ | | ⚖️ Kota farkındalıklı zamanlama | 🆕 Quota-Share | ✓ | ✓ | | 📊 Kota telemetrisi | 🆕 canlı | ✓ | ✓ | | 🧰 Başsız mod | — | — | 🆕 `serve --headless` | | 🛤️ LTS ray altyapısı | — | — | 🆕 sürüm kanalları | | 🔎 Model keşif API'si | — | — | 🆕 `/v1/models/query` | **→ [Yol Haritası](ROADMAP.md) — `v3.9.0 LTS` sürümüne giden rayda ilerliyor**

## 🧩 Mevcut [![npm sürümü](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Aylık](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Lisans: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker İndirmeleri](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron İndirmeleri](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Başlangıç	🚀 Hızlı Başlangıç	📦 Kurulum	🆓 Bir sağlayıcıya bağlan
💡 Öğren	💥 Vaat	🤔 OmniRoute neden?	🏆 Fark yaratan özellikler
⚙️ Özellikler	🎯 Kombolar	🌐 Sağlayıcılar	🔌 CLI & MCP
	🗜️ Sıkıştırma	🖥️ Nerede çalışır?	🔒 Gizlilik
👀 Gör	🎬 Uygulamada	✨ Yenilikler	🤖 Uyumlu CLI'lar
💚 Destek	💚 Destek / Bağış	💬 Topluluk	💖 Sponsorlar
📦 Proje	🛠️ Teknoloji Yığını	📖 Belgeler	👥 Katkıda Bulunanlar

🌐 67 dilde

## 🆓 Yükleyin, bir sağlayıcıya bağlanın ve ardından tek bir uç nokta üzerinden yönlendirin

Üç adım: OmniRoute'u yükleyip başlatın, kendi hesabınız veya API anahtarınızla uygun bir sağlayıcıya bağlanın, ardından aracınızı bir OmniRoute API anahtarı ve otomatik model ile localhost:20128/v1 adresine yönlendirin. Yönlendirme, kullanılabilir uygun bağlantılara ve sağlayıcı limitlerine bağlıdır.

```bash # Bir sağlayıcıya bağlandıktan sonra OmniRoute anahtarınızı Dashboard → Endpoints bölümünden kopyalayın: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto`, uygun bir rota gerektirir. Yeni bir kurulumda uygun anahtarsız hedef bulunmayabilir ve anahtarsız bir sağlayıcı, üçüncü taraf istemcileri reddedebilir. Kiro dahil `tos: avoid` olarak işaretlenen sağlayıcılar, varsayılan olarak otomatik yönlendirmeden hariç tutulur; bir hesaba bağlanmak bu ayarı geçersiz kılmaz. Bir sağlayıcı seçmeden önce [Ücretsiz Katmanlar Kılavuzu](docs/getting-started/FREE-TIERS-GUIDE.md)'na bakın.} _{📦 **Python, Node.js, PHP ve cURL** için kopyalayıp yapıştırabileceğiniz hızlı başlangıç betikleri → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Vaat

# 🤔 Neden OmniRoute?

OmniRoute istek akışı: IDE'niz veya CLI'ınız (Claude Code, Cursor, Cline…) tek bir yerel uç noktayı (http://localhost:20128/v1) çağırır; OmniRoute Smart Router (RTK + Caveman sıkıştırması, 20 yönlendirme stratejisi, devre kesiciler, TLS gizliliği, MCP, A2A, guardrail'ler), uygun ve sağlıklı bir hedef mevcut olduğu sürece 4 sağlayıcı katmanı arasında geri dönüş yapabilir — 1. Katman Abonelik, 2. Katman API Anahtarı, 3. Katman Ucuz ve 4. Katman Ücretsiz.

## 🤝 Açık Kaynak Dostlarımız Tarafından Destekleniyor

> **Açık Kaynak Dostu olarak katılmak ister misiniz?** Bunlar, açık kaynağı destekleyen ve OmniRoute'un ilerlemesine yardımcı olan şirketlerdir — ve bize verdikleri her token'ın nereye gittiğini herkese açıkça belirtiyoruz. İletişime geçin: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Bu projeyi desteklediği için kurucu Açık Kaynak Dostumuz Kimi (Moonshot AI)'ye teşekkür ederiz! Kimi, açık ağırlıklı K2 ve K3 model ailelerinin arkasındaki yapay zeka laboratuvarıdır — Kimi K3, 1M token bağlam penceresi, yerel görüntü işleme ve sınır seviyesi kodlama yeteneklerini kapalı model fiyatlarının çok altında sunar ve Claude Code, Codex ve OmniRoute'un desteklediği her kodlama aracıyla kutudan çıktığı gibi çalışır.

Kimi'nin desteği neleri güçlendiriyor: Kimi'nin API kredileri, OmniRoute'un yapay zeka onaylı yayın hattını — her çekme isteğini yayınlanmadan önce inceleyen *Kimi K3 destekli birleştirme doğrulama* aşamasını — ve günlük özellik geliştirmeyi destekler. Birinci sınıf Kimi desteği her iki yolla da sağlanır: doğrudan Kimi API'si (kimi-k3) ve Kimi Code kodlama planı (OAuth ve API anahtarı). OmniRoute aynı zamanda Kimi'nin destek programındaki ilk Brezilya açık kaynak projesidir. %15 ek krediyle bir Kimi API anahtarı alın →

Cheaper Inference
_{cheaperinference.com} Bu projeyi desteklediği için OmniRoute Açık Kaynak Dostu Cheaper Inference'a teşekkür ederiz! Cheaper Inference, 42 sınır modelini — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ve MiniMax — tek bir OpenAI uyumlu uç nokta arkasında yeniden satan, her isteği en ucuz uygun sağlayıcıya yönlendiren ve model üreticisinin liste fiyatının üzerinde asla ücret almayan, maliyet sıralamalı bir ağ geçididir.

OmniRoute'da birinci sınıf destek: Sohbet Tamamlamaları, yerel /v1/responses uç noktası, görüntü işleme, araç çağırma ve 3 görüntü modeli (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model> olarak erişilebilir). Bir API anahtarı alın →

_{aff=omniroute etiketli bağlantılar iş ortağı bağlantılarıdır. Projeyi sizin için ek maliyet olmadan finanse ederler.}

_{🎟️ Satış Ortakları Promosyonu — sponsor olmadığımız sağlayıcılardan ücretsiz kayıt kuponları (genişletmek için tıklayın)}

_{Bu bölüm yalnızca yönlendirme/kupon kodları içindir. Sponsorlu ortaklıklar yukarıdaki **🤝 Açık Kaynak Dostlarımız Tarafından Destekleniyor** bölümünde yer almaktadır. OmniRoute'un burada listelenen sağlayıcılarla herhangi bir sponsorluğu veya ortaklığı yoktur — bunlar herkesin kullanabileceği herkese açık kuponlardır.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — satış ortağı kaydı · kayıtta 100$ ücretsiz kredi (ücretsiz sunucu, daha yüksek gecikme süresi bekleyin — test için en iyisi, üretim için değil). OmniRoute'da v3.8.50'den beri birinci sınıf destek: Sohbet Tamamlamaları, Anthropic uyumlu kablo formatı ve OpenAI uyumlu yol. Mevcut modeller arasında claude-opus-4-8, claude-opus-5, gpt-5.6-sol ve daha fazlası bulunur. 100$'ınızı alın →}

_{⚠️ Satış ortağı bağlantısı — OmniRoute'un bu sağlayıcıyla herhangi bir sponsorluğu veya ortaklığı yoktur.}

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

## 🎯 Kombolar — Amiral Gemisi

20 kombo yönlendirme stratejisinden 18'i için animasyonlu örnekler — her strateji için bir kutucuk: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. cache-optimized ve quota-weighted animasyonlu değildir; aşağıdaki tablo 20 stratejinin tamamını açıklar.

> **Kombo**, OmniRoute'un **otomatik olarak** yönlendirme yaptığı bir model zinciridir. Kota biterse, bir sağlayıcı arızalanırsa veya maliyetler yükselirse kombo, uygun durumdaki bir sonraki sağlıklı modele geçebilir. 🛡️ ### ⚡ Sıfır yapılandırma — yalnızca `auto` kullanın Kombo oluşturmanız gerekmez. Modelinizi `auto` (veya bir varyantı) olarak ayarlayın; OmniRoute, bağlı sağlayıcılarınızdan canlı olarak puanlanan sanal bir kombo oluşturur:

Model kimliği	Neyi optimize eder
`auto`	🎯 Dengeli varsayılan (LKGP — son iyi sağlayıcınıza bağlı kalır)
`auto/coding`	🧑💻 Kod üretimi için kalite öncelikli ağırlıklar
`auto/fast`	⚡ Önce en düşük gecikme
`auto/cheap`	💰 Önce token başına en ucuz seçenek
`auto/subscription`	🎟️ Yalnızca hâlihazırda ücretini ödediğiniz abonelik kotası — kapalı biçimde başarısız olur, asla faturalandırılabilir bir geri dönüş kullanmaz (kılavuz)
`auto/thrifty`	🪜 Önce plan kotası, ardından en ucuz ücretli seçeneklere her seferinde bir basamak — sıfırlandıktan sonra tekrar plana döner (kılavuz)
`auto/offline`	🔋 Önce en fazla kota / hız sınırı kapasitesi
`auto/smart`	🔭 Kalite önceliği + daha iyi modeller keşfetmek için %10 keşif
`auto/lkgp`	📌 Son bilinen iyi sağlayıcıya açıkça bağlı kalma
`auto/chaos`	🧪 Bir model paneline paralel dağıtım (sağlayıcı başına bir model, varsayılan olarak 5), tek bir yanıt döndürür; hata enjeksiyonu değil, panel modeli başına bir yukarı akış çağrısıdır

## ### 🔀 Ya da kendiniz oluşturun — 20 yönlendirme stratejisi **20** stratejinin tamamı — her kombo adımında istediğiniz gibi karıştırıp eşleştirin:

#	Strateji	Ne yapar
1	`priority`	İlk hedef öncelikli sıralı liste — bir sonrakine geçmeden önce her birini tüketir 🥇
2	`fill-first`	Devam etmeden önce her hedefin kotasını tamamen doldurur
3	`weighted`	Hedef başına ağırlığa göre ağırlıklı rastgele seçim
4	`round-robin`	Hedefler arasında sırayla döngü kurar
5	`p2c`	İki seçenekten birini seçme gücüne dayalı rastgele yük dengeleme
6	`least-used`	Mevcut yükü en düşük olan hedefi seçer
7	`random`	Eşit olasılıklı rastgele seçim (yinelenenler kaldırılır)
8	`strict-random`	Tekrarları kaldırmadan rastgele seçim 🎲
9	`cost-optimized`	Canlı katalog fiyatlandırmasına göre istek başına $ maliyetini en aza indirir 💸
10	`headroom`	En fazla kalan kotaya sahip hedefi seçer
11	`quota-weighted`	Kotası tükenen hesapları atlar, ardından kalan kota ÷ devam eden yük oranına göre seçim yapar — mevcut konuşmalar aynı hedefe sabitlenmiş olarak kalır ⚖️
12	`reset-window`	Kota penceresi en kısa sürede sıfırlanacak hedefi tercih eder
13	`reset-aware`	Kota sıfırlama zamanına göre sıralar — önce kısa pencereler 📊
14	`context-relay`	Uzun konuşmalar için bağlamı hedefler arasında aktarır 🧠
15	`context-optimized`	Mevcut bağlam boyutuna en uygun hedefi seçer
16	`cache-optimized`	Yeniden kullanılabilir her istem önekini aynı hesaba sabitler — istem önbelleği isabetlerini en üst düzeye çıkarır 🎯
17	`lkgp`	Son Bilinen İyi Yol — son başarılı sağlayıcıya sabitler, ardından yedek olarak kurallara döner
18	`auto`	Her bağlantı genelinde 16 faktörlü canlı puanlama 🤖
19	`fusion`	Bir model paneline dağıtır + bir hakem tek bir yanıt sentezler 🧬
20	`pipeline`	Adımları zincirler — her hedefin çıktısı bir sonrakini besler 🔗

_{Auto-Combo motoru, her adayı **16 faktöre** göre puanlar (sağlık, kota, maliyet, gecikme, göreve uygunluk, kalite, oturum kullanılabilirliği…) — bkz. [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Dayanıklılık yerleşik olarak sunulur (3 bağımsız katman)

OmniRoute dayanıklılığı — 3 bağımsız, kendi kendini iyileştiren katman; doğru arıza için doğru katman. Katman 1 sağlayıcı devre kesici (sağlayıcının tamamı): yalnızca 408/5xx durumlarında devreye girer; eşikler OAuth 8× / API anahtarı 12× / yerel 2×; 60s/30s/15s sonra HALF-OPEN durumunda bir yoklamaya sıfırlanır, tembel kurtarma uygular; OPEN durumundayken kombinasyon trafiği bir sonraki sağlayıcıya yönlendirir. Katman 2 bağlantı bekleme süresi (tek anahtar/hesap): temel süre OAuth için 5s / API anahtarı için 3s; ani yoğunluğu önleyen korumayla üstel ×2 geri çekilme uygular; 429, Retry-After değerine uyar; başarı, tüm hata durumunu temizler; bekleme süresindeki bir anahtar atlanırken diğer anahtarlar hizmet vermeye devam eder. Katman 3 model kilitleme (tek model): model başına 429, yerel 404 veya mod reddetmeleri yalnızca ilgili modeli kilitler — hiçbir zaman bağlantının tamamını değil. Sonlandırıcı durumlar (yasaklanmış, süresi dolmuş, kredileri tükenmiş) bekleme süreleri için değil, operatör içindir.

_{📖 [Auto-Combo Motoru](docs/routing/AUTO-COMBO.md) · [Dayanıklılık Kılavuzu](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 OmniRoute'u Farklı Kılan Nedir

OmniRoute'u farklı kılan özellikler — 13 yetenek genelinde 9router, OpenRouter, CLIProxyAPI ve LiteLLM ile güncel özellik karşılaştırması. OmniRoute: 388 sağlayıcı, yerleşik 150'den fazla ücretsiz katman, 20 yönlendirme stratejisi, 12 motorlu belirteç sıkıştırma, 110 araç içeren yerleşik MCP sunucusu, A2A aracı protokolü, kalıcı bellek, koruma kuralları, bulut aracıları, TLS parmak izi gizleme, Desktop/Termux/PWA ve 67 i18n kullanıcı arayüzü yerel ayarı. OmniRoute MIT lisanslıdır ve kendi altyapınızda barındırılabilir. Rakiplerin yetenekleri ve sayıları değişebilir; bağlantısı verilen metodolojiye bakın.

_{📊 9router, OpenRouter, CLIProxyAPI ve LiteLLM ile tam metodoloji & özellik bazında ayrıntılar → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 OmniRoute'u Destekleyin OmniRoute, MIT lisanslıdır ve açık olarak sürdürülmektedir. Size zaman veya para tasarrufu sağlıyorsa, bağımsız kalmasını nasıl sağlayabileceğinizi buradan görebilirsiniz — size en uygun yöntemi seçin. Sponsorluk yönlendirme önceliğini asla etkilemez; sıralamayı değil, görünürlüğü sağlar.

⭐ 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) OmniRoute PIX QR code

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)](https://github.com/diegosouzapw/OmniRoute/discussions) açın.

Geliştirici notları: Proje, geliştirici kolaylığı sağlamak amacıyla npm install/postinstall sırasında yerel bir .env dosyası oluşturabilir. Bu dosya kasıtlı olarak .gitignore aracılığıyla yoksayılır (bkz. .gitignore) ve kesinlikle commit edilmemelidir — yanlışlıkla commit edilirse, açığa çıkan sırları yenileyin ve dosyayı geçmişten kaldırın. Yerel ortam dosyalarını ve sırları yönetmeyle ilgili rehberlik için docs/DEVELOPER-ENVIRONMENT.md dosyasına bakın.

## 📡 OmniRoute Radar Belgelenmiş, havuz bazında yinelenenleri ayıklanmış yukarıdaki katalogdan sunulan ana ücretsiz katman miktarı **~1,62 milyar token/ay** olarak devam etmektedir. Geçici sağlayıcı kayıt kredileri, ilk ayı ayrıca **~2,22 milyara** çıkarabilir. Radar, OmniRoute sürümleri arasında ücretsiz modellerin kullanılabilirliği hakkında daha güncel bilgiler isteyenler için isteğe bağlı, imzalı bir katalog katmanıdır; topluluk kataloğu ve mevcut tüm ücretsiz özellikler ücretsiz kalmaya devam eder. Destekçiler, canlı kataloğa ve ek sağlayıcı fırsatlarına erişebilir. Bunun ayrı ve değişken üst sınırı, sağlayıcıların kullanılabilirliğine bağlı olarak **ayda en fazla yaklaşık 3 milyar token** düzeyindedir. Bu üst sınır garanti edilmez: sağlayıcılar kotaları, uygunluk koşullarını, modelleri veya bölgeleri istedikleri zaman değiştirebilir. Radar isteğe bağlıdır ve yalnızca GET kullanır. OmniRoute istemcisi istemleri, trafiği, sağlayıcı yapılandırmasını, kullanım telemetrisini veya yerel duyuru kapatma durumunu yüklemez. Uygunluk koşulları ve güncel katalog hakkında bilgi edinmek için **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)** adresini ziyaret edin.

## ✨ Yenilikler

> **v3.8.20 → v3.8.54** arasındaki son öne çıkanlar. Tam geçmiş için [`CHANGELOG.md`](CHANGELOG.md) dosyasına bakın. - **⚖️ `quota-weighted` yönlendirmesi** — 20. birleşim stratejisi, tükenen hesapları atlar; ardından kalanlar arasından kalan kota ÷ devam eden yük oranına göre seçim yapar ve mevcut konuşmaları sabit tutar. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Başsız mod** — `omniroute serve --headless` (veya `OMNIROUTE_HEADLESS=1`), yalnızca `/v1/*` proxy motorunu çalıştırır; kontrol paneli ve yalnızca kontrol paneline ait alt sistemler devre dışı kalır. → [Başsız Mod](docs/guides/HEADLESS.md) - **🔎 Model keşfi** — `/v1/models`, yetenek, bağlam, tür ve metne göre filtreleme yapar; `POST /v1/models/query` ise anahtar başına aynı görünürlük kurallarıyla kısa ve deterministik bir aday listesi döndürür. → [API Referansı](docs/reference/API_REFERENCE.md) - **🔑 Anahtar başına yönlendirme denetimi** — bir API anahtarını `forcedModel` ile tek bir modele veya birleşime sabitleyin ve bir anahtarın modellerini ve birleşimlerini atomik olarak ekleyin ya da kaldırın (`/api/keys/{id}/access`). → [API Referansı](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Daha ayrıntılı PII denetimleri** — tür başına seçim, en fazla 20 doğrulanmış özel maskeleme deseni ve tür başına tespit sayaçları; maskeleme özelliği isteğe bağlı olmaya devam eder. → [Koruyucu Kurallar](docs/security/GUARDRAILS.md) - **🌍 67 dil** — kontrol paneli, dokümantasyon aynaları ve CLI için; `npm run i18n:add-locale`, tek bir komutla her yere bir dil ekler. → [i18n Kılavuzu](docs/guides/I18N.md) - **🎛️ OmniConductor** — aracı filonuza gelen A2A delegasyonu, Agent Card üzerinde Conductor becerileri ve Faro bas-konuş sesli sohbeti içeren bir kontrol paneli bölmesi. → [A2A Sunucusu](docs/frameworks/A2A-SERVER.md) - **🛂 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ı kullanılır. → [Dayanıklılık Kılavuzu](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Kanonik `/v1/models` sıralaması** — sağlayıcı başına tek ve kesintisiz, sağlayıcı gruplu bir blok (birleşimler önce sabitlenir); tüm katalog kaynaklarında kararlıdır. → [API Referansı](docs/reference/API_REFERENCE.md) - **🗜️ Sıkıştırma güçlendirmeleri** — varsayılan olarak etkin şişirme koruması, DE / FR / JA + Çince (wényán) için Caveman paketleri, Gradle ve .NET için RTK filtreleri. → [Sıkıştırma](docs/compression/COMPRESSION_ENGINES.md) - **💸 Dürüst sabit ücret maliyeti** — abonelik / kodlama planı sağlayıcıları maliyet analizlerinde **$0** olarak görünür; bütçe, kota ve yönlendirme tahmin yapmaya devam eder. → [API Referansı](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share yönlendirmesi** — paylaşılan bir hesabın kotasını havuzlanmış anahtarlar arasında adil biçimde böler; boşta kalan dilimler kullanıma sunulduğundan kaynakları verimli kullanır. → [Dayanıklılık Kılavuzu](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Tek komutla CLI/aracı kurulumu** — kayıtlı 15 `setup-*` komutu; `omniroute run`, 7 CLI'yi (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI) başlatır; `omniroute configure`, etkileşimli bir sağlayıcı+model seçici ve bağlam başına favorilerle 11 hedefi destekler. → [CLI Entegrasyonları](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Uzak mod** — kapsamlandırılmış belirteçlerle (`connect` / `contexts` / `tokens`) uzak bir OmniRoute'u yönetin ve VPS kurulumları için bir `antigravity` OAuth yardımcısı kullanın. → [Uzak Mod](docs/guides/REMOTE-MODE.md) - **🧭 Daha akıllı otomatik yönlendirme** — `auto/:` birleşimleri, **Fusion** (model paneli + değerlendirici), görevin farkında olan yönlendirme, istek başına model / mod / USD bütçesi geçersiz kılmaları. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Takılabilir sıkıştırma** — 12 birleştirilebilir motor + Compression Studios: LLMLingua-2, iki katmanlı Ultra, omniglyph, adım başına doğruluk kapısı, GCF v3.2, sürükleyip yeniden sıralama düzenleyicisi. → [Sıkıştırma](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Şeffaf MITM şifre çözme (TPROXY)** — proxy ortam değişkenlerini yok sayan CLI'leri yakalar ve SNI başına CA + güven deposu yükleyicisi sağlar. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Her yerde maliyet telemetrisi** — her uç noktada `X-OmniRoute-*` maliyet/kullanım başlıkları, önbellek isabeti tasarruf başlığı ve anahtar başına USD harcama kotaları. → [API Referansı](docs/reference/API_REFERENCE.md) - **🧠 Denetiminizdeki bellek** — varsayılan olarak kapalıdır; isteğe bağlı int8 vektör niceleme + türlendirilmiş azalma ve istek başına `x-omniroute-no-memory` sunar. → [Bellek](docs/frameworks/MEMORY.md) - **🛡️ Güvenlik** — her LLM rotasında prompt enjeksiyonu koruması (red-team paketi), isteğe bağlı kimlik bilgisi maskeleme koruyucu kuralı (sızdırılmış API anahtarlarını/gizli bilgileri her iki yönde de redakte eder), ücretsiz son çare web araması için DuckDuckGo ve kontrol paneli için isteğe bağlı OIDC giriş kapısı (parola girişi her zaman kullanılabilir olmaya devam eder). → [Koruyucu Kurallar](docs/security/GUARDRAILS.md) - **🖼️ Yeni uç noktalar** — `/v1/ocr` (Mistral OCR) ve `/v1/audio/translations` (Whisper tarzı), medya yüzeyini tamamlar. → [API Referansı](docs/reference/API_REFERENCE.md) - **🎨 Görüntü / video / ses oluşturma** — medya için tek API: xAI Grok Imagine ve Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind ve ElevenLabs gibi konuşma sağlayıcıları. → [API Referansı](docs/reference/API_REFERENCE.md) - **🌍 Dağıtım ve operasyonlar** — ters proxy `basePath`, tarayıcı dili otomatik algılama, anahtar başına cihaz takibi, kök yetkisi gerektirmeyen MITM güveni ve zh-TW yerelleştirmesi. → [Ortam](docs/reference/ENVIRONMENT.md) - **🤝 Daha fazla sağlayıcı ve aracı** — bulut aracıları (Codex Cloud, Cursor, Devin, Jules), tarayıcı + OAuth girişiyle Grok Build (xAI), birinci sınıf kart olarak Ollama, Claude Opus 5 ve Sonnet 5, Kimi ile resmî ortaklık (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… ve yenilenmiş **388 sağlayıcılı katalog**. → [Sağlayıcılar](docs/reference/PROVIDER_REFERENCE.md) - **📡 Yönlendirme şeffaflığı** — her yanıt, isteği karşılayan strateji/sağlayıcı/gecikmeyi belirten bir `X-OmniRoute-Decision` başlığı taşır; yeni bir `cache-optimized` birleşim stratejisi ile Auto-Combo `cacheAffinity` faktörü, yinelenen istekleri önbelleğe alınmış öneki tutan bağlantıya geri yönlendirir ve salt okunur `/v1/auto-combo/{channel}/candidates` uç noktası, bir `auto/*` kanalının canlı aday havuzunu kullanıma sunar. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Yerel performans ve altyapı** — tek tıkla yerel Redis, Cloudflare Workers / Deno Deploy aktarım dağıtıcıları, denetimli gömülü hizmetler olarak Bifrost ve Mux. → [Gömülü Hizmetler](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Kutuda ayrıca** — eklenti çerçevesi ve marketplace, Omni/Agent/GitHub beceri çerçeveleri, Obsidian kasa entegrasyonu (22 MCP aracı), OpenAI uyumlu Batch ve Files API'leri, anlamsal yanıt önbelleği, liderlik tablolarıyla oyunlaştırma, ACP aracı keşfi (yerleşik 15 aracı), BigQuery'ye zamanlanmış günlük dışa aktarımı, `auto/chaos` paralel çoklu model fan-out'u, Telegram bot köprüsü, uygulama içi sürüm yöneticisi ve LMArena-ELO ücretsiz sağlayıcı sıralamaları. → [Belgeler](docs/README.md)

## 🤖 Uyumlu CLI'lar & Kodlama Ajanları > Tek bir yapılandırma — `http://localhost:20128/v1` — ve **her** AI IDE veya CLI, ücretsiz & düşük maliyetli modellerle ç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

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

_{📖 Tüm 39 araç (28 CLI Code + 11 CLI Agent) için araç başına kurulum → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode eklentisi → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Desteklenen herhangi bir CLI'yi OmniRoute ile tek komutla başlatın** — yapılandırma dosyası yazılmaz, kimlik bilgileri her işlem için enjekte edilir, Qwen/Gemini izole geçici bir home dizini alır: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # Ya da sağlayıcı+modeli etkileşimli olarak seçin ve aracın kendi yapılandırmasını yazın: omniroute configure codex # ayrıca: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Her komut, aktif uzak bağlamı (`omniroute connect `) dikkate alır, `--dry-run` tam olarak hangi ortam/argümanların kullanılacağını çalıştırmadan önizler ve `--api-key-env NAME` gizli anahtarları kabuk geçmişinizden uzak tutar. → [CLI Entegrasyonları](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 Yapay Zekâ Sağlayıcısı — Katalogda İşaretlenmiş 153 Ücretsiz

> **Kanonik sohbet, medya, arama, yerel, bulut aracısı ve sistem koleksiyonlarında** toplam **388 kayıtlı sağlayıcı** bulunur; bunların **153’ü `hasFree: true` keşif meta verisini taşır**. Sohbet modeli kayıt defteri **239 sağlayıcıyı / 3.059 farklı sağlayıcı-model çiftini / 1.475 ham model kimliğini** kapsar; ayrı ücretsiz bütçe kataloğunda **model başına 471 satır**, **34 yinelenen havuz** ve **52 yinelenen/anahtarsız sonsuza kadar ücretsiz sağlayıcı** bulunur. Bunlar tasarım gereği farklı paydalardır; tanımlar ve havuz yinelemeleri giderilmiş hesaplamalar [Sağlayıcı Referansı](docs/reference/PROVIDER_REFERENCE.md) ve [Ücretsiz Katmanlar](docs/reference/FREE_TIERS.md) bölümünde yer alır.

### 🏢 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 350’den fazlası — her simge, kontrol panelinin sağlayıcı kataloğundan canlı olarak çözümlenir. 📖 [Sağlayıcı Referansı](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Sonsuza Kadar Ücretsiz — $0, kart gerekmez

OpenCode Zen
_{DeepSeek V4, Nemotron 3
Token sınırı yok}

Kilo Code
_{Otomatik yönlendirici, Tencent Hy3
Sonsuza kadar ücretsiz}

Requesty
_{GPT-OSS 120B, Nemotron
Sonsuza kadar ücretsiz}

SiliconFlow
_{DeepSeek V3.2 / R1
Ücretsiz katman}

Z.AI GLM
_{GLM-4.7 / 4.5-Flash
Sonsuza kadar ücretsiz}

Baidu ERNIE
_{ERNIE 4.0
Sonsuza kadar ücretsiz}

Qoder AI
_{Qwen3-Max, Kimi-K2
SINIRSIZ ÜCRETSİZ}

Pollinations
_{GPT, Llama, Claude
Anahtar gerekmez}

Cloudflare AI
_{50’den fazla model
Günde 10K nöron}

NVIDIA NIM
_{GLM, MiniMax
Yaklaşık 40 RPM ücretsiz}

Cerebras
_{GLM 4.7, GPT-OSS
Tek seferlik 5 $ kredi; kart gerekli}

OpenRouter
_{:free modeller
+10 $ → daha yüksek RPM} 📖 Tam makine tarafından okunabilir katalog → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ OmniRoute Çalıştırıldığı Yer — Her Yerde

> Aynı uygulama, sizin makineniz, sizin kurallarınız. Küresel bir npm kurulumundan** telefonun** Termux aracılığıyla.

Platform	Kurulum	Önemli Noktalar
📦 npm (genel)	`npm -g omniroute'u`	Tek komut, herhangi bir OS
⚡ Bun (global)	`bun -g omniroute ekleyin`	Aynı kayıt defteri tarball'ı, daha hızlı kurulum
🐳 Docker	`docker çalıştırması… diegosouzapw/omniroute`	Çoklu AMD64 + ARM64
🖥️ Masaüstü (Electron)	`npm elektron çalıştır: build`	Yerel pencere + sistem tepsisi — Windows / macOS / Linux
🎩 Menü çubuğu (OmniRouteTray)	`Brew kurulumu --cask zoispag/tap/omniroute-tray`	denetler & sunucuyu otomatik olarak günceller — macOS
💪 ARM	native `arm64`	Raspberry Pi, ARM sunucuları, Apple Silicon
📱 Android (Termux)	`pkg nodejs && npx yükleyin -y omniroute`	telefonunuzda çalıştırır , 24/7, root yok
📲 PWA	"Ana Ekrana Ekle"	Tam ekran, çevrimdışı, tarayıcıdan yüklenebilir
🧩 OpenCode eklentisi	`@omniroute/opencode-provider`	Yerel OpenCode entegrasyonu
🤖 VS Kod Copilot Sohbet	kurulumu OmniCopilot uzantısı	Yerel Copilot Sohbet seçicideki her OmniRoute modeli — kararlı & İçeriden öğrenenler
🛠️ Kaynaktan	`npm yükle && npm dev'i çalıştır`	Hackleyin, katkıda bulunun

_{📖 [Docker Kılavuzu](docs/guides/DOCKER_GUIDE.md) · [Masaüstü](electron/README.md) · [Menü çubuğu tepsisi](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Yeni: VS Kodunun yerel Copilot Sohbeti içindeki OmniRoute

> Yeni kenar çubuğu yok, yeni sohbet UI yok; OmniRoute sunduğu her model doğrudan sayfada görünüyor**Copilot Zaten kullandığınız Sohbet modeli seçici** . VS Code 1.122'den bu yana, sağlayıcı modelleri GitHub oturum açma veya Copilot aboneliği olmadan çalışır; aracı modu, araç çağırma ve görme ücretsizdir. Şunu yükleyin:** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** uzantısını kullanarak OmniRoute sunucunuza yönlendirin (varsayılanı `localhost:20128`), ardından Copilot Chat → model seçiciyi açın →** Modelleri Yönet…** →**OmniRoute** . ile çalışır < td ="sola" hizalayın >VS Kodu — kararlı & İçeriden öğrenenler < td ="sola" hizalayın >Cursor, Windsurf, VSCodium, Theia, kod sunucusu, Gitpod, Antigravity, Kiro…

Mağaza	Bağlantısı
🧩 VS Code Marketplace	Yükleyin →
🔓 VSX Kayıt Defterini açın	Yükleyin →

Düzenleyicinin içinden:** Uzantılar** görüntüleme, arama** "OmniRoute"** , tıklamak** Düzenlemek** — her iki mağazada da aynı şekilde çalışır. Kaynak, sorunlar ve yayımlama runbook'u [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) yayında. _{📖 [VS Code Copilot Sohbet kılavuzu](docs/guides/VSCODE-COPILOT.md) — kurulum, seçicinin gösterdikleri, sekmedeki kontrol paneli, sorun giderme}

### 🎩 Yeni: OmniRouteTray — menü çubuğunda yaşayan ağ geçidiniz

> `omniroute serve` her zaman açık olduğunda en mutlu olanıdır.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** bunu macOS için bir kur ve unut menü çubuğu uygulamasına dönüştürür: sunucuyu başlatır, yeniden başlatmalarda onu canlı tutar, yerinde günceller ve canlı token bütçenizi bir tık ötenize koyar —** açık terminal penceresi yok, bebek bakıcılığı yapacak `npm install -g omniroute` yok.** [Tauri v2](https://v2.tauri.app/) (yuvarlama hatası boyutunda bir Rust çekirdeği) ile oluşturulmuş olup, kendi imzalı Node 24 çalışma zamanını gönderir ve uygulamaya ait bir OmniRoute kurulumunu yönetir, böylece global `node`/`bun` asla savaşmaz. BT** mevcut `~/.omniroute/` yapılandırmanızı ve veritabanınızı paylaşır** - yani zaten koştuğun OmniRoute aynısı, sadece şapka takarak. 🎩

Ne işe yarar	Nasıl
🟢 Sunucuyu denetler	Spawns `omniroute serve` , halihazırda çalışan bir örneği kopyalamak yerine benimser
📊 Bir bakışta canlı kullanım	Sağlayıcı kota çubukları, sıfırlama geri sayımlarıyla Claude session/weekly sınırları, 30 günlük maliyet dökümü
🔄 Otomatik güncellemeler yerinde	Aşamalı kurulum, atomik değiştirme, arıza durumunda geri alma — her zaman en yeni sürümde
🚀 Oturum açma sırasında başlat	Oturum açma sırasında isteğe bağlı başlatma; yalnızca tepsi, dock simgesi yok
🩺 Doktor & günlükleri	Tek tıkla teşhis ve sunucu günlüğüne erişim

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{İndirmeyi mi tercih ediyorsunuz? En son .dmg dosyasını şu adresten edinin:
serbest bırakır. Kaynak, sorunlar ve yapı
dokümanlar zoispag/omniroute-tray yaşıyor.

💛 tarafından hazırlanan bir topluluk projesi — resmi bir OmniRoute sürümü değil.}

## 🔒 Gizli ve Önce Yerel (Local-First)

_{📖 [Yetkilendirme](docs/architecture/AUTHZ_GUIDE.md) · [Güvenlik Önlemleri](docs/security/GUARDRAILS.md) · [Uyumluluk](docs/security/COMPLIANCE.md)}

## 🔌 Eksiksiz CLI + A2A ve MCP

> OmniRoute, sunucunun ötesinde **80'den fazla komuta** sahip **eksiksiz bir komut satırı kokpitidir**; ayrıca açık ajan protokolleri sayesinde bir yapay zekâ ajanı onu **kendi başına** yönetebilir. ### ⌨️ Gerçek bir CLI (yalnızca `start` değil) ```bash omniroute # ağ geçidini + panoyu sunar (port 20128) omniroute chat # etkileşimli TUI sohbet istemcisi (eğik çizgi komutları: /model /combo /skill /memory) omniroute setup # rehberli ilk çalıştırma sihirbazı omniroute doctor # sağlayıcıları, portları ve yerel bağımlılıkları tanılar ``` ### 🛰️ Uzak mod — CLI'ı burada, OmniRoute'u bir VPS'te çalıştırın OmniRoute bir sunucuda mı? **Aynı CLI** ile dizüstü bilgisayarınızdan yönetin. Kapsamlı bir erişim belirteciyle bir kez oturum açın; ardından her komut uzak sunucuyu hedefler. ```bash omniroute connect 192.168.0.15 # parola → kapsamlı belirteç, bağlam olarak kaydedilir omniroute models # ← UZAK sunucu üzerinde çalışır omniroute configure codex # ← uzak bir model seçer, yerel bir Codex profili yazar omniroute tokens create --name ci --scope read # diğer makineler için daha dar kapsamlı belirteçler oluşturur omniroute contexts use default # ← yerel sunucuya geri döner ``` Belirteçler `read` / `write` / `admin` olarak kapsamlandırılır; süreç başlatan rotalar yalnızca geri döngü arabiriminden erişilebilir kalır. _{📖 [Uzak Mod](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI'ını gösteren animasyonlu terminal demosu — omniroute providers list, omniroute combo list ve omniroute health — 89 komutluk üst düzey komut yüzeyinde sırayla gezinir: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 Bir ajan bağlayın — OmniRoute'u kendisi yönetsin OmniRoute'u **MCP**, **A2A**, bir **REST API**, **webhook'lar** veya bir **uzak CLI** üzerinden erişime açın — yetenekli herhangi bir ajan (veya kendi kodunuz) tüm ağ geçidinin anahtarlarına sahip olur: yönlendirme, sağlayıcılar, kombinasyonlar, önbellek, sıkıştırma, bellek — üstelik otonom olarak. Aşağıdaki HTTP uç noktaları `http://localhost:20128` altında sunulur.

Arayüz	Uç nokta / komut	Kullanım amacı
🧰 MCP (stdio)	`omniroute --mcp`	Claude Desktop, Cursor veya herhangi bir MCP istemcisine bağlayın
🌊 MCP (HTTP)	`/api/mcp/stream`	Uzak MCP — 110 araç, 33 kapsam (yaptırım isteğe bağlıdır), eksiksiz denetim izi
📡 MCP (SSE)	`/api/mcp/sse`	Akış tabanlı MCP aktarımı
🤝 A2A	`/.well-known/agent.json`	Ajandan ajana, JSON-RPC 2.0 + SSE, 6 beceri
🌐 REST API	`/v1/*`	OpenAI uyumlu — sohbet, gömmeler, görseller, ses, OCR
🔔 Webhook'lar	`/api/webhooks`	İstek / kota olaylarını Slack, Discord, Telegram veya herhangi bir URL'ye gönderin
🛰️ Uzak CLI	`omniroute connect`	Uzak bir örneği kapsamlı erişim belirteçleriyle yönetin

```bash # Claude Code'a MCP üzerinden eksiksiz OmniRoute araç setini verin: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP Sunucusu](docs/frameworks/MCP-SERVER.md) · [A2A Sunucusu](docs/frameworks/A2A-SERVER.md) · [Ajan Protokolleri](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Token’ları Otomatik Olarak %15–95 Tasarruf Edin

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

OmniRoute sıkıştırma işlem hattı: 10.000 token’lık örnek bir istemci isteği, Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra ve OmniGlyph olmak üzere 12 birleştirilebilir motordan geçer ve belgelenmiş yığılmış örnekte sağlayıcıya yaklaşık 1.080 token ile ulaşabilir. Yapılandırılmış içerik, koruma kalkanları ve adım başına doğruluk eşikleriyle korunur; açıkça kayıplı veya deneysel modlar, uygun içeriği dönüştürebilir.

Varsayılan yığılmış kombinasyon `RTK → Caveman` çalıştırır. Her ikisi de aynı araç/bağlam yükü üzerinde çalıştığında tasarruflar birleşir: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Kod blokları, URL’ler, JSON ve yapılandırılmış veriler **koruma motoru tarafından her zaman korunur**. > **Az token yeterliyken neden çok token kullanalım?** Her istek, **şeffaf biçimde** OmniRoute’un sıkıştırma işlem hattından geçer — istemcide hiçbir değişiklik gerekmez. Artık sırayla çalışan ve her yönlendirme kombinasyonuna göre birlikte kullanılabilen 12 birleştirilebilir motordan oluşan bir **motor yığınıdır** — [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) ve [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) projelerindeki fikirleri temel alır. ### 🧱 12 motorlu yığın Motorlar işlem hattı sırasına göre çalışır; her biri bağımsız olarak etkinleştirilebilir ve her kombinasyon için yapılandırılabilir:

#	Motor	Ne yapar
1	Session-Dedup	Turlar arasında tekrarlanan içeriği kaldırır (içerik adreslemeli, turlar arası)
2	CCR	Büyük blokları alma işaretçilerinin arkasında arşivler, gerektiğinde getirir
3	Lite	Boşluk + görsel URL’si kırpma (gecikmesi düşük temel yapı)
4	RTK	Akıllı araç sonucu filtreleme, yinelenenleri kaldırma ve kısaltma (komut farkındalıklı)
5	Responses Tool Output	Shell/yama/arama/derleme çıktıları için kayıpsız öncelikli JSON + sınırlandırılmış tanılama sıkıştırması (Responses API)
6	Headroom	Vendored bir GCF codec’i aracılığıyla JSON dizilerinin kayıpsız tablo biçiminde sıkıştırılması (~%30)
7	Relevance	Son kullanıcı sorgusuna göre çıkarımsal cümle puanlama
8	Caveman	Kural tabanlı düzyazı sıkıştırması (çıktıda ~%65–75)
9	Aggressive	Eski turların özetlenmesi + aşamalı olarak eskimesi
10	LLMLingua-2	MobileBERT ONNX aracılığıyla ML anlamsal budama — kod güvenli, eşzamansız
11	Ultra	İsteğe bağlı küçük model (SLM) katmanına sahip sezgisel token budama
12	OmniGlyph	Doğrudan Anthropic hattında ölçülen Claude Fable 5 için deneysel bağlamı görsel olarak kodlama; GPT 5.6 dönüştürücüleri, sağlayıcı makbuzları beklenirken güvenli biçimde devre dışı kalır. Dört sıkıştırma profili (varsayılan agresif, dengeli, kodlama güvenli, passthrough) (en agresif; isteğe bağlı)

Kod blokları, URL’ler ve yapılandırılmış veriler **bayt düzeyinde her zaman korunur**. **Tek tıklamalı hazır ayarlar** motorları birleştirir:

Mod	Tasarruf	En uygun kullanım
🪶 Lite	~%15	Her zaman açık güvenli varsayılan
🪨 Standard (Caveman)	~%30	Günlük kodlama
⚡ Aggressive	~%50	Uzun ve araç ağırlıklı oturumlar
🔥 Ultra	~%75	Maksimum tasarruf
🧰 RTK	%60–90	Shell/test/derleme/git çıktısı
🔗 Stacked (RTK → Caveman)	%78–95	Karma istemler + araç günlükleri

**Gerçek örnek — Standard modu:** > **Önce (69 token):** _"React bileşeninizin yeniden işlenmesinin nedeni büyük olasılıkla her işleme döngüsünde yeni bir nesne referansı oluşturmanızdır. Satır içi bir nesneyi prop olarak geçirdiğinizde React’in sığ karşılaştırması bunu her seferinde farklı bir nesne olarak görür ve bu da yeniden işlemeyi tetikler. Nesneyi anımsamak için useMemo kullanmanızı öneririm."_ > > **Sonra (19 token):** _"Her işlemede yeni nesne ref’i. Satır içi nesne prop’u = yeni ref = yeniden işleme. useMemo ile sarın."_ > > **Aynı yanıt. %72 daha az token. Sıfır doğruluk kaybı.** ✅ **PT-BR örneği — [Troglodita](https://github.com/leninejunior/troglodita) modu:** > **Önce (42 token):** _"Sorun, her oluşturma döngüsünde yeni bir nesne başvurusu oluşturulduğu için bileşenin yeniden oluşturulmasıdır. `useMemo` kullanmanızı öneririm."_ > > **Sonra (12 token):** _"Yeniden oluşturma: her döngüde yeni başvuru (satır içi nesne yeniden oluşturuluyor). `useMemo` kullanın."_ > > **Aynı yanıt. ~%70 daha az token. Teknik doğruluk korundu.** ✅
### 🎚️ Motorların ötesinde — çıktı stilleri, uyarlanabilir ayar ve istek başına kontrol Yukarıdaki 12 motor, **girdiyi** küçültür. Üç ek katman, **nasıl**, **ne zaman** ve neyin **çıktı** olarak geleceğini şekillendirir: - **🪄 Çıktı Stilleri** _(çıktı ekseni yönlendirmesi)_ — deterministik, önbellek güvenli yanıt biçimlendirme talimatları ekler; birleştirilebilir ve her biri `lite` / `full` / `ultra` yoğunluğundadır. Stil eklemek, kayıt defterine tek satırlık bir giriş eklemektir: - **Kısa düzyazı** — dolgu sözcüklerini / artikelleri / çekinceli ifadeleri çıkarır; teknik içeriği eksiksiz korur. - **Daha az kod** — "tembel kıdemli geliştirici" YAGNI yaklaşımı: çalışan en küçük değişiklik, istenmeyen ek yapı yok. - **At kuyruğu (tembel kıdemli geliştirici)** — YAGNI merdiveninde ilerler, temel nedeni düzeltir, çalışan en küçük farkı oluşturur. - **DEHB'im var (eylem öncelikli)** — sonraki eylem başta gelir, adımlar numaralandırılır, tek bir somut sonraki adım verilir, önsöz yoktur. - **Kısa CJK (文言)** — klasik Çince ultra kısa stil (`zh` yerel ayarıyla sınırlıdır). - **🎯 Uyarlanabilir bağlam bütçesi** _(ayar düğmesi)_ — tek bir açık/kapalı token eşiği yerine, modelin bağlam penceresine sığması için en ucuz ve en az kayıplı motorları yalnızca gerektiği kadar etkinleştirir. İlke: `reserve-output` (varsayılan, modele duyarlı) · `percentage` · `absolute`. Mod: `floor` (sığmayı garanti eder) · `replace-autotrigger` (açık seçiminiz önceliklidir) · `off` (eski eşik). - **🎛️ Sıkıştırmanın belirlendiği yer** _(öncelik, yüksek → düşük)_ — istek başına `x-omniroute-compression` başlığı › yönlendirme bileşimi geçersiz kılması › etkin adlandırılmış profil › uyarlanabilir / otomatik tetikleme › panel varsayılanı › off. Uygulanan plan, `X-OmniRoute-Compression: ; source=` yanıt başlığında geri yansıtılır. Token eşiğine göre otomatik tetikleyin, uyarlanabilir ayarı etkinleştirin, adlandırılmış bir profili sabitleyin, istek başına tek seferlik bir ayar belirleyin veya her yönlendirme bileşimi için bir işlem hattı atayın — iş yüküne en uygun olanı seçin. İsteğe bağlı çevrimdışı **değerlendirme düzeneği** (`npm run eval:compression`), bir değişikliği kullanıma sunmadan önce sabitlenmiş bir külliyat üzerinde aslına uygunluk ile tasarrufu puanlar. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Hızlı Başlangıç

**1) Yükleyin ve çalıştırın** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` veya eş bağımlılık uyarıları mı görüyorsunuz? [Bunlar zararsızdır](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **npm 11 veya sonraki bir sürümü mü kullanıyorsunuz?** npm, izin verilmediği sürece paket yaşam döngüsü betiklerini engelleyebilir. OmniRoute'un `postinstall` (`node scripts/build/postinstall.mjs`) işlemi, yerel çalışma zamanı dosyalarını hazırlamak için gereklidir. Genel olarak yüklerken npm uyarısında adları belirtilen paketlere izin verin. OmniRoute 3.8.54 tarafından bildirilen paket kümesi için: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Bu izin listesini gelecekteki genel yüklemelerde yeniden kullanmak için bir kez yapılandırın, ardından normal şekilde yükleyin: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Bağımlılık listesi sürümler arasında değişebilir; npm farklı bir liste bildirirse bu uyarıdaki paket adlarını kullanın. Bir pakete izin vermek, yükleme betiklerinin çalışmasına izin verir. > **Gemini Web veya başka bir web çerezi sağlayıcısı mı kullanıyorsunuz?** npm paketi > Playwright'ı içerir, ancak Chromium ikilisini içermez. İlk web sağlayıcısı isteğini > yapmadan önce [Playwright Chromium kurulumu](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > notuna bakın. Kontrol paneli: `http://localhost:20128` · API: `http://localhost:20128/v1`. **2) Kendi hesabınızı kullanarak uygun bir sağlayıcıya bağlanın** Kontrol paneli → **Sağlayıcılar** → mevcut koşulları ve kotası kullanım senaryonuza uygun olan bir sağlayıcı seçin → API anahtarını ekleyin veya hesap akışını tamamlayın. Ücretsiz katmanlar kayıt, onay veya ödeme yöntemi gerektirebilir. [Ücretsiz Katmanlar Kılavuzu](docs/getting-started/FREE-TIERS-GUIDE.md) belgesini inceleyin; anahtarsız kullanılabilirlik garanti edilmez ve `tos: avoid` olarak işaretlenen sağlayıcılar varsayılan olarak `auto` kapsamından çıkarılır. **3) Kodlama aracınızı yönlendirin** ```txt Temel URL: http://localhost:20128/v1 API anahtarı: [Kontrol paneli → Uç noktalarından kopyalayın] Model: auto (uygun bağlantılar arasında yönlendirir — veya sağlayıcı/model seçin) ``` **4) Çalıştığını doğrulayın** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Bağlı modellerinizin listelendiğini görmelisiniz. 🎉 Hepsi bu kadar — kodlamaya başlayın; OmniRoute sizin için otomatik olarak yönlendirme ve yedek geçiş yapar. İstemciniz özel başlıklar gönderemiyorsa OmniRoute, token içeren uyumluluk takma adlarını da sunar: ```txt OpenAI kataloğu: http://localhost:20128/vscode/YOUR_KEY/ OpenAI modelleri: http://localhost:20128/vscode/YOUR_KEY/models OpenAI sohbeti: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI yanıtları: http://localhost:20128/vscode/YOUR_KEY/responses Ollama sohbeti: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama etiketleri: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Bunları yalnızca `Authorization: Bearer ...` ekleyemeyen istemciler için kullanın. Başlık kimlik doğrulaması tercih edilen yöntem olmaya devam eder.
## 📦 Daha fazla kurulum yöntemi — Docker, kaynak kod, pnpm, Arch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest` etiketi **yayımlanmış** en yüksek kararlı SemVer sürümünü takip eder. Git `main` dalını takip etmez. GitOps için `:X.Y.Z` sürümünü sabitleyin. Bkz. [Docker Sürüm Kanalları](docs/guides/DOCKER_GUIDE.md#release-channels). İmaj **`OMNIROUTE_MEMORY_MB=1024`** değerini sabitler. Bu, pano ve hafif bir sohbet için yeterlidir. **Kodlama ajanları** (Claude Code, Codex, Grok, vb.'den gelen `POST /v1/responses`), çok daha büyük bir V8 heap alanına ihtiyaç duyar; aksi takdirde iki örtüşen uzun bağlam altında süreç ~12 GiB seviyesinde `FATAL ERROR` verir. Konteyneri heap boyutunun üzerinde boyutlandırın (yerel arabellekler V8'in dışında yer alır): | İş Yükü | Heap (`-e OMNIROUTE_MEMORY_MB`) | Konteyner (`--memory`) | | ---------------------------------- | ------------------------------- | ---------------------- | | Pano / hafif sohbet | `1024` (imaj varsayılanı) | ≥2 g | | Tek bir kodlama ajanı | `8192` | ≥10 g | | İki eşzamanlı uzun `/v1/responses` | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` Tam tablo: [Docker Kılavuzu — çalışma zamanı RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Ön sürüm Docker kanalı:** `diegosouzapw/omniroute:next` ve > `diegosouzapw/omniroute:next-web` geçerli varsayılan `release/v*` > dalını takip eder. Bu değişken etiketler yalnızca yayımlanmamış düzeltmeleri test etmek içindir ve > **üretim ortamı için desteklenmez**. Bkz. > [Docker Sürüm Kanalları](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** Standart `bun install` ve genel kurulum (`bun install -g omniroute`), Bun çalışma zamanı algılamasıyla desteklenir: - **Yerleşik `bun:sqlite`**: OmniRoute, Bun altında çalışırken Bun'ın yerleşik `bun:sqlite` sürücüsünü kullanır; Node.js altında `better-sqlite3` veya `sql.js`'e geri döner. - **Otomatik Webpack paketleyici seçimi**: Geliştirme (`bun run dev`) ve üretim derlemeleri (`bun run build`), Bun'ı otomatik olarak algılar ve yerel V8 bağlama uyumsuzluklarını önlemek için Turbopack yerine Webpack'i seçer. - **Özel Bun Dockerfile**: Yerel Bun üretim dağıtımları için çok aşamalı `Dockerfile.bun` (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Bun ile kurun ve çalıştırın bun install bun run dev ``` **🛠️ Kaynak koddan** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux (AUR)** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix (Flake)** ```bash # Nix flakes kullanarak nix develop npm run dev # Veya devbox kullanarak devbox run npm run dev ``` 📖 [Docker Kılavuzu](docs/guides/DOCKER_GUIDE.md) — Compose profilleri, Caddy HTTPS, Cloudflare tünelleri. **🦭 Podman** ```bash # 1. Bind-mount veri dizinini hazırlayın mkdir -p data # 2. Yalnızca Linux + yerel rootless Podman (asla uzak Podman Machine istemcisi değil): podman unshare chown 1000:1000 ./data # 3. Çalışma zamanı ipucunu ayarlayın, yerel Compose imajını derleyin ve başlatın echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS veya Windows üzerinde Podman uzak bir Podman Machine kullanır: `podman unshare` adımını atlayın ve [topolojiye özel veri dizini rehberini](contrib/podman/README.md#data-directory-permissions-by-topology) izleyin. 📖 [Podman Kılavuzu](contrib/podman/README.md) — Compose derlemeleri, Podman Machine ve Linux/systemd Quadlet kurulumu. **⚡ Daha hızlı / daha hafif kurulum (yerel derlemeyi atlayın)** Yerel SQLite motoru (`better-sqlite3`) **isteğe bağlı** bir bağımlılıktır; bu nedenle genel bir kurulum asla kaynak koddan derlemeyi beklemez: platformunuza/Node sürümünüze uygun önceden derlenmiş bir ikili dosya olduğunda onu kullanır, aksi takdirde şeffaf bir şekilde saf JS motoruna (Node 22+ üzerinde `node:sqlite`, aksi halde paketlenmiş `sql.js` WASM) geri döner — derleme araçları gerekmez. Kurulum sonrası yerel ısınmayı tamamen atlamak için (CI, headless veya yavaş makineler): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 de bunu atlar ``` En hızlı kurulumlar için **pnpm** tercih edin (içerik adresli depolama + hard linkler — yukarıya bakın). Panosuz, headless bir çalışma zamanı için Docker `base` profilini (yukarıda) veya [Termux kılavuzunu](docs/guides/TERMUX_GUIDE.md) kullanın. CLI ve web panosu aynı port üzerinde aynı süreç tarafından sunulur, bu nedenle bugün için ayrı bir yalnızca CLI paketi bulunmamaktadır.

# 🎬 OmniRoute İş Başında

## 📹 Video Rehberleri

_{2026-10-18 tarihli panel anlık görüntüsü · Ham katalog: YT 1.352 | TT 334 | IG 290 · Güncellik (gün): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 görüntüleme}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 görüntüleme}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 görüntüleme}

🎬 #4 — Instagram
_{theopenstack — 692,419 görüntüleme}

🎬 #5 — TikTok
_{migue.baena — 685,788 görüntüleme}

**Tam sıralama (yinelenenlerden arındırılmış kanonik URL'ler, `v > 0`, en yüksek erişim):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | 2026-10-18 tarihli kanonik metrikler: **1.976 benzersiz video** · **20.220.289 bilinen görüntüleme** (`v > 0`) · **platform başına 1.210 kanal/profil**. Ham panel 1.976 satır içeriyor (YouTube 1.352 = 740 uzun video + 612 Shorts · TikTok 334 · Instagram 290); video başına en yüksek sayımı koruyan kanonik URL normalizasyonunun ardından yinelenen kayıt kalmadı. YouTube veri toplama işlemi 2026-10-13 tarihinde donduruldu (API kotası 14–18/10 tarihleri arasında tükendi); TikTok/Instagram veri toplama işlemi ise 2026-09-02 tarihinden beri dondurulmuş durumda (veri toplama kredisi yok); 76 videonun görüntüleme sayısı hâlâ mevcut değil. > 🎬 **OmniRoute hakkında bir video mu hazırladınız?** Bağlantıyla birlikte bir [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) veya [discussion](https://github.com/diegosouzapw/OmniRoute/discussions) açın — burada öne çıkaralım.

# 📧 Topluluk ve Yardım > Her şey tek bir yerde — proje sorumlusunu takip edin, toplulukla sohbet edin veya bir issue açın. | Kanal | Nerede / nasıl | | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — geliştiriciyi takip edin | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — sürümler ve ipuçları için takip edin | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Küresel** | [gruba katılın](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brezilya** | [gruba katılın](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Web sitesi** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute Topluluğu (ücretsiz)** | [StHub portalı](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Kaynak kodu** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Hata bildirin** | [bir sorun açın](https://github.com/diegosouzapw/OmniRoute/issues) — `npm run system-info` çıktısını ekleyin | | 🤝 **Katkıda bulunun** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Dallanma ve Sürüm Modeli](docs/ops/BRANCHING_MODEL.md) · bir `good first issue` seçin | | 💚 **Projeyi destekleyin** | [Destekleme yolları ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ 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 çekirdek kodda sıfır `any`)
Çatı	Next.js 16 + React 19 + Tailwind CSS 4
Veritabanı	better-sqlite3 (SQLite, WAL günlüğe kaydetme) + LowDB (JSON eski sistem) — 147 alan modülü, 233 geçiş
Bellek	SQLite FTS5 tam metin + int8 nicemlemeli vektör gömmeleri, tür bilgili 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 Tarafından Gönderilen 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 & güvenlik	OAuth 2.0 (PKCE) + JWT + API Anahtarları + MCP kapsamlı kimlik doğrulama · Beklemedeki 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, ani yük yığılmasını önleme, otomatik birleşim kendi kendini iyileştirme
Günlükleme	pino — istek bağlamına sahip yapılandırılmış JSON günlükleri
Test	Node.js test çalıştırıcısı + Vitest — 8.400'den fazla izlenen test dosyasında (birim, entegrasyon, E2E, güvenlik, ekosistem) 60.000'den fazla statik test bildirimi
Platformlar	Masaüstü (Electron) · Android (Termux) · PWA (herhangi bir tarayıcı)
CI/CD	GitHub Actions — sürüm yayımlandığında otomatik npm yayımlama + Docker Hub
Bağlantılar	Web sitesi · npm · Docker Hub

## 📖 Belgeler

### 📘 Başlarken

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, Copilot için araç bazında kurulum
Uzak Mod	Kapsamı belirlenmiş erişim belirteçleri aracılığıyla dizüstü bilgisayarınızdaki CLI üzerinden uzak bir OmniRoute'u (VPS) yönetme
Claude Code Yapılandırması	`launch` + model başına profiller ile Claude Code'u OmniRoute'a (yerel/uzak) yönlendirme
Hızlı Başlangıç	3 adımda kur → bağlan → yapılandır

### 🔧 İşletim ve Dağıtım

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ı	Tam kılavuz: VM + nginx + Cloudflare kurulumu
Fly.io Dağıtımı	Kalıcı depolama ile Fly.io'ya dağıtım
Termux Kılavuzu	Termux aracılığıyla OmniRoute'u Android üzerinde çalıştırma
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ı	Tüm `.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ı: kapalı / lite / standart / agresif / ultra / RTK / yığınlanmış
RTK Sıkıştırması	Komut çıktısı sıkıştırma, filtreler, güven, doğrulama, ham çıktı kurtarma
Sıkıştırma Motorları	Caveman, RTK, yığınlanmış işlem hatları, dashboard/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 geliştirme
Dayanıklılık Kılavuzu	Devre kesiciler, bekleme süreleri, kuyruk, ani yük artışını önleme, TLS taklidi
Otomatik Kombinasyon Motoru	16 faktörlü puanlama, mod paketleri, kendini iyileştirme
Proxy Kılavuzu	3 seviyeli proxy sistemi, 1proxy pazaryeri, kayıt CRUD işlemleri
Ücretsiz Katmanlar	Birleştirilmiş dizin: belgelenmiş 34 yinelenen havuz / kataloglanmış 465 ücretsiz katman girdisi
Özellik Galerisi	Ekran görüntüleriyle görsel dashboard turu
Kod Tabanı Belgeleri	Yeni başlayanlara uygun kod tabanı anlatımı

### 🤖 Protokoller ve API'ler

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, taşıma yöntemleri 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ış

### 📋 Proje ve Kalite

Belge	Açıklama
Katkıda Bulunma	Geliştirme kurulumu ve yönergeler
Dallanma ve Sürüm Modeli	PR'ların hedeflendiği yer (`release/*`), `main` ve etiketlerin anlamı
Değişiklik Günlüğü	Sürümlere göre eksiksiz yayın geçmişi
Güvenlik Politikası	Güvenlik açığı bildirme ve güvenlik uygulamaları
i18n Kılavuzu	67 dil desteği, çeviri iş akışı, RTL
Sürüm Kontrol Listesi	Sürüm öncesi doğrulama adımları
Kapsam Planı	8.400'den fazla izlenen test dosyasındaki 60.000'den fazla statik test bildirimi için test kapsamı stratejisi

# ⭐ Öne Çıkan Katkıcılar > 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ürler.** ### Birleştirilen pull request'lere göre harici katkıcılar

Sıra	Katkıcı	Birleştirilen PR'lar	~Değiştirilen satırlar
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{Sayım, canlı release/v3.8.53 dalının 05bc048d6c ipucuyla 2026-11-03 03:01:19 UTC tarihinde yapılmıştır. Sayfalandırılmış GitHub GraphQL sayımı 9.947 birleştirilmiş PR içerir: 4.130'u depo sahibi, 240'ı Dependabot, 6'sı diğer botlar/uygulamalar ve 883 farklı katkıcıdan gelen 5.571 harici PR. “Değiştirilen satırlar”, GitHub eklemeleri + silmeleridir ve oluşturulan dosyaları, kilit dosyalarını, katalogları, çevirileri ve belgeleri içerir; bu, yazarlık LOC'su değil, değişim miktarıdır. 53 PR, 500.000 satırın üzerinde GitHub farkı bildirir (örneğin tek bir sağlayıcı eklemesi olan #13399, 2.347 değiştirilmiş dosya listeler); bu durum yukarıdaki toplamların birkaçını şişirir. Eşitlikler birlikte sıralanır.} ### GitHub'a atfedilen commit'ler

Dizzle _{🥇 GitHub'a atfedilen 418 katkı}	Bob.Hou _{🥈 GitHub'a atfedilen 294 katkı}	Paijo _{🥉 GitHub'a atfedilen 229 katkı}	Paco Cartones _{🏅 GitHub'a atfedilen 222 katkı}	backryun _{🏅 GitHub'a atfedilen 202 katkı}	Jan Leon _{🏅 GitHub'a atfedilen 134 katkı}
Ravi Tharuma _{🏅 GitHub'a atfedilen 126 katkı}	Markus Hartung _{🏅 GitHub'a atfedilen 115 katkı}	Randi _{🏅 GitHub'a atfedilen 108 katkı}	Chris _{🏅 GitHub'a atfedilen 70 katkı}	WebPerson _{🏅 GitHub'a atfedilen 68 katkı}	Koosha Paridehpour _{🏅 GitHub'a atfedilen 68 katkı}

_{2026-11-03 02:09:16 UTC tarihinde yeniden kontrol edildi: release/v3.8.53 varsayılan dalı için depodaki Contributors API tarafından bildirilen GitHub'a atfedilen katkılar. API, 903 kimlik döndürdü (429 kullanıcı, 2 bot, 472 anonim); bu tablo sürdürücüyü, botları ve anonim kimlikleri hariç tutar ve eşitlikleri korur. Bu tablo, hem yukarıdaki birleştirilmiş PR sıralamasından hem de aşağıdaki 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 özelliklere sahip yapan unsurların **temel bir parçasıdır**. Her pull request, her test senaryosu ve her i18n çeviri dosyası önemlidir. Açık kaynak, onlar gibi insanlar tarafından geliştirilir.

---
## 💖 Sponsorlar

OmniRoute'u kendi ceplerinden finanse eden insanlara gönülden teşekkür ederiz — her katkı projenin ücretsiz, bağımsız ve gelişmeye devam etmesini sağlıyor.

Andrew _{💛 Aktif aylık sponsor}	Vlad I _{💛 Aktif aylık sponsor}	小妍儿 _{💛 Aktif aylık sponsor}	Guilherme Costa _{💛 Aktif tek seferlik sponsor}	Henrique Iurkiv _{💛 Aktif tek seferlik sponsor}	Somesh Ghaturle _{💛 Aktif tek seferlik sponsor}
Kolonie AI _{💛 Geçmişte tek seferlik destekçi}	Prof. Igor Morais _{💛 Geçmişte tek seferlik destekçi}	Pixma _{💛 Geçmişte tek seferlik destekçi}	Paco Cartones _{💛 Geçmişte tek seferlik destekçi}	longtao _{💛 Geçmişte tek seferlik destekçi}

_{… ve gizli kalmayı tercih eden diğerleri 💛} _{Herkese açık GitHub Sponsorları, GitHub Sponsors GraphQL API aracılığıyla 2026-10-18 tarihinde yeniden doğrulandı: toplam 14 sponsorluktan 11'i herkese açık (6 aktif, 5 geçmiş). Yukarıdaki aktif etiketleri GitHub'ın isActive durumu belirler; geçmişteki herkese açık tek seferlik destekçilere teşekkür edilmeye devam edilirken özel sponsorlar anonim kalır. Ko-fi, Buy Me a Coffee, Liberapay, PIX ve kripto bağışları, herkese açık sponsor kayıtları bulunmadığından listelenmemiştir.} 💖 Sponsor olun → — bağışlanan her dolar OmniRoute'un ücretsiz ve bağımsız kalmasını sağlar.

## 👥 1.000+ Katkıda Bulunan

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-11-02 tarihinde canlı release/v3.8.53 ipucunda 1c7135e0fb (7.972 commit) denetlendi: 1.074 normalleştirilmiş gerçek kişi Git kimliği — 759'u commit yazarı olarak (bakımcı dahil), 315'i ise yalnızca açık Co-authored-by satırlarında görünüyor. Sayımda .mailmap uygulanır, e-posta adresleri büyük/küçük harf duyarsız olarak karşılaştırılır, sayısal ve düz GitHub noreply adresleri yalnızca aynı kullanıcı adını kodluyorsa birleştirilir, 29 bot/ajan/hizmet/yer tutucu kimliği hariç tutulur ve yalnızca görünen adları eşleştiği için sıradan e-posta adresleri birleştirilmez. 2026-08-24 denetimi 639 yayımlamıştı; bu yöntemin söz konusu denetimin temeli olan ac02c5b42f üzerinde yeniden çalıştırılması 619 sonucunu veriyor. Dolayısıyla artış, daha gevşek bir yöntemden değil, yeni katkıda bulunanlardan kaynaklanıyor.} ### Nasıl Katkıda Bulunulur 1. Depoyu fork'layın 2. **Etkin** `release/vX.Y.Z` dalının ( `main` değil) ipucundan dallanın — bkz. [Dallanma ve Sürüm Modeli](docs/ops/BRANCHING_MODEL.md) 3. Özellik dalınızı oluşturun (`git checkout -b feat/amazing-feature`) 4. Değişikliklerinizi commit'leyin (`git commit -m 'feat: add amazing feature'`) 5. Dalı gönderin (`git push origin feat/amazing-feature`) 6. **base =** `release/vX.Y.Z` dalı olacak şekilde bir Pull Request açın Ayrıntılı yönergeler için [CONTRIBUTING.md](CONTRIBUTING.md) dosyasına bakın. ### Yeni Sürüm Yayımlama ```bash # Bir sürüm oluşturun — npm publish otomatik olarak gerçekleşir VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Yıldızlar

## 🌍 StarMapper

## 🙏 Teşekkürler

OmniRoute, devlerin omuzlarında yükseliyor. **[9router](https://github.com/decolua/9router)** projesinin bir çatallanması ve Go projesi **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**'nin TypeScript portu olarak başladı — ardından aşağıdaki her alt sistem, bu alanda daha önce yol açmış bir açık kaynak projeden ilham aldı. Her biri OmniRoute'un somut bir parçasını şekillendirdi. Bu, hepsine teşekkürümüzdür. 🙏 > ⭐ yıldız sayıları, 3 Kasım 2026 tarihinde GitHub REST API kullanılarak doğrulanmıştır — gidip bu projelere bir yıldız verin. Sayılar, belirli bir tarihe ait kesin bir anlık görüntüdür ve doğal olarak değişecektir. ### 🧬 Soy ağacı ve ağ geçidi

Proje	⭐	OmniRoute'a ilham kaynağı
9router	31,861	Bu çatallanmanın üzerine kurulduğu özgün proje — burada çok modlu API'ler ve eksiksiz bir TypeScript yeniden yazımıyla genişletildi.
CLIProxyAPI	57,329	Bu JavaScript / TypeScript portuna ilham veren Go uygulaması.
LiteLLM	62,580	Maliyet takibi senkronizasyonumuzu besleyen herkese açık fiyatlandırma veri kümesine sahip ve sağlayıcı normalleştirme modeli yönlendirmemize ilham veren AI ağ geçidi.
codex-chatgpt-web	15,435	Tarayıcı oturumu, yanıt çerçeveleme, kullanım ve web araması adaptörleri de dahil olmak üzere, satıcıya dahil edilen ChatGPT Web → Codex Responses köprüsüne uyarlanan MIT kaynak kodu.
free-claude-code	65,966	Akış kurtarma, düşünmesiz takma adlar, yedek web araması, kayan pencere sınırları, günlük redaksiyonu ve güçlendirilmiş başlatıcı akışlarına aktarılan kalıplar.
composer-api	347	Cursor Composer araç seçimi, çıktı kısıtlaması ve araç commit kalıpları yerel Cursor yürütücüsüne uyarlandı.
codex-multi-auth	561	Yeni giriş ve yenileme belirteci döndürme kalıpları Codex OAuth yeniden kimlik doğrulamasına aktarıldı.
opencode-anthropic-auth	562	Claude Code uyumlu dönüştürme varsayılanları ve faturalandırma üst bilgisi davranışı, OmniRoute'un yapılandırma odaklı köprüsünde genelleştirildi.
grok2api-merged	2	Grok model eşlemeleri, sahte-TypeError Statsig oluşturucusu, istek ve cihaz varsayılanları ile NDJSON yanıt işlemcisi, OmniRoute'un Grok Web yürütücüsüne önemli ölçüde uyarlandı.
TQZHR/grok2api	707	grok2api-merged'in arkasındaki başlıca geçişli kod kaynağı; model, üst bilgi, yük, Statsig ve işlemci uygulamaları Grok Web soy ağacında korunmuştur.
chenyme/grok2api	7,874	TQZHR ve grok2api-merged üzerinden taşınan Grok yükü ve cihaz varsayılanları, Statsig oluşturucusu ve `result.response` işlemcisinin temel MIT kaynağı.
grok2api-pro	27	Proxy havuzu katmanı için grok2api-merged tarafından belirtilen geçişli bir kaynak; OmniRoute bu soy ağacı bildirimini korur ancak sınırlandırılmış Grok Web yürütücüsünde bir proxy havuzu portu olduğunu iddia etmez.
GrokProxy	52	Çerez kimlik doğrulamalı Grok proxy'si ve `result.response.token` akış kalıbı, OmniRoute'un Grok Web aktarım katmanına ilham verdi.
GrokBridge	5	Özgün Grok Web uygulamasının HTTP/tarayıcı üst akış tasarımına başvuruldu; doğrudan HTTP yolu GrokProxy'den türediğinden bağımsız bir kod portu iddia edilmez.

### 🗜️ Bağlam ve belirteç sıkıştırma — motorlar

Proje	⭐	OmniRoute'a nasıl ilham verdi
Caveman	116,957	Viral "neden çok token kullanmalı, az token kullanınca da iş görülüyor" projesi — mağara insanı gibi konuşma felsefesi, standart sıkıştırma modumuza ve 30'dan fazla dolgu/yoğunlaştırma kuralımıza güç veriyor.
RTK – Rust Token Killer	85,350	Yüksek performanslı komut çıktısı sıkıştırma — RTK motorumuza, JSON filtre DSL'ine, ham çıktı kurtarmaya ve RTK → Caveman katmanlı işlem hattına ilham verdi.
headroom	78,672	Geri döndürülebilir bağlam sıkıştırma (SmartCrusher) — `headroom` motorumuza ve `ccr` alma işareti desenine ilham verdi.
LLMLingua	6,797	İstem sıkıştırma araştırması (LLMLingua / LLMLingua-2) — eşzamansız, kod güvenli ve hata durumunda açılma özelliğine sahip `llmlingua` motorumuza ilham verdi.
llmlingua-2-js	33	LLMLingua motorumuz için worker-thread arka ucu olarak kullanılan JS/ONNX portu (MobileBERT / XLM-RoBERTa).
Troglodita	50	PT-BR token sıkıştırma — Brezilya Portekizcesi dil bilgisine göre ayarlanmış gereksiz sözcük azaltma ve dolgu kaldırma özellikleriyle pt-BR dil paketimize güç veriyor.
ponytail	182,929	Viral "tembel kıdemli geliştirici" YAGNI kodlayıcı becerisi — daha-az-kod Output Style'ımıza ilham verdi: Caveman'ın kısa ve öz anlatımının çıktı eksenindeki kardeşi olan, _üretilen_ kodu azaltan en küçük çalışan değişikliği yönlendirmesi.
i-have-adhd	59,838	Eylem öncelikli, DEHB dostu yanıt stili, beş dilde OmniRoute'un özlü çıktı stiline uyarlandı.

### 🧩 Kompakt biçimler, token araştırması ve kod farkındalığına sahip araçlar

Proje	⭐	OmniRoute'a nasıl ilham verdi
TOON	25,602	Token Odaklı Nesne Gösterimi — sütun tabanlı, başlık ve satırlardan oluşan modeli tablo yoğunlaştırma aşamamızı şekillendirdi.
GCF – Graph Compact Format	61	Kompakt grafik biçimi ve genel profil tasarımı, OmniRoute'un tablo yoğunlaştırma ve Headroom kodlayıcı biçimine bilgi sağladı.
gcf-typescript	4	Headroom genel profil kodlayıcısı olarak doğrudan projeye dahil edilip genişletilen MIT TypeScript uygulaması.
token-optimizer-mcp	566	Brotli/SQLite önbelleği + oturum başına bağlam farkı — `session-dedup` motorumuza ilham verdi.
token-savior	1,203	Bash çıktısı yoğunlaştırma + MCP profilleri — sıkıştırmadan vazgeçme disiplinimize ve MCP araç bildirim dosyası azaltımına ilham verdi.
token-saver	162	İçerik farkındalığına sahip, dosya türü başına çıktı sıkıştırma ve hata farkındalığıyla vazgeçme — tür başına yönlendirmemizi ve minimum kazançta atlama davranışımızı doğruladı.
token-optimizer	2,853	"Hayalet token'ları bulun" — boşaltma + kurtarılabilir tanıtıcı deseni, CCR boşaltma yaklaşımımıza bilgi sağladı.
TokenMizer	34	Oturum grafiği + turlar arası satır tekilleştirme taslağı, session-dedup tasarımımıza bilgi sağladı.
OmniCompress	3	Rust sütun tabanlı JSON + içerik adresli alma + iletiler arası tekilleştirme — `headroom`/`ccr`/`session-dedup` motor tasarımımızı ve önbellek kararlılığı sağlayan "sıkıştırılmış biçim konumdan bağımsızdır" değişmezini doğruladı.
mcp-compressor	140	MCP araç şeması/açıklaması sıkıştırma — MCP araç bildirim dosyasındaki öğe sayısını azaltma yaklaşımımıza bilgi sağladı.
RepoMapper	218	Aider tarzı depo haritası sıralaması — depo haritası / alma sıralaması araştırmamıza bilgi sağladı.
quiet-shell-mcp	4	MCP üzerinden bildirimsel kabuk çıktısı azaltma — bildirimsel bash çıktısı yoğunlaştırmamızı doğruladı.
ts-morph	6,222	TypeScript Derleyici API araç seti — dize, şablon ve normal ifade sabitlerini koruyarak ayrıştırıcı tabanlı yorum kaldırma özelliğimize ilham verdi.

### 🧠 Bellek ve RAG

Proje	⭐	OmniRoute'a nasıl ilham verdi
Mem0	68,294	Evrensel bellek katmanı — proxy'nin yazma/okuma sınırı olarak kullanıldığı modeli, bellek mimarimizi şekillendirdi.
Letta (MemGPT)	25,321	Katmanlı belleğe sahip durum bilgili aracılar — Context Control & Recovery (CCR) katmanlı modelimize ilham verdi.
WFGY	1,804	16 yinelenen RAG/LLM hata modundan oluşan ProblemMap taksonomisi — sorun giderme kılavuzumuzdaki ortak terminolojiyi oluşturdu.

### 🛰️ Trafik inceleme, MITM ve şeffaf proxy

Proje	⭐	OmniRoute'a nasıl ilham verdi
llm-interceptor	81	Kodlama asistanı ↔ LLM trafiğinin MITM üzerinden yakalanması/analizi, ilk Traffic Inspector gereksinimlerini şekillendirdi. Daha önce türetilmiş dört modül — SSE birleştirme, konuşma normalleştirme, gizli bilgilerin maskelenmesi ve başlık temizleme — kamuya açık protokol standartlarına dayalı bağımsız temiz oda uygulamalarıyla değiştirildi. İki ana bilgisayar geçiş yüzeyi (`passthrough.ts` ve `_internal/bypass.cjs`) bağımsız olarak sınıflandırılan OmniRoute dahili uygulamaları olarak kalmıştır; bu değişimin parçası olarak yeniden yazılmamışlardır.
ProxyBridge	6,978	İşlem başına şeffaf proxy yönlendirmesi — çökme güvenli MITM sonlandırmamıza, soket boşta kalma zaman aşımlarına, `/proc` işlem ilişkilendirmesine ve TPROXY yakalamasına ilham verdi.

### 📚 Model verileri, gözlemlenebilirlik ve kullanıcı arayüzü

Proje	⭐	OmniRoute'a nasıl ilham verdi
models.dev	7,486	Yapay zeka modellerinin özellikleri, fiyatlandırması ve yeteneklerine ilişkin açık veritabanı — model kataloğumuza yerel olarak senkronize edilir.
React Flow / xyflow	38,874	Gerçek zamanlı Compression Studio ve Combo/Routing Studio'larımıza güç veren düğüm tabanlı grafik kütüphanesi.
LangGraph	44,349	LangGraph Studio'nun canlı iş akışı grafiği görselleştirmesi, Studio'larımızın gerçek zamanlı kademeli görünümüne ilham verdi.
Langfuse	36,907	İz → span → oluşturma gözlemlenebilirlik modeli, Compression Studio şelalemizi şekillendirdi.
Kiali	3,647	Istio servis ağı gözlemlenebilirliği — Routing/Combo Studio'daki devre kesici rozetlerimize ve hata kenarı görsellerimize ilham verdi.
lobe-icons	2,666	Kontrol panelimizde sağlayıcı simgelerini oluşturan yapay zeka/LLM marka logoları.
flag-icons	12,499	README dil seçicisinde kullanılan MIT lisanslı SVG bayraklarını sağlar.

### 🛡️ Güvenlik

Proje	⭐	OmniRoute'a nasıl ilham verdi
awesome-secure-defaults	723	Güvenli varsayılanlarla gelen kütüphanelerin derlenmiş listesi; güvenlik tercihlerimize (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink) yön verir.

### 🧭 Tamamlayıcı araçlar

Proje	⭐	OmniRoute'a nasıl ilham verdi
ClawRouter	6,649	İstek tekilleştirmeye, acil durumlarda sıfır maliyetli geri dönüşe, eklenti olarak kullanılabilen Auto-Combo stratejilerine ve çok dilli niyet sınıflandırmasına ilham verdi.
Antigravity-Manager	32,785	Hesap farkındalıklı model yeniden eşlemesi, çalıştırılabilir yol doğrulaması ve plan etiketi davranışı, OmniRoute'un Antigravity çalışma zamanını şekillendirdi.
vscode-antigravity-cockpit	4,852	Kompakt kota sıfırlama geri sayımı biçimi, OmniRoute'taki ilgili sağlayıcı sınırı görünümüne ilham verdi.
AionUi	33,996	ACP entegrasyonları, OmniRoute'un yüklü CLI aracılarını otomatik olarak algılamasına ilham verdi.
CodexBar	22,955	Grok Build kota yüzeyini belirledi; OmniRoute daha sonra canlı kablo biçimini bağımsız olarak doğrulayıp düzeltti.

## 📄 Lisans MIT Lisansı - ayrıntılar için [LİSANS](LICENSE) bölümüne bakın. ---

**[⬆ Başa dön](#-omniroute)** · Açık kaynaklı yapay zekâ topluluğu için ❤️ ile geliştirildi. _{Diego Souza tarafından oluşturuldu · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT Lisansı · omniroute.online}