> שילוב ידני של מסלולים חינמיים הוא משימה מתישה — עשרות ערכות SDK, עשרות מגבלות קצב, ואין שום דרך לדעת כמה באמת עומד לרשותכם. OmniRoute מקטלגת **489 רשומות של מסלולים חינמיים על פני 35 מפתחות מאגרים מתחדשים**, ומחשבת את נתון הטוקנים הראשי מתוך **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 [🌍 גלובלי](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)**
## 📈 ה-Gateway ממשיך לצמוח
```bash
# התקנה טרייה, אפס אישורים — `auto` כבר עובד:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
מעדיף בקרת קצה חינמית ספציפית? קרא ל-`oc/…` (OpenCode Free) ישירות. לאחר מכן שדרג ל-`auto` ותן ל-OmniRoute לבחור.📦 סקריפטים מהירים של העתק-הדבק עבור **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
🧪 משקלי הזרקת תקלות לבדיקת עמידות (הנדסת כאוס)
##
### 🔀 או בנו קומבו משלכם — 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)
- **⚖️ ניתוב Quota-Share** — חלוקה הוגנת של מכסת חשבון משותף בין מפתחות במאגר, תוך שימור עבודה כך שחלקים שאינם בשימוש מושאלים לאחרים. → [מדריך עמידות](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`) + מסייע OAuth בשם `antigravity` עבור התקנות VPS. → [מצב מרוחק](docs/guides/REMOTE-MODE.md)
- **🧭 ניתוב אוטומטי חכם יותר** — שילובי `auto/:`, **Fusion** (פאנל מודלים + שופט), ניתוב מודע למשימה ועקיפות מודל / מצב / תקציב-USD לכל בקשה. → [Auto-Combo](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-*` בכל נקודת קצה, כותרת חיסכון עבור cache-HIT ומכסות הוצאה ב-USD לכל מפתח. → [תיעוד API](docs/reference/API_REFERENCE.md)
- **🧠 זיכרון בשליטתכם** — כבוי כברירת מחדל, קוונטיזציית וקטורים int8 ודעיכה מבוססת-טיפוס בהצטרפות יזומה, וכן `x-omniroute-no-memory` לכל בקשה. → [זיכרון](docs/frameworks/MEMORY.md)
- **🛡️ אבטחה** — הגנה מפני הזרקת הנחיות בכל נתיב LLM (חבילת בדיקות red-team), מנגנון הגנה אופציונלי למיסוך פרטי גישה (משחיר מפתחות 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… וכן **קטלוג מעודכן של 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)
## 🌐 357 ספקי AI — מתוכם 152 מסומנים בקטלוג כחינמיים
> **357 ספקים רשומים** באוספים הקנוניים של צ'אט, מדיה, חיפוש, הפעלה מקומית, סוכני ענן ומערכת, כולל **152 הנושאים מטא-נתוני גילוי מסוג `hasFree: true`**. מרשם מודלי הצ'אט מכסה **229 ספקים / 2,554 צמדי ספק-מודל ייחודיים / 1,283 מזהי מודל גולמיים**; קטלוג התקציבים החינמיים הנפרד כולל **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 1M טוקנים ליום
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 ללא אובדן תחילה + דחיסה תחומה של פלט אבחון מ-shell/patch/search/build (ממשק Responses API)
6
Headroom
דחיסה טבלאית ללא אובדן של מערכי JSON (~30%) באמצעות רכיב codec משולב מסוג 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 נותרים סגורים כברירת מחדל בהמתנה לאישורי ספק. ארבעה פרופילי דחיסה (אגרסיבי כברירת מחדל, מאוזן, בטוח לקידוד, מעבר ללא שינוי) (האגרסיבי ביותר; הצטרפות מפורשת)
בלוקי קוד, כתובות 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`. הוספת סגנון היא רשומה בת שורה אחת ברישום:
- **ניסוח תמציתי** — הסרת מלל מיותר / תוויות / הסתייגויות; שמירה מדויקת על המהות הטכנית.
- **פחות קוד** — YAGNI בסגנון "מפתח בכיר עצלן": השינוי הפעיל הקטן ביותר, ללא תשתית שלא התבקשה.
- **Ponytail (מפתח בכיר עצלן)** — התקדמות בסולם 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` או אזהרות peer-dep? [הן אינן מזיקות](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
לוח הבקרה נמצא ב-`http://localhost:20128` · ה-API נמצא ב-`http://localhost:20128/v1`.
**2) חיבור ספק חינמי (ללא הרשמה)**
לוח הבקרה → **ספקים** → חיבור **Kiro AI** (Claude בחינם, כ-50 קרדיטים בחודש לכל חשבון) או **OpenCode Free** (ללא אימות) → סיימתם.
**3) הפניית כלי התכנות שלך**
```txt
כתובת בסיס: 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.51 · Node ≥22.22.2 · רישיון MIT · omniroute.online
> תקציר מונפש של העמוד החי `/dashboard/free-tiers`. המתודולוגיה המלאה (מניעת ספירה כפולה של מאגרים, רמות קרדיט, תנאי ספקים): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> הנתונים האלה נבדקים מחדש מדי שבועיים מול הקטלוג החי, ו**נעים בשני הכיוונים** — ספק מסיים מסלול חינמי והמספר יורד; ספק חדש מצטרף והמספר עולה. אנחנו מפרסמים את מה שהקטלוג מחשב בפועל, ולעולם לא תרחיש מיטבי שעוגל כלפי מעלה.
```bash
# התקנה טרייה, אפס אישורים — `auto` כבר עובד:
curl http://localhost:20128/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'
```
מעדיף בקרת קצה חינמית ספציפית? קרא ל-`oc/…` (OpenCode Free) ישירות. לאחר מכן שדרג ל-`auto` ותן ל-OmniRoute לבחור.
📦 סקריפטים מהירים של העתק-הדבק עבור **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 המנועים
המנועים פועלים לפי סדר צינור העיבוד; ניתן להפעיל או להשבית ולהגדיר כל אחד מהם באופן עצמאי בכל צירוף:
