## 💰 ~1.62B טוקנים / חודש על פני שכבות חינמיות של צדדים שלישיים
> **הביאו את חשבונות הספקים שלכם.** זהו אומדן מצטבר על פני שכבות חינמיות נפרדות של צדדים שלישיים, ולא הקצאת טוקנים מטעם OmniRoute. הירשמו, השיגו פרטי גישה היכן שנדרש, וחברו את הספקים שבהם אתם יכולים להשתמש; כל ספק קובע את המגבלות, הזמינות והתנאים שלו.
>
> ערימה ידנית של שכבות חינמיות היא כאב ראש — עשרות SDK‑ים, עשרות מגבלות קצב, ובלי מושג כמה באמת יש לכם. OmniRoute מקטלג **467 רשומות של שכבות חינמיות על פני 34 מפתחות מאגר חוזרים** ומחשב את כותרת הטוקנים מ‑**17 מאגרים עם תקציב חודשי חיובי מפורסם ועוד חמש תקרות Groq לכל מודל**, עם הסרת כפילויות לפי מאגר משותף. מכסות שנפתחות רק לאחר בדיקת זהות אזורית (נכון היום: ModelScope) מוצגות בנפרד, +~6M מאחורי אימות זהות אזורי, ולעולם אינן נכללות בסכום הכותרת. התוצאה נשארת גלויה בלוח הבקרה (`/dashboard/free-tiers`).
> סיכום מונפש של העמוד החי `/dashboard/free-tiers`. מתודולוגיה מלאה (הסרת כפילויות מאגרים, מדרגות קרדיט, תנאי ספקים): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> הנתונים האלה נבדקים מחדש כל שבועיים מול הקטלוג החי ו**נעים לשני הכיוונים** — ספק מסיים שכבה חינמית והמספר יורד; ספק חדש נכנס והוא עולה. אנו מפרסמים את מה שהקטלוג באמת מחשב, ולעולם לא מקרה מיטבי מעוגל כלפי מעלה.
⭐ תנו כוכב לריפו אם OMNIROUTE עזר לכם לחסוך כסף ולהקל על העבודה.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 הצטרפו לקהילה
**👋 עקבו אחרי המתחזק — קבלו ספקים חדשים, גרסאות וטיפים ראשונים:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**שאלות, טיפים לספקים, מפת דרכים ותמיכה → [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)**
## 📈 השער ממשיך לגדול
## 🆓 התקנה, חיבור ספק, ואז ניתוב דרך נקודת קצה אחת
```bash
# לאחר חיבור ספק, העתק את מפתח ה-OmniRoute שלך מ-Dashboard → Endpoints:
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` זקוק למסלול זכאי. התקנה חדשה עשויה שלא לכלול יעדים ללא מפתח זכאים, וספק ללא מפתח עשוי לדחות לקוחות צד שלישי. ספקים המסומנים `tos: avoid`, כולל Kiro, מוחרגים מניתוב אוטומטי כברירת מחדל; חיבור חשבון אינו עוקף הגדרה זו. עיין ב[מדריך המסלולים החינמיים](docs/getting-started/FREE-TIERS-GUIDE.md) לפני בחירת ספק.📦 סקריפטים מוכנים להעתקה-הדבקה להתחלה מהירה עבור **Python, Node.js, PHP ו-cURL** → [`examples/quickstart/`](examples/quickstart/)
# 💥 ההבטחה
# 🤔 למה OmniRoute?
## 🤝 נתמך על ידי חברי הקוד הפתוח שלנו
> **רוצה להצטרף כחבר קוד פתוח?** אלו החברות שתומכות בקוד פתוח ועוזרות לשמור על OmniRoute בתנועה – ואנחנו מפרסמים בגלוי לאן הולך כל אסימון שהן נותנות לנו. צור קשר: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
תודה ל-Kimi (Moonshot AI), חברת הקוד הפתוח המייסדת שלנו, על תמיכתה בפרויקט זה! Kimi היא מעבדת הבינה המלאכותית שמאחורי משפחות המודלים K2 ו-K3 בעלי המשקל הפתוח – Kimi K3 מספקת חלון הקשר של מיליון אסימונים, ראייה מובנית וקידוד ברמה מתקדמת בשבריר ממחירי המודלים הסגורים, ועובדת מחוץ לקופסה עם Claude Code, Codex וכל כלי קידוד ש-OmniRoute משרתת.
מה תמיכת Kimi מאפשרת: זיכויי ה-API של Kimi מפעילים את צינור השחרור המאושר על ידי AI של OmniRoute – שלב ה-אימות מיזוג המופעל על ידי Kimi K3 הסוקר כל בקשת משיכה לפני שהיא נשלחת – בתוספת פיתוח תכונות יומיומי. תמיכה מהשורה הראשונה של Kimi נשלחת בשני מסלולים: ה-Kimi API הישיר (kimi-k3) ו-תוכנית הקידוד Kimi Code (OAuth ומפתח API). OmniRoute הוא גם פרויקט הקוד הפתוח הברזילאי הראשון בתוכנית התמיכה של Kimi. קבל מפתח Kimi API עם 15% זיכויים נוספים ←
Cheaper Inference cheaperinference.com
תודה ל-Cheaper Inference, חבר קוד פתוח של OmniRoute, על תמיכתו בפרויקט זה! Cheaper Inference הוא שער מדורג על פי עלות המוכר מחדש 42 מודלים מתקדמים – Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok ו-MiniMax – מאחורי נקודת קצה אחת תואמת OpenAI, המנתב כל בקשה לספק הזול ביותר הזכאי מבלי לגבות אי פעם מעל מחיר המחירון של יצרן המודל.
תמיכה מהשורה הראשונה ב-OmniRoute: השלמות צ'אט, נקודת הקצה המובנית /v1/responses, ראייה, קריאת כלים ו-3 מודלי תמונה (grok-imagine, nano-banana-pro, nano-banana-2, נגישים כ-cheaperinference/<model>). קבל מפתח API ←
קישורים מתויגים aff=omniroute הם קישורי שותפים. הם מממנים את הפרויקט ללא עלות נוספת עבורך. 🎟️ מבצע שותפים — קופוני הרשמה חינם מספקים שאנחנו לא נותני חסות שלהם (לחץ להרחבה)סעיף זה מיועד לקודי הפניה/קופונים בלבד. שותפויות ממומנות נמצאות ב-🤝 נתמך על ידי חברי הקוד הפתוח שלנו למעלה. ל-OmniRoute אין חסות או שותפות עם הספקים המפורטים כאן – אלו קופונים ציבוריים שכל אחד יכול להשתמש בהם.
AgentRouter agentrouter.org
AgentRouter — הרשמת שותפים · $100 זיכויים חינם בהרשמה (שרת חינם, צפה לחביון גבוה יותר – הטוב ביותר לבדיקות, לא לייצור). תמיכה מהשורה הראשונה ב-OmniRoute מאז v3.8.50: השלמות צ'אט, פורמט ה-wire התואם Anthropic והנתיב התואם OpenAI. מודלים זמינים כוללים claude-opus-4-8, claude-opus-5, gpt-5.6-sol ועוד. קח את ה-$100 שלך ←
⚠️ קישור שותפים – ל-OmniRoute אין חסות או שותפות עם ספק זה.
מכיר ספק אחר עם קופון הרשמה חינם נדיב המועיל למשתמשי OmniRoute? פתח גיליון ונוסיף אותו כאן.
## 🎯 קומבואים — יכולת הדגל
> **קומבו** הוא שרשרת של מודלים ש-OmniRoute מנתב ביניהם **באופן אוטומטי**. אם המכסה אוזלת, ספק נכשל או שהעלויות מזנקות, הקומבו יכול לעבור למודל התקין והכשיר הבא. 🛡️
### ⚡ ללא הגדרות — פשוט השתמשו ב-`auto`
אין צורך ליצור קומבו. הגדירו את המודל שלכם ל-`auto` (או לגרסה אחרת שלו), ו-OmniRoute יבנה קומבו וירטואלי מהספקים המחוברים שלכם, עם ניקוד בזמן אמת:
מזהה מודל
מה הוא ממטב
auto
🎯 ברירת מחדל מאוזנת (LKGP — נשאר עם הספק התקין האחרון שלכם)
auto/coding
🧑💻 משקולות המעדיפות איכות ליצירת קוד
auto/fast
⚡ זמן ההשהיה הנמוך ביותר תחילה
auto/cheap
💰 העלות הזולה ביותר לטוקן תחילה
auto/subscription
🎟️ רק מכסת המינוי שכבר שילמתם עליה — נכשל במצב סגור ולעולם אינו עובר לחלופה בתשלום (מדריך)
auto/thrifty
🪜 תחילה מכסת התוכנית, ולאחר מכן שלב אחר שלב אל האפשרויות הזולות ביותר בתשלום — חזרה לתוכנית לאחר איפוס המכסה (מדריך)
auto/offline
🔋 מרווח המכסה / מגבלת הקצב הגדול ביותר תחילה
auto/smart
🔭 איכות תחילה + 10% חקירה לגילוי מודלים טובים יותר
auto/lkgp
📌 היצמדות מפורשת לספק התקין האחרון הידוע
auto/chaos
🧪 פיזור מקביל לפאנל מודלים (אחד לכל ספק, 5 כברירת מחדל), המחזיר תשובה אחת; קריאה אחת לשירות חיצוני לכל מודל בפאנל, לא הזרקת תקלות
##
### 🔀 או בנו קומבו משלכם — 20 אסטרטגיות ניתוב
כל **20** האסטרטגיות — ניתן לשלב ולהתאים בכל שלב בקומבו:
#
אסטרטגיה
מה היא עושה
1
priority
רשימה מסודרת לפי יעד ראשון — ממצה כל אחד לפני המעבר לבא 🥇
2
fill-first
ממלא את מכסתו של כל יעד במלואה לפני המעבר הלאה
3
weighted
בחירה אקראית משוקללת לפי המשקל של כל יעד
4
round-robin
עובר בין היעדים לפי הסדר במחזוריות
5
p2c
איזון עומסים אקראי בשיטת כוחן של שתי בחירות
6
least-used
בוחר את היעד בעל העומס הנוכחי הנמוך ביותר
7
random
בחירה אקראית אחידה (ללא כפילויות)
8
strict-random
בחירה אקראית ללא הסרת חזרות כפולות 🎲
9
cost-optimized
ממזער את העלות בדולרים לכל בקשה לפי תמחור הקטלוג בזמן אמת 💸
10
headroom
בוחר את היעד בעל המכסה הנותרת הגדולה ביותר
11
quota-weighted
מדלג על חשבונות שמכסתם מוצתה, ואז בוחר ביחס למכסה הנותרת ÷ העומס הפעיל — שיחות קיימות נשארות מוצמדות ⚖️
12
reset-window
מעדיף את היעד שחלון המכסה שלו יתאפס ראשון
13
reset-aware
מדרג לפי זמן איפוס המכסה — חלונות קצרים תחילה 📊
14
context-relay
מעביר הקשר בין יעדים עבור שיחות ארוכות 🧠
15
context-optimized
בוחר את ההתאמה הטובה ביותר לגודל ההקשר הנוכחי
16
cache-optimized
מצמיד כל תחילית הנחיה הניתנת לשימוש חוזר לאותו חשבון — ממקסם פגיעות במטמון ההנחיות 🎯
17
lkgp
הנתיב התקין האחרון הידוע — נצמד לספק האחרון שהצליח, ולאחר מכן עובר לכללי גיבוי
18
auto
ניקוד בזמן אמת לפי 16 גורמים בכל החיבורים 🤖
19
fusion
מפזר בקשות לפאנל מודלים + שופט מסנתז תשובה אחת 🧬
20
pipeline
משרשר שלבים — הפלט של כל יעד מוזן ליעד הבא 🔗
מנוע Auto-Combo מדרג כל מועמד לפי **16 גורמים** (תקינות, מכסה, עלות, זמן השהיה, התאמה למשימה, איכות, זמינות סשן…) — ראו [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 העמידות מובנית במערכת (3 שכבות עצמאיות)
📖 [מנוע Auto-Combo](docs/routing/AUTO-COMBO.md) · [מדריך עמידות](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 מה מייחד את OmniRoute
📊 המתודולוגיה המלאה ופרטים לפי תכונה בהשוואה ל-9router, OpenRouter, CLIProxyAPI ו-LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 תמיכה ב־OmniRoute
ל־OmniRoute רישיון MIT והוא מתוחזק באופן פתוח. אם הוא חוסך לכם זמן או כסף, כך תוכלו לסייע לו להישאר עצמאי — בחרו במה שמתאים לכם. חסות לעולם אינה משפיעה על עדיפות הניתוב; היא מקנה חשיפה, לא דירוג.
**🇧🇷 PIX** — מיידי, ללא עמלות (ברזיל)
מפתח (אקראי): `5d865059-bc44-483a-962d-43ceb80126eb`
העתקה והדבקה של Pix:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
₿ מטבעות קריפטוגרפיים — BTC · ETH · USDT-TRC20 · USDC-Solana (לחצו להרחבה)
₿ BTC
Bitcoin (SegWit)
bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETH
Ethereum (ERC20)
0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDT
Tron (TRC20)
TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDC
Solana
2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ שלחו כל מטבע רק ברשת המוצגת — שליחה ברשת שגויה עלולה לגרום לאובדן הכספים.
🐛 מצאתם באג או שיש לכם משוב? פתחו [דיון](https://github.com/diegosouzapw/OmniRoute/discussions).
הערות למפתחים: הפרויקט עשוי ליצור קובץ .env מקומי במהלך npm install/postinstall לנוחות המפתחים. המערכת מתעלמת מקובץ זה במכוון באמצעות .gitignore (ראו .gitignore), ולעולם אין לבצע לו commit — אם הוא בוצע בטעות, החליפו כל סוד שנחשף והסירו את הקובץ מההיסטוריה. להנחיות בנושא ניהול קובצי סביבה מקומיים וסודות, ראו docs/DEVELOPER-ENVIRONMENT.md.
## 📡 מכ"ם OmniRoute
הכותרת המרכזית של המסלול החינמי נותרת **כ־1.62 מיליארד טוקנים בחודש**, בהתאם לקטלוג המתועד לעיל, לאחר הסרת כפילויות בין המאגרים. קרדיטים זמניים שמעניקים ספקים בעת ההרשמה יכולים להגדיל בנפרד את המכסה בחודש הראשון ל־**כ־2.22 מיליארד**. Radar הוא שכבת־על אופציונלית וחתומה לקטלוג, המיועדת למי שמעוניינים במידע עדכני יותר על זמינות מודלים חינמיים בין מהדורות OmniRoute; הקטלוג הקהילתי וכל התכונות החינמיות הקיימות יישארו בחינם.
תומכים יכולים לקבל את הקטלוג החי והזדמנויות נוספות מספקים. התקרה הנפרדת והמשתנה שלו היא **לכל היותר כ־3 מיליארד טוקנים בחודש**, בהתאם לזמינות אצל הספקים. תקרה זו אינה מובטחת: ספקים יכולים לשנות מכסות, תנאי זכאות, מודלים או אזורים בכל עת.
Radar הוא שירות אופציונלי המבוסס על GET בלבד. לקוח OmniRoute אינו מעלה פרומפטים, תעבורה, הגדרות ספקים, נתוני טלמטריה על השימוש או את מצב הסגירה המקומי של הודעות. למידע על תנאי הזכאות ועל הקטלוג הנוכחי, בקרו ב־**[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.
## ✨ מה חדש
> נקודות בולטות מהגרסאות האחרונות **v3.8.20 → v3.8.53**. ההיסטוריה המלאה נמצאת ב-[`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ ניתוב `quota-weighted`** — אסטרטגיית השילוב ה-20 מדלגת על חשבונות שמיצו את המכסה שלהם, ולאחר מכן בוחרת מבין השאר באופן יחסי לפי המכסה שנותרה ÷ העומס הפעיל, תוך שמירת שיחות קיימות מוצמדות. → [שילוב אוטומטי](docs/routing/AUTO-COMBO.md)
- **🧰 מצב ללא ממשק גרפי** — `omniroute serve --headless` (או `OMNIROUTE_HEADLESS=1`) מפעיל רק את מנוע ה-Proxy של `/v1/*`, כאשר לוח הבקרה ותתי-המערכות הייעודיות לו כבויים. → [מצב ללא ממשק גרפי](docs/guides/HEADLESS.md)
- **🔎 גילוי מודלים** — `/v1/models` מסנן לפי יכולת, הקשר, סוג וטקסט, ו-`POST /v1/models/query` מחזיר רשימה מצומצמת, קצרה ודטרמיניסטית, עם אותה נראות לכל מפתח. → [תיעוד ה-API](docs/reference/API_REFERENCE.md)
- **🔑 בקרת ניתוב לכל מפתח** — הצמידו מפתח API למודל או לשילוב יחיד באמצעות `forcedModel`, והוסיפו או הסירו מודלים ושילובים של מפתח באופן אטומי (`/api/keys/{id}/access`). → [תיעוד ה-API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ בקרות PII מדויקות יותר** — בחירה לפי סוג, עד 20 תבניות מיסוך מותאמות אישית ומאומתות, ומוני זיהוי לפי סוג; המיסוך עצמו נשאר אופציונלי. → [אמצעי הגנה](docs/security/GUARDRAILS.md)
- **🌍 67 שפות** — לוח הבקרה, עותקי התיעוד וה-CLI, כאשר `npm run i18n:add-locale` מוסיף שפה בכל מקום באמצעות פקודה אחת. → [מדריך i18n](docs/guides/I18N.md)
- **🎛️ OmniConductor** — האצלת A2A נכנסת לצי הסוכנים שלכם, מיומנויות Conductor בכרטיס הסוכן, ופאנל בלוח הבקרה עם צ'אט קולי בלחיצה-לדיבור של Faro. → [שרת A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 בקרת כניסה אדפטיבית והגנה מעומס יתר** — בקשות צ'אט כבדות נכנסות לתור במקום להחזיר 503, עם חכירות RPM מתגלגלות ואטומיות לכל חיבור. → [מדריך החוסן](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ סדר קנוני של `/v1/models`** — מקטע רציף אחד המקובץ לפי ספק עבור כל ספק (שילובים מוצמדים ראשונים), היציב בכל מקורות הקטלוג. → [תיעוד ה-API](docs/reference/API_REFERENCE.md)
- **🗜️ הקשחת דחיסה** — הגנה מפני ניפוח המופעלת כברירת מחדל, חבילות Caveman לגרמנית / צרפתית / יפנית + סינית (wényán), ומסנני RTK עבור Gradle ו-.NET. → [דחיסה](docs/compression/COMPRESSION_ENGINES.md)
- **💸 עלות כנה בתעריף קבוע** — ספקי מנויים / תוכניות תכנות מוצגים בעלות של **$0** בניתוח העלויות; התקציב, המכסה והניתוב ממשיכים לבצע הערכות. → [תיעוד ה-API](docs/reference/API_REFERENCE.md)
- **⚖️ ניתוב Quota-Share** — חלוקה הוגנת של מכסת חשבון משותף בין מפתחות במאגר, תוך שימור עבודה כך שחלקים שאינם בשימוש מושאלים לאחרים. → [מדריך החוסן](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 הגדרת CLI/סוכן בפקודה אחת** — 15 פקודות `setup-*` רשומות; `omniroute run` מפעיל 7 כלי CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); הפקודה `omniroute configure` תומכת ב-11 יעדים, עם בורר אינטראקטיבי של ספק+מודל ומועדפים לכל הקשר. → [שילובי CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ מצב מרוחק** — שליטה ב-OmniRoute מרוחק באמצעות אסימונים מוגבלי היקף (`connect` / `contexts` / `tokens`) + כלי עזר OAuth בשם `antigravity` להתקנות VPS. → [מצב מרוחק](docs/guides/REMOTE-MODE.md)
- **🧭 ניתוב אוטומטי חכם יותר** — שילובי `auto/:`, **Fusion** (פאנל מודלים + שופט), ניתוב מודע-משימה ודריסות לפי בקשה עבור מודל / מצב / תקציב בדולרים. → [שילוב אוטומטי](docs/routing/AUTO-COMBO.md)
- **🗜️ דחיסה מודולרית** — 12 מנועים הניתנים לשילוב + אולפני דחיסה: LLMLingua-2, Ultra דו-שכבתי, omniglyph, שער נאמנות לכל שלב, GCF v3.2 ועורך לשינוי סדר בגרירה. → [דחיסה](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ פענוח MITM שקוף (TPROXY)** — לכידת כלי CLI שמתעלמים ממשתני סביבת Proxy, עם CA לכל SNI ומתקין למאגר האישורים המהימנים. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 טלמטריית עלויות בכל מקום** — כותרות עלות/שימוש מסוג `X-OmniRoute-*` בכל נקודת קצה, כותרת חיסכון עבור פגיעה במטמון, ומכסות הוצאה בדולרים לכל מפתח. → [תיעוד ה-API](docs/reference/API_REFERENCE.md)
- **🧠 זיכרון בשליטתכם** — כבוי כברירת מחדל, קוונטיזציית וקטורים int8 אופציונלית + דעיכה טיפוסית, ו-`x-omniroute-no-memory` לכל בקשה. → [זיכרון](docs/frameworks/MEMORY.md)
- **🛡️ אבטחה** — הגנה מפני הזרקת הנחיות בכל נתיב LLM (ערכת בדיקות צוות אדום), אמצעי הגנה אופציונלי למיסוך פרטי גישה (משחיר מפתחות API וסודות שדלפו בשני הכיוונים), חיפוש חינמי ב-DuckDuckGo כמוצא אחרון, ושער התחברות OIDC אופציונלי ללוח הבקרה (התחברות באמצעות סיסמה נשארת זמינה תמיד). → [אמצעי הגנה](docs/security/GUARDRAILS.md)
- **🖼️ נקודות קצה חדשות** — `/v1/ocr` (Mistral OCR) ו-`/v1/audio/translations` (בסגנון Whisper) משלימות את ממשק המדיה. → [תיעוד ה-API](docs/reference/API_REFERENCE.md)
- **🎨 יצירת תמונות / וידאו / שמע** — API אחד למדיה: xAI Grok Imagine ו-Novita AI לווידאו, ComfyUI, Magnific, Adobe Firefly, Segmind וספקי דיבור כגון ElevenLabs. → [תיעוד ה-API](docs/reference/API_REFERENCE.md)
- **🌍 פריסה ותפעול** — `basePath` עבור Reverse Proxy, זיהוי אוטומטי של שפת הדפדפן, מעקב אחר מכשירים לכל מפתח, אמון MITM ללא הרשאות Root ולוקליזציה zh-TW. → [סביבה](docs/reference/ENVIRONMENT.md)
- **🤝 ספקים וסוכנים נוספים** — סוכני ענן (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) עם דפדפן + התחברות OAuth, כרטיס ייעודי של Ollama, Claude Opus 5 ו-Sonnet 5, שותפות רשמית עם Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… וכן **קטלוג מעודכן של 375 ספקים**. → [ספקים](docs/reference/PROVIDER_REFERENCE.md)
- **📡 שקיפות ניתוב** — כל תגובה כוללת כותרת `X-OmniRoute-Decision` המציינת את האסטרטגיה/הספק/זמן ההשהיה ששירתו אותה; אסטרטגיית שילוב חדשה בשם `cache-optimized` + גורם Auto-Combo בשם `cacheAffinity` מנתבים בקשות חוזרות בחזרה לחיבור שמחזיק את הקידומת המאוחסנת במטמון; ונקודת קצה לקריאה בלבד, `/v1/auto-combo/{channel}/candidates`, חושפת את מאגר המועמדים הפעיל של ערוץ `auto/*`. → [שילוב אוטומטי](docs/routing/AUTO-COMBO.md)
- **⚡ ביצועים ותשתית מקומיים** — Redis מקומי בלחיצה אחת, מפרסי Relay של Cloudflare Workers / Deno Deploy, Bifrost ו-Mux כשירותים מוטמעים בפיקוח. → [שירותים מוטמעים](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 גם בארגז הכלים** — מסגרת תוספים + מרקטפלייס, מסגרות כישורים Omni/Agent/GitHub, שילוב כספת Obsidian (22 כלי MCP), ממשקי API של Batch ו-Files תואמי OpenAI, מטמון תגובות סמנטי, גיימיפיקציה עם לוחות מובילים, גילוי סוכני ACP (15 סוכנים מובנים), ייצוא לוגים מתוזמן ל-BigQuery, פיזור מקבילי רב-מודלי `auto/chaos`, גשר בוט Telegram, מנהל גרסאות בתוך האפליקציה ודירוגי ספקים חינמיים LMArena-ELO. → [תיעוד](docs/README.md)
## 🤖 ממשקי CLI וסוכני תכנות תואמים
> תצורה אחת — `http://localhost:20128/v1` — ו**כל** סביבת פיתוח מבוססת AI או ממשק CLI פועלים עם מודלים חינמיים ובעלות נמוכה.
＋ פועל גם עם · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · כל כלי תואם OpenAI
📖 הגדרה נפרדת לכל אחד מ-37 הכלים (27 כלי קוד CLI ו-10 סוכני CLI) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 תוסף OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)
**הפעילו כל CLI נתמך דרך OmniRoute בפקודה אחת** — ללא כתיבת קובצי תצורה,
פרטי הגישה מוזרקים לכל תהליך בנפרד, ו-Qwen/Gemini מקבלים ספריית בית מבודדת וזמנית:
```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"
# לחלופין, בחרו ספק+מודל באופן אינטראקטיבי וכתבו את התצורה של הכלי עצמו:
omniroute configure codex # זמינים גם: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
כל פקודה מכבדת את הקשר המרוחק הפעיל (`omniroute connect `), האפשרות `--dry-run`
מציגה תצוגה מקדימה של משתני הסביבה/הארגומנטים המדויקים ללא ביצוע, ו-`--api-key-env NAME` שומרת סודות מחוץ
להיסטוריית המעטפת שלכם. → [שילובי CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 375 ספקי AI — 153 מסומנים בקטלוג כחינמיים
> **375 ספקים רשומים** באוספים הקנוניים של צ'אט, מדיה, חיפוש, מקומי, סוכן ענן ומערכת, כולל **153 הנושאים מטא-נתוני גילוי של `hasFree: true`**. מרשם מודלי הצ'אט מכסה **239 ספקים / 3,059 צמדי ספק–מודל ייחודיים / 1,475 מזהי מודל גולמיים**; בקטלוג נפרד של תקציב החינם יש **467 שורות לכל מודל**, **34 מאגרים חוזרים** ו-**51 ספקי חינם לתמיד מתחדשים/ללא מפתח**. אלו מכנים שונים במכוון; ההגדרות והחישובים לאחר הסרת כפילויות מאגרים נמצאים ב[מדריך ספקים](docs/reference/PROVIDER_REFERENCE.md) וב[רמות חינם](docs/reference/FREE_TIERS.md).
### 🏢 כל מעבדה מרכזית — דרך נקודת קצה אחת
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…ועוד 350+ — כל אייקון נטען בזמן אמת מקטלוג הספקים של לוח הבקרה. 📖 [מדריך ספקים](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 חינם לתמיד — $0, ללא כרטיס
OpenCode Zen DeepSeek V4, Nemotron 3 ללא הגבלת טוקנים
Kilo Code Auto-router, Tencent Hy3 חינם לתמיד
Requesty GPT-OSS 120B, Nemotron חינם לתמיד
SiliconFlow DeepSeek V3.2 / R1 שכבה חינמית
Z.AI GLM GLM-4.7 / 4.5-Flash חינם לתמיד
Baidu ERNIE ERNIE 4.0 חינם לתמיד
Qoder AI Qwen3-Max, Kimi-K2 חינם ללא הגבלה
Pollinations GPT, Llama, Claude לא נדרש מפתח
Cloudflare AI למעלה מ-50 מודלים 10K נוירונים/יום
NVIDIA NIM GLM, MiniMax ~40 RPM בחינם
Cerebras GLM 4.7, GPT-OSS זיכוי חד-פעמי של $5; נדרש כרטיס אשראי
OpenRouter מודלים :free +$10 ← RPM גבוה יותר
📖 קטלוג מלא לקריאה על ידי מכונה → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ היכן OmniRoute פועל — בכל מקום
> אותו יישום, המחשב שלכם, הכללים שלכם. מהתקנת npm גלובלית ועד **לטלפון שלכם** באמצעות Termux.
פלטפורמה
התקנה
יתרונות בולטים
📦 npm (גלובלי)
npm install -g omniroute
פקודה אחת, בכל מערכת הפעלה
🐳 Docker
docker run … diegosouzapw/omniroute
תמיכה בריבוי ארכיטקטורות AMD64 + ARM64
🖥️ שולחן עבודה (Electron)
npm run electron:build
חלון מקורי + מגש מערכת — Windows / macOS / Linux
🎩 שורת תפריטים (OmniRouteTray)
brew install --cask zoispag/tap/omniroute-tray
מפקח על השרת ומעדכן אותו אוטומטית — macOS
💪 ARM
arm64 מקורי
Raspberry Pi, שרתי ARM, Apple Silicon
📱 Android (Termux)
pkg install nodejs && npx -y omniroute
פועל בטלפון שלכם, מסביב לשעון, ללא root
📲 PWA
"הוספה למסך הבית"
מסך מלא, עבודה לא מקוונת והתקנה מהדפדפן
🧩 תוסף OpenCode
@omniroute/opencode-provider
שילוב מקורי עם OpenCode
🤖 VS Code Copilot Chat
התקינו את התוסף OmniCopilot
כל מודל של OmniRoute בבורר המקורי של Copilot Chat — בגרסה היציבה וב-Insiders
### 🧩 חדש: OmniRoute בתוך Copilot Chat המקורי של VS Code
> בלי סרגל צד חדש ובלי ממשק צ'אט חדש — כל מודל ש-OmniRoute מספק מופיע ישירות
> **בבורר המודלים של Copilot Chat שבו אתם כבר משתמשים**. החל מ-VS Code 1.122, מודלים של ספקים פועלים
> ללא התחברות ל-GitHub או מינוי Copilot — מצב סוכן, קריאה לכלים וראייה ממוחשבת,
> בחינם.
התקינו את התוסף **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, הפנו אותו
לשרת OmniRoute שלכם (ברירת המחדל היא `localhost:20128`), ולאחר מכן פתחו את Copilot Chat ← בורר המודלים
← **ניהול מודלים…** ← **OmniRoute**.
מתוך העורך: פתחו את תצוגת **ההרחבות**, חפשו **"OmniRoute"** ולחצו על **התקנה**
— הפעולה זהה בשתי החנויות. קוד המקור, הדיווחים ותהליך הפרסום נמצאים ב-
[diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [מדריך VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — הגדרה, מה מוצג בבורר, לוח בקרה בכרטיסייה ופתרון בעיות
### 🎩 חדש: OmniRouteTray — שער הגישה שלכם, ישירות בשורת התפריטים
> `omniroute serve` פועל במיטבו כשהוא פעיל תמיד. **[OmniRouteTray](https://github.com/zoispag/omniroute-tray)**
> הופך אותו ליישום שורת תפריטים בשיטת „הגדר ושכח” עבור macOS: הוא מפעיל את השרת, משאיר אותו פעיל
> גם לאחר הפעלות מחדש, מעדכן אותו במקום ומציג את תקציב הטוקנים העדכני שלכם במרחק לחיצה אחת — **בלי
> להשאיר חלון מסוף פתוח ובלי צורך לתחזק את `npm install -g omniroute`.**
הוא נבנה באמצעות [Tauri v2](https://v2.tauri.app/) (ליבת Rust זעירה במיוחד), מגיע
עם סביבת הריצה החתומה Node 24 משלו ומנהל התקנת OmniRoute בבעלות היישום, כך שלעולם אינו מתנגש עם
`node`/`bun` הגלובליים שלכם. הוא **משתף את התצורה ומסד הנתונים הקיימים שלכם ב-`~/.omniroute/`** — כך שזהו
אותו OmniRoute שאתם כבר מפעילים, רק עם כובע. 🎩
מה הוא עושה
כיצד
🟢 מפקח על השרת
מפעיל את omniroute serve ומאמץ מופע שכבר פועל במקום לשכפל אותו
📊 שימוש בזמן אמת במבט חטוף
סרגלי מכסה לפי ספק, מגבלות הפעלה ושבוע עבור Claude עם ספירה לאחור עד לאיפוס, ופירוט עלויות ל-30 יום
🔄 מתעדכן אוטומטית במקום
התקנה מדורגת, החלפה אטומית וחזרה לאחור במקרה של כשל — תמיד בגרסה החדשה ביותר
🚀 הפעלה בעת הכניסה
הפעלה אופציונלית בעת הכניסה; מגש בלבד, ללא סמל ב-Dock
🩺 אבחון ויומנים
אבחון וגישה ליומני השרת בלחיצה אחת
```sh
brew install --cask zoispag/tap/omniroute-tray
```
מעדיפים הורדה? הורידו את קובץ ה־.dmg העדכני ביותר מתוך
הגרסאות. קוד המקור, הדיווחים על בעיות ותיעוד הבנייה
נמצאים ב־zoispag/omniroute-tray.
💛 פרויקט קהילתי מאת @zoispag — אינו גרסה רשמית של OmniRoute.
> מעבר לשרת, OmniRoute הוא **תא פיקוד מלא משורת הפקודה** עם **יותר מ-80 פקודות**, לצד פרוטוקולים פתוחים לסוכנים, כך שסוכן AI יכול להפעיל אותו **בכוחות עצמו**.
### ⌨️ CLI אמיתי (לא רק `start`)
```bash
omniroute # הפעלת שער ולוח בקרה (פורט 20128)
omniroute chat # לקוח צ'אט TUI אינטראקטיבי (פקודות לוכסן: /model /combo /skill /memory)
omniroute setup # אשף מודרך להפעלה ראשונה
omniroute doctor # אבחון ספקים, פורטים ותלויות מקוריות
```
### 🛰️ מצב מרוחק — הפעילו את ה-CLI כאן ואת OmniRoute ב-VPS
OmniRoute פועל בשרת? הפעילו אותו מהמחשב הנייד שלכם באמצעות **אותו CLI**. התחברו פעם אחת
באמצעות אסימון גישה מוגבל-היקף; לאחר מכן, כל פקודה תופנה לשרת המרוחק.
```bash
omniroute connect 192.168.0.15 # סיסמה ← אסימון מוגבל-היקף, נשמר כהקשר
omniroute models # ← פועל מול השרת המרוחק
omniroute configure codex # ← בוחר מודל מרוחק, כותב פרופיל Codex מקומי
omniroute tokens create --name ci --scope read # הנפקת אסימונים מצומצמים יותר למחשבים אחרים
omniroute contexts use default # ← חזרה לשרת המקומי
```
האסימונים מוגבלים להיקפים `read` / `write` / `admin`; נתיבים שמפעילים תהליכים נשארים זמינים רק דרך loopback.
📖 [מצב מרוחק](docs/guides/REMOTE-MODE.md)
### 🤝 חברו סוכן — והוא ישלוט ב-OmniRoute בעצמו
חשפו את OmniRoute דרך **MCP**, **A2A**, **REST API**, **webhooks** או **CLI מרוחק** — כל סוכן מתאים (או הקוד שלכם) יקבל גישה לכל יכולות השער: ניתוב, ספקים, שילובים, מטמון, דחיסה וזיכרון — באופן אוטונומי. נקודות הקצה של HTTP שלהלן זמינות תחת `http://localhost:20128`.
ממשק
נקודת קצה / פקודה
שימושים
🧰 MCP (stdio)
omniroute --mcp
חיבור ל-Claude Desktop, ל-Cursor או לכל לקוח MCP
🌊 MCP (HTTP)
/api/mcp/stream
MCP מרוחק — 110 כלים, 33 היקפים (האכיפה ניתנת להפעלה), יומן ביקורת מלא
📡 MCP (SSE)
/api/mcp/sse
תעבורת MCP בהזרמה
🤝 A2A
/.well-known/agent.json
תקשורת בין סוכנים, JSON-RPC 2.0 + SSE, 6 מיומנויות
🌐 REST API
/v1/*
תואם OpenAI — צ'אט, הטמעות, תמונות, שמע ו-OCR
🔔 Webhooks
/api/webhooks
דחיפת אירועי בקשות / מכסות אל Slack, Discord, Telegram או כל URL
🛰️ CLI מרוחק
omniroute connect
הפעלת מופע מרוחק באמצעות אסימוני גישה מוגבלי-היקף
```bash
# הענקת ערכת הכלים המלאה של OmniRoute ל-Claude Code דרך MCP:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [שרת MCP](docs/frameworks/MCP-SERVER.md) · [שרת A2A](docs/frameworks/A2A-SERVER.md) · [פרוטוקולים לסוכנים](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)
## 🗜️ חסוך 15–95% טוקנים — אוטומטית
### 📖 איך זה עובד — צינור עיבוד, ארכיטקטורה ומתמטיקת החיסכון
קומבו מוערם כברירת מחדל מריץ `RTK → Caveman`. כאשר שניהם פועלים על אותו מטען (payload) של כלי/הקשר, החיסכון מצטבר:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
בלוקי קוד, כתובות URL, JSON ונתונים מובנים **תמיד מוגנים** על ידי מנוע השימור.
> **למה להשתמש בהרבה טוקנים כשמעט טוקנים עושים את העבודה?** כל בקשה עוברת דרך צינור הדחיסה של OmniRoute **באופן שקוף** — ללא שינויים בצד הלקוח. זהו כעת **מערך של 12 מנועים ניתנים להרכבה** שרצים לפי הסדר ומתמזגים ומתחלפים לפי כל קומבו ניתוב — בבנייה על רעיונות מ-[RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), ו-[Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 מערך 12 המנועים
המנועים פועלים לפי סדר הצינור; כל אחד ניתן להפעלה/כיבוי בנפרד וניתן להגדרה לכל קומבו:
#
מנוע
מה הוא עושה
1
Session-Dedup
מפיל תוכן שחוזר על עצמו בין תורות (מבוסס תוכן, בין-תורי)
2
CCR
מארכב בלוקים גדולים מאחורי סמני שליפה, נשלפים לפי דרישה
3
Lite
קיצוץ רווחים + כתובות URL של תמונות (בסיס קליל-השהיה)
4
RTK
סינון חכם של תוצאות כלים, דה-דופ וקיצוץ (מודע לפקודות)
5
Responses Tool Output
דחיסת JSON חסרת-אובדן תחילה + דחיסת אבחון תחומה עבור פלטי shell/patch/search/build (Responses API)
6
Headroom
כיווץ טבלאי חסר-אובדן של מערכי JSON (~30%) באמצעות קודק GCF מוטמע
7
Relevance
ניקוד משפטים אקסטרקטיבי מול שאילתת המשתמש האחרונה
8
Caveman
דחיסת פרוזה מבוססת-כללים (~65–75% בפלט)
9
Aggressive
תמצות + הזדקנות הדרגתית של תורות ישנים
10
LLMLingua-2
גיזום סמנטי ב-ML באמצעות MobileBERT ONNX — בטוח לקוד, אסינכרוני
11
Ultra
גיזום טוקנים היוריסטי עם שכבת מודל קטן (SLM) אופציונלית
12
OmniGlyph
קידוד הקשר-כתמונה ניסיוני עבור Claude Fable 5 נמדד על החוט הישיר של Anthropic; שנאי GPT 5.6 נותרים fail-closed בהמתנה לקבלות ספק. ארבעה פרופילי דחיסה (aggressive כברירת מחדל, balanced, coding-safe, passthrough) (האגרסיבי ביותר; בהצטרפות)
בלוקי קוד, כתובות URL ונתונים מובנים **נשמרים תמיד** באופן מושלם-בייט. **פריסטים בלחיצה אחת** משלבים את המנועים:
מצב
חיסכון
הכי מתאים ל
🪶 Lite
~15%
ברירת מחדל בטוחה תמיד-פעילה
🪨 Standard (Caveman)
~30%
קידוד יומיומי
⚡ Aggressive
~50%
מפגשים ארוכים עתירי-כלים
🔥 Ultra
~75%
חיסכון מקסימלי
🧰 RTK
60–90%
פלט shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
פרומפטים משולבים + לוגים של כלים
**דוגמה אמיתית — מצב Standard:**
> **לפני (69 טוקנים):** _"הסיבה שרכיב ה-React שלך מתרנדר מחדש היא כנראה יצירת הפניה חדשה לאובייקט בכל מחזור רינדור. כשמעבירים אובייקט מוטבע כ-prop, ההשוואה הרדודה של React רואה אותו כאובייקט שונה בכל פעם, מה שמפעיל רינדור מחדש. הייתי ממליץ להשתמש ב-useMemo כדי לממואיזציה של האובייקט."_
>
> **אחרי (19 טוקנים):** _"הפניה חדשה לאובייקט בכל רינדור. prop אובייקט מוטבע = הפניה חדשה = רינדור מחדש. עטוף ב-useMemo."_
>
> **אותה תשובה. 72% פחות טוקנים. אפס אובדן דיוק.** ✅
**דוגמה PT-BR — מצב [Troglodita](https://github.com/leninejunior/troglodita):**
> **לפני (42 טוקנים):** _"הבעיה היא שהקומפוננטה מבצעת רה-רנדור כי נוצרת הפניה חדשה לאובייקט בכל מחזור רינדור. הייתי ממליץ להשתמש ב-useMemo."_
>
> **אחרי (12 טוקנים):** _"רה-רנדור: הפניה חדשה בכל מחזור (אובייקט inline נוצר מחדש). להשתמש ב-`useMemo`."_
>
> **אותה תשובה. ~70% פחות טוקנים. דיוק טכני נשמר.** ✅
### 🎚️ מעבר למנועים — סגנונות פלט, החוגה האדפטיבית ושליטה לכל בקשה
12 המנועים שלמעלה מקטינים את מה שנכנס **פנימה**. שלוש שכבות נוספות מעצבות **איך**, **מתי**, ומה שיוצא **החוצה**:
- **🪄 סגנונות פלט** _(הכוונה על ציר הפלט)_ — הזרקת הוראות עיצוב תגובה דטרמיניסטיות ובטוחות למטמון; ניתנות לשילוב, כל אחת בעוצמת `lite` / `full` / `ultra`. הוספת סגנון היא רשומת registry של שורה אחת:
- **פרוזה תמציתית** — השמטת מילוי / מילות קישור / הסתייגויות; שמירה על התוכן הטכני במדויק.
- **פחות קוד** — YAGNI בסגנון "מפתח בכיר עצלן": השינוי הקטן ביותר שעובד, בלי תשתית שלא התבקשה.
- **Ponytail (מפתח בכיר עצלן)** — לטפס על סולם ה-YAGNI, לתקן את שורש הבעיה, ה-diff הקטן ביותר שעובד.
- **יש לי ADHD (פעולה תחילה)** — הפעולה הבאה מובילה, צעדים ממוספרים, צעד הבא קונקרטי אחד, בלי הקדמה.
- **CJK תמציתי (文言)** — סגנון סיני קלאסי אולטרה-תמציתי (מוגבל לפי locale ל-`zh`).
- **🎯 תקציב הקשר אדפטיבי** _(החוגה)_ — במקום סף טוקנים יחיד של הפעל/כבה, מטפסים עם המנועים הזולים והפחות מאבדניים רק עד כמה שצריך כדי **להתאים לחלון ההקשר של המודל**. מדיניות: `reserve-output` (ברירת מחדל, מודע למודל) · `percentage` · `absolute`. מצב: `floor` (הבטחת התאמה) · `replace-autotrigger` (הבחירה המפורשת שלך מנצחת) · `off` (סף מורשת).
- **🎛️ היכן הכיווץ מוכרע** _(עדיפות, גבוה → נמוך)_ — כותרת `x-omniroute-compression` לכל בקשה › עקיפת routing-combo › פרופיל פעיל בשם › אדפטיבי / auto-trigger › ברירת מחדל של הפאנל › כבוי. התוכנית שהוחלה מוחזרת בכותרת התגובה `X-OmniRoute-Compression: ; source=`.
auto-trigger לפי סף טוקנים, הפעלת החוגה האדפטיבית, נעיצת פרופיל בשם, הגדרה חד-פעמית לכל בקשה, או שיוך pipeline לכל routing combo — מה שמתאים לעומס העבודה. **eval harness** אופליין אופציונלי (`npm run eval:compression`) מדרג נאמנות מול חיסכון על קורפוס נעוץ לפני שקידום שינוי.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ התחלה מהירה
**1) התקנה והרצה**
```bash
npm install -g omniroute
omniroute
```
> 💡 רואה `npm warn ERESOLVE` או אזהרות peer-dep? [הן בלתי מזיקות](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **משתמשים ב-npm 11 ואילך?** ייתכן ש-npm יחסום סקריפטים של מחזור חיים של חבילות אלא אם הם מורשים. ה-`postinstall` של OmniRoute (`node scripts/build/postinstall.mjs`) נדרש כדי להכין את קבצי ה-runtime המקוריים שלו. אפשרו את החבילות הנקובות באזהרה של npm בעת התקנה גלובלית. עבור סט החבילות שדווח על ידי OmniRoute 3.8.53:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> כדי לעשות שימוש חוזר ברשימת ההיתר הזו בהתקנות גלובליות עתידיות, הגדירו אותה פעם אחת, ואז התקינו כרגיל:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> רשימת התלויות יכולה להשתנות בין גרסאות; אם npm מדווח על רשימה אחרת, השתמשו בשמות החבילות מאותה אזהרה. אישור חבילה מתיר לסקריפטי ההתקנה שלה לרוץ.
> **משתמשים ב-Gemini Web או בספק אחר מבוסס web-cookie?** חבילת ה-npm כוללת את Playwright אך לא את בינארי ה-Chromium שלה. ראו את ההערה על [הגדרת Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) לפני ביצוע הבקשה הראשונה לספק web.
Dashboard בכתובת `http://localhost:20128` · API בכתובת `http://localhost:20128/v1`.
**2) חיבור ספק זכאי באמצעות החשבון שלך**
Dashboard → **Providers** → בחרו ספק שתנאיו ומכסתו הנוכחיים מתאימים לשימוש שלכם → הוסיפו את מפתח ה-API שלו או השלימו את תהליך החשבון שלו. חבילות חינמיות עשויות לדרוש הרשמה, אישור או אמצעי תשלום. עיינו ב-[Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md); זמינות ללא מפתח אינה מובטחת, וספקים המסומנים `tos: avoid` מוחרגים מ-`auto` כברירת מחדל.
**3) כוונו את כלי הקידוד שלכם**
```txt
Base URL: http://localhost:20128/v1
API Key: [copy from Dashboard → Endpoints]
Model: auto (routes among eligible connections — or choose provider/model)
```
**4) אימות שהכול עובד**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
אמורים להופיע המודלים המחוברים שלכם ברשימה. 🎉 זה הכול — התחילו לקודד, ו-OmniRoute מנתב אוטומטית ועושה fallback עבורכם.
אם הלקוח שלכם אינו יכול לשלוח כותרות מותאמות אישית, OmniRoute חושף גם כינויים לתאימות מבוססי טוקן:
```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
```
השתמשו באלה רק עבור לקוחות שאינם יכולים לצרף `Authorization: Bearer ...`. אימות באמצעות כותרת נשאר המצב המועדף.
## 📦 שיטות התקנה נוספות — Docker, קוד מקור, 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` עוקבת אחר גרסת ה-SemVer היציבה **שפורסמה** הגבוהה ביותר. היא אינה עוקבת אחר `main` ב-git. עבור GitOps, קבעו גרסה באמצעות `:X.Y.Z`. ראו [ערוצי הפצה של Docker](docs/guides/DOCKER_GUIDE.md#release-channels).התמונה מקבעת את **`OMNIROUTE_MEMORY_MB=1024`**. זה מספיק ללוח הבקרה ולצ'אט קל. **סוכני קידוד** (`POST /v1/responses` מ-Claude Code, Codex, Grok, …) זקוקים לערמת V8 גדולה בהרבה, אחרת התהליך נתקל ב-`FATAL ERROR` בסביבות 12 GiB כאשר שני הקשרים ארוכים חופפים. הקצו למכולה יותר זיכרון מגודל הערמה (מאגרים טבעיים נמצאים מחוץ ל-V8):
| עומס עבודה | ערמה (`-e OMNIROUTE_MEMORY_MB`) | מכולה (`--memory`) |
| --------------------------------------- | ------------------------------- | ------------------ |
| לוח בקרה / צ'אט קל | `1024` (ברירת המחדל של התמונה) | ≥2 g |
| סוכן קידוד אחד | `8192` | ≥10 g |
| שתי בקשות `/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
```
הטבלה המלאה: [מדריך Docker — זיכרון RAM בזמן ריצה](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **ערוץ קדם-הפצה של Docker:** התגיות `diegosouzapw/omniroute:next` ו-
> `diegosouzapw/omniroute:next-web` עוקבות אחר ענף ברירת המחדל הנוכחי `release/v*`.
> תגיות משתנות אלו מיועדות רק לבדיקת תיקונים שטרם הופצו,
> ו**אינן נתמכות לשימוש בסביבת ייצור**. ראו
> [ערוצי הפצה של Docker](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
התקנה רגילה באמצעות `bun install` והתקנה גלובלית (`bun install -g omniroute`) נתמכות באמצעות זיהוי סביבת הריצה Bun:
- **`bun:sqlite` מובנה**: בעת ריצה תחת Bun, OmniRoute משתמש במנהל ההתקן `bun:sqlite` המובנה של Bun, ובמקרה הצורך חוזר ל-`better-sqlite3` ב-Node.js או ל-`sql.js`.
- **בחירה אוטומטית ב-Webpack לפיתוח**: סביבת הפיתוח (`bun run dev`) מזהה את Bun באופן אוטומטי ומשביתה את Turbopack לטובת Webpack, כדי למנוע אי-תאימויות עם קישורי V8 טבעיים. בניות לייצור (`bun run build`) פועלות בדיוק בהתאם ל-`OMNIROUTE_USE_TURBOPACK`, כמו ב-Node: Turbopack כברירת מחדל, או `OMNIROUTE_USE_TURBOPACK=0` לבנייה באמצעות Webpack (`Dockerfile.bun` חושף אותו כ-`--build-arg`).
- **Dockerfile ייעודי ל-Bun**: הקובץ הרב-שלבי `Dockerfile.bun` מיועד לפריסות ייצור טבעיות של Bun (`docker build -f Dockerfile.bun -t omniroute:bun .`).
```bash
# התקנה והרצה באמצעות Bun
bun install
bun run dev
```
**🛠️ מקוד המקור**
```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
# שימוש ב-flakes של Nix
nix develop
npm run dev
# או שימוש ב-devbox
devbox run npm run dev
```
📖 [מדריך Docker](docs/guides/DOCKER_GUIDE.md) — פרופילי Compose, HTTPS באמצעות Caddy ומנהרות Cloudflare.
**🦭 Podman**
```bash
# 1. הכנת ספריית הנתונים המחוברת באמצעות bind mount
mkdir -p data
# 2. רק ב-Linux וב-Podman מקומי ללא root (לעולם לא בלקוח מרוחק של Podman Machine):
podman unshare chown 1000:1000 ./data
# 3. הגדרת רמז סביבת הריצה, בניית תמונת Compose המקומית והפעלה
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build
```
ב-macOS או ב-Windows, Podman משתמש ב-Podman Machine מרוחק: דלגו על `podman unshare`
ופעלו לפי [ההנחיות לספריית הנתונים בהתאם לטופולוגיה](contrib/podman/README.md#data-directory-permissions-by-topology).
📖 [מדריך Podman](contrib/podman/README.md) — בניות Compose, Podman Machine והגדרת
Quadlet עם Linux/systemd.
**⚡ התקנה מהירה / רזה יותר (דילוג על הבנייה הטבעית)**
מנוע SQLite הטבעי (`better-sqlite3`) הוא תלות **אופציונלית**, ולכן התקנה גלובלית
לעולם אינה נתקעת בהידור מקוד המקור: היא משתמשת בקובץ בינארי שנבנה מראש כאשר הוא תואם
לפלטפורמה/Node שלכם, ובמקרה אחר חוזרת באופן שקוף למנוע JavaScript טהור
(`node:sqlite` ב-Node 22 ומעלה, או `sql.js` WASM המצורף) — ללא צורך בכלי בנייה.
כדי לדלג לחלוטין על החימום הטבעי שלאחר ההתקנה (CI, מערכת ללא ממשק גרפי או מחשבים איטיים):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # גם CI=1 מדלג עליו
```
להתקנות המהירות ביותר, העדיפו את **pnpm** (אחסון ממוען-תוכן + קישורים קשיחים — ראו לעיל).
לסביבת ריצה ללא לוח בקרה וללא ממשק גרפי, השתמשו בפרופיל Docker בשם `base` (לעיל) או
ב[מדריך Termux](docs/guides/TERMUX_GUIDE.md). ממשק שורת הפקודה ולוח הבקרה האינטרנטי מסופקים על ידי
אותו תהליך ביציאה אחת, ולכן כיום אין חבילה נפרדת לממשק שורת הפקודה בלבד.
# 🎬 OmniRoute בפעולה
## 📹 מדריכי וידאו
תמונת מצב של לוח הבקרה מ־2026-10-18 · קטלוג גולמי: YT 1.352 | TT 334 | IG 290 · עדכניות (ימים): YT 5 | TT 48 | IG 49
🎬 #1 — Instagram nick_saraev — 3,042,474 צפיות
🎬 #2 — Instagram nnapier7 — 1,454,535 צפיות
🎬 #3 — YouTube Amidia AI & Tech — 794,974 צפיות
🎬 #4 — Instagram theopenstack — 692,419 צפיות
🎬 #5 — TikTok migue.baena — 685,788 צפיות
**הדירוג המלא (כתובות URL קנוניות ללא כפילויות, `v > 0`, החשיפה הגבוהה ביותר):**
| #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: **1.976 סרטונים ייחודיים** · **20.220.289 צפיות ידועות** (`v > 0`) · **1.210 ערוצים/פרופילים לפי רשת**. לוח הבקרה הגולמי מכיל 1.976 שורות (YouTube 1.352 = 740 סרטונים ארוכים + 612 Shorts · TikTok 334 · Instagram 290); לא נותרו כפילויות לאחר הנרמול לפי כתובת ה־URL הקנונית, ששומר את מספר הצפיות הגבוה ביותר לכל סרטון. איסוף הנתונים מ־YouTube מוקפא נכון ל־2026-10-13 (מכסת ה־API נוצלה במלואה בין 14 ל־18/10), ומ־TikTok/Instagram מאז 2026-09-02 (אין קרדיטים לאיסוף); ל־76 סרטונים עדיין אין ספירת צפיות.
> 🎬 **יצרתם סרטון על OmniRoute?** פתחו [בעיה](https://github.com/diegosouzapw/OmniRoute/issues/new) או [דיון](https://github.com/diegosouzapw/OmniRoute/discussions) עם הקישור — ונציג אותו כאן.
# 📧 קהילה ועזרה
> הכול במקום אחד — עקבו אחר המתחזק, שוחחו עם הקהילה או פתחו בעיה.
| ערוץ | היכן / כיצד |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| 💼 **LinkedIn** — עקבו אחר המתחזק | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) |
| 🐙 **GitHub** — עקבו לקבלת עדכונים וטיפים | [@diegosouzapw](https://github.com/diegosouzapw) |
| 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) |
| ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) |
| 🟢 **WhatsApp — 🌍 גלובלי** | [הצטרפו לקבוצה](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) |
| 🟢 **WhatsApp — 🇧🇷 ברזיל** | [הצטרפו לקבוצה](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) |
| 🌍 **אתר אינטרנט** | [omniroute.online](https://omniroute.online) |
| 🌍 **🌍קהילת StHub OmniRoute (בחינם)** | [פורטל StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) |
| 📦 **קוד מקור** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) |
| 🐛 **דיווח על באג** | [פתחו דיווח](https://github.com/diegosouzapw/OmniRoute/issues) — צרפו את הפלט של `npm run system-info` |
| 🤝 **תרומה** | [CONTRIBUTING.md](CONTRIBUTING.md) · [מודל הסתעפות והפצה](docs/ops/BRANCHING_MODEL.md) · בחרו `good first issue` |
| 💚 **תמיכה בפרויקט** | [דרכים לתמיכה ↑](#-support-omniroute) · [נותני החסות ב-GitHub](https://github.com/sponsors/diegosouzapw) |
אסטרטגיית כיסוי בדיקות עבור 56,000+ הצהרות בדיקה סטטיות ב-7,800+ קבצי בדיקה במעקב
# ⭐ תורמים מובילים
> OmniRoute מעוצב על ידי קהילת קוד פתוח נלהבת. אנשים אלה תרמו תרומות יוצאות דופן שמשפיעות ישירות על האיכות, היציבות וההיקף של הפרויקט. **תודה לכם.**
### תורמים חיצוניים לפי pull requests שמוזגו
המניין נערך ב-2026-10-18 15:09:09 UTC עם קצה חי של release/v3.8.52656f01cb43. מניין ה-GitHub GraphQL המפולח כולל 9,191 PRs מוזגו: 3,834 על ידי בעלי המאגר, 229 על ידי Dependabot, 6 על ידי בוטים/אפליקציות אחרים, ו5,122 PRs חיצוניים מ-835 תורמים שונים. “שורות ששונו” הן תוספות + מחיקות של GitHub וכוללות קבצים שנוצרו, lockfiles, קטלוגים, תרגומים ותיעוד; זהו נפח שינויים, לא LOC שנכתבו. 49 PRs מדווחים על diffs של GitHub מעל 500,000 שורות (לדוגמה #13399, תוספת ספק בודדת, מפרט 2,347 קבצים ששונו), מה שמנפח כמה מהסכומים לעיל. תוצאות תיקו מדורגות יחד.
### קומיטים המיוחסים ל-GitHub
נבדק מחדש ב-2026-10-18 14:44:45 UTC: קומיטים המיוחסים ל-GitHub כפי שדווחו על ידי ה-Contributors API של המאגר עבור ענף ברירת המחדל release/v3.8.52. ה-API החזיר 849 זהויות (429 משתמשים, 2 בוטים, 418 אנונימיים); טבלה זו אינה כוללת את המתחזק, בוטים וזהויות אנונימיות, ומשמרת מצבי תיקו בתחרות. היא נפרדת הן מדירוג ה-PR הממוזגים שלמעלה והן ממפקד מטא-הנתונים של Git שלמטה.
> 🙏 התכונות, תיקוני הבאגים ושיפורי התשתית של התורמים הללו הם **חלק מרכזי** ממה שהופך את OmniRoute לאמינה ועשירה בתכונות. כל pull request, כל מקרה בדיקה וכל קובץ תרגום i18n חשובים. קוד פתוח נבנה על ידי אנשים כמוהם.
---
## 💖 נותני חסות
תודה מעומק הלב לאנשים שמממנים את OmniRoute מכיסם הפרטי — כל תרומה שומרת על הפרויקט חינמי, עצמאי ובתנועה.
… ואחרים שמעדיפים להישאר פרטיים 💛נותני החסות הציבוריים ב-GitHub Sponsors אומתו מחדש ב-2026-10-18 באמצעות GitHub Sponsors GraphQL API: 11 חסויות ציבוריות (6 פעילות, 5 מהעבר) מתוך 14 בסך הכול. הסטטוס isActive של GitHub קובע את התוויות הפעילות שלעיל; תומכים ציבוריים שנתנו תמיכה חד-פעמית בעבר עדיין זוכים להוקרה, ונותני חסות פרטיים נשארים אנונימיים. תרומות דרך Ko-fi, Buy Me a Coffee, Liberapay, PIX ומטבעות קריפטוגרפיים אינן מופיעות משום שאין להן רישום ציבורי של נותן חסות.💖 הצטרפו כנותני חסות ← — כל דולר שומר על OmniRoute חינמי ועצמאי.
## 👥 יותר מ-900 תורמים
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
נבדק ב-2026-10-18 בקצה הפעיל של release/v3.8.52, ב-commit ad160ab2d1 (6,826 commits): 993 זהויות Git אנושיות מנורמלות — 707 מופיעות כמחברי commits (כולל המתחזק) ו-286 מופיעות רק בשורות Co-authored-by מפורשות. המפקד מחיל את .mailmap, משווה כתובות דוא"ל ללא תלות ברישיות, מאחד כתובות noreply מספריות ורגילות של GitHub רק כאשר הן מקודדות את אותו שם משתמש, מחריג 26 זהויות של בוטים/סוכנים/שירותים/מצייני מקום, ואינו מאחד כתובות דוא"ל רגילות רק משום ששמות התצוגה שלהן זהים. הבדיקה מ-2026-08-24 פרסמה נתון של 639; הרצה חוזרת של שיטה זו על בסיס הבדיקה ההיא, ac02c5b42f, מניבה 619, ולכן הגידול נובע מתורמים חדשים ולא משיטה מקלה יותר.
### כיצד לתרום
1. צרו fork של המאגר
2. צרו ענף מקצה ה-`release/vX.Y.Z` **הפעיל** (לא מ-`main`) — ראו [מודל הענפים והגרסאות](docs/ops/BRANCHING_MODEL.md)
3. צרו את ענף התכונה שלכם (`git checkout -b feat/amazing-feature`)
4. בצעו commit לשינויים שלכם (`git commit -m 'feat: add amazing feature'`)
5. דחפו אל הענף (`git push origin feat/amazing-feature`)
6. פתחו Pull Request כאשר **base = הענף `release/vX.Y.Z` הזה**
להנחיות מפורטות, ראו [CONTRIBUTING.md](CONTRIBUTING.md).
### פרסום גרסה חדשה
```bash
# יצירת גרסה — npm publish מתבצע אוטומטית
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 כוכבים
## 🌍 ממפה כוכבים
## 🙏 תודות
OmniRoute עומד על כתפיהם של ענקים. הוא התחיל כפיצול של **[9router](https://github.com/decolua/9router)** וכהסבה ל-TypeScript של פרויקט ה-Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — ומשם, כל תת-מערכת המופיעה להלן נוצרה בהשראת פרויקט קוד פתוח שהגיע לשם קודם. כל אחד מהם עיצב חלק ממשי ב-OmniRoute. זוהי התודה שלנו לכולם. 🙏
> ⭐ מספרי הכוכבים אומתו באמצעות REST API של GitHub ב-18 באוקטובר 2026 — לכו ותנו לפרויקטים האלה כוכב. המספרים הם תמונת מצב מדויקת לתאריך זה, ומטבע הדברים ישתנו.
### 🧬 שושלת ושער
מיפויי המודלים של Grok, מחולל Statsig עם TypeError מדומה, ברירות המחדל לבקשות ולהתקנים ומעבד תגובות ה-NDJSON שלו הותאמו באופן מהותי למבצע Grok Web של OmniRoute.
מקור עקיף שקיבל קרדיט מ-grok2api-merged עבור שכבת מאגר שרתי ה-proxy שלו; OmniRoute משמר את הודעת השושלת הזו, אך אינו טוען להסבת מאגר שרתי proxy במסגרת מבצע Grok Web המוגבל שלו.
המימוש המקורי של Grok Web הסתמך על תכנון החיבור שלו לשירותי HTTP/דפדפן במעלה הזרם; נתיב ה-HTTP הישיר שלו נגזר מ-GrokProxy, ולכן אין טענה להסבת קוד עצמאית.
הפרויקט הוויראלי "למה להשתמש בהרבה טוקנים כשמעט טוקנים עושים את העבודה" — פילוסופיית שפת-האדם-הקדמון שלו מניעה את מצב הדחיסה הסטנדרטי שלנו ויותר מ-30 כללי הסרת מילות מילוי ותמצות.
מיומנות הקידוד הוויראלית "מפתח בכיר עצלן" בגישת YAGNI — היוותה השראה לסגנון הפלט פחות קוד שלנו: הכוונה לשינוי הקטן ביותר שעובד, המצמצמת את הקוד _שנוצר_ (המקבילה בציר הפלט לפרוזה התמציתית של Caveman).
JSON עמודתי ב-Rust יחד עם אחזור ממוען-תוכן והסרת כפילויות בין הודעות — אימתו את תכנון מנועי headroom/ccr/session-dedup שלנו ואת האינווריאנט הידידותי למטמון שלפיו "הצורה הדחוסה אינה תלויה במיקום".
יירוט/ניתוח MITM של תעבורת עוזר קידוד ↔ LLM סייעו בגיבוש הדרישות הראשוניות ל-Traffic Inspector. ארבעה מודולים שנגזרו בעבר — מיזוג SSE, נרמול שיחות, מיסוך סודות וטיהור כותרות — הוחלפו במימושי clean-room עצמאיים המבוססים על תקני פרוטוקול ציבוריים. שני ממשקי העברת המארח (passthrough.ts ו-_internal/bypass.cjs) נותרו מימושים פנימיים של OmniRoute שסווגו באופן עצמאי; הם לא נכתבו מחדש כחלק מהחלפה זו.
ניתוב proxy שקוף לכל תהליך בנפרד — היווה השראה לפירוק MITM בטוח במקרה של קריסה, לזמני קצוב לחוסר פעילות של socket, לשיוך תהליכים באמצעות /proc וללכידת TPROXY.
> סיכום מונפש של העמוד החי `/dashboard/free-tiers`. מתודולוגיה מלאה (הסרת כפילויות מאגרים, מדרגות קרדיט, תנאי ספקים): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> הנתונים האלה נבדקים מחדש כל שבועיים מול הקטלוג החי ו**נעים לשני הכיוונים** — ספק מסיים שכבה חינמית והמספר יורד; ספק חדש נכנס והוא עולה. אנו מפרסמים את מה שהקטלוג באמת מחשב, ולעולם לא מקרה מיטבי מעוגל כלפי מעלה.
```bash
# לאחר חיבור ספק, העתק את מפתח ה-OmniRoute שלך מ-Dashboard → Endpoints:
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` זקוק למסלול זכאי. התקנה חדשה עשויה שלא לכלול יעדים ללא מפתח זכאים, וספק ללא מפתח עשוי לדחות לקוחות צד שלישי. ספקים המסומנים `tos: avoid`, כולל Kiro, מוחרגים מניתוב אוטומטי כברירת מחדל; חיבור חשבון אינו עוקף הגדרה זו. עיין ב[מדריך המסלולים החינמיים](docs/getting-started/FREE-TIERS-GUIDE.md) לפני בחירת ספק.
📦 סקריפטים מוכנים להעתקה-הדבקה להתחלה מהירה עבור **Python, Node.js, PHP ו-cURL** → [`examples/quickstart/`](examples/quickstart/)
> **קומבו** הוא שרשרת של מודלים ש-OmniRoute מנתב ביניהם **באופן אוטומטי**. אם המכסה אוזלת, ספק נכשל או שהעלויות מזנקות, הקומבו יכול לעבור למודל התקין והכשיר הבא. 🛡️
### ⚡ ללא הגדרות — פשוט השתמשו ב-`auto`
אין צורך ליצור קומבו. הגדירו את המודל שלכם ל-`auto` (או לגרסה אחרת שלו), ו-OmniRoute יבנה קומבו וירטואלי מהספקים המחוברים שלכם, עם ניקוד בזמן אמת:
📖 [מנוע Auto-Combo](docs/routing/AUTO-COMBO.md) · [מדריך עמידות](docs/architecture/RESILIENCE_GUIDE.md)
📊 המתודולוגיה המלאה ופרטים לפי תכונה בהשוואה ל-9router, OpenRouter, CLIProxyAPI ו-LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
מפתח (אקראי): `5d865059-bc44-483a-962d-43ceb80126eb`
העתקה והדבקה של Pix:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [הרשאות](docs/architecture/AUTHZ_GUIDE.md) · [אמצעי הגנה](docs/security/GUARDRAILS.md) · [תאימות](docs/security/COMPLIANCE.md)
קומבו מוערם כברירת מחדל מריץ `RTK → Caveman`. כאשר שניהם פועלים על אותו מטען (payload) של כלי/הקשר, החיסכון מצטבר:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
בלוקי קוד, כתובות URL, JSON ונתונים מובנים **תמיד מוגנים** על ידי מנוע השימור.
> **למה להשתמש בהרבה טוקנים כשמעט טוקנים עושים את העבודה?** כל בקשה עוברת דרך צינור הדחיסה של OmniRoute **באופן שקוף** — ללא שינויים בצד הלקוח. זהו כעת **מערך של 12 מנועים ניתנים להרכבה** שרצים לפי הסדר ומתמזגים ומתחלפים לפי כל קומבו ניתוב — בבנייה על רעיונות מ-[RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua), ו-[Troglodita](https://github.com/leninejunior/troglodita) (PT-BR).
### 🧱 מערך 12 המנועים
המנועים פועלים לפי סדר הצינור; כל אחד ניתן להפעלה/כיבוי בנפרד וניתן להגדרה לכל קומבו:
