## 💰 כ־1.62 מיליארד טוקנים בחודש במסלולים חינמיים של צדדים שלישיים
> **הביאו חשבונות משלכם אצל הספקים.** זוהי הערכה מצטברת של מסלולים חינמיים נפרדים של צדדים שלישיים שאתם עשויים להיות זכאים להם, ולא הקצאת טוקנים מטעם OmniRoute. הירשמו, השיגו פרטי גישה במידת הצורך וחברו את הספקים שבהם תוכלו להשתמש; כל ספק שולט במגבלות, בזמינות ובתנאים שלו.
>
> שילוב ידני של מסלולים חינמיים הוא משימה מתישה — עשרות SDKs, עשרות מגבלות קצב וללא דרך לדעת כמה באמת עומד לרשותכם. OmniRoute מקטלגת **489 רשומות של מסלולים חינמיים על פני 35 מפתחות של מאגרים מתחדשים** ומחשבת את נתון הטוקנים הראשי מתוך **17 המאגרים בעלי תקציב חודשי חיובי שפורסם, בתוספת חמש מכסות Groq לפי מודל**, לאחר הסרת כפילויות לפי מאגר משותף. מכסות שנפתחות רק לאחר אימות זהות אזורי (נכון להיום: ModelScope) מוצגות בנפרד, כתוספת של כ־6 מיליון בכפוף לאימות זהות אזורי, ולעולם אינן נכללות בסכום הראשי. התוצאה נשארת גלויה בלוח הבקרה (`/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 [🌍 גלובלי](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 ברזיל](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [פורטל](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 השער ממשיך לצמוח
## 🆓 התקינו, חברו ספק ולאחר מכן נתבו דרך נקודת קצה אחת
```bash
# לאחר חיבור ספק, העתיקו את מפתח OmniRoute שלכם מלוח הבקרה ← נקודות קצה:
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`, כולל OpenCode Free ו-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/offline
🔋 המכסה / מרווח מגבלת הקצב הגדולים ביותר קודם
auto/smart
🔭 איכות קודם + 10% חקירה לגילוי מודלים טובים יותר
auto/lkgp
📌 היצמדות מפורשת לספק התקין האחרון הידוע
auto/chaos
🧪 פיזור מקבילי לפאנל מודלים (אחד לכל ספק, 5 כברירת מחדל), שמחזיר תשובה אחת; קריאה אחת לשירות במעלה הזרם לכל מודל בפאנל, לא הזרקת תקלות
##
### 🔀 או בנו קומבו משלכם — 19 אסטרטגיות ניתוב
כל **19** האסטרטגיות — אפשר לשלב ולהתאים בכל שלב בקומבו:
#
אסטרטגיה
מה היא עושה
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
reset-window
מעדיפה את היעד שחלון המכסה שלו יתאפס בהקדם
12
reset-aware
מדרגת לפי זמן איפוס המכסה — חלונות קצרים קודם 📊
13
context-relay
מעבירה הקשר בין יעדים בשיחות ארוכות 🧠
14
context-optimized
בוחרת את ההתאמה הטובה ביותר לגודל ההקשר הנוכחי
15
cache-optimized
מצמידה כל קידומת הנחיה שניתנת לשימוש חוזר לאותו חשבון — ממקסמת פגיעות במטמון ההנחיות 🎯
16
lkgp
הנתיב התקין האחרון הידוע — מצמידה לספק האחרון שהצליח, ואז חוזרת לכללי הגיבוי
17
auto
ניקוד בזמן אמת על בסיס 16 גורמים בכל חיבור 🤖
18
fusion
מפזרת את הבקשה לפאנל מודלים + שופט שמסנתז תשובה אחת 🧬
19
pipeline
משרשרת שלבים — הפלט של כל יעד מוזן ליעד הבא 🔗
מנוע ה-Auto-Combo מעניק לכל מועמד ניקוד על בסיס **16 גורמים** (תקינות, מכסה, עלות, זמן השהיה, התאמה למשימה, איכות, זמינות הפעלה…) — ראו [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 עמידות מובנית במערכת (3 שכבות עצמאיות)
📖 [מנוע שילוב אוטומטי](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.50**. ההיסטוריה המלאה נמצאת ב-[`CHANGELOG.md`](CHANGELOG.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 עבור DE / FR / JA וסינית (wényán), ומסנני RTK עבור Gradle ו-.NET. → [דחיסה](docs/compression/COMPRESSION_ENGINES.md)
- **💸 עלות כנה בתעריף קבוע** — ספקי מנויים / תוכניות קידוד מציגים עלות של **$0** בניתוח העלויות; התקציב, המכסה והניתוב ממשיכים לבצע הערכות. → [תיעוד API](docs/reference/API_REFERENCE.md)
- **⚖️ ניתוב לפי חלוקת מכסה** — חלוקה הוגנת של מכסת חשבון משותף בין מפתחות מאוגמים, תוך שימור עבודה כך שנתחים שאינם בשימוש מושאלים לאחרים. → [מדריך שרידות](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 הגדרת CLI/סוכן בפקודה אחת** — 13 פקודות `setup-*` רשומות; `omniroute run` מפעילה 7 כלי CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); הפקודה `omniroute configure` תומכת ב-10 יעדים, עם בורר אינטראקטיבי של ספק+מודל ומועדפים לכל הקשר. → [שילובי CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ מצב מרוחק** — שליטה ב-OmniRoute מרוחק באמצעות אסימונים מוגבלי-היקף (`connect` / `contexts` / `tokens`) וכלי עזר `antigravity` עבור OAuth בהתקנות VPS. → [מצב מרוחק](docs/guides/REMOTE-MODE.md)
- **🧭 ניתוב אוטומטי חכם יותר** — שילובי `auto/:`, **Fusion** (פאנל מודלים + שופט), ניתוב מודע-משימה ודריסות לפי בקשה של מודל / מצב / תקציב בדולר ארה"ב. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ דחיסה ניתנת להרחבה** — 12 מנועים הניתנים להרכבה + אולפני דחיסה: LLMLingua-2, Ultra דו-שכבתי, omniglyph, שער נאמנות לכל שלב, GCF v3.2 ועורך לסידור מחדש בגרירה. → [דחיסה](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ פענוח MITM שקוף (TPROXY)** — לכידת כלי CLI שמתעלמים ממשתני סביבת פרוקסי, עם CA לכל SNI ומתקין למאגר האישורים המהימנים. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 טלמטריית עלויות בכל מקום** — כותרות עלות/שימוש `X-OmniRoute-*` בכל נקודת קצה, כותרת חיסכון עבור cache-HIT ומכסות הוצאה בדולר ארה"ב לכל מפתח. → [תיעוד 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` עבור פרוקסי הפוך, זיהוי אוטומטי של שפת הדפדפן, מעקב אחר מכשירים לכל מפתח, אמון 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… ו**קטלוג מעודכן של 352 ספקים**. → [ספקים](docs/reference/PROVIDER_REFERENCE.md)
- **📡 שקיפות ניתוב** — כל תגובה כוללת כותרת `X-OmniRoute-Decision` המציינת את האסטרטגיה/הספק/זמן ההשהיה ששירתו אותה; אסטרטגיית שילוב חדשה `cache-optimized` יחד עם גורם Auto-Combo בשם `cacheAffinity` מנתבות בקשות חוזרות בחזרה לחיבור שמחזיק בקידומת השמורה במטמון; ונקודת קצה לקריאה בלבד, `/v1/auto-combo/{channel}/candidates`, חושפת את מאגר המועמדים החי של ערוץ `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ ביצועים ותשתית מקומיים** — Redis מקומי בלחיצה אחת, כלי פריסה של ממסרים עבור Cloudflare Workers / Deno Deploy, וכן Bifrost ו-Mux כשירותים משובצים ומפוקחים. → [שירותים משובצים](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 כלול בחבילה גם** — תשתית תוספים + זירת מסחר, תשתיות מיומנויות Omni/Agent/GitHub, שילוב עם כספת Obsidian (22 כלי MCP), ממשקי API תואמי OpenAI עבור Batch ו-Files, מטמון תגובות סמנטי, משחוק עם טבלאות מובילים, גילוי סוכני 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
📖 הגדרה ייעודית לכל אחד מ־36 הכלים (26 כלי קוד 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
```
כל פקודה מכבדת את ההקשר המרוחק הפעיל (`omniroute connect `), האפשרות `--dry-run`
מציגה תצוגה מקדימה של משתני הסביבה/הארגומנטים המדויקים ללא ביצוע, והאפשרות `--api-key-env NAME` מונעת מסודות
להופיע בהיסטוריית המעטפת שלכם. → [שילובי CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 ספקי AI — 154 מסומנים בקטלוג כחינמיים
> **372 ספקים רשומים** באוספים הקנוניים של צ'אט, מדיה, חיפוש, הרצה מקומית, סוכני ענן ומערכת, ובהם **154 הנושאים מטא-נתוני גילוי מסוג `hasFree: true`**. מרשם מודלי הצ'אט כולל **237 ספקים / 3,009 צמדים ייחודיים של ספק ומודל / 1,443 מזהי מודל גולמיים**; קטלוג התקציבים החינמיים הנפרד כולל **491 שורות לפי מודל**, **35 מאגרים מתחדשים** ו-**54 ספקים חינמיים לתמיד, מתחדשים/ללא מפתח**. המכנים האלה שונים זה מזה במכוון; ההגדרות והחישובים לאחר הסרת כפילויות בין מאגרים מופיעים ב[מדריך הספקים](docs/reference/PROVIDER_REFERENCE.md) וב[מסלולים החינמיים](docs/reference/FREE_TIERS.md).
### 🏢 כל מעבדת AI מובילה — דרך נקודת קצה אחת
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…ועוד 330+ — כל סמל נטען בזמן אמת מקטלוג הספקים של לוח הבקרה. 📖 [מדריך הספקים](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 חינם לתמיד — $0, ללא כרטיס
OpenCode Zen DeepSeek V4, Nemotron 3 ללא מגבלת טוקנים
Kilo Code נתב אוטומטי, 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 list # ← מופעל מול השרת המרוחק
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`. כאשר שניהם פועלים על אותו מטען של כלי/הקשר, החיסכון מצטבר:
```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 ללא אובדן בעדיפות ראשונה + דחיסת אבחון מוגבלת עבור פלטי מעטפת/תיקונים/חיפוש/בנייה (Responses API)
6
Headroom
דחיסה טבלאית ללא אובדן של מערכי JSON (~30%) באמצעות רכיב Codec מסוג GCF המשולב בפרויקט
7
Relevance
דירוג וחילוץ משפטים ביחס לשאילתת המשתמש האחרונה
8
Caveman
דחיסת טקסט מבוססת כללים (~65–75% בפלט)
9
Aggressive
סיכום + יישון הדרגתי של סבבים ישנים
10
LLMLingua-2
גיזום סמנטי מבוסס למידת מכונה באמצעות MobileBERT ONNX — בטוח לקוד ואסינכרוני
11
Ultra
גיזום טוקנים היוריסטי עם שכבת מודל קטן (SLM) אופציונלית
12
OmniGlyph
קידוד ניסיוני של הקשר כתמונה עבור Claude Fable 5 שנמדד בחיבור הישיר ל-Anthropic; הטרנספורמרים של GPT 5.6 נשארים במצב סגור כברירת מחדל עד לקבלת אישורי ספק. ארבעה פרופילי דחיסה (אגרסיבי כברירת מחדל, מאוזן, בטוח לקוד, מעבר ללא שינוי) (האגרסיבי ביותר; מחייב הצטרפות יזומה)
בלוקי קוד, כתובות URL ונתונים מובנים **נשמרים תמיד** בדיוק ברמת הבתים. **הגדרות מוכנות בלחיצה אחת** משלבות בין המנועים:
מצב
חיסכון
המתאים ביותר עבור
🪶 Lite
~15%
ברירת מחדל בטוחה שפועלת תמיד
🪨 Standard (Caveman)
~30%
כתיבת קוד יומיומית
⚡ Aggressive
~50%
הפעלות ארוכות עתירות כלים
🔥 Ultra
~75%
חיסכון מרבי
🧰 RTK
60–90%
פלט מעטפת/בדיקות/בנייה/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 בסגנון "מפתח בכיר עצלן": השינוי הפעיל הקטן ביותר, ללא תשתית שלא התבקשה.
- **קוקו (מפתח בכיר עצלן)** — טיפוס בסולם ה-YAGNI, תיקון שורש הבעיה, ה-diff הפעיל הקטן ביותר.
- **יש לי ADHD (פעולה תחילה)** — הפעולה הבאה מופיעה ראשונה, השלבים ממוספרים, צעד המשך קונקרטי אחד, ללא הקדמה.
- **CJK תמציתי (文言)** — סגנון סיני קלאסי ותמציתי במיוחד (מוגבל לאזור `zh`).
- **🎯 תקציב הקשר אדפטיבי** _(הבורר)_ — במקום סף אסימונים יחיד של הפעלה/כיבוי, מגביר את המנועים הזולים ביותר ובעלי אובדן המידע הנמוך ביותר רק במידה הנדרשת כדי **להיכנס לחלון ההקשר של המודל**. מדיניות: `reserve-output` (ברירת מחדל, מודעת למודל) · `percentage` · `absolute`. מצב: `floor` (הבטחת התאמה) · `replace-autotrigger` (הבחירה המפורשת שלך גוברת) · `off` (סף מהדור הקודם).
- **🎛️ היכן נקבעת הדחיסה** _(קדימות, מגבוה לנמוך)_ — כותרת `x-omniroute-compression` לכל בקשה › דריסה של שילוב ניתוב › פרופיל פעיל בעל שם › אדפטיבי / הפעלה אוטומטית › ברירת המחדל בלוח הבקרה › כבוי. התוכנית שהוחלה מוחזרת בכותרת התגובה `X-OmniRoute-Compression: ; source=`.
הפעילו הפעלה אוטומטית לפי סף אסימונים, הפעילו את הבורר האדפטיבי, קבעו פרופיל בעל שם, הגדירו בחירה חד-פעמית לכל בקשה, או הקצו צינור עיבוד לכל שילוב ניתוב — לפי מה שמתאים לעומס העבודה. **ערכת הערכה** לא מקוונת המחייבת הצטרפות (`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` או אזהרות על תלויות עמית? [הן אינן מזיקות](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **משתמשים ב-npm 11 או בגרסה מאוחרת יותר?** npm עשוי לחסום סקריפטים של מחזור חיי החבילה אלא אם הם מורשים. ה-`postinstall` של OmniRoute (`node scripts/build/postinstall.mjs`) נדרש להכנת קובצי זמן הריצה המקוריים שלו. בעת התקנה גלובלית, התירו את החבילות ששמותיהן מופיעים באזהרה של npm. עבור קבוצת החבילות שדווחה על ידי OmniRoute 3.8.51:
>
> ```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 או בספק אחר המבוסס על קובצי cookie מהאינטרנט?** חבילת npm כוללת את
> Playwright אך לא את הקובץ הבינארי של Chromium. עיינו בהערה בנושא
> [הגדרת Chromium עבור Playwright](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> לפני שליחת הבקשה הראשונה לספק אינטרנט.
לוח הבקרה נמצא ב-`http://localhost:20128` · ה-API נמצא ב-`http://localhost:20128/v1`.
**2) חיבור ספק מתאים באמצעות החשבון שלכם**
לוח הבקרה → **ספקים** → בחרו ספק שהתנאים והמכסה הנוכחיים שלו מתאימים לתרחיש השימוש שלכם → הוסיפו את מפתח ה-API שלו או השלימו את תהליך החיבור לחשבון. מסלולים חינמיים עשויים לדרוש הרשמה, אישור או אמצעי תשלום. עיינו ב-[מדריך המסלולים החינמיים](docs/getting-started/FREE-TIERS-GUIDE.md); זמינות ללא מפתח אינה מובטחת, וספקים המסומנים `tos: avoid` אינם נכללים כברירת מחדל ב-`auto`.
**3) הפניית כלי הפיתוח שלכם**
```txt
כתובת URL בסיסית: http://localhost:20128/v1
מפתח API: [העתיקו מלוח הבקרה → נקודות קצה]
מודל: auto (מנתב בין חיבורים מתאימים — או בחרו ספק/מודל)
```
**4) אימות שהמערכת פועלת**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
המודלים המחוברים שלכם אמורים להופיע ברשימה. 🎉 זה הכול — התחילו לכתוב קוד, ו-OmniRoute ינתב אוטומטית ויעבור לחלופה עבורכם.
אם הלקוח שלכם אינו יכול לשלוח כותרות מותאמות אישית, OmniRoute מספק גם כינויי תאימות הכוללים אסימון:
```txt
קטלוג OpenAI: http://localhost:20128/vscode/YOUR_KEY/
מודלי OpenAI: http://localhost:20128/vscode/YOUR_KEY/models
צ'אט OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions
תגובות OpenAI: http://localhost:20128/vscode/YOUR_KEY/responses
צ'אט Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat
תגיות Ollama: 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-08-24 · קטלוג גולמי: YT 809 | TT 137 | IG 124 · עדכניות (ימים): YT 1 | TT 21 | IG 22
אסטרטגיית כיסוי בדיקות עבור יותר מ-39,000 הצהרות בדיקה סטטיות ביותר מ-5,100 קובצי בדיקה במעקב
# ⭐ התורמים המובילים
> OmniRoute מעוצב בידי קהילת קוד פתוח חדורת תשוקה. אנשים אלה תרמו תרומות יוצאות דופן המשפיעות ישירות על האיכות, היציבות והתפוצה של הפרויקט. **תודה לכם.**
### תורמים חיצוניים לפי בקשות משיכה שמוזגו
הנתונים הוקפאו בקצה הפעיל של release/v3.8.50, ב-dafb4ae808, עם מיזוגים עד 2026-08-24 05:26:03 UTC. המפקד המחולק לעמודים של GitHub GraphQL כולל 5,911 בקשות משיכה שמוזגו: 2,707 מאת בעלי המאגר, 179 מאת Dependabot, ו-3,025 בקשות משיכה חיצוניות מאת 535 תורמים שונים. „שורות שהשתנו” הן סכום התוספות והמחיקות ב-GitHub, וכוללות קבצים שנוצרו אוטומטית, קובצי נעילה, קטלוגים, תרגומים ותיעוד; זהו מדד לתחלופת קוד, לא למספר שורות הקוד שנכתבו. שוויונות בנקודת החיתוך נשמרו.
### ביצועי commit המיוחסים ב-GitHub
נבדק מחדש ב-2026-08-24 06:14:31 UTC: קומיטים המיוחסים לחשבונות GitHub, כפי שדווחו על ידי Contributors API של המאגר עבור ענף ברירת המחדל release/v3.8.50. ה-API החזיר 525 זהויות (415 משתמשים, 2 בוטים, 108 אנונימיות); טבלה זו אינה כוללת את מתחזק הפרויקט, בוטים וזהויות אנונימיות, והיא משמרת תיקו בדירוג. היא נפרדת הן מדירוג בקשות המשיכה שמוזגו לעיל והן ממפקד מטא-נתוני Git של 639 אנשים להלן.
> 🙏 התכונות, תיקוני הבאגים ושיפורי התשתית של תורמים אלה הם **חלק מרכזי** ממה שהופך את OmniRoute לאמין ולעשיר בתכונות. כל בקשת משיכה, כל מקרה בדיקה וכל קובץ תרגום i18n חשובים. קוד פתוח נבנה בידי אנשים כמותם.
---
## 💖 נותני חסות
תודה מעומק הלב לאנשים שמממנים את OmniRoute מכיסם הפרטי — כל תרומה שומרת על הפרויקט חינמי, עצמאי ומתקדם.
… ואחרים שמעדיפים להישאר פרטיים 💛נותני החסות הציבוריים ב-GitHub אומתו מחדש בתאריך 2026-08-24. הסטטוס activeOnly של GitHub קובע את תוויות הפעילות שלעיל; תומכים ציבוריים חד-פעמיים שנחשפו בעבר עדיין זוכים לתודה, ונותני חסות פרטיים נשארים אנונימיים.💖 הצטרפות כנותן חסות ← — כל דולר שומר על OmniRoute חינמי ועצמאי.
## 👥 יותר מ-600 תורמים
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
נבדק בתאריך 2026-08-24 בבסיס הקפוא ac02c5b42f ונבדק מחדש בקצה הפעיל של release/v3.8.50, ב-dafb4ae808: 639 זהויות Git אנושיות מנורמלות — 407 מופיעות כמחברי commits (כולל מתחזק הפרויקט), ו-232 מופיעות רק בשורות Co-authored-by מפורשות. המפקד מנרמל שמות משתמש מסוג noreply של GitHub, מחריג 26 זהויות של בוטים/סוכנים/שירותים/מצייני מקום, ואינו ממזג כתובות דוא"ל רגילות רק משום ששמות התצוגה שלהן זהים.
### כיצד לתרום
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. פתחו בקשת משיכה כאשר **הבסיס = אותו ענף `release/vX.Y.Z`**
להנחיות מפורטות, ראו [CONTRIBUTING.md](CONTRIBUTING.md).
### פרסום גרסה חדשה
```bash
# יצירת גרסה — הפרסום ב-npm מתבצע אוטומטית
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 ב-24 באוגוסט 2026 — לכו ותנו כוכב לפרויקטים האלה. המספרים הם תמונת מצב מדויקת לתאריך שצוין, ומטבע הדברים ישתנו.
### 🧬 שושלת ושער גישה
מיפויי המודלים של Grok, מחולל Statsig המדמה TypeError, ברירות המחדל לבקשות ולהתקנים ומעבד תגובות ה-NDJSON שלו הותאמו באופן מהותי למבצע Grok Web של OmniRoute.
מקור עקיף ש-grok2api-merged מעניק לו קרדיט על שכבת מאגר שרתי ה-proxy שלו; OmniRoute משמר את הודעת הייחוס הזו, אך אינו טוען להסבה של מאגר שרתי proxy במבצע Grok Web התחום שלו.
הפרויקט הוויראלי "למה להשתמש בהרבה טוקנים כשמעט טוקנים עושים את העבודה" — פילוסופיית שפת איש המערות שלו מניעה את מצב הדחיסה הסטנדרטי שלנו ויותר מ-30 כללי הסרת מילות מילוי ותמצות.
מיומנות המקודד הוויראלית "מפתח בכיר עצלן" בגישת YAGNI — היוותה השראה לסגנון הפלט less-code שלנו: הכוונה לשינוי הקטן ביותר שעובד, המצמצמת קוד _שנוצר_ (האח המקביל בציר הפלט לפרוזה התמציתית של Caveman).
JSON עמודתי ב-Rust, אחזור ממוען-תוכן ומניעת כפילויות בין הודעות — אימתו את עיצוב מנועי headroom/ccr/session-dedup שלנו ואת האינווריאנט היציב למטמון שלפיו "הצורה הדחוסה אינה תלויה במיקום".
יירוט/ניתוח MITM של תעבורה בין מסייע קידוד ל-LLM תרם לעיצוב הדרישות המוקדמות של בודק התעבורה. ארבעה מודולים שנגזרו בעבר — מיזוג SSE, נרמול שיחות, מיסוך סודות וסניטציה של כותרות — הוחלפו במימושי clean-room עצמאיים המבוססים על תקני פרוטוקול ציבוריים. שני משטחי העברת המארח (passthrough.ts ו-_internal/bypass.cjs) נותרו מימושים פנימיים של OmniRoute שסווגו באופן עצמאי; הם לא נכתבו מחדש כחלק מהחלפה זו.
זיהה את ממשק המכסה של Grok Build; לאחר מכן OmniRoute אימת ותיקן באופן עצמאי את פורמט התקשורת הפעיל.
## 📄 רישיון
רישיון MIT — לפרטים נוספים, ראו [LICENSE](LICENSE).
---
**[⬆ חזרה לראש העמוד](#-omniroute)** · נבנה באהבה ❤️ עבור קהילת הבינה המלאכותית בקוד פתוח.
OmniRoute v3.8.52 · Node ≥22.22.2 · רישיון MIT · omniroute.online
> סיכום מונפש של עמוד `/dashboard/free-tiers` החי. המתודולוגיה המלאה (הסרת כפילויות בין מאגרים, מדרגות זיכוי, תנאי ספקים): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> הנתונים האלה נבדקים מחדש מדי שבועיים מול הקטלוג החי ויכולים **לנוע בשני הכיוונים** — ספק מסיים מסלול חינמי והמספר יורד; ספק חדש מצטרף והמספר עולה. אנחנו מפרסמים את מה שהקטלוג מחשב בפועל, ולעולם לא תרחיש מיטבי שעוגל כלפי מעלה.
```bash
# לאחר חיבור ספק, העתיקו את מפתח OmniRoute שלכם מלוח הבקרה ← נקודות קצה:
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`, כולל OpenCode Free ו-Kiro, מוחרגים כברירת מחדל מהניתוב האוטומטי; חיבור חשבון אינו עוקף הגדרה זו. עיינו ב[מדריך המסלולים החינמיים](docs/getting-started/FREE-TIERS-GUIDE.md) לפני בחירת ספק.
📦 סקריפטים להתחלה מהירה בהעתקה והדבקה עבור **Python, Node.js, PHP ו-cURL** ← [`examples/quickstart/`](examples/quickstart/)
> **קומבו** הוא שרשרת של מודלים ש-OmniRoute מנתב ביניהם **אוטומטית**. אם המכסה נגמרת, ספק נכשל או שהעלויות מזנקות, הקומבו יכול לעבור למודל התקין והכשיר הבא. 🛡️
### ⚡ ללא הגדרות — פשוט השתמשו ב-`auto`
אין צורך ליצור קומבו. הגדירו את המודל שלכם ל-`auto` (או לגרסה שלו), ו-OmniRoute יבנה קומבו וירטואלי מהספקים המחוברים שלכם, עם ניקוד בזמן אמת:
📖 [מנוע שילוב אוטומטי](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`. כאשר שניהם פועלים על אותו מטען של כלי/הקשר, החיסכון מצטבר:
```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 המנועים
המנועים פועלים לפי סדר צינור העיבוד; ניתן להפעיל או להשבית כל אחד מהם בנפרד ולהגדירו עבור כל שילוב:
