# README (Bahasa Melayu) 🌐 **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) · 🇲🇹 [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) · 🇹🇷 [tr](../tr/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 — Gerbang AI Percuma **Dicipta oleh [Diego Souza](https://github.com/diegosouzapw)**

OmniRoute — Jangan berhenti menulis kod. Setiap alat AI → 388 pembekal — 150+ percuma — melalui satu titik akhir. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity kepada Claude / GPT / Gemini PERCUMA dengan sandaran automatik. Pemampatan bertindan RTK + Caveman menjimatkan 15–95% token (~89% secara purata) — jangan sekali-kali mencapai had. 388 pembekal AI · 150+ peringkat percuma · ~1.62B token percuma/bln · 20 strategi penghalaan · $0 untuk bermula.

## 💰 ~1.62B Token / Bulan Merentas Peringkat Percuma Pihak Ketiga

> **Gunakan akaun penyedia anda sendiri.** Ini ialah anggaran agregat merentas peringkat percuma pihak ketiga yang layak secara berasingan, bukannya pemberian token daripada OmniRoute. Daftar, dapatkan kelayakan apabila diperlukan, dan sambungkan penyedia yang boleh anda gunakan; setiap penyedia mengawal had, ketersediaan dan syarat mereka sendiri. > > Menggabungkan peringkat percuma secara manual memang menyusahkan — berpuluh-puluh SDK, berpuluh-puluh had kadar, dan tiada cara untuk mengetahui jumlah sebenar yang anda miliki. OmniRoute mengkatalogkan **465 entri peringkat percuma merentas 34 kunci pool berulang** dan mengira tajuk token daripada **17 pool dengan bajet bulanan positif yang diterbitkan serta lima had Groq setiap model**, dengan pendua dibuang berdasarkan pool yang dikongsi. Kuota yang hanya dibuka selepas semakan identiti serantau (hari ini: ModelScope) dipaparkan secara berasingan, +~6M selepas pengesahan identiti serantau, dan tidak pernah dijumlahkan ke dalam tajuk utama. Hasilnya kekal kelihatan pada papan pemuka (`/dashboard/free-tiers`).

Kad bajet peringkat percuma OmniRoute: ~1.62B token percuma sebulan secara stabil, sehingga ~2.22B pada bulan pertama dengan kredit pendaftaran, daripada 34 kunci pool berulang yang didokumenkan merangkumi 465 entri peringkat percuma yang dikatalogkan di sebalik satu titik akhir. Pengiraan jujur yang dinyahpendua berdasarkan pool — setiap pool yang dikongsi dikira sekali sahaja, termasuk 17 pool berulang dengan bajet token bulanan positif yang diterbitkan serta lima had Groq setiap model; 12 penyedia ditandakan sebagai elakkan dalam katalog risiko syarat supaya anda boleh membuat keputusan. Bar bajet merangkumi Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (lima had setiap model) dan pool yang lebih kecil, serta kredit pendaftaran bulan pertama dan penyedia yang percuma secara kekal tanpa had token yang dipaparkan secara berasingan supaya tidak mengembangkan tajuk utama. Jumlah digunakan/baki secara langsung pada /dashboard/free-tiers.

> Ringkasan beranimasi halaman `/dashboard/free-tiers` secara langsung. Metodologi penuh (penyahduaan pool, peringkat kredit, syarat penyedia): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Angka ini diaudit semula setiap dua minggu berdasarkan katalog langsung dan **boleh berubah ke kedua-dua arah** — penyedia menamatkan peringkat percuma dan jumlahnya menurun; penyedia baharu muncul dan jumlahnya meningkat. Kami menerbitkan perkara yang benar-benar dikira oleh katalog, bukan senario terbaik yang dibundarkan ke atas.}

⭐ Beri bintang pada repositori ini jika OMNIROUTE membantu anda menjimatkan wang dan memudahkan kerja anda.

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

[![Kedudukan Sejarah Bintang](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) ### 💬 Sertai komuniti **👋 Ikuti penyelenggara — dapatkan penyedia baharu, keluaran dan tip terlebih dahulu:** [![Ikuti Diego di LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Ikuti @diegosouzapw di GitHub](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) [![Laman Web](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Soalan, tip penyedia, peta jalan & sokongan → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Gateway Terus Berkembang

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | -------------------------------- | :----------------------------: | :---------: | :-------------------: | | 🌐 Penyedia | 352 | **358** | 388 | | 🧠 ID model chat unik | 1320 | **1374** | 1491 | | 🖼️ Jambatan modaliti | 🆕 penglihatan + audio + video | ✓ | ✓ | | 📡 Katalog percuma Radar | 🆕 ikut serta | ✓ | ✓ | | ⚖️ Penjadualan berpandukan kuota | 🆕 Quota-Share | ✓ | ✓ | | 📊 Telemetri kuota | 🆕 langsung | ✓ | ✓ | | 🧰 Mod tanpa kepala | — | — | 🆕 `serve --headless` | | 🛤️ Infrastruktur rel LTS | — | — | 🆕 saluran keluaran | | 🔎 API penemuan model | — | — | 🆕 `/v1/models/query` | **→ [Pelan hala tuju](ROADMAP.md) — meniti rel menuju `v3.9.0 LTS`**

## 🧩 Tersedia [![Versi npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Bulanan](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) [![Lesen: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Tarikan Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Muat Turun Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Mula	🚀 Mula Pantas	📦 Pasang	🆓 Sambungkan pembekal
💡 Pelajari	💥 Janji	🤔 Mengapa OmniRoute	🏆 Keistimewaan
⚙️ Ciri	🎯 Kombinasi	🌐 Pembekal	🔌 CLI & MCP
	🗜️ Pemampatan	🖥️ Tempat Ia Berjalan	🔒 Persendirian
👀 Lihat	🎬 Dalam Tindakan	✨ Perkara Baharu	🤖 CLI yang Serasi
💚 Sokong	💚 Sokong / Derma	💬 Komuniti	💖 Penaja
📦 Projek	🛠️ Timbunan Teknologi	📖 Dokumentasi	👥 Penyumbang

🌐 Dalam 67 bahasa

## 🆓 Pasang, sambungkan penyedia, kemudian halakan melalui satu titik akhir

Tiga langkah: pasang dan mulakan OmniRoute, sambungkan penyedia yang layak menggunakan akaun atau kunci API anda sendiri, kemudian halakan alat anda ke localhost:20128/v1 menggunakan kunci API OmniRoute dan model auto. Penghalaan bergantung pada sambungan layak yang tersedia dan had penyedia.

```bash # Selepas menyambungkan penyedia, salin kunci OmniRoute anda daripada Papan Pemuka → Titik Akhir: 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` memerlukan laluan yang layak. Pemasangan baharu mungkin tidak mempunyai sasaran tanpa kunci yang layak, dan penyedia tanpa kunci mungkin menolak klien pihak ketiga. Penyedia yang ditandai `tos: avoid`, termasuk Kiro, dikecualikan daripada penghalaan automatik secara lalai; menyambungkan akaun tidak akan mengatasi tetapan tersebut. Rujuk [Panduan Tingkatan Percuma](docs/getting-started/FREE-TIERS-GUIDE.md) sebelum memilih penyedia.} _{📦 Skrip quickstart salin-tampal untuk **Python, Node.js, PHP, dan cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Janji

# 🤔 Mengapa OmniRoute?

Aliran permintaan OmniRoute: IDE atau CLI anda (Claude Code, Cursor, Cline…) memanggil satu titik akhir setempat (http://localhost:20128/v1); Penghala Pintar OmniRoute (pemampatan RTK + Caveman, 20 strategi penghalaan, pemutus litar, penyamaran TLS, MCP, A2A, pagar kawalan) boleh melakukan fallback merentasi 4 tingkat penyedia selagi sasaran sihat yang layak masih tersedia — Tingkat 1 Langganan, Tingkat 2 Kunci API, Tingkat 3 Murah dan Tingkat 4 Percuma.

## 🤝 Disokong oleh Rakan Sumber Terbuka Kami

> **Ingin menyertai sebagai Rakan Sumber Terbuka?** Ini adalah syarikat-syarikat yang menyokong sumber terbuka dan membantu OmniRoute terus bergerak — dan kami menyatakan secara terbuka ke mana setiap token yang mereka berikan kepada kami pergi. Hubungi: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Terima kasih kepada Kimi (Moonshot AI), Rakan Sumber Terbuka pengasas kami, kerana menyokong projek ini! Kimi adalah makmal AI di sebalik keluarga model K2 dan K3 dengan berat terbuka — Kimi K3 menawarkan tetingkap konteks 1M-token, penglihatan asli dan pengekodan peringkat sempadan pada sebahagian kecil daripada harga model tertutup, dan berfungsi dengan baik dengan Claude Code, Codex dan setiap alat pengekodan yang disediakan oleh OmniRoute.

Apa yang disokong oleh Kimi: Kredit API Kimi menggerakkan saluran keluaran yang disahkan AI OmniRoute — peringkat pengesahan gabungan yang dikuasakan oleh Kimi K3 yang menyemak setiap permintaan tarik sebelum ia dihantar — serta pembangunan ciri harian. Sokongan Kimi kelas pertama dihantar pada kedua-dua rel: API Kimi langsung (kimi-k3) dan pelan pengekodan Kimi Code (OAuth dan kunci API). OmniRoute juga merupakan projek sumber terbuka Brazil pertama dalam program sokongan Kimi. Dapatkan kunci API Kimi dengan 15% kredit tambahan →

Cheaper Inference
_{cheaperinference.com} Terima kasih kepada Cheaper Inference, Rakan Sumber Terbuka OmniRoute, kerana menyokong projek ini! Cheaper Inference adalah gerbang yang dinilai kos yang menjual semula 42 model sempadan — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok dan MiniMax — di sebalik satu titik akhir yang serasi dengan OpenAI, menghantar setiap permintaan kepada penyedia yang paling murah tanpa pernah mengenakan bayaran melebihi harga senarai pembuat model.

Sokongan kelas pertama dalam OmniRoute: Chat Completions, titik akhir /v1/responses asli, penglihatan, panggilan alat dan 3 model imej (grok-imagine, nano-banana-pro, nano-banana-2, boleh dicapai sebagai cheaperinference/<model>). Dapatkan kunci API →

_{Pautan yang ditandai aff=omniroute adalah pautan rakan kongsi. Ia membiayai projek tanpa kos tambahan kepada anda.}

_{🎟️ Promosi Afiliasi — kupon pendaftaran percuma daripada penyedia yang tidak kami taja (klik untuk kembangkan)}

_{Bahagian ini adalah untuk kod rujukan/kupon sahaja. Perkongsian yang ditaja terdapat dalam 🤝 Disokong oleh Rakan Sumber Terbuka Kami di atas. OmniRoute tidak mempunyai penajaan atau perkongsian dengan penyedia yang disenaraikan di sini — ini adalah kupon awam yang boleh digunakan oleh sesiapa sahaja.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — pendaftaran afiliasi · $100 kredit percuma semasa pendaftaran (pelayan percuma, jangkakan kependaman yang lebih tinggi — terbaik untuk ujian, bukan pengeluaran). Sokongan kelas pertama dalam OmniRoute sejak v3.8.50: Chat Completions, format wayar yang serasi dengan Anthropic dan laluan yang serasi dengan OpenAI. Model yang tersedia termasuk claude-opus-4-8, claude-opus-5, gpt-5.6-sol dan banyak lagi. Dapatkan $100 anda →}

_{⚠️ Pautan afiliasi — OmniRoute tidak mempunyai penajaan atau perkongsian dengan penyedia ini.}

_{Tahu penyedia lain dengan kupon pendaftaran percuma yang murah hati yang memberi manfaat kepada pengguna OmniRoute? Buka isu dan kami akan menambahnya di sini.}

## 🎯 Kombo — Ciri Utama

Contoh animasi bagi 18 daripada 20 strategi penghalaan kombo — satu petak bagi setiap strategi: 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 dan quota-weighted tidak dianimasikan; jadual di bawah menerangkan kesemua 20 strategi.

> **Kombo** ialah rantaian model yang OmniRoute halakan secara **automatik**. Jika kuota habis, penyedia gagal, atau kos melonjak, kombo boleh beralih kepada model sihat seterusnya yang layak. 🛡️ ### ⚡ Konfigurasi sifar — hanya gunakan `auto` Tiada kombo yang perlu dicipta. Tetapkan model anda kepada `auto` (atau variannya) dan OmniRoute membina kombo maya daripada penyedia anda yang telah disambungkan, dengan pemarkahan masa nyata:

ID Model	Perkara yang dioptimumkan
`auto`	🎯 Lalai seimbang (LKGP — kekal dengan penyedia terakhir anda yang berfungsi dengan baik)
`auto/coding`	🧑💻 Pemberat yang mengutamakan kualiti untuk penjanaan kod
`auto/fast`	⚡ Kependaman terendah didahulukan
`auto/cheap`	💰 Kos termurah bagi setiap token didahulukan
`auto/subscription`	🎟️ Hanya kuota langganan yang telah anda bayar — gagal secara tertutup, tanpa sandaran yang boleh dikenakan bayaran (panduan)
`auto/thrifty`	🪜 Kuota pelan didahulukan, kemudian satu anak tangga pada satu masa kepada pilihan berbayar termurah — kembali kepada pelan selepas ia ditetapkan semula (panduan)
`auto/offline`	🔋 Ruang baki kuota / had kadar terbanyak didahulukan
`auto/smart`	🔭 Mengutamakan kualiti + penerokaan 10% untuk menemui model yang lebih baik
`auto/lkgp`	📌 Kekekalan eksplisit pada penyedia terakhir yang diketahui berfungsi dengan baik
`auto/chaos`	🧪 Pengagihan selari kepada panel model (satu bagi setiap penyedia, 5 secara lalai), mengembalikan satu jawapan; satu panggilan huluan bagi setiap model panel, bukan penyuntikan kegagalan

## ### 🔀 Atau bina sendiri — 20 strategi penghalaan Kesemua **20** strategi — campur & padankan bagi setiap langkah kombo:

#	Strategi	Fungsinya
1	`priority`	Senarai tersusun yang mengutamakan sasaran pertama — habiskan setiap satu sebelum beralih kepada yang seterusnya 🥇
2	`fill-first`	Gunakan sepenuhnya kuota setiap sasaran sebelum beralih
3	`weighted`	Pemilihan rawak berwajaran berdasarkan pemberat setiap sasaran
4	`round-robin`	Kitar melalui sasaran mengikut turutan
5	`p2c`	Pengimbangan beban rawak menggunakan kaedah kuasa dua pilihan
6	`least-used`	Pilih sasaran dengan beban semasa yang paling rendah
7	`random`	Pemilihan rawak seragam (dinyahpendua)
8	`strict-random`	Rawak tanpa menyahpendua pengulangan 🎲
9	`cost-optimized`	Minimumkan $ bagi setiap permintaan berdasarkan harga katalog masa nyata 💸
10	`headroom`	Pilih sasaran dengan baki kuota terbanyak
11	`quota-weighted`	Langkau akaun yang telah kehabisan kuota, kemudian pilih secara berkadar dengan baki kuota ÷ beban sedang diproses — perbualan sedia ada kekal disematkan ⚖️
12	`reset-window`	Utamakan sasaran yang tempoh kuotanya akan ditetapkan semula paling awal
13	`reset-aware`	Susun kedudukan berdasarkan masa penetapan semula kuota — tempoh pendek didahulukan 📊
14	`context-relay`	Serahkan konteks merentas sasaran untuk perbualan panjang 🧠
15	`context-optimized`	Pilih padanan terbaik untuk saiz konteks semasa
16	`cache-optimized`	Sematkan setiap awalan prom yang boleh digunakan semula kepada akaun yang sama — maksimumkan padanan cache prom 🎯
17	`lkgp`	Laluan Terakhir yang Diketahui Baik — menyematkan kepada penyedia terakhir yang berjaya, kemudian kembali kepada peraturan sandaran
18	`auto`	Pemarkahan masa nyata 16 faktor merentas setiap sambungan 🤖
19	`fusion`	Agihkan kepada panel model + penilai mensintesis satu jawapan 🧬
20	`pipeline`	Rantaikan langkah — output setiap sasaran disalurkan kepada sasaran seterusnya 🔗

_{Enjin Auto-Combo memberikan skor kepada setiap calon berdasarkan **16 faktor** (kesihatan, kuota, kos, kependaman, kesesuaian tugas, kualiti, ketersediaan sesi…) — lihat [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Daya tahan terbina dalam (3 lapisan bebas)

Daya tahan OmniRoute — 3 lapisan pemulihan kendiri yang bebas, lapisan yang tepat untuk kegagalan yang tepat. Lapisan 1 pemutus litar penyedia (seluruh penyedia): dicetuskan hanya pada 408/5xx, ambang OAuth 8× / kunci API 12× / setempat 2×, ditetapkan semula selepas 60s/30s/15s kepada siasatan HALF-OPEN, pemulihan malas; semasa OPEN, kombo mengubah hala ke penyedia seterusnya. Lapisan 2 tempoh bertenang sambungan (satu kunci/akaun): asas 5s OAuth / 3s kunci API, undur eksponen ×2 dengan perlindungan anti-thundering-herd, 429 mematuhi Retry-After, kejayaan mengosongkan semua keadaan ralat; satu kunci yang sedang dalam tempoh bertenang dilangkau sementara kunci setara terus berkhidmat. Lapisan 3 sekatan model (satu model): 429 bagi setiap model, 404 setempat atau penolakan mod menyekat model itu sahaja — bukan keseluruhan sambungan. Keadaan terminal (diharamkan, tamat tempoh, kredit habis) adalah untuk pengendali, bukan tempoh bertenang.

_{📖 [Enjin Auto-Combo](docs/routing/AUTO-COMBO.md) · [Panduan Daya Tahan](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Perkara yang Membezakan OmniRoute

_{📊 Metodologi lengkap & perincian setiap ciri berbanding 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Sokong OmniRoute OmniRoute dilesenkan di bawah MIT dan diselenggara secara terbuka. Jika ia menjimatkan masa atau wang anda, berikut ialah cara untuk membantu mengekalkannya bebas — pilih apa sahaja yang sesuai untuk anda. Penajaan tidak pernah mempengaruhi keutamaan penghalaan; ia memberikan keterlihatan, bukan kedudukan.

⭐ Bintangkan repositori	Percuma — benar-benar membantu keterlihatan	Bintangkan OmniRoute
🐙 GitHub Sponsors	Sekali bayar atau bulanan · tiada yuran platform	github.com/sponsors/diegosouzapw
☕ Ko-fi	Sumbangan sekali bayar yang pantas, penderma tidak perlu mendaftar	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Sumbangan kecil dan tidak formal	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Berulang · bukan berasaskan keuntungan · sumber terbuka	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)	Serta-merta, tanpa yuran	kunci & kod QR di bawah
₿ Kripto	BTC · ETH · USDT-TRC20 · USDC-Solana	alamat di bawah

**🇧🇷 PIX** — serta-merta, tanpa yuran (Brazil) Kod QR PIX OmniRoute

Kunci (rawak): `5d865059-bc44-483a-962d-43ceb80126eb` Salin dan tampal Pix: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ Kripto — BTC · ETH · USDT-TRC20 · USDC-Solana (klik untuk kembangkan)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ Hantar setiap mata wang hanya melalui rangkaian yang ditunjukkan — penghantaran melalui rangkaian yang salah boleh menyebabkan kehilangan dana.}

🐛 Menemui pepijat atau ingin memberikan maklum balas? Buka [Perbincangan](https://github.com/diegosouzapw/OmniRoute/discussions).

Nota pembangun: Projek ini mungkin menjana fail .env setempat semasa npm install/postinstall untuk kemudahan pembangun. Fail ini sengaja diabaikan melalui .gitignore (lihat .gitignore) dan tidak boleh dikomit sama sekali — jika terkomit secara tidak sengaja, tukar semua rahsia yang terdedah dan alih keluar fail tersebut daripada sejarah. Lihat docs/DEVELOPER-ENVIRONMENT.md untuk panduan mengurus fail persekitaran setempat dan rahsia.

## 📡 Radar OmniRoute Sorotan utama peringkat percuma kekal pada **~1.62B token/bulan** daripada katalog yang didokumenkan dan dinyahpendua berdasarkan kumpulan di atas. Kredit pendaftaran penyedia sementara boleh meningkatkan jumlah bulan pertama secara berasingan kepada **~2.22B**. Radar ialah lapisan tindanan katalog bertandatangan yang bersifat pilihan untuk mereka yang mahukan ketersediaan model percuma yang lebih terkini antara keluaran OmniRoute; katalog komuniti dan setiap ciri percuma sedia ada kekal percuma. Penyokong boleh menerima katalog langsung dan peluang penyedia tambahan. Had maksimumnya yang berasingan dan boleh berubah ialah **kira-kira 3B token/bulan paling banyak**, bergantung pada ketersediaan penyedia. Had maksimum tersebut bukan jaminan: penyedia boleh mengubah kuota, kelayakan, model atau rantau pada bila-bila masa. Radar adalah secara ikut serta dan GET sahaja. Klien OmniRoute tidak memuat naik gesaan, trafik, konfigurasi penyedia, telemetri penggunaan atau keadaan setempat bagi pengumuman yang telah ditutup. Ketahui tentang kelayakan dan katalog semasa di **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Apa yang Baharu

> Sorotan terkini daripada **v3.8.20 → v3.8.54**. Sejarah penuh dalam [`CHANGELOG.md`](CHANGELOG.md). - **⚖️ Penghalaan `quota-weighted`** — strategi gabungan ke-20 melangkau akaun yang telah kehabisan kuota, kemudian memilih daripada akaun yang selebihnya mengikut kadar kuota berbaki ÷ beban dalam penerbangan, sambil mengekalkan perbualan sedia ada pada akaun masing-masing. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Mod tanpa antara muka** — `omniroute serve --headless` (atau `OMNIROUTE_HEADLESS=1`) hanya menjalankan enjin proksi `/v1/*`, dengan papan pemuka dan subsistem khusus papan pemuka dimatikan. → [Mod Tanpa Antara Muka](docs/guides/HEADLESS.md) - **🔎 Penemuan model** — `/v1/models` menapis mengikut keupayaan, konteks, jenis dan teks, manakala `POST /v1/models/query` mengembalikan senarai pendek deterministik dengan keterlihatan setiap kunci yang sama. → [Rujukan API](docs/reference/API_REFERENCE.md) - **🔑 Kawalan penghalaan setiap kunci** — sematkan kunci API pada satu model atau gabungan dengan `forcedModel`, dan tambah atau buang model serta gabungan kunci secara atomik (`/api/keys/{id}/access`). → [Rujukan API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ Kawalan PII yang lebih terperinci** — pemilihan mengikut jenis, sehingga 20 corak pelindungan tersuai yang disahkan dan pembilang pengesanan mengikut jenis; pelindungan itu sendiri kekal sebagai pilihan. → [Perlindungan](docs/security/GUARDRAILS.md) - **🌍 67 bahasa** — papan pemuka, cermin dokumentasi dan CLI, dengan `npm run i18n:add-locale` menambahkan bahasa di semua tempat melalui satu arahan. → [Panduan i18n](docs/guides/I18N.md) - **🎛️ OmniConductor** — delegasi A2A masuk kepada armada ejen anda, kemahiran Conductor pada Agent Card, serta panel papan pemuka dengan sembang suara tekan-untuk-bercakap Faro. → [Pelayan A2A](docs/frameworks/A2A-SERVER.md) - **🛂 Kemasukan adaptif & perlindungan beban berlebihan** — permintaan sembang berat beratur dan bukannya menghasilkan ralat 503, dengan pajakan gelongsor RPM atomik bagi setiap sambungan. → [Panduan Ketahanan](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Susunan kanonikal `/v1/models`** — satu blok bersebelahan yang dikumpulkan mengikut pembekal bagi setiap pembekal (gabungan disematkan dahulu), stabil merentasi setiap sumber katalog. → [Rujukan API](docs/reference/API_REFERENCE.md) - **🗜️ Pengukuhan pemampatan** — perlindungan pengembangan yang diaktifkan secara lalai, pek Caveman untuk DE / FR / JA + bahasa Cina (wényán), penapis RTK untuk Gradle & .NET. → [Pemampatan](docs/compression/COMPRESSION_ENGINES.md) - **💸 Kos kadar rata yang telus** — pembekal langganan / pelan pengekodan memaparkan **$0** dalam analitik kos; belanjawan, kuota & penghalaan terus membuat anggaran. → [Rujukan API](docs/reference/API_REFERENCE.md) - **⚖️ Penghalaan Quota-Share** — bahagikan kuota akaun dikongsi secara adil merentasi kunci terkumpul, dengan penggunaan berterusan supaya bahagian yang tidak aktif boleh dipinjamkan. → [Panduan Ketahanan](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Persediaan CLI/ejen satu arahan** — 15 arahan `setup-*` didaftarkan; `omniroute run` melancarkan 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` menyokong 11 sasaran dengan pemilih pembekal+model interaktif serta kegemaran mengikut konteks. → [Integrasi CLI](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Mod jauh** — kendalikan OmniRoute jauh dengan token berskop (`connect` / `contexts` / `tokens`) + pembantu OAuth `antigravity` untuk pemasangan VPS. → [Mod Jauh](docs/guides/REMOTE-MODE.md) - **🧭 Penghalaan automatik yang lebih pintar** — gabungan `auto/:`, **Fusion** (panel model + hakim), penghalaan sedar tugas, penggantian model / mod / belanjawan USD bagi setiap permintaan. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Pemampatan boleh pasang** — 12 enjin boleh gubah + Compression Studios: LLMLingua-2, Ultra dua peringkat, omniglyph, get laluan kesetiaan setiap langkah, GCF v3.2, penyunting seret-susun. → [Pemampatan](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Nyahsulit MITM telus (TPROXY)** — tangkap CLI yang mengabaikan pemboleh ubah persekitaran proksi, dengan pemasang CA + gedung kepercayaan mengikut SNI. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Telemetri kos di semua tempat** — pengepala kos/penggunaan `X-OmniRoute-*` pada setiap titik akhir, pengepala penjimatan cache-HIT, kuota perbelanjaan USD mengikut kunci. → [Rujukan API](docs/reference/API_REFERENCE.md) - **🧠 Memori yang anda kawal** — dimatikan secara lalai, pengkuantuman vektor int8 + pereputan bertip yang diaktifkan secara pilihan, `x-omniroute-no-memory` bagi setiap permintaan. → [Memori](docs/frameworks/MEMORY.md) - **🛡️ Keselamatan** — perlindungan suntikan prompt pada setiap laluan LLM (suite red-team), perlindungan penyamaran kelayakan yang diaktifkan secara pilihan (menyunting kunci API/rahsia yang bocor dalam kedua-dua arah), carian web DuckDuckGo percuma sebagai pilihan terakhir, serta get laluan log masuk OIDC pilihan untuk papan pemuka (log masuk kata laluan sentiasa tersedia). → [Perlindungan](docs/security/GUARDRAILS.md) - **🖼️ Titik akhir baharu** — `/v1/ocr` (Mistral OCR) dan `/v1/audio/translations` (gaya Whisper) melengkapkan permukaan media. → [Rujukan API](docs/reference/API_REFERENCE.md) - **🎨 Penjanaan imej / video / audio** — satu API untuk media: xAI Grok Imagine & video Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind, serta pembekal pertuturan seperti ElevenLabs. → [Rujukan API](docs/reference/API_REFERENCE.md) - **🌍 Penerapan & operasi** — `basePath` proksi songsang, pengesanan automatik bahasa pelayar, penjejakan peranti mengikut kunci, kepercayaan MITM tanpa root, penyetempatan zh-TW. → [Persekitaran](docs/reference/ENVIRONMENT.md) - **🤝 Lebih banyak pembekal & ejen** — ejen awan (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) dengan log masuk pelayar + OAuth, kad kelas pertama Ollama, Claude Opus 5 & Sonnet 5, kerjasama rasmi Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… serta **katalog 388 pembekal** yang diperbaharui. → [Pembekal](docs/reference/PROVIDER_REFERENCE.md) - **📡 Ketelusan penghalaan** — setiap respons membawa pengepala `X-OmniRoute-Decision` yang menamakan strategi/pembekal/latensi yang menyampaikannya, strategi gabungan `cache-optimized` baharu + faktor laluan `cacheAffinity` Auto-Combo menghalakan permintaan berulang kembali kepada sambungan yang menyimpan awalan dalam cache, dan titik akhir baca sahaja `/v1/auto-combo/{channel}/candidates` mendedahkan kumpulan calon langsung saluran `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)。 - **⚡ Prestasi & infrastruktur setempat** — Redis setempat satu klik, penyebar geganti Cloudflare Workers / Deno Deploy, Bifrost & Mux sebagai perkhidmatan terbenam yang diselia. → [Perkhidmatan Terbenam](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Turut disertakan** — rangka kerja pemalam + pasaran, rangka kerja kemahiran Omni/Agent/GitHub, integrasi peti besi Obsidian (22 alat MCP), API Batch & Files yang serasi dengan OpenAI, cache respons semantik, gamifikasi dengan papan pendahulu, penemuan ejen ACP (15 ejen terbina dalam), pengeksportan log berjadual ke BigQuery, fan-out selari berbilang model `auto/chaos`, jambatan bot Telegram, pengurus versi dalam aplikasi dan kedudukan penyedia percuma LMArena-ELO. → [Dokumentasi](docs/README.md)

## 🤖 CLI & Ejen Pengekodan Serasi > Satu konfigurasi — `http://localhost:20128/v1` — dan **setiap** IDE AI atau CLI berjalan pada model percuma & kos rendah.

_{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

＋ juga berfungsi dengan · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · mana-mana alat serasi OpenAI

_{📖 Persediaan setiap alat untuk semua 39 alat (28 CLI Code + 11 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Plugin OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Lancarkan mana-mana CLI yang disokong melalui OmniRoute dengan satu arahan** — tiada fail konfigurasi ditulis, kelayakan disuntik setiap proses, Qwen/Gemini mendapat direktori rumah terasing sementara: ```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" # Atau pilih penyedia+model secara interaktif dan tulis konfigurasi alat itu sendiri: omniroute configure codex # juga: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` Setiap arahan menghormati konteks jauh aktif (`omniroute connect `), `--dry-run` memaparkan pratonton persekitaran/argumen tepat tanpa melaksanakan, dan `--api-key-env NAME` memastikan rahsia tidak masuk dalam sejarah shell anda. → [Integrasi CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 Penyedia AI — 153 Ditandai sebagai Percuma dalam Katalog

> **388 penyedia berdaftar** merentasi koleksi kanonik chat, media, carian, setempat, ejen awan dan sistem, termasuk **153 yang membawa metadata penemuan `hasFree: true`**. Daftar model chat merangkumi **239 penyedia / 3,059 pasangan penyedia-model berbeza / 1,475 ID model mentah**; katalog bajet percuma yang berasingan mempunyai **471 baris setiap model**, **34 kumpulan berulang** dan **52 penyedia percuma selama-lamanya yang berulang/tanpa kunci**. Ini ialah penyebut yang berbeza mengikut reka bentuk; definisi dan pengiraan yang dinyahgandakan mengikut kumpulan tersedia dalam [Rujukan Penyedia](docs/reference/PROVIDER_REFERENCE.md) dan [Peringkat Percuma](docs/reference/FREE_TIERS.md).

### 🏢 Setiap makmal utama — melalui satu titik akhir

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…dan 350+ lagi — setiap ikon diselesaikan secara langsung daripada katalog penyedia papan pemuka. 📖 [Rujukan Penyedia](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Percuma Selama-lamanya — $0, tanpa kad

OpenCode Zen _{DeepSeek V4, Nemotron 3 Tiada had token}	Kilo Code _{Penghala automatik, Tencent Hy3 Percuma selama-lamanya}	Requesty _{GPT-OSS 120B, Nemotron Percuma selama-lamanya}	SiliconFlow _{DeepSeek V3.2 / R1 Tahap percuma}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Percuma selama-lamanya}	Baidu ERNIE _{ERNIE 4.0 Percuma selama-lamanya}
Qoder AI _{Qwen3-Max, Kimi-K2 PERCUMA tanpa had}	Pollinations _{GPT, Llama, Claude Kunci tidak diperlukan}	Cloudflare AI _{50+ model 10K neuron/hari}	NVIDIA NIM _{GLM, MiniMax ~40 RPM percuma}	Cerebras _{GLM 4.7, GPT-OSS Kredit $5 sekali sahaja; kad diperlukan}	OpenRouter _{Model :free +$10 → RPM lebih tinggi}

📖 Katalog boleh dibaca mesin sepenuhnya → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Where OmniRoute Runs — Di Mana-mana

> Apl yang sama, mesin anda, peraturan anda. Daripada pemasangan npm global kepada** telefon anda** melalui Termux.

Platform	Pasang
📦 npm (global)	`npm pasang -g omniroute`	Satu arahan, sebarang OS
⚡ Bun (global)	`bun tambah -g omniroute`	tarball pendaftaran yang sama, pemasangan lebih pantas
🐳 Docker	`docker run … diegosouzapw/omniroute`	Multi-arch AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:bina`	Tetingkap asli + sistem zqm — Windows / macOS / Linux
🎩 Menu-bar (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Menyelia & auto-kemas kini pelayan — macOS
💪 ARM	asli `arm64`	Raspberry Pi, pelayan ARM, Apple Silicon
📱 Android (Termux)	`pkg pasang nodej && npx -y omniroute`	Menjalankan pada telefon anda , 24/7, tiada akar
📲 PWA	"Tambah pada Skrin Utama"	Skrin penuh, luar talian, boleh dipasang daripada penyemak imbas
🧩 OpenCode plugin	`@omniroute/opencode-provider`	Penyepaduan OpenCode asli
🤖 VS Kod Copilot Sembang	pasang OmniCopilot sambungan	Setiap model OmniRoute dalam Copilot asli Pemilih Sembang — & yang stabil Orang dalam
🛠️ Dari sumber	`npm pasang && npm jalankan dev`	Hack padanya, sumbangkan

[Docker](docs/guides/DOCKER_GUIDE.md)_{📖 zqc · [Desktop](electron/README.md) · [Dulang bar menu](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Baharu: OmniRoute dalam VS Code's native Copilot Chat

> Tiada bar sisi baharu, tiada sembang UI baharu — setiap model yang dihidangkan OmniRoute dipaparkan terus dalam**Copilot Pemilih model Chat yang telah anda gunakan** . Sejak Kod VS 1.122, model pembekal berfungsi tanpa log masuk GitHub atau langganan Copilot — mod ejen, panggilan alat dan penglihatan, secara percuma. Pasangkan** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** sambungan, halakannya pada pelayan OmniRoute anda (lalai kepada `localhost:20128`), kemudian buka Copilot Chat → model picker →** Urus Model…** →**OmniRoute** . < td jajar ="kiri">VS Kod — & stabil Orang dalam < td jajar ="kiri">Cursor, Windsurf, VSCodium Theia pelayan kod, Gitpod, Antigravity, Kiro…

Simpan	Pautan	Berfungsi dengan
🧩 VS Kod Pasaran	Pasang →
🔓 Buka VSX Pendaftaran	→

Dari dalam editor: buka** Sambungan** lihat, cari** "OmniRoute"** , klik** Pasang** — berfungsi dengan cara yang sama di kedua-dua kedai. Sumber, isu dan buku panduan penerbitan secara langsung di [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [VS Kod Copilot Panduan sembang](docs/guides/VSCODE-COPILOT.md) — persediaan, perkara yang ditunjukkan oleh pemilih, papan pemuka dalam tab, penyelesaian masalah}

### 🎩 Baharu: OmniRouteTray — gerbang anda, tinggal dalam bar menu

> `omniroute serve` paling gembira bila sentiasa on.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** mengubahnya menjadi aplikasi set-dan-lupakan menu-bar untuk macOS: ia memulakan pelayan, memastikan ia hidup sepanjang but semula, mengemas kininya pada tempatnya dan meletakkan belanjawan token langsung anda dengan satu klik sahaja —** tiada tingkap terminal dibiarkan terbuka, tiada `npm install -g omniroute` untuk menjaga anak.** Dibina dengan [Tauri v2](https://v2.tauri.app/) (teras Rust sebesar ralat pembulatan), ia menghantar masa jalan Node 24 yang ditandatangani sendiri dan mengurus pemasangan OmniRoute milik apl, jadi ia tidak pernah melawan `node`/`bun` global anda. Ia** berkongsi konfigurasi dan pangkalan data `~/.omniroute/` anda yang sedia ada** — jadi ia adalah OmniRoute yang sama yang telah anda jalankan, hanya dengan memakai topi. 🎩

Apa yang dilakukannya	Bagaimana
🟢 Mengawasi pelayan	Memunculkan `omniroute serve` , menggunakan contoh yang sudah berjalan dan bukannya menduplikasikannya
📊 Penggunaan langsung sepintas lalu	Bar kuota pembekal, had Claude session/weekly dengan kira detik tetapan semula, pecahan kos 30 hari
🔄 Autokemas kini di tempat	Pemasangan berperingkat, pertukaran atom, rollback apabila gagal — sentiasa pada keluaran terbaharu
🚀 Mulakan pada log masuk	Pelancaran pilihan semasa log masuk; dulang sahaja, tiada ikon dok
🩺 Doktor & log	Diagnostik satu klik dan akses log pelayan

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{Lebih suka muat turun? Dapatkan .dmg terkini daripada
Melepaskan . Sumber, isu dan binaan
docs live di zoispag/omniroute-tray.

💛 Projek komuniti oleh @zoispag — bukan keluaran OmniRoute rasmi.}

## 🔒 Peribadi & Mengutamakan Setempat

Peribadi dan mengutamakan setempat — get laluan dan satah kawalan OmniRoute berjalan pada mesin anda. Prom dihantar kepada penyedia huluan yang dipilih bagi setiap permintaan; OmniRoute tidak menambah sebarang perantara pemprosesan prom yang dihoskan dan telemetri dilumpuhkan secara lalai. Bukti kelayakan disulitkan ketika disimpan dengan AES-256-GCM; kawalan termasuk penskopan kunci API, penapisan IP, had kadar, perlindungan daripada suntikan prom, pembersihan pengepala huluan, penyuntingan PII secara pilihan, ralat yang dinyahpekakan dan jejak audit SQLite setempat. OmniRoute dilesenkan di bawah MIT dan boleh dihoskan sendiri.

_{📖 [Keizinan](docs/architecture/AUTHZ_GUIDE.md) · [Perlindungan](docs/security/GUARDRAILS.md) · [Pematuhan](docs/security/COMPLIANCE.md)}

## 🔌 CLI Lengkap + A2A & MCP

> Selain pelayan, OmniRoute ialah **kokpit baris perintah lengkap** dengan **80+ perintah**, serta protokol ejen terbuka supaya ejen AI boleh mengendalikannya **secara kendiri**. ### ⌨️ CLI sebenar (bukan sekadar `start`) ```bash omniroute # sediakan get laluan + papan pemuka (port 20128) omniroute chat # klien sembang TUI interaktif (garis condong: /model /combo /skill /memory) omniroute setup # bestari penggunaan kali pertama berpandu omniroute doctor # diagnosis penyedia, port, kebergantungan natif ``` ### 🛰️ Mod jauh — jalankan CLI di sini, OmniRoute pada VPS OmniRoute berada pada pelayan? Kendalikannya daripada komputer riba anda menggunakan **CLI yang sama**. Log masuk sekali dengan token akses berskop; selepas itu, setiap perintah akan menyasarkan pelayan jauh. ```bash omniroute connect 192.168.0.15 # kata laluan → token berskop, disimpan sebagai konteks omniroute models # ← dijalankan pada pelayan JAUH omniroute configure codex # ← memilih model jauh, menulis profil Codex setempat omniroute tokens create --name ci --scope read # jana token yang lebih terhad untuk mesin lain omniroute contexts use default # ← bertukar kembali kepada pelayan setempat ``` Token mempunyai skop `read` / `write` / `admin`; laluan yang mencetuskan proses kekal terhad kepada gelung balik sahaja. _{📖 [Mod Jauh](docs/guides/REMOTE-MODE.md)}

Terminal animasi yang menunjukkan CLI OmniRoute — omniroute providers list, omniroute combo list dan omniroute health — berputar melalui permukaan peringkat teratas dengan 89 perintah: 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 …

### 🤝 Sambungkan ejen — dan ia mengawal OmniRoute sendiri Dedahkan OmniRoute melalui **MCP**, **A2A**, **REST API**, **webhooks** atau **CLI jauh** — mana-mana ejen yang berkeupayaan (atau kod anda sendiri) memperoleh akses kepada keseluruhan get laluan: penghalaan, penyedia, gabungan, cache, pemampatan, memori — secara autonomi. Titik akhir HTTP di bawah disediakan melalui `http://localhost:20128`.

Antara muka	Titik akhir / perintah	Gunakannya untuk
🧰 MCP (stdio)	`omniroute --mcp`	Sambungkan kepada Claude Desktop, Cursor atau mana-mana klien MCP
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP jauh — 110 alat, 33 skop (penguatkuasaan secara ikut serta), jejak audit penuh
📡 MCP (SSE)	`/api/mcp/sse`	Pengangkutan MCP penstriman
🤝 A2A	`/.well-known/agent.json`	Ejen-ke-ejen, JSON-RPC 2.0 + SSE, 6 kemahiran
🌐 REST API	`/v1/*`	Serasi dengan OpenAI — sembang, pembenaman, imej, audio, OCR
🔔 Webhooks	`/api/webhooks`	Tolak peristiwa permintaan / kuota ke Slack, Discord, Telegram atau mana-mana URL
🛰️ CLI Jauh	`omniroute connect`	Kendalikan tika jauh menggunakan token akses berskop

```bash # Berikan Claude Code set alat OmniRoute lengkap melalui MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [Pelayan MCP](docs/frameworks/MCP-SERVER.md) · [Pelayan A2A](docs/frameworks/A2A-SERVER.md) · [Protokol Ejen](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Jimat 15–95% Token — Secara Automatik

### 📖 Cara ia berfungsi — matematik saluran paip, seni bina & penjimatan

Saluran paip pemampatan OmniRoute: permintaan klien 10,000 token yang bersifat ilustratif melalui 12 enjin boleh gubah — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra dan OmniGlyph — dan boleh sampai kepada penyedia pada kira-kira 1,080 token dalam contoh bertindan yang didokumenkan. Kandungan berstruktur dilindungi oleh pengawal pemeliharaan dan gerbang kesetiaan setiap langkah; mod lossy atau eksperimen yang eksplisit boleh mengubah kandungan yang layak.

Gabungan bertindan lalai menjalankan `RTK → Caveman`. Apabila kedua-duanya bertindak pada muatan alat/konteks yang sama, penjimatan terkumpul: ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` Blok kod, URL, JSON dan data berstruktur **sentiasa dilindungi** oleh enjin pemeliharaan. > **Mengapa menggunakan banyak token apabila sedikit token sudah memadai?** Setiap permintaan melalui saluran paip pemampatan OmniRoute **secara telus** — tanpa perubahan pada klien. Kini ia merupakan **susunan 12 enjin boleh gubah** yang berjalan mengikut turutan dan boleh digabungkan mengikut kombinasi penghalaan — dibina berdasarkan idea daripada [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), dan [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Susunan 12 enjin Enjin berjalan mengikut turutan saluran paip; setiap satunya boleh dihidupkan atau dimatikan dan dikonfigurasikan secara berasingan mengikut kombinasi:

#	Enjin	Fungsinya
1	Session-Dedup	Menggugurkan kandungan yang diulang merentas giliran (beralamat kandungan, merentas giliran)
2	CCR	Mengarkibkan blok besar di sebalik penanda pengambilan, yang diambil apabila diperlukan
3	Lite	Pemangkasan ruang kosong + URL imej (asas dengan kependaman rendah)
4	RTK	Penapisan, deduplikasi & pemangkasan hasil alat secara pintar (sedar arahan)
5	Responses Tool Output	JSON berasaskan lossless + pemampatan diagnostik terhad untuk output shell/tampalan/carian/binaan (Responses API)
6	Headroom	Pemadatan lossless tatasusunan JSON berbentuk jadual (~30%) melalui codec GCF yang dibekalkan bersama
7	Relevance	Pemberian skor ayat ekstraktif berdasarkan pertanyaan pengguna terakhir
8	Caveman	Pemampatan prosa berasaskan peraturan (~65–75% pada output)
9	Aggressive	Peringkasan + penuaan progresif giliran lama
10	LLMLingua-2	Pangkasaan semantik ML melalui MobileBERT ONNX — selamat untuk kod, tak segerak
11	Ultra	Pemangkasan token heuristik dengan peringkat model kecil (SLM) pilihan
12	OmniGlyph	Pengekodan konteks sebagai imej secara eksperimen untuk Claude Fable 5 yang diukur pada talian Anthropic terus; transformer GPT 5.6 kekal fail-closed sementara menunggu resit penyedia. Empat profil pemampatan (lalai agresif, seimbang, selamat untuk pengekodan, laluan terus) (paling agresif; ikut serta)

Blok kod, URL dan data berstruktur **sentiasa dipelihara** dengan ketepatan bait. **Praset satu klik** menggabungkan enjin:

Mod	Penjimatan	Terbaik untuk
🪶 Lite	~15%	Lalai selamat yang sentiasa aktif
🪨 Standard (Caveman)	~30%	Pengekodan harian
⚡ Aggressive	~50%	Sesi panjang yang banyak menggunakan alat
🔥 Ultra	~75%	Penjimatan maksimum
🧰 RTK	60–90%	Output shell/ujian/binaan/git
🔗 Stacked (RTK → Caveman)	78–95%	Gesaan bercampur + log alat

**Contoh sebenar — mod Standard:** > **Sebelum (69 token):** _"Sebab komponen React anda dirender semula berkemungkinan kerana anda mencipta rujukan objek baharu pada setiap kitaran render. Apabila anda menghantar objek sebaris sebagai prop, perbandingan cetek React menganggapnya sebagai objek yang berbeza setiap kali, lalu mencetuskan render semula. Saya mengesyorkan penggunaan useMemo untuk memo objek tersebut."_ > > **Selepas (19 token):** _"Rujukan objek baharu pada setiap render. Prop objek sebaris = rujukan baharu = render semula. Balut dengan useMemo."_ > > **Jawapan yang sama. 72% lebih sedikit token. Tiada kehilangan ketepatan.** ✅ **Contoh PT-BR — mod [Troglodita](https://github.com/leninejunior/troglodita):** > **Sebelum (42 token):** _"Masalahnya ialah komponen sedang dipaparkan semula kerana rujukan objek baharu sedang dicipta pada setiap kitaran pemaparan. Saya mengesyorkan penggunaan useMemo."_ > > **Selepas (12 token):** _"Paparan semula: ref baharu setiap kitaran (objek sebaris dicipta semula). Gunakan `useMemo`."_ > > **Jawapan yang sama. ~70% kurang token. Ketepatan teknikal kekal utuh.** ✅
### 🎚️ Melangkaui enjin — gaya output, dail adaptif & kawalan setiap permintaan 12 enjin di atas mengecilkan perkara yang **masuk**. Tiga lapisan tambahan membentuk **cara**, **masa**, dan perkara yang keluar: - **🪄 Gaya Output** _(pengemudian paksi output)_ — menyuntik arahan pembentukan respons yang deterministik dan selamat cache; boleh digabungkan, setiap satu pada keamatan `lite` / `full` / `ultra`. Menambah gaya hanya memerlukan satu entri pendaftaran: - **Prosa ringkas** — buang pengisi / artikel / kata-kata berwaspada; kekalkan kandungan teknikal dengan tepat. - **Kurangkan kod** — YAGNI "pembangun senior malas": perubahan berfungsi paling kecil, tanpa perancah yang tidak diminta. - **Ikat ekor (pembangun senior malas)** — naikkan tahap YAGNI, baiki punca akar, hasilkan diff berfungsi yang paling kecil. - **Saya menghidap ADHD (utamakan tindakan)** — tindakan seterusnya didahulukan, langkah bernombor, satu langkah seterusnya yang konkrit, tanpa mukadimah. - **CJK ringkas (文言)** — gaya ultra-ringkas Cina klasik (terhad mengikut locale kepada `zh`). - **🎯 Bajet konteks adaptif** _(dail)_ — bukannya satu ambang token hidup/mati, tingkatkan enjin yang paling murah dan paling kurang kehilangan hanya setakat yang diperlukan untuk **memuatkan tetingkap konteks model**. Dasar: `reserve-output` (lalai, sedar-model) · `percentage` · `absolute`. Mod: `floor` (jamin muat) · `replace-autotrigger` (pilihan eksplisit anda diutamakan) · `off` (ambang legasi). - **🎛️ Tempat pemampatan diputuskan** _(keutamaan, tinggi → rendah)_ — pengepala `x-omniroute-compression` setiap permintaan › penggantian routing-combo › profil bernama aktif › pencetus automatik / adaptif › lalai panel › off. Pelan yang digunakan dipantulkan semula dalam pengepala respons `X-OmniRoute-Compression: ; source=`. Cetuskan secara automatik mengikut ambang token, hidupkan dail adaptif, tetapkan profil bernama, tetapkan satu permintaan khusus, atau berikan saluran paip bagi setiap routing combo — mana-mana yang paling sesuai dengan beban kerja. **Harness penilaian** luar talian pilihan (`npm run eval:compression`) menilai kesetiaan berbanding penjimatan pada korpus yang dipinkan sebelum anda mempromosikan perubahan. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ Mula Pantas

**1) Pasang & jalankan** ```bash npm install -g omniroute omniroute ``` > 💡 Nampak `npm warn ERESOLVE` atau amaran peer-dep? [Amaran tersebut tidak berbahaya](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **Menggunakan npm 11 atau lebih baharu?** npm mungkin menyekat skrip kitar hayat pakej melainkan skrip tersebut dibenarkan. `postinstall` OmniRoute (`node scripts/build/postinstall.mjs`) diperlukan untuk menyediakan fail runtime natifnya. Benarkan pakej yang dinamakan dalam amaran npm ketika memasang secara global. Untuk set pakej yang dilaporkan oleh OmniRoute 3.8.54: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > Untuk menggunakan semula senarai benarkan ini bagi pemasangan global akan datang, konfigurasikannya sekali, kemudian pasang seperti biasa: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > Senarai kebergantungan boleh berubah antara keluaran; jika npm melaporkan senarai yang berbeza, gunakan nama pakej daripada amaran tersebut. Membenarkan sesuatu pakej membolehkan skrip pemasangannya dijalankan. > **Menggunakan Gemini Web atau penyedia kuki web yang lain?** Pakej npm menyertakan > Playwright tetapi bukan binari Chromiumnya. Lihat nota > [Persediaan Chromium Playwright](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > sebelum membuat permintaan penyedia web yang pertama. Papan pemuka di `http://localhost:20128` · API di `http://localhost:20128/v1`. **2) Sambungkan penyedia yang layak menggunakan akaun anda sendiri** Papan pemuka → **Providers** → pilih penyedia yang terma dan kuota semasanya sesuai dengan kes penggunaan anda → tambahkan kunci APInya atau lengkapkan aliran akaunnya. Tahap percuma mungkin memerlukan pendaftaran, kelulusan atau kaedah pembayaran. Semak [Panduan Tahap Percuma](docs/getting-started/FREE-TIERS-GUIDE.md); ketersediaan tanpa kunci tidak dijamin, dan penyedia yang ditandakan `tos: avoid` dikecualikan daripada `auto` secara lalai. **3) Halakan alat pengekodan anda** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) Sahkan ia berfungsi** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Anda sepatutnya melihat model yang disambungkan disenaraikan. 🎉 Itu sahaja — mula mengekod, dan OmniRoute akan menghalakan serta bertukar ganti secara automatik untuk anda. Jika klien anda tidak dapat menghantar pengepala tersuai, OmniRoute turut menyediakan alias keserasian bertoken: ```txt 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 ``` Gunakan ini hanya untuk klien yang tidak dapat melampirkan `Authorization: Bearer ...`. Pengesahan pengepala kekal sebagai mod pilihan.
## 📦 Lebih banyak kaedah pemasangan — Docker, sumber, 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` mengikuti versi stabil SemVer **yang diterbitkan** tertinggi. Ia tidak menjejaki `main` git. Tetapkan `:X.Y.Z` untuk GitOps. Lihat [Saluran Keluaran Docker](docs/guides/DOCKER_GUIDE.md#release-channels). Imej tersebut menetapkan **`OMNIROUTE_MEMORY_MB=1024`**. Itu mencukupi untuk papan pemuka dan sembang ringan. **Ejen pengekodan** (`POST /v1/responses` daripada Claude Code, Codex, Grok, …) memerlukan heap V8 yang jauh lebih besar atau proses akan mengalami `FATAL ERROR` pada sekitar 12 GiB apabila dua konteks panjang bertindih. Saizkan bekas melebihi heap (penimbal natif berada di luar V8): | Beban kerja | Heap (`-e OMNIROUTE_MEMORY_MB`) | Bekas (`--memory`) | | ------------------------------------ | ------------------------------- | ------------------ | | Papan pemuka / sembang ringan | `1024` (lalai imej) | ≥2 g | | Satu ejen pengekodan | `8192` | ≥10 g | | Dua `/v1/responses` panjang serentak | `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 ``` Jadual penuh: [Panduan Docker — RAM masa jalan](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Saluran Docker prakeluaran:** `diegosouzapw/omniroute:next` dan > `diegosouzapw/omniroute:next-web` mengikuti cabang `release/v*` lalai semasa. > Tag boleh ubah ini hanya bertujuan untuk menguji pembaikan yang belum dikeluarkan dan > **tidak disokong untuk penggunaan produksi**. Lihat > [Saluran Keluaran Docker](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** `bun install` standard dan pemasangan global (`bun install -g omniroute`) disokong melalui pengesanan masa jalan Bun: - **`bun:sqlite` terbina dalam**: OmniRoute menggunakan pemacu `bun:sqlite` terbina dalam Bun apabila dijalankan di bawah Bun, dengan kembali menggunakan `better-sqlite3` pada Node.js atau `sql.js`. - **Pemilihan pembundel Webpack secara automatik dalam pembangunan**: Pembangunan (`bun run dev`) mengesan Bun secara automatik dan menyahdayakan Turbopack untuk menggunakan Webpack bagi mengelakkan ketidakserasian pengikatan V8 natif. Binaan produksi (`bun run build`) mengikuti `OMNIROUTE_USE_TURBOPACK` sama seperti pada Node: Turbopack secara lalai, `OMNIROUTE_USE_TURBOPACK=0` untuk membina dengan Webpack (`Dockerfile.bun` menyediakannya sebagai `--build-arg`). - **Dockerfile Bun khusus**: `Dockerfile.bun` berbilang peringkat untuk pelaksanaan produksi Bun natif (`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Pasang dan jalankan dengan Bun bun install bun run dev ``` **🛠️ Daripada sumber** ```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 # Menggunakan Nix flakes nix develop npm run dev # Atau menggunakan devbox devbox run npm run dev ``` 📖 [Panduan Docker](docs/guides/DOCKER_GUIDE.md) — Profil Compose, HTTPS Caddy, terowong Cloudflare. **🦭 Podman** ```bash # 1. Sediakan direktori data yang dilekapkan melalui bind mkdir -p data # 2. Linux + Podman rootless tempatan sahaja (jangan sekali-kali gunakan klien Podman Machine jauh): podman unshare chown 1000:1000 ./data # 3. Tetapkan petunjuk masa jalan, bina imej Compose tempatan dan mulakan echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` Pada macOS atau Windows, Podman menggunakan Podman Machine jauh: langkau `podman unshare` dan ikuti [panduan direktori data khusus topologi](contrib/podman/README.md#data-directory-permissions-by-topology). 📖 [Panduan Podman](contrib/podman/README.md) — Binaan Compose, Podman Machine dan persediaan Quadlet Linux/systemd. **⚡ Pemasangan lebih pantas / ringan (langkau binaan natif)** Enjin SQLite natif (`better-sqlite3`) ialah kebergantungan **pilihan**, jadi pemasangan global tidak akan tersekat kerana pengkompilan daripada sumber: ia menggunakan binari prabina apabila tersedia yang sepadan dengan platform/Node anda, dan jika tidak, akan beralih secara telus kepada enjin JavaScript tulen (`node:sqlite` pada Node 22+, jika tidak, WASM `sql.js` yang disertakan) — tiada alat binaan diperlukan. Untuk melangkau sepenuhnya pemanasan natif selepas pemasangan (CI, tanpa paparan atau mesin perlahan): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 turut melangkaunya ``` Untuk pemasangan terpantas, utamakan **pnpm** (storan beralamat kandungan + pautan keras — lihat di atas). Untuk masa jalan tanpa papan pemuka dan tanpa paparan, gunakan profil Docker `base` (di atas) atau [Panduan Termux](docs/guides/TERMUX_GUIDE.md). CLI dan papan pemuka web disediakan oleh proses yang sama pada satu port, jadi buat masa ini tiada pakej CLI sahaja yang berasingan.

# 🎬 OmniRoute Sedang Beraksi

## 📹 Panduan Video

_{Petikan panel pada 2026-10-18 · Katalog mentah: YT 1.352 | TT 334 | IG 290 · Kesegaran (hari): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 tontonan}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 tontonan}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 tontonan}

🎬 #4 — Instagram
_{theopenstack — 692,419 tontonan}

🎬 #5 — TikTok
_{migue.baena — 685,788 tontonan}

**Kedudukan penuh (URL kanonik dinyahduplikasi, `v > 0`, capaian tertinggi):** | #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** | Metrik kanonik pada 2026-10-18: **1.976 video unik** · **20.220.289 tontonan yang diketahui** (`v > 0`) · **1.210 saluran/profil mengikut rangkaian**. Panel mentah mengandungi 1.976 baris (YouTube 1.352 = 740 video panjang + 612 Shorts · TikTok 334 · Instagram 290); tiada pendua yang tinggal selepas penormalan berdasarkan URL kanonik, yang mengekalkan jumlah tertinggi bagi setiap video. Pengumpulan data YouTube dibekukan pada 2026-10-13 (kuota API habis dari 14 hingga 18/10), manakala TikTok/Instagram sejak 2026-09-02 (tiada kredit pengumpulan data); 76 video masih belum mempunyai jumlah tontonan. > 🎬 **Menghasilkan video tentang OmniRoute?** Buka [isu](https://github.com/diegosouzapw/OmniRoute/issues/new) atau [perbincangan](https://github.com/diegosouzapw/OmniRoute/discussions) dengan pautan tersebut — kami akan menampilkannya di sini.

# 📧 Komuniti & Bantuan > Semuanya di satu tempat — ikuti penyelenggara, berbual dengan komuniti, atau buka isu. | Saluran | Di mana / cara | | -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — ikuti penyelenggara | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — ikuti untuk keluaran & petua | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Global** | [sertai kumpulan](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Brazil** | [sertai kumpulan](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Laman web** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍Komuniti StHub OmniRoute (percuma)** | [portal StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Kod sumber** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Laporkan pepijat** | [buka isu](https://github.com/diegosouzapw/OmniRoute/issues) — lampirkan output `npm run system-info` | | 🤝 **Sumbang** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Model Percabangan & Keluaran](docs/ops/BRANCHING_MODEL.md) · pilih `good first issue` | | 💚 **Sokong projek ini** | [Cara untuk menyokong ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ Tindanan Teknologi

Lapisan	Teknologi
Masa jalan	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Bahasa	TypeScript 6.0 — 100% TypeScript merentasi `src/` dan `open-sse/` (sifar `any` dalam teras sejak v2.0)
Rangka kerja	Next.js 16 + React 19 + Tailwind CSS 4
Pangkalan data	better-sqlite3 (SQLite, pengjurnalan WAL) + LowDB (JSON legasi) — 147 modul domain, 233 migrasi
Memori	Teks penuh SQLite FTS5 + pembenaman vektor terkuantum int8, pereputan bertip
Skema	Zod 4 — pengesahan I/O alat MCP + kontrak API
Protokol	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Penstriman	Acara Dihantar Pelayan (SSE) + jambatan WebSocket (`/v1/ws`)
Pemampatan	Saluran paip 12 enjin — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Pengesahan & keselamatan	OAuth 2.0 (PKCE) + JWT + Kunci API + pengesahan terskop MCP · AES-256-GCM semasa rehat · DOMPurify
Siluman	wreq-js — penyamaran cap jari TLS JA3 / JA4, proksi 3 tahap
Ketahanan	Pemutus litar, undur eksponen, pencegahan kumpulan yang menyerbu serentak, pemulihan kendiri auto-combo
Pembalakan	pino — log JSON berstruktur dengan konteks permintaan
Pengujian	Pelaksana ujian Node.js + Vitest — 60,000+ pengisytiharan ujian statik merentasi 8,400+ fail ujian dijejaki (unit, integrasi, E2E, keselamatan, ekosistem)
Platform	Desktop (Electron) · Android (Termux) · PWA (mana-mana pelayar)
CI/CD	GitHub Actions — penerbitan npm automatik + Docker Hub semasa keluaran
Pautan	Laman web · npm · Docker Hub

## 📖 Dokumentasi

### 📘 Bermula

Dokumen	Penerangan
Panduan Pengguna	Penyedia, gabungan, integrasi CLI, penggunaan
Panduan Persediaan	Kaedah pemasangan lengkap, konfigurasi alat CLI, persediaan protokol, pelarasan tamat masa
Panduan Alat CLI	Persediaan mengikut alat untuk Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Mod Jauh	Kawal OmniRoute jauh (VPS) daripada CLI komputer riba anda melalui token akses berskop
Konfigurasi Claude Code	Arahkan Claude Code ke OmniRoute (tempatan/jauh) dengan `launch` + profil mengikut model
Mula Pantas	Pemasangan 3 langkah → sambung → konfigurasi

### 🔧 Operasi & Penggunaan

Dokumen	Penerangan
Panduan Docker	Menjalankan Docker, profil Compose, HTTPS Caddy, terowong, tag imej
Panduan Podman	Integrasi systemd Quadlet, podman-compose, SELinux
Penggunaan VM	Panduan lengkap: persediaan VM + nginx + Cloudflare
Penggunaan Fly.io	Gunakan pada Fly.io dengan storan berterusan
Panduan Termux	Jalankan OmniRoute pada Android melalui Termux
Panduan PWA	Pemasangan, pencachean dan seni bina Progressive Web App
Panduan Nyahpasang	Pembuangan bersih untuk semua kaedah pemasangan
Konfigurasi Persekitaran	Pemboleh ubah dan rujukan `.env` lengkap

### 🧠 Ciri & Seni Bina

Dokumen	Penerangan
Seni Bina	Seni bina sistem, aliran data dan dalaman
Panduan Pemampatan	Saluran paip 7 pilihan: off / lite / standard / aggressive / ultra / RTK / stacked
Pemampatan RTK	Pemampatan output perintah, penapis, kepercayaan, pengesahan, pemulihan output mentah
Enjin Pemampatan	Saluran paip Caveman, RTK dan stacked, permukaan papan pemuka/API/MCP
Format Peraturan Pemampatan	Skema pek peraturan JSON untuk penapis Caveman dan RTK
Pek Bahasa Pemampatan	Pengesanan bahasa dan penghasilan pek peraturan Caveman
Panduan Ketahanan	Pemutus litar, tempoh bertenang, baris gilir, pencegahan kumpulan permintaan serentak, penyamaran TLS
Enjin Auto-Combo	Pemarkahan 16 faktor, pek mod, pemulihan kendiri
Panduan Proksi	Sistem proksi 3 peringkat, pasaran 1proxy, CRUD pendaftaran
Peringkat Percuma	Direktori disatukan: 34 himpunan berulang yang didokumenkan / 465 entri peringkat percuma yang dikatalogkan
Galeri Ciri	Lawatan papan pemuka visual dengan tangkapan skrin
Dokumentasi Pangkalan Kod	Penjelasan menyeluruh pangkalan kod untuk pemula

### 🤖 Protokol & API

Dokumen	Penerangan
Rujukan API	Semua titik akhir dengan contoh
Spesifikasi OpenAPI	Spesifikasi OpenAPI 3.0
Pelayan MCP	110 alat MCP, konfigurasi IDE, klien Python/TS/Go
Panduan Pelayan MCP	Pemasangan MCP, pengangkutan dan rujukan alat
Pelayan A2A	Protokol JSON-RPC 2.0, kemahiran, penstriman, pengurusan tugas
Panduan Pelayan A2A	Kad ejen A2A, tugas, kemahiran dan penstriman

### 📋 Projek & Kualiti

Dokumen	Penerangan
Menyumbang	Persediaan dan garis panduan pembangunan
Model Percabangan & Keluaran	Tempat PR disasarkan (`release/*`), maksud `main` dan tag
Log Perubahan	Sejarah keluaran penuh mengikut versi
Dasar Keselamatan	Pelaporan kerentanan dan amalan keselamatan
Panduan i18n	Sokongan 67 bahasa, aliran kerja terjemahan, RTL
Senarai Semak Keluaran	Langkah pengesahan sebelum keluaran
Pelan Liputan	Strategi liputan ujian untuk lebih 60,000 pengisytiharan ujian statik merentas lebih 8,400 fail ujian yang dijejaki

# ⭐ Penyumbang Utama > OmniRoute dibentuk oleh komuniti sumber terbuka yang bersemangat. Individu-individu ini telah memberikan sumbangan luar biasa yang memberi kesan langsung kepada kualiti, kestabilan dan capaian projek. **Terima kasih.** ### Penyumbang luaran mengikut pull request yang digabungkan

Kedudukan	Penyumbang	PR yang Digabungkan	~Baris Diubah
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

_{Banci diambil pada 2026-11-03 03:01:19 UTC dengan tip langsung release/v3.8.53 05bc048d6c. Banci GitHub GraphQL berhalaman mengandungi 9,947 PR yang digabungkan: 4,130 oleh pemilik repositori, 240 oleh Dependabot, 6 oleh bot/aplikasi lain dan 5,571 PR luaran daripada 883 penyumbang berbeza. “Baris diubah” ialah penambahan + pemadaman GitHub dan merangkumi fail yang dijana, lockfile, katalog, terjemahan serta dokumentasi; ia mengukur churn, bukan LOC yang ditulis. 53 PR melaporkan diff GitHub melebihi 500,000 baris (contohnya #13399, satu penambahan provider, menyenaraikan 2,347 fail yang diubah), yang meningkatkan beberapa jumlah di atas. Kedudukan seri dikongsi bersama.} ### Komit yang dikaitkan dengan GitHub

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

_{Disemak semula pada 2026-11-03 02:09:16 UTC: Komit yang dikaitkan dengan GitHub seperti yang dilaporkan oleh Contributors API repositori untuk cawangan lalai release/v3.8.53. API tersebut mengembalikan 903 identiti (429 pengguna, 2 bot, 472 tanpa nama); jadual ini mengecualikan penyelenggara, bot dan identiti tanpa nama, serta mengekalkan kedudukan seri dalam pertandingan. Jadual ini berbeza daripada kedua-dua kedudukan PR yang digabungkan di atas dan bancian metadata Git di bawah.} > 🙏 Ciri, pembaikan pepijat dan penambahbaikan infrastruktur daripada penyumbang ini ialah **bahagian teras** yang menjadikan OmniRoute boleh dipercayai dan kaya dengan ciri. Setiap permintaan tarik, setiap kes ujian dan setiap fail terjemahan i18n adalah penting. Sumber terbuka dibina oleh orang seperti mereka.

---
## 💖 Penaja

Setinggi-tinggi penghargaan kepada mereka yang membiayai OmniRoute daripada poket sendiri — setiap sumbangan memastikan projek ini kekal percuma, bebas dan terus berkembang.

Andrew _{💛 Penaja bulanan aktif}	Vlad I _{💛 Penaja bulanan aktif}	小妍儿 _{💛 Penaja bulanan aktif}	Guilherme Costa _{💛 Penaja sekali bayar aktif}	Henrique Iurkiv _{💛 Penaja sekali bayar aktif}	Somesh Ghaturle _{💛 Penaja sekali bayar aktif}
Kolonie AI _{💛 Penyokong sekali bayar terdahulu}	Prof. Igor Morais _{💛 Penyokong sekali bayar terdahulu}	Pixma _{💛 Penyokong sekali bayar terdahulu}	Paco Cartones _{💛 Penyokong sekali bayar terdahulu}	longtao _{💛 Penyokong sekali bayar terdahulu}

_{… dan mereka yang lain yang memilih untuk kekal tanpa nama 💛} _{Penaja GitHub awam disahkan semula pada 2026-10-18 melalui API GraphQL GitHub Sponsors: 11 tajaan awam (6 aktif, 5 terdahulu) daripada jumlah keseluruhan 14. Status isActive GitHub menentukan label aktif di atas; penyokong sekali bayar awam terdahulu terus diberikan penghargaan, manakala penaja persendirian kekal tanpa nama. Sumbangan melalui Ko-fi, Buy Me a Coffee, Liberapay, PIX dan mata wang kripto tidak disenaraikan kerana tiada rekod penaja awam.} 💖 Jadi penaja → — setiap dolar memastikan OmniRoute kekal percuma dan bebas.

## 👥 1,000+ Penyumbang

[![Penyumbang](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Diaudit pada 2026-11-02 di hujung release/v3.8.53 langsung 1c7135e0fb (7,972 commit): 1,074 identiti Git manusia yang dinormalkan — 759 muncul sebagai pengarang commit (termasuk penyelenggara) dan 315 hanya dalam trailer Co-authored-by yang eksplisit. Banci ini menggunakan .mailmap, membandingkan alamat e-mel tanpa mengambil kira huruf besar atau kecil, menggabungkan alamat GitHub noreply berangka dan biasa hanya apabila alamat tersebut mengekod pemegang yang sama, mengecualikan 29 identiti bot/ejen/perkhidmatan/pemegang tempat, dan tidak menggabungkan alamat e-mel biasa semata-mata kerana nama paparannya sepadan. Audit pada 2026-08-24 menerbitkan 639; kaedah ini yang dijalankan semula pada asas audit tersebut ac02c5b42f memberikan 619, jadi peningkatan itu datang daripada penyumbang baharu, bukannya daripada kaedah yang lebih longgar.} ### Cara Menyumbang 1. Fork repositori 2. Buat cabang daripada hujung `release/vX.Y.Z` **aktif** (bukan `main`) — lihat [Model Percabangan & Keluaran](docs/ops/BRANCHING_MODEL.md) 3. Cipta cabang ciri anda (`git checkout -b feat/amazing-feature`) 4. Commit perubahan anda (`git commit -m 'feat: add amazing feature'`) 5. Tolak ke cabang tersebut (`git push origin feat/amazing-feature`) 6. Buka Permintaan Tarik dengan **base = cabang `release/vX.Y.Z` tersebut** Lihat [CONTRIBUTING.md](CONTRIBUTING.md) untuk panduan terperinci. ### Mengeluarkan Versi Baharu ```bash # Cipta keluaran — npm publish berlaku secara automatik VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Bintang

## 🌍 StarMapper

## 🙏 Penghargaan

OmniRoute berdiri di atas bahu gergasi. Ia bermula sebagai fork daripada **[9router](https://github.com/decolua/9router)** dan port TypeScript bagi projek Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — dan sejak itu, setiap subsistem di bawah mendapat ilham daripada projek sumber terbuka yang telah mendahuluinya. Setiap satunya membentuk bahagian konkrit OmniRoute. Inilah ucapan terima kasih kami kepada semua projek tersebut. 🙏 > ⭐ bilangan bintang disahkan daripada GitHub REST API pada 3 November 2026 — berikan bintang kepada projek-projek ini. Bilangan tersebut ialah gambaran tepat pada tarikh berkenaan dan sememangnya akan berubah. ### 🧬 Asal-usul & gerbang

Projek	⭐	Bagaimana ia memberi ilham kepada OmniRoute
9router	31,861	Projek asal yang menjadi asas fork ini — diperluas di sini dengan API multimodal dan penulisan semula TypeScript sepenuhnya.
CLIProxyAPI	57,329	Pelaksanaan Go yang memberi ilham kepada port JavaScript / TypeScript ini.
LiteLLM	62,580	Gerbang AI yang set data harga awamnya membekalkan penyegerakan penjejakan kos kami dan model penormalan penyedianya mempengaruhi penghalaan kami.
codex-chatgpt-web	15,435	Sumber MIT yang diadaptasi ke dalam jambatan ChatGPT Web → Codex Responses vendored, termasuk penyesuai sesi pelayar, pembingkaian respons, penggunaan dan carian web.
free-claude-code	65,966	Corak yang dipindahkan ke dalam pemulihan strim, alias tanpa pemikiran, carian web sandaran, had tetingkap gelongsor, penyamaran log dan aliran pelancar yang diperkukuh.
composer-api	347	Corak pemilihan alat Cursor Composer, kekangan output dan komit alat yang diadaptasi ke dalam pelaksana Cursor natif.
codex-multi-auth	561	Corak log masuk baharu dan penggiliran token penyegaran yang dipindahkan ke dalam pengesahan semula OAuth Codex.
opencode-anthropic-auth	562	Lalai transform yang serasi dengan Claude Code dan tingkah laku pengepala pengebilan yang digeneralisasikan ke dalam jambatan dipacu konfigurasi OmniRoute.
grok2api-merged	2	Pemetaan model Grok, penjana Statsig fake-TypeError, lalai permintaan dan peranti, serta pemproses respons NDJSON telah diadaptasi secara ketara ke dalam pelaksana Grok Web OmniRoute.
TQZHR/grok2api	707	Sumber kod transitif utama di sebalik grok2api-merged; pelaksanaan model, pengepala, muatan, Statsig dan pemprosesnya dikekalkan dalam susur galur Grok Web.
chenyme/grok2api	7,874	Sumber MIT asas untuk lalai muatan dan peranti Grok, penjana Statsig, serta pemproses `result.response` yang diteruskan melalui TQZHR dan grok2api-merged.
grok2api-pro	27	Sumber transitif yang dikreditkan oleh grok2api-merged untuk lapisan kumpulan proksi; OmniRoute mengekalkan notis susur galur tersebut tetapi tidak mendakwa pemindahan kumpulan proksi dalam pelaksana Grok Webnya yang berhad.
GrokProxy	52	Proksi Grok yang disahkan melalui kuki dan corak penstriman `result.response.token`nya memberi ilham kepada pengangkutan Grok Web OmniRoute.
GrokBridge	5	Pelaksanaan Grok Web asalnya dirujuk untuk reka bentuk hulu HTTP/pelayarnya; laluan HTTP langsungnya berasal daripada GrokProxy, jadi tiada pemindahan kod bebas didakwa.

### 🗜️ Pemampatan konteks & token — enjin

Projek	⭐	Cara ia mengilhamkan OmniRoute
Caveman	116,957	Projek tular "mengapa gunakan banyak token jika beberapa token sudah memadai" — falsafah pertuturan caveman ini menggerakkan mod pemampatan standard kami serta lebih 30 peraturan pengisi/pemadatan.
RTK – Rust Token Killer	85,350	Pemampatan output arahan berprestasi tinggi — mengilhamkan enjin RTK, DSL penapis JSON, pemulihan output mentah dan saluran paip bertindan RTK → Caveman kami.
headroom	78,672	Pemampatan konteks boleh balik (SmartCrusher) — mengilhamkan enjin `headroom` kami dan corak penanda pengambilan semula `ccr`.
LLMLingua	6,797	Penyelidikan pemampatan prompt (LLMLingua / LLMLingua-2) — mengilhamkan enjin `llmlingua` kami yang tak segerak, selamat untuk kod dan terbuka apabila gagal.
llmlingua-2-js	33	Port JS/ONNX (MobileBERT / XLM-RoBERTa) yang digunakan sebagai backend worker-thread untuk enjin LLMLingua kami.
Troglodita	50	Pemampatan token PT-BR — menggerakkan pek bahasa pt-BR kami: pengurangan pleonasme dan penyingkiran pengisi yang ditala untuk tatabahasa Portugis-Brazil.
ponytail	182,929	Kemahiran pengekodan YAGNI "pembangun kanan yang malas" yang tular — mengilhamkan Gaya Output less-code kami: pengarahan perubahan berfungsi paling kecil yang mengurangkan kod _dijana_ (saudara paksi output kepada prosa ringkas Caveman).
i-have-adhd	59,838	Gaya responsnya yang mengutamakan tindakan dan mesra ADHD disesuaikan menjadi gaya output ringkas OmniRoute merentas lima bahasa.

### 🧩 Format padat, penyelidikan token & perkakasan peka kod

Projek	⭐	Cara ia mengilhamkan OmniRoute
TOON	25,602	Token-Oriented Object Notation — model berkolum, pengepala-dan-barisnya membentuk peringkat pemadatan jadual kami.
GCF – Graph Compact Format	61	Format graf padat dan reka bentuk profil generiknya memaklumkan pemadatan jadual serta format codec Headroom OmniRoute.
gcf-typescript	4	Pelaksanaan TypeScript berlesen MIT yang dibekalkan terus dan diperluas sebagai codec profil-generik Headroom.
token-optimizer-mcp	566	Cache Brotli/SQLite + delta konteks bagi setiap sesi — mengilhamkan enjin `session-dedup` kami.
token-savior	1,203	Pemadatan output Bash + profil MCP — mengilhamkan disiplin pembatalan pemampatan kami dan pengurangan manifes alat MCP.
token-saver	162	Pemampatan output peka kandungan mengikut jenis fail dengan pembatalan yang peka kegagalan — mengesahkan penghantaran mengikut jenis dan langkauan keuntungan minimum kami.
token-optimizer	2,853	"Cari token hantu" — corak pemindahan + pemegang boleh pulihnya memaklumkan pemikiran pemindahan CCR kami.
TokenMizer	34	Rangka tindakan graf sesi + deduplikasi baris merentas giliran yang memaklumkan reka bentuk session-dedup kami.
OmniCompress	3	JSON berkolum Rust + pengambilan semula beralamat kandungan + deduplikasi merentas mesej — mengesahkan reka bentuk enjin `headroom`/`ccr`/`session-dedup` kami serta invarian "bentuk termampat tidak bergantung pada kedudukan" yang stabil untuk cache.
mcp-compressor	140	Pemampatan skema/deskripsi alat MCP — memaklumkan pengurangan kardinaliti manifes alat MCP kami.
RepoMapper	218	Pemeringkatan peta repositori gaya Aider — memaklumkan penerokaan peta repositori / pemeringkatan pengambilan semula kami.
quiet-shell-mcp	4	Pengurangan output shell deklaratif melalui MCP — mengesahkan pemadatan output bash deklaratif kami.
ts-morph	6,222	Kit alat TypeScript Compiler API — mengilhamkan penyingkiran komen berasaskan penghurai kami yang mengekalkan literal rentetan, templat dan ungkapan nalar.

### 🧠 Memori & RAG

Projek	⭐	Cara ia memberi inspirasi kepada OmniRoute
Mem0	68,294	Lapisan memori universal — model proksi sebagai sempadan tulis/baca membentuk seni bina memori kami.
Letta (MemGPT)	25,321	Ejen berkeadaan dengan memori bertingkat — memberi inspirasi kepada model bertingkat Context Control & Recovery (CCR) kami.
WFGY	1,804	Taksonomi ProblemMap bagi 16 mod kegagalan RAG/LLM yang berulang — kosa kata bersama dalam panduan penyelesaian masalah kami.

### 🛰️ Pemeriksaan trafik, MITM & proksi telus

Projek	⭐	Cara ia memberi inspirasi kepada OmniRoute
llm-interceptor	81	Pemintasan/analisis MITM trafik pembantu pengekodan ↔ LLM memaklumkan keperluan awal Traffic Inspector. Empat modul yang sebelum ini diperoleh — penggabungan SSE, penormalan perbualan, penyamaran rahsia dan sanitasi pengepala — telah digantikan dengan pelaksanaan bebas dan clean-room berdasarkan piawaian protokol awam. Dua permukaan host-passthrough (`passthrough.ts` dan `_internal/bypass.cjs`) kekal sebagai pelaksanaan dalaman OmniRoute yang diklasifikasikan secara berasingan; ia tidak ditulis semula sebagai sebahagian daripada penggantian tersebut.
ProxyBridge	6,978	Penghalaan proksi telus bagi setiap proses — memberi inspirasi kepada penamatan MITM yang selamat daripada ranap, tamat masa melahu soket, atribusi proses `/proc` dan tangkapan TPROXY kami.

### 📚 Data model, kebolehlihatan & UI

Projek	⭐	Cara ia memberi inspirasi kepada OmniRoute
models.dev	7,486	Pangkalan data terbuka spesifikasi, harga dan keupayaan model AI — disegerakkan secara natif ke dalam katalog model kami.
React Flow / xyflow	38,874	Pustaka graf berasaskan nod yang memperkasakan Compression Studio dan Combo/Routing Studio masa nyata kami.
LangGraph	44,349	Visualisasi graf aliran kerja langsung LangGraph Studio memberi inspirasi kepada paparan lata masa nyata Studios kami.
Langfuse	36,907	Model kebolehlihatan trace → span → generation membentuk paparan waterfall Compression Studio kami.
Kiali	3,647	Kebolehlihatan service mesh Istio — memberi inspirasi kepada lencana pemutus litar dan visual tepi ralat kami dalam Routing/Combo Studio.
lobe-icons	2,666	Logo jenama AI/LLM yang memaparkan ikon penyedia merentasi papan pemuka kami.
flag-icons	12,499	Menyediakan bendera SVG berlesen MIT yang digunakan oleh pemilih bahasa README.

### 🛡️ Keselamatan

Projek	⭐	Cara ia memberi inspirasi kepada OmniRoute
awesome-secure-defaults	723	Senarai tersusun pustaka dengan tetapan lalai selamat yang membimbing pilihan keselamatan kami (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Alat pelengkap

Projek	⭐	Cara ia memberi inspirasi kepada OmniRoute
ClawRouter	6,649	Memberi inspirasi kepada deduplikasi permintaan, sandaran kecemasan tanpa kos, strategi Auto-Combo boleh pasang dan pengelasan niat berbilang bahasa.
Antigravity-Manager	32,785	Pemetaan semula model yang menyedari akaun, pengesahan laluan boleh laku dan tingkah laku label pelan memaklumkan runtime Antigravity OmniRoute.
vscode-antigravity-cockpit	4,852	Format kira detik tetapan semula kuota yang padat memberi inspirasi kepada paparan had penyedia yang sepadan dalam OmniRoute.
AionUi	33,996	Integrasi ACP-nya memberi inspirasi kepada pengesanan automatik ejen CLI yang dipasang oleh OmniRoute.
CodexBar	22,955	Mengenal pasti permukaan kuota Grok Build; OmniRoute kemudiannya mengesahkan dan membetulkan format wire langsung secara bebas.

## 📄 Lesen Lesen MIT - lihat [LESEN](LESEN) untuk butiran. ---

**[⬆ Kembali ke atas](#-omniroute)** · Dibina dengan ❤️ untuk komuniti AI sumber terbuka. _{Dicipta oleh Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Lesen MIT · omniroute.online}