> **Φέρτε τους δικούς σας λογαριασμούς παρόχων.** Πρόκειται για εκτιμώμενο άθροισμα από ξεχωριστά επιλέξιμα δωρεάν επίπεδα τρίτων παρόχων, όχι για παραχώρηση tokens από το OmniRoute. Εγγραφείτε, αποκτήστε διαπιστευτήρια όπου απαιτείται και συνδέστε τους παρόχους που μπορείτε να χρησιμοποιήσετε· κάθε πάροχος ελέγχει τα όριά του, τη διαθεσιμότητα και τους όρους του.
>
> Η χειροκίνητη στοίβαξη δωρεάν επιπέδων είναι επίπονη — δεκάδες SDK, δεκάδες όρια ρυθμού και καμία ιδέα για το πόσα πραγματικά έχετε. Το OmniRoute καταγράφει **467 καταχωρίσεις δωρεάν επιπέδων σε 34 επαναλαμβανόμενα κλειδιά pool** και υπολογίζει τον τίτλο των tokens από τις **17 pools με δημοσιευμένο θετικό μηνιαίο προϋπολογισμό συν πέντε ανά μοντέλο όρια Groq**, χωρίς διπλοεγγραφές ανά κοινό pool. Τα όρια που ανοίγουν μόνο μετά από περιφερειακό έλεγχο ταυτότητας (σήμερα: ModelScope) εμφανίζονται ξεχωριστά, +~6M πίσω από περιφερειακή επαλήθευση ταυτότητας, και δεν αθροίζονται ποτέ στον τίτλο. Το αποτέλεσμα παραμένει ορατό στον πίνακα ελέγχου (`/dashboard/free-tiers`).
> Κινούμενη σύνοψη της ζωντανής σελίδας `/dashboard/free-tiers`. Πλήρης μεθοδολογία (αφαίρεση διπλοεγγραφών pool, βαθμίδες πιστώσεων, όροι παρόχων): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Αυτά τα στοιχεία επαναελέγχονται κάθε δύο εβδομάδες με τον ζωντανό κατάλογο και **κινούνται προς αμφότερες τις κατευθύνσεις** — ένας πάροχος τερματίζει ένα δωρεάν επίπεδο και ο αριθμός πέφτει· ένας νέος προστίθεται και ανεβαίνει. Δημοσιεύουμε ό,τι πραγματικά υπολογίζει ο κατάλογος, ποτέ μια στρογγυλοποιημένη προς τα πάνω βέλτιστη περίπτωση.
⭐ Κάντε star στο repo αν το OMNIROUTE σας βοήθησε να εξοικονομήσετε χρήματα και να κάνετε τη δουλειά σας ευκολότερη.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Γίνετε μέλος της κοινότητας
**👋 Ακολουθήστε τον maintainer — μάθετε πρώτοι για νέους παρόχους, εκδόσεις και συμβουλές:**
[](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)
**Ερωτήσεις, συμβουλές για παρόχους, roadmap και υποστήριξη → [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) / [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 να συνεχίσει να εξελίσσεται — και εμείς δηλώνουμε δημόσια πού αξιοποιείται κάθε token που μας παρέχουν. Επικοινωνήστε μαζί μας: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi Moonshot AI
Ευχαριστούμε την Kimi (Moonshot AI), τον ιδρυτικό μας Φίλο του Ανοιχτού Κώδικα, για την υποστήριξη αυτού του έργου! Η Kimi είναι το εργαστήριο τεχνητής νοημοσύνης πίσω από τις οικογένειες μοντέλων ανοιχτών βαρών K2 και K3 — το Kimi K3 προσφέρει παράθυρο περιβάλλοντος 1M token, εγγενή δυνατότητα όρασης και προγραμματισμό επιπέδου αιχμής με ένα κλάσμα του κόστους των κλειστών μοντέλων, ενώ λειτουργεί άμεσα με τα Claude Code, Codex και κάθε εργαλείο προγραμματισμού που εξυπηρετεί το OmniRoute.
Τι καθιστά δυνατή η υποστήριξη της Kimi: Οι πιστώσεις API της Kimi τροφοδοτούν τη ροή εκδόσεων του OmniRoute με επικύρωση μέσω AI — το στάδιο επικύρωσης συγχωνεύσεων με την υποστήριξη του 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: Chat Completions, το εγγενές τελικό σημείο /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: Chat Completions, μορφή επικοινωνίας συμβατή με το Anthropic και διαδρομή συμβατή με το OpenAI. Στα διαθέσιμα μοντέλα περιλαμβάνονται τα claude-opus-4-8, claude-opus-5, gpt-5.6-sol και άλλα. Αποκτήστε τα $100 σας →
⚠️ Σύνδεσμος συνεργάτη — το OmniRoute δεν έχει σχέση χορηγίας ή συνεργασίας με αυτόν τον πάροχο.
Γνωρίζετε κάποιον άλλο πάροχο με ένα γενναιόδωρο δωρεάν κουπόνι εγγραφής που θα ωφελούσε τους χρήστες του OmniRoute; Ανοίξτε ένα issue και θα το προσθέσουμε εδώ.
## 🎯 Combos — Η ναυαρχίδα
> Ένα **combo** είναι μια αλυσίδα μοντέλων μεταξύ των οποίων το OmniRoute δρομολογεί **αυτόματα**. Αν εξαντληθεί το όριο χρήσης, αποτύχει ένας πάροχος ή αυξηθεί απότομα το κόστος, το combo μπορεί να μεταβεί στο επόμενο κατάλληλο και λειτουργικό μοντέλο. 🛡️
### ⚡ Χωρίς ρυθμίσεις — χρησιμοποιήστε απλώς το `auto`
Δεν χρειάζεται να δημιουργήσετε combo. Ορίστε το μοντέλο σας σε `auto` (ή σε μια παραλλαγή του) και το OmniRoute δημιουργεί ένα εικονικό combo από τους συνδεδεμένους παρόχους σας, με αξιολόγηση σε πραγματικό χρόνο:
🧑💻 Συντελεστές με προτεραιότητα στην ποιότητα για παραγωγή κώδικα
auto/fast
⚡ Πρώτα η χαμηλότερη καθυστέρηση
auto/cheap
💰 Πρώτα το χαμηλότερο κόστος ανά token
auto/subscription
🎟️ Μόνο το όριο χρήσης της συνδρομής που ήδη πληρώνετε — τερματίζει με ασφάλεια, χωρίς ποτέ να καταφεύγει σε χρεώσιμη εναλλακτική (οδηγός)
auto/thrifty
🪜 Πρώτα το όριο χρήσης του προγράμματος και, στη συνέχεια, ένα επίπεδο κάθε φορά προς τις φθηνότερες επί πληρωμή επιλογές — επιστροφή στο πρόγραμμα μετά την επαναφορά του ορίου (οδηγός)
auto/offline
🔋 Πρώτα το μεγαλύτερο περιθώριο ορίου χρήσης / ορίου ρυθμού
auto/smart
🔭 Προτεραιότητα στην ποιότητα + 10% εξερεύνηση για την ανακάλυψη καλύτερων μοντέλων
auto/lkgp
📌 Ρητή προσκόλληση στον τελευταίο γνωστό αξιόπιστο πάροχο
auto/chaos
🧪 Παράλληλη διανομή σε μια ομάδα μοντέλων (ένα ανά πάροχο, 5 από προεπιλογή), η οποία επιστρέφει μία απάντηση· μία κλήση προς ανάντη υπηρεσία ανά μοντέλο της ομάδας, όχι εισαγωγή σφαλμάτων
##
### 🔀 Ή δημιουργήστε το δικό σας — 20 στρατηγικές δρομολόγησης
Και οι **20** στρατηγικές — συνδυάστε τις ελεύθερα σε κάθε βήμα του combo:
#
Στρατηγική
Τι κάνει
1
priority
Ταξινομημένη λίστα με προτεραιότητα στον πρώτο στόχο — εξαντλεί τον καθένα πριν προχωρήσει στον επόμενο 🥇
2
fill-first
Χρησιμοποιεί πλήρως το όριο χρήσης κάθε στόχου πριν προχωρήσει στον επόμενο
3
weighted
Σταθμισμένη τυχαία επιλογή βάσει του συντελεστή κάθε στόχου
4
round-robin
Κυκλική εναλλαγή μεταξύ των στόχων με τη σειρά
5
p2c
Τυχαία εξισορρόπηση φορτίου με τη μέθοδο επιλογής μεταξύ δύο
Ελαχιστοποιεί το κόστος $ ανά αίτημα βάσει των τιμών του καταλόγου σε πραγματικό χρόνο 💸
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 copia-e-cola:
```
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) και δεν πρέπει ποτέ να υποβληθεί — αν υποβληθεί κατά λάθος, αντικαταστήστε τυχόν εκτεθειμένα μυστικά και αφαιρέστε το αρχείο από το ιστορικό. Δείτε docs/DEVELOPER-ENVIRONMENT.md για οδηγίες σχετικά με τη διαχείριση τοπικών αρχείων περιβάλλοντος και μυστικών.
## 📡 OmniRoute Radar
Ο κύριος αριθμός για το δωρεάν επίπεδο παραμένει **~1.62B tokens/μήνα** από τον τεκμηριωμένο,
αποδιπλοποιημένο ανά pool κατάλογο παραπάνω. Οι προσωρινές πιστώσεις εγγραφής παρόχων μπορούν ξεχωριστά να αυξήσουν τον πρώτο
μήνα σε **~2.22B**. Το Radar είναι μια προαιρετική, υπογεγραμμένη επικάλυψη καταλόγου για όσους θέλουν πιο ενημερωμένη
διαθεσιμότητα δωρεάν μοντέλων μεταξύ των εκδόσεων του OmniRoute· ο κατάλογος της κοινότητας και κάθε υπάρχουσα δωρεάν
δυνατότητα παραμένουν δωρεάν.
Οι υποστηρικτές μπορούν να λαμβάνουν τον κατάλογο σε πραγματικό χρόνο και πρόσθετες ευκαιρίες από παρόχους. Το ξεχωριστό,
μεταβλητό ανώτατο όριό του είναι **περίπου 3B tokens/μήνα το πολύ**, ανάλογα με τη διαθεσιμότητα των παρόχων.
Αυτό το ανώτατο όριο δεν αποτελεί εγγύηση: οι πάροχοι μπορούν να αλλάξουν τα όρια χρήσης, τα κριτήρια επιλεξιμότητας, τα μοντέλα ή τις περιοχές
ανά πάσα στιγμή.
Το 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`) εκτελεί μόνο τη μηχανή διαμεσολάβησης `/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 στην Κάρτα Πράκτορα και ένας πίνακας ελέγχου με φωνητική συνομιλία push-to-talk 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/πράκτορα με μία εντολή** — 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** (πάνελ μοντέλων + κριτής), δρομολόγηση με επίγνωση εργασιών, παρακάμψεις μοντέλου / λειτουργίας / προϋπολογισμού USD ανά αίτημα. → [Αυτόματος συνδυασμός](docs/routing/AUTO-COMBO.md)
- **🗜️ Αρθρωτή συμπίεση** — 12 συνθέσιμες μηχανές + Compression Studios: 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, όρια δαπανών 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` αντίστροφου διακομιστή μεσολάβησης, αυτόματος εντοπισμός γλώσσας προγράμματος περιήγησης, παρακολούθηση συσκευών ανά κλειδί, εμπιστοσύνη MITM χωρίς δικαιώματα root, τοπικοποίηση zh-TW. → [Περιβάλλον](docs/reference/ENVIRONMENT.md)
- **🤝 Περισσότεροι πάροχοι και πράκτορες** — πράκτορες cloud (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), Batch & Files APIs συμβατά με OpenAI, σημασιολογική cache αποκρίσεων, παιχνιδοποίηση με πίνακες κατάταξης, ανακάλυψη πρακτόρων ACP (15 ενσωματωμένοι πράκτορες), προγραμματισμένη εξαγωγή αρχείων καταγραφής στο BigQuery, `auto/chaos` παράλληλη διανομή σε πολλαπλά μοντέλα, γέφυρα bot Telegram, διαχειριστής εκδόσεων εντός εφαρμογής και κατατάξεις δωρεάν παρόχων LMArena-ELO. → [Τεκμηρίωση](docs/README.md)
## 🤖 Συμβατά CLI & πράκτορες προγραμματισμού
> Μία ρύθμιση — `http://localhost:20128/v1` — και **κάθε** AI IDE ή CLI λειτουργεί με δωρεάν μοντέλα και μοντέλα χαμηλού κόστους.
＋ λειτουργεί επίσης με · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · οποιοδήποτε εργαλείο συμβατό με το OpenAI
📖 Ρύθμιση ανά εργαλείο και για τα 37 εργαλεία (27 CLI Code + 10 CLI Agents) → [`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 εγγεγραμμένοι πάροχοι** στις κανονικές συλλογές chat, media, search, local, cloud-agent και system, συμπεριλαμβανομένων **153 που φέρουν μεταδεδομένα ανακάλυψης `hasFree: true`**. Το μητρώο μοντέλων chat καλύπτει **239 παρόχους / 3,059 διακριτά ζεύγη παρόχου-μοντέλου / 1,475 ακατέργαστα IDs μοντέλων**· ο ξεχωριστός κατάλογος δωρεάν προϋπολογισμού έχει **467 γραμμές ανά μοντέλο**, **34 επαναλαμβανόμενες δεξαμενές** και **51 επαναλαμβανόμενους/χωρίς κλειδί παρόχους δωρεάν για πάντα**. Αυτοί είναι διαφορετικοί παρονομαστές εκ σχεδιασμού· οι ορισμοί και οι υπολογισμοί με αφαίρεση διπλότυπων δεξαμενών βρίσκονται στις [Provider Reference](docs/reference/PROVIDER_REFERENCE.md) και [Free Tiers](docs/reference/FREE_TIERS.md).
### 🏢 Κάθε μεγάλο εργαστήριο — μέσω ενός endpoint
OpenAI
Anthropic
Gemini
xAI Grok
DeepSeek
Mistral
Qwen
Meta Llama
Groq
NVIDIA
MiniMax
Cohere
Perplexity
HuggingFace
Together
Fireworks
Cloudflare
Baidu
…και 350+ ακόμη — κάθε εικονίδιο φορτώνεται ζωντανά από τον κατάλογο παρόχων του dashboard. 📖 [Provider Reference](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Δωρεάν για Πάντα — 0 $, χωρίς κάρτα
OpenCode Zen DeepSeek V4, Nemotron 3 Χωρίς ανώτατο όριο token
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 Δεν απαιτείται κλειδί
### 🧩 Νέο: Το OmniRoute μέσα στο εγγενές Copilot Chat του VS Code
> Χωρίς νέα πλαϊνή γραμμή, χωρίς νέο περιβάλλον συνομιλίας — κάθε μοντέλο που διαθέτει το OmniRoute εμφανίζεται απευθείας στον
> **επιλογέα μοντέλων του Copilot Chat που ήδη χρησιμοποιείτε**. Από το VS Code 1.122, τα μοντέλα παρόχων λειτουργούν
> χωρίς σύνδεση στο GitHub ή συνδρομή Copilot — λειτουργία agent, κλήση εργαλείων και όραση,
> δωρεάν.
Εγκαταστήστε την επέκταση **[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 που ρυθμίζετε μία φορά και ξεχνάτε: εκκινεί τον διακομιστή, τον διατηρεί ενεργό
> μετά από επανεκκινήσεις, τον ενημερώνει επί τόπου και σας παρέχει πρόσβαση στον τρέχοντα προϋπολογισμό token με ένα κλικ — **χωρίς
> να παραμένει ανοιχτό κάποιο παράθυρο τερματικού και χωρίς `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 endpoints παρέχονται στη διεύθυνση `http://localhost:20128`.
Διεπαφή
Endpoint / εντολή
Χρησιμοποιήστε το για
🧰 MCP (stdio)
omniroute --mcp
Σύνδεση με Claude Desktop, Cursor ή οποιοδήποτε πρόγραμμα-πελάτη MCP
Επικοινωνία πράκτορα προς πράκτορα, 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% tokens — αυτόματα
### 📖 Πώς λειτουργεί — pipeline, αρχιτεκτονική & μαθηματικά εξοικονόμησης
Ο προεπιλεγμένος συνδυασμός stacked εκτελεί `RTK → Caveman`. Όταν και τα δύο δρουν στο ίδιο φορτίο tool/context, η εξοικονόμηση πολλαπλασιάζεται:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Τα code blocks, τα URLs, το JSON και τα δομημένα δεδομένα **προστατεύονται πάντα** από τον μηχανισμό διατήρησης.
> **Γιατί να χρησιμοποιείτε πολλά tokens όταν λίγα κάνουν τη δουλειά;** Κάθε αίτημα περνά **διαφανώς** από το pipeline συμπίεσης του OmniRoute — χωρίς αλλαγές στον πελάτη. Τώρα είναι μια **στοίβα 12 συνθέσιμων μηχανισμών** που εκτελούνται με σειρά και συνδυάζονται ανά routing combo — βασισμένη σε ιδέες από [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 μηχανισμών
Οι μηχανισμοί εκτελούνται με τη σειρά του pipeline· ο καθένας ενεργοποιείται και ρυθμίζεται ανεξάρτητα ανά combo:
#
Μηχανισμός
Τι κάνει
1
Session-Dedup
Αφαιρεί περιεχόμενο που επαναλαμβάνεται μεταξύ γύρων (content-addressed, cross-turn)
2
CCR
Αρχειοθετεί μεγάλα μπλοκ πίσω από δείκτες ανάκτησης, που ανακτώνται κατά απαίτηση
3
Lite
Περικοπή κενών διαστημάτων + URL εικόνων (baseline ελαφρύ σε καθυστέρηση)
Συμπίεση JSON με προτεραιότητα στο lossless + οριοθετημένη διαγνωστική συμπίεση για έξοδο shell/patch/search/build (Responses API)
6
Headroom
Lossless συμπύκνωση πινάκων JSON arrays (~30%) μέσω ενσωματωμένου codec GCF
7
Relevance
Εξαγωγική βαθμολόγηση προτάσεων σε σχέση με το τελευταίο ερώτημα του χρήστη
8
Caveman
Συμπίεση πεζού λόγου βάσει κανόνων (~65–75% στην έξοδο)
9
Aggressive
Σύνοψη + προοδευτική γήρανση παλιών γύρων
10
LLMLingua-2
Σημασιολογικό κλάδεμα ML μέσω MobileBERT ONNX — code-safe, async
11
Ultra
Ευρετικό κλάδεμα tokens με προαιρετικό επίπεδο small-model (SLM)
12
OmniGlyph
Πειραματική κωδικοποίηση context-as-image για μετρημένο Claude Fable 5 στο άμεσο καλώδιο της Anthropic· τα transformers του GPT 5.6 παραμένουν fail-closed εν αναμονή αποδείξεων από τον πάροχο. Τέσσερα προφίλ συμπίεσης (aggressive default, balanced, coding-safe, passthrough) (το πιο επιθετικό· opt-in)
Τα code blocks, τα URLs και τα δομημένα δεδομένα **διατηρούνται πάντα** byte-perfect. Τα **presets ενός κλικ** συνδυάζουν τους μηχανισμούς:
Λειτουργία
Εξοικονόμηση
Ιδανικό για
🪶 Lite
~15%
Ασφαλές default, πάντα ενεργό
🪨 Standard (Caveman)
~30%
Καθημερινός προγραμματισμός
⚡ Aggressive
~50%
Μεγάλες συνεδρίες με πολλά εργαλεία
🔥 Ultra
~75%
Μέγιστη εξοικονόμηση
🧰 RTK
60–90%
Έξοδος shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
Μικτά prompts + αρχεία καταγραφής εργαλείων
**Πραγματικό παράδειγμα — Λειτουργία Standard:**
> **Πριν (69 tokens):** _"Ο λόγος που το React component σας κάνει re-render είναι πιθανότατα επειδή δημιουργείτε μια νέα αναφορά αντικειμένου σε κάθε κύκλο render. Όταν περνάτε ένα inline αντικείμενο ως prop, η ρηχή σύγκριση του React το βλέπει ως διαφορετικό αντικείμενο κάθε φορά, κάτι που προκαλεί re-render. Θα πρότεινα να χρησιμοποιήσετε useMemo για να αποθηκεύσετε το αντικείμενο."_
>
> **Μετά (19 tokens):** _"Νέα αναφορά αντικειμένου σε κάθε render. Inline prop αντικειμένου = νέα αναφορά = re-render. Τυλίξτε το σε useMemo."_
>
> **Ίδια απάντηση. 72% λιγότερα tokens. Μηδενική απώλεια ακρίβειας.** ✅
**Παράδειγμα PT-BR — λειτουργία [Troglodita](https://github.com/leninejunior/troglodita):**
> **Πριν (42 tokens):** _"O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo."_
>
> **Μετά (12 tokens):** _"Re-render: ref nova cada ciclo (objeto inline recriado). Usar `useMemo`."_
>
> **Ίδια απάντηση. ~70% λιγότερα tokens. Τεχνική ακρίβεια άθικτη.** ✅
### 🎚️ Πέρα από τις μηχανές — στυλ εξόδου, ο προσαρμοστικός δείκτης & έλεγχος ανά αίτημα
Οι 12 μηχανές παραπάνω συρρικνώνουν αυτό που μπαίνει **μέσα**. Τρία ακόμη επίπεδα διαμορφώνουν **πώς**, **πότε** και τι βγαίνει **έξω**:
- **🪄 Στυλ εξόδου** _(καθοδήγηση στον άξονα εξόδου)_ — έγχυση ντετερμινιστικών, ασφαλών για cache οδηγιών διαμόρφωσης απόκρισης· συνδυάσιμα, το καθένα σε ένταση `lite` / `full` / `ultra`. Η προσθήκη ενός στυλ είναι μία καταχώριση στο registry, μιας γραμμής:
- **Terse prose** — αφαίρεση filler / άρθρων / hedging· διατήρηση της τεχνικής ουσίας ακριβούς.
- **Less code** — "lazy senior dev" YAGNI: η μικρότερη λειτουργική αλλαγή, χωρίς αζήτητο scaffolding.
- **Ponytail (lazy senior dev)** — ανέβα τη σκάλα YAGNI, διόρθωσε τη ρίζα του προβλήματος, το μικρότερο λειτουργικό diff.
- **I have ADHD (action-first)** — η επόμενη ενέργεια οδηγεί, βήματα αριθμημένα, ένα συγκεκριμένο επόμενο βήμα, χωρίς preamble.
- **Terse CJK (文言)** — κλασικό κινεζικό ultra-terse στυλ (locale-gated στο `zh`).
- **🎯 Προσαρμοστικός προϋπολογισμός context** _(ο δείκτης)_ — αντί για ένα κατώφλι token on/off, κλιμάκωσε τις φθηνότερες, πιο lossless μηχανές μόνο όσο χρειάζεται για να **χωρέσει στο παράθυρο context του μοντέλου**. Πολιτική: `reserve-output` (προεπιλογή, model-aware) · `percentage` · `absolute`. Λειτουργία: `floor` (εγγύηση χωρητικότητας) · `replace-autotrigger` (η ρητή σου επιλογή υπερισχύει) · `off` (legacy κατώφλι).
- **🎛️ Πού αποφασίζεται η συμπίεση** _(προτεραιότητα, υψηλή → χαμηλή)_ — header `x-omniroute-compression` ανά αίτημα › παράκαμψη routing-combo › ενεργό επώνυμο profile › adaptive / auto-trigger › προεπιλογή πίνακα › off. Το εφαρμοσμένο πλάνο επιστρέφεται στο response header `X-OmniRoute-Compression: ; source=`.
Auto-trigger με κατώφλι token, ενεργοποίηση του adaptive δείκτη, καρφίτσωμα ενός επώνυμοu profile, ορισμός μιας μεμονωμένης ρύθμισης ανά αίτημα ή ανάθεση pipeline ανά routing combo — ό,τι ταιριάζει στο workload. Ένα opt-in offline **eval harness** (`npm run eval:compression`) βαθμολογεί fidelity vs. savings σε pinned corpus πριν προωθήσεις μια αλλαγή.
📖 [`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 warnings; [Είναι ακίνδυνα](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Χρησιμοποιείς npm 11 ή νεότερο;** Το npm μπορεί να μπλοκάρει τα lifecycle scripts των πακέτων εκτός αν επιτραπούν. Το `postinstall` του OmniRoute (`node scripts/build/postinstall.mjs`) απαιτείται για την προετοιμασία των native runtime αρχείων του. Επίτρεψε τα πακέτα που αναφέρονται στην προειδοποίηση του npm κατά την global εγκατάσταση. Για το σύνολο πακέτων που αναφέρει το OmniRoute 3.8.53:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Για να επαναχρησιμοποιήσεις αυτή τη λίστα επιτρεπόμενων σε μελλοντικές global εγκαταστάσεις, ρύθμισέ την μία φορά και μετά εγκατέστησε κανονικά:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Η λίστα εξαρτήσεων μπορεί να αλλάξει μεταξύ εκδόσεων· αν το npm αναφέρει διαφορετική λίστα, χρησιμοποίησε τα ονόματα πακέτων από εκείνη την προειδοποίηση. Η επιτρεψη σε ένα πακέτο επιτρέπει στα install scripts του να εκτελεστούν.
> **Χρησιμοποιείς Gemini Web ή άλλον web-cookie provider;** Το npm package περιλαμβάνει
> Playwright αλλά όχι το Chromium binary του. Δες τη
> σημείωση [Playwright Chromium setup](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> πριν κάνεις το πρώτο αίτημα web-provider.
Dashboard στο `http://localhost:20128` · API στο `http://localhost:20128/v1`.
**2) Σύνδεσε έναν κατάλληλο provider χρησιμοποιώντας τον δικό σου λογαριασμό**
Dashboard → **Providers** → διάλεξε έναν provider του οποίου οι τρέχοντες όροι και το quota ταιριάζουν στη χρήση σου → πρόσθεσε το API key του ή ολοκλήρωσε τη ροή του λογαριασμού του. Τα δωρεάν tiers μπορεί να απαιτούν εγγραφή, έγκριση ή μέθοδο πληρωμής. Δες τον [Free Tiers Guide](docs/getting-started/FREE-TIERS-GUIDE.md)· η keyless διαθεσιμότητα δεν είναι εγγυημένη, και οι providers με σήμανση `tos: avoid` εξαιρούνται από το `auto` εξ ορισμού.
**3) Στρέψε το coding tool σου**
```txt
Base URL: http://localhost:20128/v1
API Key: [αντιγραφή από Dashboard → Endpoints]
Model: auto (δρομολόγηση μεταξύ κατάλληλων συνδέσεων — ή διάλεξε provider/model)
```
**4) Επαλήθευσε ότι δουλεύει**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Θα πρέπει να δεις τα συνδεδεμένα μοντέλα σου στη λίστα. 🎉 Αυτό ήταν — ξεκίνα να γράφεις κώδικα, και το OmniRoute κάνει auto-routing & fallback για σένα.
Αν ο client σου δεν μπορεί να στείλει custom headers, το OmniRoute εκθέτει επίσης tokenized compatibility aliases:
```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
```
Χρησιμοποίησέ τα μόνο για clients που δεν μπορούν να προσαρτήσουν `Authorization: Bearer ...`. Το header auth παραμένει ο προτιμώμενος τρόπος.
## 📦 Περισσότερες μέθοδοι εγκατάστασης — 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. Δεν παρακολουθεί το git `main`. Καρφιτσώστε το `:X.Y.Z` για GitOps. Δείτε [Docker Release Channels](docs/guides/DOCKER_GUIDE.md#release-channels). Η εικόνα καρφιτσώνει **`OMNIROUTE_MEMORY_MB=1024`**. Αυτό είναι αρκετό για το dashboard και μια ελαφριά συνομιλία. Οι **πράκτορες κώδικα** (`POST /v1/responses` από Claude Code, Codex, Grok, …) χρειάζονται πολύ μεγαλύτερο heap V8, αλλιώς η διεργασία εμφανίζει `FATAL ERROR` στα ~12 GiB με δύο αλληλοεπικαλυπτόμενα μεγάλα πλαίσια. Μεγεθύνετε το container πάνω από το heap (οι native buffers βρίσκονται εκτός V8):
| Φόρτος εργασίας | Heap (`-e OMNIROUTE_MEMORY_MB`) | Container (`--memory`) |
| ------------------------------------- | ------------------------------- | ---------------------- |
| Dashboard / ελαφριά συνομιλία | `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 Guide — runtime RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents).
> **Κανάλι Docker προ-κυκλοφορίας:** Τα `diegosouzapw/omniroute:next` και
> `diegosouzapw/omniroute:next-web` ακολουθούν τον τρέχοντα προεπιλεγμένο κλάδο `release/v*`.
> Αυτές οι μεταβλητές ετικέτες προορίζονται μόνο για δοκιμή μη κυκλοφορημένων διορθώσεων και
> **δεν υποστηρίζονται για παραγωγή**. Δείτε
> [Docker Release Channels](docs/guides/DOCKER_GUIDE.md#release-channels).
**🥟 Bun**
Το τυπικό `bun install` και η καθολική εγκατάσταση (`bun install -g omniroute`) υποστηρίζονται μέσω ανίχνευσης χρόνου εκτέλεσης Bun:
- **Ενσωματωμένο `bun:sqlite`**: Το OmniRoute χρησιμοποιεί τον ενσωματωμένο οδηγό `bun:sqlite` του Bun όταν εκτελείται υπό Bun, με εναλλακτική χρήση του `better-sqlite3` σε Node.js ή `sql.js`.
- **Αυτόματη επιλογή bundler Webpack στη ανάπτυξη**: Η ανάπτυξη (`bun run dev`) ανιχνεύει αυτόματα το Bun και απενεργοποιεί το Turbopack υπέρ του Webpack για αποφυγή ασυμβατοτήτων native δεσμεύσεων V8. Οι builds παραγωγής (`bun run build`) ακολουθούν ακριβώς το `OMNIROUTE_USE_TURBOPACK` όπως στο Node: Turbopack από προεπιλογή, `OMNIROUTE_USE_TURBOPACK=0` για build με Webpack (το `Dockerfile.bun` το εκθέτει ως `--build-arg`).
- **Αποκλειστικό Bun Dockerfile**: Πολυσταδιακό `Dockerfile.bun` για native 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
# Χρήση Nix flakes
nix develop
npm run dev
# Ή χρήση devbox
devbox run npm run dev
```
📖 [Docker Guide](docs/guides/DOCKER_GUIDE.md) — Προφίλ Compose, Caddy HTTPS, tunnels Cloudflare.
**🦭 Podman**
```bash
# 1. Προετοιμασία του καταλόγου δεδομένων με bind-mount
mkdir -p data
# 2. Μόνο Linux + τοπικό rootless Podman (ποτέ απομακρυσμένο Podman Machine client):
podman unshare chown 1000:1000 ./data
# 3. Ορισμός της υπόδειξης χρόνου εκτέλεσης, build της τοπικής εικόνας 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 Guide](contrib/podman/README.md) — Builds Compose, Podman Machine και
ρύθμιση Linux/systemd Quadlet.
**⚡ Ταχύτερη / ελαφρύτερη εγκατάσταση (παράλειψη native build)**
Η native μηχανή SQLite (`better-sqlite3`) είναι **προαιρετική** εξάρτηση, οπότε μια καθολική
εγκατάσταση δεν εμποδίζεται ποτέ από μεταγλώττιση πηγαίου κώδικα: χρησιμοποιεί προκατασκευασμένο δυαδικό αρχείο όταν ταιριάζει με
την πλατφόρμα/Node σας, και διαφορετικά υποχωρεί διαφανώς σε καθαρή JS μηχανή
(`node:sqlite` σε Node 22+, αλλιώς στο ενσωματωμένο `sql.js` WASM) — δεν απαιτούνται εργαλεία build.
Για πλήρη παράλειψη της native προθέρμανσης μετά την εγκατάσταση (CI, headless ή αργά μηχανήματα):
```bash
OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1 επίσης την παραλείπει
```
Για τις ταχύτερες εγκαταστάσεις προτιμήστε το **pnpm** (αποθήκη με διευθυνσιοδότηση περιεχομένου + hard links — δείτε παραπάνω).
Για headless χρόνο εκτέλεσης χωρίς dashboard χρησιμοποιήστε το προφίλ `base` του Docker (παραπάνω) ή τον
[οδηγό Termux](docs/guides/TERMUX_GUIDE.md). Το CLI και το web dashboard εξυπηρετούνται από την
ίδια διεργασία σε μία θύρα, οπότε δεν υπάρχει ξεχωριστό πακέτο αποκλειστικά CLI σήμερα.
Στρατηγική κάλυψης δοκιμών για 56,000+ στατικές δηλώσεις δοκιμών σε 7,800+ παρακολουθούμενα αρχεία δοκιμών
# ⭐ Κορυφαίοι συνεισφέροντες
> Το OmniRoute διαμορφώνεται από μια παθιασμένη κοινότητα ανοιχτού κώδικα. Αυτά τα άτομα έχουν κάνει εξαιρετικές συνεισφορές που επηρεάζουν άμεσα την ποιότητα, τη σταθερότητα και την εμβέλεια του έργου. **Σας ευχαριστούμε.**
### Εξωτερικοί συνεισφέροντες με βάση τα συγχωνευμένα pull requests
Η απογραφή ελήφθη στις 2026-10-18 15:09:09 UTC με τρέχον tip 656f01cb43 του release/v3.8.52. Η σελιδοποιημένη απογραφή GitHub GraphQL περιέχει 9,191 συγχωνευμένα PR: 3,834 από τον ιδιοκτήτη του αποθετηρίου, 229 από το Dependabot, 6 από άλλα bots/apps και 5,122 εξωτερικά PR από 835 διαφορετικούς συνεισφέροντες. Οι «Αλλαγμένες γραμμές» είναι προσθέσεις + διαγραφές του GitHub και περιλαμβάνουν παραγόμενα αρχεία, lockfiles, καταλόγους, μεταφράσεις και τεκμηρίωση· είναι churn, όχι LOC που γράφτηκαν. 49 PR αναφέρουν διαφορές GitHub άνω των 500,000 γραμμών (για παράδειγμα το #13399, μια μεμονωμένη προσθήκη παρόχου, εμφανίζει 2,347 αλλαγμένα αρχεία), γεγονός που διογκώνει αρκετά από τα παραπάνω σύνολα. Οι ισοπαλίες κατατάσσονται μαζί.
### Commits που αποδίδονται στο GitHub
Επανελέγχθηκε στις 2026-10-18 14:44:45 UTC: commits που αποδίδονται στο GitHub, όπως αναφέρονται από το Contributors API του αποθετηρίου για τον προεπιλεγμένο κλάδο release/v3.8.52. Το API επέστρεψε 849 ταυτότητες (429 χρήστες, 2 bots, 418 ανώνυμες)· αυτός ο πίνακας εξαιρεί τον συντηρητή, τα bots και τις ανώνυμες ταυτότητες και διατηρεί τις ισοπαλίες κατάταξης. Διαφέρει τόσο από την παραπάνω κατάταξη βάσει συγχωνευμένων PR όσο και από την απογραφή μεταδεδομένων Git παρακάτω.
> 🙏 Οι λειτουργίες, οι διορθώσεις σφαλμάτων και οι βελτιώσεις υποδομής αυτών των συνεισφερόντων αποτελούν **βασικό μέρος** αυτού που κάνει το OmniRoute αξιόπιστο και πλούσιο σε λειτουργίες. Κάθε pull request, κάθε test case και κάθε αρχείο μετάφρασης i18n έχει σημασία. Το open source χτίζεται από ανθρώπους σαν αυτούς.
---
## 💖 Χορηγοί
Ένα εγκάρδιο ευχαριστώ στους ανθρώπους που χρηματοδοτούν το OmniRoute από την τσέπη τους — κάθε συνεισφορά διατηρεί το έργο δωρεάν, ανεξάρτητο και σε διαρκή εξέλιξη.
… και άλλοι που προτιμούν να παραμείνουν ανώνυμοι 💛Οι δημόσιοι Χορηγοί GitHub επαληθεύτηκαν εκ νέου στις 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, ad160ab2d1 (6.826 commits): 993 κανονικοποιημένες ανθρώπινες ταυτότητες Git — 707 εμφανίζονται ως συντάκτες commits (συμπεριλαμβανομένου του συντηρητή) και 286 μόνο σε ρητές καταχωρίσεις Co-authored-by. Η απογραφή εφαρμόζει το .mailmap, συγκρίνει τις διευθύνσεις e-mail χωρίς διάκριση πεζών-κεφαλαίων, συσχετίζει τις αριθμητικές και τις απλές διευθύνσεις GitHub noreply μόνο όταν κωδικοποιούν το ίδιο όνομα χρήστη, εξαιρεί 26 ταυτότητες bot/agent/service/placeholder και δεν συγχωνεύει συνηθισμένες διευθύνσεις e-mail απλώς και μόνο επειδή τα εμφανιζόμενα ονόματά τους συμπίπτουν. Ο έλεγχος της 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. Κάντε push στον κλάδο (`git push origin feat/amazing-feature`)
6. Ανοίξτε ένα Pull Request με **base = τον συγκεκριμένο κλάδο `release/vX.Y.Z`**
Ανατρέξτε στο [CONTRIBUTING.md](CONTRIBUTING.md) για λεπτομερείς οδηγίες.
### Δημοσίευση νέας έκδοσης
```bash
# Δημιουργήστε μια έκδοση — η δημοσίευση στο npm πραγματοποιείται αυτόματα
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes
```
## 📊 Αστέρια
## 🌍 StarMapper
## 🙏 Ευχαριστίες
Το OmniRoute στέκεται στους ώμους γιγάντων. Ξεκίνησε ως fork του **[9router](https://github.com/decolua/9router)** και ως μεταφορά σε TypeScript του έργου σε Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — και από εκεί και πέρα, κάθε υποσύστημα παρακάτω εμπνεύστηκε από ένα έργο ανοιχτού κώδικα που προηγήθηκε. Καθένα από αυτά διαμόρφωσε ένα συγκεκριμένο τμήμα του OmniRoute. Αυτές είναι οι ευχαριστίες μας προς όλα τους. 🙏
> ⭐ οι αριθμοί αστεριών επαληθεύτηκαν μέσω του REST API του GitHub στις 18 Οκτωβρίου 2026 — δώστε κι εσείς ένα αστέρι σε αυτά τα έργα. Οι αριθμοί αποτελούν ένα ακριβές στιγμιότυπο της συγκεκριμένης ημερομηνίας και φυσικά θα αλλάξουν.
### 🧬 Προέλευση & πύλη
Η πύλη AI της οποίας το δημόσιο σύνολο δεδομένων τιμολόγησης τροφοδοτεί τον συγχρονισμό παρακολούθησης κόστους και της οποίας το μοντέλο κανονικοποίησης παρόχων συνέβαλε στη διαμόρφωση της δρομολόγησής μας.
Πηγαίος κώδικας MIT που προσαρμόστηκε στην ενσωματωμένη γέφυρα ChatGPT Web → Codex Responses, συμπεριλαμβανομένων των προσαρμογέων συνεδρίας προγράμματος περιήγησης, πλαισίωσης αποκρίσεων, χρήσης και αναζήτησης στον ιστό.
Μοτίβα που μεταφέρθηκαν στην ανάκτηση ροής, στα ψευδώνυμα χωρίς συλλογισμό, στην εφεδρική αναζήτηση στον ιστό, στα όρια κυλιόμενου παραθύρου, στην απόκρυψη ευαίσθητων δεδομένων από τα αρχεία καταγραφής και στις ενισχυμένες ροές εκκίνησης.
Προεπιλεγμένοι μετασχηματισμοί συμβατοί με το Claude Code και συμπεριφορά κεφαλίδων χρέωσης, που γενικεύτηκαν στη γέφυρα του OmniRoute η οποία καθοδηγείται από τη διαμόρφωση.
Οι αντιστοιχίσεις μοντέλων Grok, η γεννήτρια Statsig με πλαστό TypeError, οι προεπιλογές αιτημάτων και συσκευών, καθώς και ο επεξεργαστής αποκρίσεων NDJSON προσαρμόστηκαν ουσιαστικά στον εκτελεστή Grok Web του OmniRoute.
Η κύρια μεταβατική πηγή κώδικα πίσω από το grok2api-merged· οι υλοποιήσεις μοντέλων, κεφαλίδων, ωφέλιμων φορτίων, Statsig και επεξεργαστών διατηρούνται στην προέλευση του Grok Web.
Η υποκείμενη πηγή MIT για τις προεπιλογές ωφέλιμου φορτίου και συσκευών του Grok, τη γεννήτρια Statsig και τον επεξεργαστή result.response που μεταφέρθηκε μέσω των TQZHR και grok2api-merged.
Μια μεταβατική πηγή στην οποία αποδίδει εύσημα το grok2api-merged για το επίπεδο δεξαμενής διακομιστών μεσολάβησης· το OmniRoute διατηρεί αυτήν την αναφορά προέλευσης, αλλά δεν ισχυρίζεται ότι μετέφερε δεξαμενή διακομιστών μεσολάβησης στον οριοθετημένο εκτελεστή Grok Web.
Ο διακομιστής μεσολάβησης Grok με έλεγχο ταυτότητας μέσω cookie και το μοτίβο ροής result.response.token συνέβαλαν στη διαμόρφωση του επιπέδου μεταφοράς Grok Web του OmniRoute.
Η αρχική υλοποίηση του Grok Web συμβουλεύτηκε τον σχεδιασμό ανοδικής σύνδεσης HTTP/προγράμματος περιήγησης αυτού του έργου· η άμεση διαδρομή HTTP προέρχεται από το GrokProxy, επομένως δεν υποστηρίζεται ότι πραγματοποιήθηκε ανεξάρτητη μεταφορά κώδικα.
Το viral έργο «γιατί χρησιμοποιείς πολλά token όταν λίγα token κάνουν δουλειά» — η φιλοσοφία της πρωτόγονης ομιλίας του τροφοδοτεί την τυπική λειτουργία συμπίεσής μας και πάνω από 30 κανόνες αφαίρεσης περιττών λέξεων/σύμπτυξης.
Έρευνα συμπίεσης προτροπών (LLMLingua / LLMLingua-2) — ενέπνευσε την ασύγχρονη, ασφαλή για κώδικα μηχανή llmlingua, η οποία σε περίπτωση αστοχίας επιτρέπει τη συνέχεια.
Συμπίεση token για τα Πορτογαλικά Βραζιλίας — τροφοδοτεί το πακέτο γλώσσας pt-BR: μείωση πλεονασμών και αφαίρεση περιττών λέξεων, προσαρμοσμένες στη γραμματική των Πορτογαλικών Βραζιλίας.
Η viral δεξιότητα προγραμματιστή YAGNI του «τεμπέλη senior dev» — ενέπνευσε το στυλ εξόδου λιγότερου κώδικα: καθοδήγηση προς τη μικρότερη λειτουργική αλλαγή, η οποία μειώνει τον _παραγόμενο_ κώδικα (το αντίστοιχο στον άξονα εξόδου της λακωνικής πρόζας του Caveman).
Αντικειμενοστρεφής σημειογραφία προσανατολισμένη σε token — το στηλοκεντρικό μοντέλο κεφαλίδας και γραμμών του διαμόρφωσε το στάδιο συμπύκνωσης πινάκων μας.
Συμπίεση εξόδου με επίγνωση περιεχομένου, ανά τύπο αρχείου, και διακοπή με επίγνωση αστοχίας — επιβεβαίωσε τη δρομολόγηση ανά τύπο και την παράλειψη όταν το όφελος είναι μικρότερο από το ελάχιστο.
Στηλοκεντρικό JSON σε Rust + ανάκτηση βάσει διεύθυνσης περιεχομένου + απαλοιφή διπλοτύπων μεταξύ μηνυμάτων — επιβεβαίωσε τον σχεδιασμό των μηχανών headroom/ccr/session-dedup και την αναλλοίωτη ιδιότητα, που διατηρεί σταθερή την κρυφή μνήμη, ότι «η συμπιεσμένη μορφή είναι ανεξάρτητη από τη θέση».
Εργαλειοθήκη TypeScript Compiler API — ενέπνευσε την αφαίρεση σχολίων βάσει αναλυτή, η οποία διατηρεί αλφαριθμητικά, πρότυπα και λεκτικά κανονικών εκφράσεων.
Η υποκλοπή/ανάλυση MITM της κίνησης μεταξύ βοηθού προγραμματισμού ↔ LLM διαμόρφωσε τις αρχικές απαιτήσεις του Επιθεωρητή Κίνησης. Τέσσερις μονάδες που είχαν προκύψει προηγουμένως — συγχώνευση SSE, κανονικοποίηση συνομιλιών, απόκρυψη μυστικών και εξυγίανση κεφαλίδων — έχουν αντικατασταθεί από ανεξάρτητες υλοποιήσεις καθαρού δωματίου, βασισμένες σε δημόσια πρότυπα πρωτοκόλλων. Οι δύο επιφάνειες παράκαμψης του κεντρικού υπολογιστή (passthrough.ts και _internal/bypass.cjs) παραμένουν εσωτερικές υλοποιήσεις του OmniRoute που ταξινομούνται ανεξάρτητα· δεν επανεγγράφηκαν στο πλαίσιο αυτής της αντικατάστασης.
Διαφανής δρομολόγηση μέσω διακομιστή μεσολάβησης ανά διεργασία — ενέπνευσε την ασφαλή σε περίπτωση κατάρρευσης κατάργηση του MITM, τα χρονικά όρια αδράνειας υποδοχών, την αντιστοίχιση διεργασιών μέσω /proc και τη δέσμευση TPROXY.
### 📚 Δεδομένα μοντέλων, παρατηρησιμότητα και διεπαφή χρήστη
Παρατηρησιμότητα πλέγματος υπηρεσιών Istio — ενέπνευσε τα σήματα διακοπτών κυκλώματος και τις οπτικές ενδείξεις ακμών σφαλμάτων στο Routing/Combo Studio.
Μια επιμελημένη λίστα βιβλιοθηκών που είναι ασφαλείς από προεπιλογή και καθοδηγεί τις επιλογές ασφαλείας μας (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Ενέπνευσε την αποδιπλοποίηση αιτημάτων, την εφεδρική λύση έκτακτης ανάγκης μηδενικού κόστους, τις επεκτάσιμες στρατηγικές Auto-Combo και την πολυγλωσσική ταξινόμηση προθέσεων.
Η επαναχαρτογράφηση μοντέλων με επίγνωση λογαριασμού, η επικύρωση διαδρομής εκτελέσιμου αρχείου και η συμπεριφορά ετικετών προγράμματος διαμόρφωσαν το περιβάλλον εκτέλεσης Antigravity του OmniRoute.
Εντόπισε την επιφάνεια ορίου χρήσης του Grok Build· στη συνέχεια, το OmniRoute επαλήθευσε και διόρθωσε ανεξάρτητα την ενεργή μορφή μετάδοσης.
## 📄 Άδεια
Άδεια MIT - δείτε το [LICENSE](LICENSE) για λεπτομέρειες.
---
**[⬆ Επιστροφή στην κορυφή](#-omniroute)** · Φτιαγμένο με ❤️ για την κοινότητα AI ανοιχτού κώδικα.
OmniRoute v3.8.53 · Node ≥22.22.2 · Άδεια MIT · omniroute.online
> Κινούμενη σύνοψη της ζωντανής σελίδας `/dashboard/free-tiers`. Πλήρης μεθοδολογία (αφαίρεση διπλοεγγραφών pool, βαθμίδες πιστώσεων, όροι παρόχων): **[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/)
> Ένα **combo** είναι μια αλυσίδα μοντέλων μεταξύ των οποίων το OmniRoute δρομολογεί **αυτόματα**. Αν εξαντληθεί το όριο χρήσης, αποτύχει ένας πάροχος ή αυξηθεί απότομα το κόστος, το combo μπορεί να μεταβεί στο επόμενο κατάλληλο και λειτουργικό μοντέλο. 🛡️
### ⚡ Χωρίς ρυθμίσεις — χρησιμοποιήστε απλώς το `auto`
Δεν χρειάζεται να δημιουργήσετε combo. Ορίστε το μοντέλο σας σε `auto` (ή σε μια παραλλαγή του) και το OmniRoute δημιουργεί ένα εικονικό combo από τους συνδεδεμένους παρόχους σας, με αξιολόγηση σε πραγματικό χρόνο:
📖 [Μηχανή 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 copia-e-cola:
```
00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD
```
📖 [Εξουσιοδότηση](docs/architecture/AUTHZ_GUIDE.md) · [Προστατευτικά Μέτρα](docs/security/GUARDRAILS.md) · [Συμμόρφωση](docs/security/COMPLIANCE.md)
Ο προεπιλεγμένος συνδυασμός stacked εκτελεί `RTK → Caveman`. Όταν και τα δύο δρουν στο ίδιο φορτίο tool/context, η εξοικονόμηση πολλαπλασιάζεται:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Τα code blocks, τα URLs, το JSON και τα δομημένα δεδομένα **προστατεύονται πάντα** από τον μηχανισμό διατήρησης.
> **Γιατί να χρησιμοποιείτε πολλά tokens όταν λίγα κάνουν τη δουλειά;** Κάθε αίτημα περνά **διαφανώς** από το pipeline συμπίεσης του OmniRoute — χωρίς αλλαγές στον πελάτη. Τώρα είναι μια **στοίβα 12 συνθέσιμων μηχανισμών** που εκτελούνται με σειρά και συνδυάζονται ανά routing combo — βασισμένη σε ιδέες από [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 μηχανισμών
Οι μηχανισμοί εκτελούνται με τη σειρά του pipeline· ο καθένας ενεργοποιείται και ρυθμίζεται ανεξάρτητα ανά combo:
