# 🚀 OmniRoute — Η δωρεάν πύλη AI
**Δημιουργήθηκε από τον [Diego Souza](https://github.com/diegosouzapw)**
## 💰 ~1.62B Tokens / Μήνα Σε Δωρεάν Πακέτα Τρίτων
> **Χρησιμοποιήστε τους δικούς σας λογαριασμούς παρόχων.** Πρόκειται για εκτιμώμενο συνολικό άθροισμα από ξεχωριστά επιλέξιμα δωρεάν πακέτα τρίτων και όχι για παροχή tokens από το OmniRoute. Εγγραφείτε, αποκτήστε διαπιστευτήρια όπου απαιτείται και συνδέστε τους παρόχους που μπορείτε να χρησιμοποιήσετε· κάθε πάροχος ελέγχει τα όριά του, τη διαθεσιμότητα και τους όρους του.
>
> Η χειροκίνητη συνδυασμένη χρήση δωρεάν πακέτων είναι επίπονη — δεκάδες SDK, δεκάδες όρια ρυθμού και καμία σαφής εικόνα για το πόσα διαθέτετε πραγματικά. Το OmniRoute καταγράφει **465 εγγραφές δωρεάν πακέτων σε 34 επαναλαμβανόμενα κλειδιά pool** και υπολογίζει το συνολικό token από τα **17 pool με δημοσιευμένο θετικό μηνιαίο προϋπολογισμό, συν πέντε όρια 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) / [Πύλη](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Η πύλη συνεχίζει να μεγαλώνει
## 🆓 Εγκαταστήστε, συνδέστε έναν πάροχο και, στη συνέχεια, δρομολογήστε μέσω ενός endpoint
```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) πριν επιλέξετε πάροχο.📦 Scripts γρήγορης εκκίνησης για αντιγραφή και επικόλληση σε **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.54**. Πλήρες ιστορικό στο [`CHANGELOG.md`](CHANGELOG.md).
- **⚖️ Δρομολόγηση `quota-weighted`** — η 20ή στρατηγική συνδυασμού παραλείπει τους εξαντλημένους λογαριασμούς και, στη συνέχεια, επιλέγει μεταξύ των υπόλοιπων ανάλογα με το υπόλοιπο quota ÷ το φορτίο των αιτημάτων σε εξέλιξη, διατηρώντας τις υπάρχουσες συνομιλίες συνδεδεμένες με τον ίδιο λογαριασμό. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🧰 Λειτουργία χωρίς UI** — το `omniroute serve --headless` (ή `OMNIROUTE_HEADLESS=1`) εκτελεί μόνο τη μηχανή διαμεσολάβησης `/v1/*`, με τον πίνακα ελέγχου και τα υποσυστήματα που αφορούν αποκλειστικά τον πίνακα απενεργοποιημένα. → [Λειτουργία χωρίς UI](docs/guides/HEADLESS.md)
- **🔎 Εντοπισμός μοντέλων** — το `/v1/models` φιλτράρει βάσει δυνατότητας, περιβάλλοντος, τύπου και κειμένου, ενώ το `POST /v1/models/query` επιστρέφει μια σύντομη, ντετερμινιστική λίστα προεπιλογής με την ίδια ορατότητα ανά κλειδί. → [Αναφορά API](docs/reference/API_REFERENCE.md)
- **🔑 Έλεγχος δρομολόγησης ανά κλειδί** — συνδέστε ένα API key με ένα μοντέλο ή συνδυασμό χρησιμοποιώντας το `forcedModel` και προσθέστε ή αφαιρέστε ατομικά τα μοντέλα και τους συνδυασμούς ενός κλειδιού (`/api/keys/{id}/access`). → [Αναφορά API](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml)
- **🛡️ Λεπτομερέστεροι έλεγχοι PII** — επιλογή ανά τύπο, έως 20 επικυρωμένα προσαρμοσμένα μοτίβα απόκρυψης και μετρητές εντοπισμού ανά τύπο· η ίδια η απόκρυψη παραμένει προαιρετική. → [Guardrails](docs/security/GUARDRAILS.md)
- **🌍 67 γλώσσες** — πίνακας ελέγχου, αντικατοπτρισμένη τεκμηρίωση και CLI, με το `npm run i18n:add-locale` να προσθέτει μια γλώσσα παντού με μία εντολή. → [Οδηγός i18n](docs/guides/I18N.md)
- **🎛️ OmniConductor** — εισερχόμενη ανάθεση A2A στον στόλο των agent σας, δεξιότητες Conductor στην Agent Card και ένα πλαίσιο στον πίνακα ελέγχου με φωνητική συνομιλία 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 packs για DE / FR / JA και Κινεζικά (wényán), φίλτρα RTK για Gradle και .NET. → [Συμπίεση](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Ειλικρινές κόστος σταθερής χρέωσης** — οι πάροχοι συνδρομών / coding-plan εμφανίζονται με κόστος **$0** στα αναλυτικά στοιχεία κόστους· ο προϋπολογισμός, το quota και η δρομολόγηση εξακολουθούν να κάνουν εκτιμήσεις. → [Αναφορά API](docs/reference/API_REFERENCE.md)
- **⚖️ Δρομολόγηση Quota-Share** — κατανέμει δίκαια το quota ενός κοινόχρηστου λογαριασμού μεταξύ ομαδοποιημένων κλειδιών, αξιοποιώντας τους πόρους αποτελεσματικά ώστε τα αδρανή τμήματα να δανείζονται. → [Οδηγός ανθεκτικότητας](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Ρύθμιση CLI/agent με μία εντολή** — 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 με διακριτά tokens (`connect` / `contexts` / `tokens`) και έναν βοηθό OAuth `antigravity` για εγκαταστάσεις VPS. → [Απομακρυσμένη λειτουργία](docs/guides/REMOTE-MODE.md)
- **🧭 Εξυπνότερη αυτόματη δρομολόγηση** — συνδυασμοί `auto/:`, **Fusion** (πίνακας μοντέλων + κριτής), δρομολόγηση με επίγνωση εργασίας, παρακάμψεις μοντέλου / λειτουργίας / προϋπολογισμού USD ανά αίτημα. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **🗜️ Αρθρωτή συμπίεση** — 12 συνδυάσιμοι μηχανισμοί και Compression Studios: LLMLingua-2, Ultra δύο επιπέδων, omniglyph, πύλη πιστότητας ανά βήμα, GCF v3.2, επεξεργαστής μεταφοράς με drag-and-drop. → [Συμπίεση](docs/compression/COMPRESSION_ENGINES.md)
- **🕵️ Διαφανής αποκρυπτογράφηση MITM (TPROXY)** — CLI καταγραφής που αγνοούν τις μεταβλητές περιβάλλοντος proxy, με CA ανά SNI και πρόγραμμα εγκατάστασης trust store. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md)
- **💸 Τηλεμετρία κόστους παντού** — κεφαλίδες κόστους/χρήσης `X-OmniRoute-*` σε κάθε endpoint, κεφαλίδα εξοικονόμησης από cache HIT και quota δαπάνης USD ανά κλειδί. → [Αναφορά API](docs/reference/API_REFERENCE.md)
- **🧠 Μνήμη υπό τον έλεγχό σας** — απενεργοποιημένη από προεπιλογή, προαιρετική κβαντοποίηση διανυσμάτων int8 και typed decay, `x-omniroute-no-memory` ανά αίτημα. → [Μνήμη](docs/frameworks/MEMORY.md)
- **🛡️ Ασφάλεια** — προστασία από prompt injection σε κάθε διαδρομή LLM (σουίτα red-team), προαιρετική προστασία απόκρυψης διαπιστευτηρίων (αποκρύπτει διαρρεύσαντα API keys/secrets και προς τις δύο κατευθύνσεις), δωρεάν αναζήτηση ιστού DuckDuckGo ως έσχατη λύση και προαιρετική πύλη σύνδεσης OIDC για τον πίνακα ελέγχου (η σύνδεση με κωδικό πρόσβασης παραμένει πάντα διαθέσιμη). → [Guardrails](docs/security/GUARDRAILS.md)
- **🖼️ Νέα endpoints** — τα `/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, αυτόματος εντοπισμός γλώσσας προγράμματος περιήγησης, παρακολούθηση συσκευών ανά κλειδί, trust MITM χωρίς δικαιώματα root, τοπικοποίηση zh-TW. → [Περιβάλλον](docs/reference/ENVIRONMENT.md)
- **🤝 Περισσότεροι πάροχοι και agent** — cloud agent (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) με σύνδεση μέσω browser + OAuth, κάρτα πρώτης κατηγορίας για Ollama, Claude Opus 5 και Sonnet 5, επίσημη συνεργασία με την Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… και ανανεωμένος **κατάλογος 388 παρόχων**. → [Πάροχοι](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Διαφάνεια δρομολόγησης** — κάθε απόκριση περιλαμβάνει μια κεφαλίδα `X-OmniRoute-Decision` που αναφέρει τη στρατηγική/πάροχο/καθυστέρηση που την εξυπηρέτησε, μια νέα στρατηγική συνδυασμού `cache-optimized` και ο παράγοντας `cacheAffinity` του Auto-Combo δρομολογούν τα επαναλαμβανόμενα αιτήματα πίσω στη σύνδεση που διατηρεί το αποθηκευμένο πρόθεμα, ενώ ένα μόνο για ανάγνωση endpoint `/v1/auto-combo/{channel}/candidates` εκθέτει τη ζωντανή ομάδα υποψηφίων ενός καναλιού `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Τοπική απόδοση και υποδομή** — τοπικό Redis με ένα κλικ, deployers relay για Cloudflare Workers / Deno Deploy, Bifrost και Mux ως εποπτευόμενες ενσωματωμένες υπηρεσίες. → [Ενσωματωμένες υπηρεσίες](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Περιλαμβάνονται επίσης** — πλαίσιο προσθηκών και marketplace, πλαίσια δεξιοτήτων Omni/Agent/GitHub, ενσωμάτωση με θησαυροφυλάκιο Obsidian (22 εργαλεία MCP), API Batch και Files συμβατά με OpenAI, σημασιολογική cache αποκρίσεων, gamification με βαθμολογικούς πίνακες, ανακάλυψη πρακτόρων ACP (15 ενσωματωμένοι πράκτορες), προγραμματισμένη εξαγωγή αρχείων καταγραφής στο BigQuery, παράλληλο multi-model fan-out `auto/chaos`, γέφυρα bot Telegram, διαχειριστής εκδόσεων εντός της εφαρμογής και δωρεάν κατατάξεις παρόχων LMArena-ELO. → [Τεκμηρίωση](docs/README.md)
## 🤖 Συμβατά CLIs & Πράκτορες Κώδικα
> Μία ρύθμιση — `http://localhost:20128/v1` — και **κάθε** AI IDE ή CLI λειτουργεί με δωρεάν & οικονομικά μοντέλα.
+ λειτουργεί επίσης με · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · οποιοδήποτε εργαλείο συμβατό με OpenAI
📖 Ρύθμιση ανά εργαλείο για όλα τα 39 εργαλεία (28 CLI Code's + 11 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 λαμβάνουν ένα απομονωμένο προσωρινό home:
```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"
# Ή επιλέξτε provider+model διαδραστικά και γράψτε το δικό του αρχείο ρυθμίσεων:
omniroute configure codex # επίσης: claude opencode qwen aider goose gemini cline continue kilo 5dive
```
Κάθε εντολή σέβεται το ενεργό απομακρυσμένο context (`omniroute connect `), το `--dry-run`
προβάλλει το ακριβές env/args χωρίς εκτέλεση, και το `--api-key-env NAME` κρατά τα μυστικά
εκτός του ιστορικού του shell σας. → [Ενσωματώσεις CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 388 πάροχοι AI — 153 σημειωμένοι στον κατάλογο ως δωρεάν
> **388 εγγεγραμμένοι πάροχοι** στις κανονικές συλλογές συνομιλίας, πολυμέσων, αναζήτησης, τοπικών, cloud-agent και συστήματος, συμπεριλαμβανομένων **153 που διαθέτουν μεταδεδομένα ανακάλυψης `hasFree: true`**. Το μητρώο μοντέλων συνομιλίας καλύπτει **239 παρόχους / 3,059 διακριτά ζεύγη παρόχου-μοντέλου / 1,475 ακατέργαστα αναγνωριστικά μοντέλων**· ο ξεχωριστός κατάλογος δωρεάν προϋπολογισμού διαθέτει **471 γραμμές ανά μοντέλο**, **34 επαναλαμβανόμενες δεξαμενές** και **52 επαναλαμβανόμενους/χωρίς κλειδί δωρεάν παρόχους για πάντα**. Αυτοί είναι διαφορετικοί παρονομαστές εκ σχεδιασμού· οι ορισμοί και οι υπολογισμοί με αφαίρεση διπλοτύπων δεξαμενών βρίσκονται στην [Αναφορά παρόχων](docs/reference/PROVIDER_REFERENCE.md) και στις [Δωρεάν βαθμίδες](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. 📖 [Αναφορά παρόχων](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 του κώδικα VS
> Καμία νέα πλευρική γραμμή, καμία νέα συνομιλία UI — κάθε μοντέλο που εξυπηρετεί OmniRoute εμφανίζεται ακριβώς στο**Copilot Επιλογέας μοντέλου συνομιλίας που χρησιμοποιείτε ήδη** . Από τον κώδικα VS 1.122, τα μοντέλα παρόχων λειτουργούν χωρίς σύνδεση GitHub ή συνδρομή Copilot — λειτουργία πράκτορα, κλήση εργαλείου και όραση, δωρεάν.
Εγκαταστήστε το** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** επέκταση, τοποθετήστε το στον διακομιστή OmniRoute σας (προεπιλογή σε `localhost:20128`) και μετά ανοίξτε Copilot Chat → model picker →** Διαχείριση μοντέλων…** →**OmniRoute** .
Από το εσωτερικό του επεξεργαστή: ανοίξτε το** Επεκτάσεις** προβολή, αναζήτηση** "OmniRoute"** , κάντε κλικ** Εγκαθιστώ** — λειτουργεί με τον ίδιο τρόπο και στα δύο καταστήματα. Πηγή, τεύχη και το runbook εκδόσεων ζωντανά στο [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot).
📖 [VS Code Copilot Οδηγός συνομιλίας](docs/guides/VSCODE-COPILOT.md) — ρύθμιση, τι δείχνει ο επιλογέας, πίνακας ελέγχου σε καρτέλα, αντιμετώπιση προβλημάτων
### 🎩 Νέο: OmniRouteTray — η πύλη σας, που μένει στη γραμμή μενού
> `omniroute serve` είναι πιο χαρούμενο όταν είναι πάντα ανοιχτό.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** το μετατρέπει σε μια εφαρμογή γραμμής μενού set-and-forget για macOS: ξεκινά τον διακομιστή, τον διατηρεί ζωντανό κατά τις επανεκκινήσεις, τον ενημερώνει στη θέση του και τοποθετεί τον προϋπολογισμό του live token σας ένα κλικ μακριά —** κανένα παράθυρο τερματικού δεν έχει μείνει ανοιχτό, κανένα `npm install -g omniroute` για babysit.**
Κατασκευασμένο με [Tauri v2](https://v2.tauri.app/) (ένας πυρήνας Rust με μέγεθος σφάλματος στρογγυλοποίησης), αποστέλλει το δικό του υπογεγραμμένο χρόνο εκτέλεσης Node 24 και διαχειρίζεται μια εγκατάσταση OmniRoute που ανήκει στην εφαρμογή, ώστε να μην καταπολεμά ποτέ το παγκόσμιο `node`/`bun` σας. Το** μοιράζεται την υπάρχουσα διαμόρφωση `~/.omniroute/` και τη βάση δεδομένων σας** — άρα είναι το ίδιο OmniRoute που τρέχετε ήδη, μόνο με ένα καπέλο. 🎩
Τι κάνει
Πώς
🟢 Επιβλέπει τον διακομιστή
Δημιουργεί omniroute serve , υιοθετεί μια παρουσία που ήδη εκτελείται αντί να την αντιγράφει
📊 Ζωντανή χρήση με μια ματιά
Γραμμές ορίων παρόχου, όρια Claude session/weekly με αντίστροφες μετρήσεις επαναφοράς, ανάλυση κόστους 30 ημερών
🔄 Εφαρμόζονται αυτόματες ενημερώσεις
Σταδιακή εγκατάσταση, ατομική εναλλαγή, επαναφορά σε περίπτωση αποτυχίας — πάντα στη νεότερη έκδοση
🚀 Έναρξη κατά τη σύνδεση
Προαιρετική εκκίνηση κατά τη σύνδεση. μόνο σε δίσκο, χωρίς εικονίδιο βάσης
🩺 Doctor & καταγράφει
Διαγνωστικά με ένα κλικ και πρόσβαση στο αρχείο καταγραφής διακομιστή
```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, αρχιτεκτονική και υπολογισμός εξοικονόμησης
Ο προεπιλεγμένος συνδυασμός διαδοχικής εφαρμογής εκτελεί `RTK → Caveman`. Όταν και οι δύο εφαρμόζονται στο ίδιο payload εργαλείου/περιβάλλοντος, η εξοικονόμηση πολλαπλασιάζεται:
```txt
combined = 1 − (1 − RTK) × (1 − Caveman_input)
average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range = 78.4 – 94.6%
```
Τα μπλοκ κώδικα, τα URL, τα JSON και τα δομημένα δεδομένα προστατεύονται **πάντα** από τη μηχανή διατήρησης.
> **Γιατί να χρησιμοποιείτε πολλά tokens όταν αρκούν λίγα;** Κάθε αίτημα περνά **διαφανώς** από το pipeline συμπίεσης του 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 μηχανών
Οι μηχανές εκτελούνται με τη σειρά του pipeline· καθεμία μπορεί να ενεργοποιείται ή να απενεργοποιείται και να ρυθμίζεται ανεξάρτητα ανά συνδυασμό:
#
Μηχανή
Λειτουργία
1
Session-Dedup
Αφαιρεί περιεχόμενο που επαναλαμβάνεται μεταξύ διαδοχικών μηνυμάτων (με βάση το περιεχόμενο, μεταξύ διαδοχικών μηνυμάτων)
2
CCR
Αρχειοθετεί μεγάλα μπλοκ πίσω από δείκτες ανάκτησης, τα οποία ανακτώνται κατ’ απαίτηση
3
Lite
Περικοπή κενών και URL εικόνων (βασική λειτουργία με μικρή επιβάρυνση καθυστέρησης)
Πρώτα χωρίς απώλειες 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
Ευρετική αφαίρεση tokens με προαιρετική βαθμίδα μικρού μοντέλου (SLM)
12
OmniGlyph
Πειραματική κωδικοποίηση του περιβάλλοντος ως εικόνας για μετρημένο Claude Fable 5 μέσω του απευθείας wire της Anthropic· οι μετασχηματιστές GPT 5.6 παραμένουν σε κατάσταση ασφαλούς αποτυχίας εν αναμονή αποδείξεων από τον πάροχο. Τέσσερα προφίλ συμπίεσης (προεπιλεγμένο επιθετικό, ισορροπημένο, ασφαλές για κώδικα, passthrough) (το πιο επιθετικό· απαιτεί ρητή ενεργοποίηση)
Τα μπλοκ κώδικα, τα URL και τα δομημένα δεδομένα **διατηρούνται πάντα** byte-perfect. Τα **προκαθορισμένα με ένα κλικ** συνδυάζουν τις μηχανές:
Λειτουργία
Εξοικονόμηση
Ιδανική για
🪶 Lite
~15%
Ασφαλής προεπιλογή που παραμένει πάντα ενεργή
🪨 Standard (Caveman)
~30%
Καθημερινή ανάπτυξη κώδικα
⚡ Aggressive
~50%
Μεγάλες συνεδρίες με πολλά εργαλεία
🔥 Ultra
~75%
Μέγιστη εξοικονόμηση
🧰 RTK
60–90%
Έξοδος shell/test/build/git
🔗 Stacked (RTK → Caveman)
78–95%
Μεικτά prompts και αρχεία καταγραφής εργαλείων
**Πραγματικό παράδειγμα — λειτουργία Standard:**
> **Πριν (69 tokens):** _"Ο λόγος για τον οποίο το στοιχείο React σας επανασχεδιάζεται πιθανότατα είναι ότι δημιουργείτε μια νέα αναφορά αντικειμένου σε κάθε κύκλο απόδοσης. Όταν περνάτε ένα ενσωματωμένο αντικείμενο ως prop, η ρηχή σύγκριση του React το βλέπει ως διαφορετικό αντικείμενο κάθε φορά, γεγονός που ενεργοποιεί νέο render. Θα συνιστούσα να χρησιμοποιήσετε το useMemo για την απομνημόνευση του αντικειμένου."_
>
> **Μετά (19 tokens):** _"Νέα αναφορά αντικειμένου σε κάθε render. Inline object prop = νέα αναφορά = νέο render. Τυλίξτε το σε useMemo."_
>
> **Η ίδια απάντηση. 72% λιγότερα tokens. Μηδενική απώλεια ακρίβειας.** ✅
**Παράδειγμα PT-BR — λειτουργία [Troglodita](https://github.com/leninejunior/troglodita):**
> **Πριν (42 tokens):** _"Το πρόβλημα είναι ότι το component κάνει re-render επειδή δημιουργείται μια νέα αναφορά αντικειμένου σε κάθε κύκλο απόδοσης. Θα συνιστούσα να χρησιμοποιήσετε το useMemo."_
>
> **Μετά (12 tokens):** _"Re-render: νέα αναφορά σε κάθε κύκλο (το inline αντικείμενο αναδημιουργείται). Χρησιμοποιήστε `useMemo`."_
>
> **Η ίδια απάντηση. ~70% λιγότερα tokens. Η τεχνική ακρίβεια παραμένει ανέπαφη.** ✅
### 🎚️ Πέρα από τις μηχανές — στυλ εξόδου, ο προσαρμοστικός ρυθμιστής και ο έλεγχος ανά αίτημα
Οι 12 παραπάνω μηχανές συρρικνώνουν ό,τι **εισέρχεται**. Τρία ακόμη επίπεδα διαμορφώνουν **το πώς**, **το πότε** και τι **εξέρχεται**:
- **🪄 Στυλ εξόδου** _(καθοδήγηση στον άξονα εξόδου)_ — εισάγουν ντετερμινιστικές οδηγίες ασφαλείς για την cache, οι οποίες διαμορφώνουν την απόκριση· μπορούν να συνδυαστούν, καθεμία με ένταση `lite` / `full` / `ultra`. Η προσθήκη ενός στυλ απαιτεί μία γραμμή στην registry:
- **Συνοπτική πεζογραφία** — αφαιρέστε περιττά στοιχεία / άρθρα / επιφυλακτικές διατυπώσεις· διατηρήστε την τεχνική ουσία ακριβή.
- **Λιγότερος κώδικας** — YAGNI με τη λογική του «τεμπέλη senior dev»: η μικρότερη λειτουργική αλλαγή, χωρίς μη ζητημένο scaffolding.
- **Αλογοουρά (τεμπέλης senior dev)** — ανεβείτε τη σκάλα του YAGNI, διορθώστε τη βασική αιτία, με το μικρότερο λειτουργικό diff.
- **Έχω ADHD (πρώτα η ενέργεια)** — η επόμενη ενέργεια προηγείται, τα βήματα είναι αριθμημένα, υπάρχει ένα συγκεκριμένο επόμενο βήμα, χωρίς εισαγωγή.
- **Συνοπτικό CJK (文言)** — υπερβολικά συνοπτικό στυλ κλασικών κινεζικών (περιορίζεται βάσει locale στο `zh`).
- **🎯 Προσαρμοστικός προϋπολογισμός context** _(ο ρυθμιστής)_ — αντί για ένα μοναδικό κατώφλι token ενεργοποίησης/απενεργοποίησης, κλιμακώνει τις φθηνότερες και λιγότερο απωλεστικές μηχανές μόνο όσο χρειάζεται για να **χωρέσει το παράθυρο context του μοντέλου**. Πολιτική: `reserve-output` (προεπιλογή, με επίγνωση του μοντέλου) · `percentage` · `absolute`. Λειτουργία: `floor` (εγγυάται ότι χωράει) · `replace-autotrigger` (υπερισχύει η ρητή επιλογή σας) · `off` (παλαιό κατώφλι).
- **🎛️ Πού αποφασίζεται η συμπίεση** _(προτεραιότητα, από υψηλή → χαμηλή)_ — κεφαλίδα `x-omniroute-compression` ανά αίτημα › override συνδυασμού routing › ενεργό ονομασμένο profile › adaptive / auto-trigger › προεπιλογή panel › off. Το εφαρμοσμένο σχέδιο επιστρέφεται στην κεφαλίδα απόκρισης `X-OmniRoute-Compression: ; source=`.
Ενεργοποιήστε το auto-trigger βάσει κατωφλίου token, γυρίστε τον προσαρμοστικό ρυθμιστή, καρφιτσώστε ένα ονομασμένο profile, ορίστε μια εφάπαξ ρύθμιση ανά αίτημα ή αντιστοιχίστε ένα pipeline ανά συνδυασμό routing — ό,τι ταιριάζει στον φόρτο εργασίας. Ένα προαιρετικό offline **eval harness** (`npm run eval:compression`) βαθμολογεί την πιστότητα σε σχέση με την εξοικονόμηση σε ένα σταθερό 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; [Είναι ακίνδυνες](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Χρησιμοποιείτε npm 11 ή νεότερο;** Το npm ενδέχεται να αποκλείσει τα package lifecycle scripts, εκτός αν επιτραπεί η εκτέλεσή τους. Το `postinstall` του OmniRoute (`node scripts/build/postinstall.mjs`) απαιτείται για την προετοιμασία των εγγενών αρχείων runtime. Επιτρέψτε τα πακέτα που αναφέρονται στην προειδοποίηση του npm κατά την καθολική εγκατάσταση. Για το σύνολο πακέτων που αναφέρει το OmniRoute 3.8.54:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Για να επαναχρησιμοποιήσετε αυτή τη λίστα επιτρεπόμενων πακέτων σε μελλοντικές καθολικές εγκαταστάσεις, ρυθμίστε την μία φορά και έπειτα εγκαθιστάτε κανονικά:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Η λίστα εξαρτήσεων μπορεί να αλλάξει μεταξύ εκδόσεων· αν το npm αναφέρει διαφορετική λίστα, χρησιμοποιήστε τα ονόματα πακέτων από εκείνη την προειδοποίηση. Η έγκριση ενός πακέτου επιτρέπει την εκτέλεση των script εγκατάστασής του.
> **Χρησιμοποιείτε το Gemini Web ή άλλο πάροχο web-cookie;** Το πακέτο npm περιλαμβάνει
> το Playwright, αλλά όχι το δυαδικό αρχείο Chromium. Δείτε τη σημείωση
> [Ρύθμιση του Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> πριν από το πρώτο αίτημα προς πάροχο web.
Πίνακας ελέγχου στο `http://localhost:20128` · API στο `http://localhost:20128/v1`.
**2) Συνδέστε έναν κατάλληλο πάροχο χρησιμοποιώντας τον δικό σας λογαριασμό**
Πίνακας ελέγχου → **Πάροχοι** → επιλέξτε έναν πάροχο του οποίου οι τρέχοντες όροι και το όριο χρήσης ταιριάζουν στην περίπτωσή σας → προσθέστε το API key του ή ολοκληρώστε τη διαδικασία λογαριασμού του. Τα δωρεάν επίπεδα ενδέχεται να απαιτούν εγγραφή, έγκριση ή μέθοδο πληρωμής. Ανατρέξτε στον [Οδηγό δωρεάν επιπέδων](docs/getting-started/FREE-TIERS-GUIDE.md)· η διαθεσιμότητα χωρίς κλειδί δεν είναι εγγυημένη και οι πάροχοι με την ένδειξη `tos: avoid` εξαιρούνται από το `auto` από προεπιλογή.
**3) Ρυθμίστε το εργαλείο προγραμματισμού σας**
```txt
Βασικό URL: http://localhost:20128/v1
Κλειδί API: [αντιγράψτε το από τον Πίνακα ελέγχου → Endpoints]
Μοντέλο: auto (δρομολογεί μεταξύ κατάλληλων συνδέσεων — ή επιλέξτε πάροχο/μοντέλο)
```
**4) Επαληθεύστε ότι λειτουργεί**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Θα πρέπει να δείτε τα συνδεδεμένα μοντέλα σας. 🎉 Αυτό ήταν — ξεκινήστε να γράφετε κώδικα και το OmniRoute αναλαμβάνει αυτόματα το routing και το fallback για εσάς.
Αν το client σας δεν μπορεί να στείλει προσαρμοσμένες κεφαλίδες, το OmniRoute παρέχει επίσης aliases συμβατότητας με token:
```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
```
Χρησιμοποιήστε τα μόνο για clients που δεν μπορούν να επισυνάψουν `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. Δεν παρακολουθεί το 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 σήμερα.
Στρατηγική κάλυψης δοκιμών για περισσότερες από 60.000 στατικές δηλώσεις δοκιμών σε περισσότερα από 8.400 καταγεγραμμένα αρχεία δοκιμών
# ⭐ Κορυφαίοι συνεισφέροντες
> Το OmniRoute διαμορφώνεται από μια παθιασμένη κοινότητα ανοιχτού κώδικα. Αυτά τα άτομα έχουν πραγματοποιήσει εξαιρετικές συνεισφορές που επηρεάζουν άμεσα την ποιότητα, τη σταθερότητα και την απήχηση του έργου. **Σας ευχαριστούμε.**
### Εξωτερικοί συνεισφέροντες ανά συγχωνευμένα pull requests
Η απογραφή πραγματοποιήθηκε στις 2026-11-03 03:01:19 UTC με την τρέχουσα κορυφή του release/v3.8.5305bc048d6c. Η σελιδοποιημένη απογραφή GitHub GraphQL περιέχει 9.947 συγχωνευμένα PR: 4.130 από τον ιδιοκτήτη του αποθετηρίου, 240 από το Dependabot, 6 από άλλα bots/apps και 5.571 εξωτερικά PR από 883 διαφορετικούς συνεισφέροντες. Οι «αλλαγμένες γραμμές» είναι οι προσθήκες + διαγραφές του GitHub και περιλαμβάνουν παραγόμενα αρχεία, lockfiles, καταλόγους, μεταφράσεις και τεκμηρίωση· αντιπροσωπεύουν τον όγκο αλλαγών, όχι LOC που έχουν συνταχθεί από τους συγγραφείς. 53 PR αναφέρουν διαφορές του GitHub άνω των 500.000 γραμμών (για παράδειγμα το #13399, μια μεμονωμένη προσθήκη provider, αναφέρει 2.347 αλλαγμένα αρχεία), γεγονός που διογκώνει αρκετά από τα παραπάνω σύνολα. Οι ισοβαθμίες κατατάσσονται μαζί.
### Commits που αποδίδονται στο GitHub
Επανελέγχθηκε στις 2026-11-03 02:09:16 UTC: commit που αποδίδονται στο GitHub, όπως αναφέρθηκαν από το Contributors API του αποθετηρίου για τον προεπιλεγμένο κλάδο release/v3.8.53. Το API επέστρεψε 903 ταυτότητες (429 χρήστες, 2 bot, 472 ανώνυμες)· αυτός ο πίνακας εξαιρεί τον συντηρητή, τα bot και τις ανώνυμες ταυτότητες και διατηρεί τις ισοβαθμίες. Διαφέρει τόσο από την παραπάνω κατάταξη των συγχωνευμένων PR όσο και από την παρακάτω απογραφή των μεταδεδομένων του Git.
> 🙏 Οι δυνατότητες, οι διορθώσεις σφαλμάτων και οι βελτιώσεις υποδομής αυτών των συνεισφερόντων αποτελούν **βασικό μέρος** όσων κάνουν το OmniRoute αξιόπιστο και πλούσιο σε δυνατότητες. Κάθε pull request, κάθε περίπτωση δοκιμής και κάθε αρχείο μετάφρασης i18n έχει σημασία. Ο ανοιχτός κώδικας δημιουργείται από ανθρώπους σαν κι αυτούς.
---
## 💖 Χορηγοί
Ένα εγκάρδιο ευχαριστώ στους ανθρώπους που χρηματοδοτούν το OmniRoute από την τσέπη τους — κάθε συνεισφορά διατηρεί το έργο δωρεάν, ανεξάρτητο και σε διαρκή εξέλιξη.
… και άλλοι που προτιμούν να παραμείνουν ανώνυμοι 💛Οι δημόσιοι Χορηγοί GitHub επαληθεύτηκαν εκ νέου στις 2026-10-18 μέσω του GitHub Sponsors GraphQL API: 11 δημόσιες χορηγίες (6 ενεργές, 5 παλαιότερες) από 14 συνολικά. Η κατάσταση isActive του GitHub καθορίζει τις παραπάνω ενδείξεις ενεργών χορηγών· οι παλαιότεροι δημόσιοι εφάπαξ υποστηρικτές εξακολουθούν να αναφέρονται με ευχαριστίες, ενώ οι ιδιωτικοί χορηγοί παραμένουν ανώνυμοι. Οι δωρεές μέσω Ko-fi, Buy Me a Coffee, Liberapay, PIX και κρυπτονομισμάτων δεν αναφέρονται, επειδή δεν διαθέτουν δημόσια καταχώριση χορηγού.💖 Γίνετε χορηγός → — κάθε δολάριο διατηρεί το OmniRoute δωρεάν και ανεξάρτητο.
## 👥 1,000+ Συνεισφέροντες
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Ελεγχθεί στις 2026-11-02 στην ενεργή κορυφή release/v3.8.531c7135e0fb (7,972 commits): 1.074 κανονικοποιημένες ανθρώπινες ταυτότητες Git — 759 εμφανίζονται ως συντάκτες commits (συμπεριλαμβανομένου του συντηρητή) και 315 μόνο σε ρητές καταχωρίσεις Co-authored-by. Η απογραφή εφαρμόζει το .mailmap, συγκρίνει τις διευθύνσεις e-mail χωρίς διάκριση πεζών-κεφαλαίων, συνενώνει αριθμητικές και απλές διευθύνσεις noreply του GitHub μόνο όταν κωδικοποιούν το ίδιο handle, εξαιρεί 29 ταυτότητες bot/agent/service/placeholder και δεν συγχωνεύει συνηθισμένες διευθύνσεις e-mail απλώς επειδή τα εμφανιζόμενα ονόματά τους ταιριάζουν. Ο έλεγχος της 2026-08-24 δημοσίευσε 639· η επανεκτέλεση αυτής της μεθόδου στη βάση εκείνου του ελέγχου ac02c5b42f δίνει 619, επομένως η αύξηση προέρχεται από νέους συνεισφέροντες και όχι από λιγότερο αυστηρή μέθοδο.
### Πώς να συνεισφέρετε
1. Κάντε fork του αποθετηρίου
2. Δημιουργήστε branch από την **ενεργή** κορυφή `release/vX.Y.Z` (όχι από το `main`) — δείτε το [Μοντέλο διακλάδωσης και εκδόσεων](docs/ops/BRANCHING_MODEL.md)
3. Δημιουργήστε το branch της δυνατότητάς σας (`git checkout -b feat/amazing-feature`)
4. Κάντε commit των αλλαγών σας (`git commit -m 'feat: add amazing feature'`)
5. Κάντε push στο branch (`git push origin feat/amazing-feature`)
6. Ανοίξτε ένα Pull Request με **βάση = εκείνο το branch `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)** και ως port σε TypeScript του project σε Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — και από εκεί και έπειτα, κάθε παρακάτω υποσύστημα εμπνεύστηκε από ένα project ανοιχτού κώδικα που προηγήθηκε. Καθένα διαμόρφωσε ένα συγκεκριμένο κομμάτι του OmniRoute. Αυτή είναι η δική μας ευχαριστία προς όλα. 🙏
> ⭐ οι μετρήσεις αστεριών επαληθεύτηκαν μέσω του REST API του GitHub στις 3 Νοεμβρίου 2026 — δώστε ένα αστέρι σε αυτά τα projects. Οι μετρήσεις αποτελούν ακριβές στιγμιότυπο της συγκεκριμένης ημερομηνίας και φυσικά θα αλλάξουν.
### 🧬 Καταγωγή & gateway
Το AI gateway του οποίου το δημόσιο dataset τιμολόγησης τροφοδοτεί τον συγχρονισμό παρακολούθησης κόστους και του οποίου το μοντέλο κανονικοποίησης παρόχων επηρέασε το routing μας.
Πηγαίος κώδικας MIT, προσαρμοσμένος στη vendored γέφυρα ChatGPT Web → Codex Responses, συμπεριλαμβανομένων των adapters για browser session, framing αποκρίσεων, usage και web search.
Patterns που μεταφέρθηκαν στην ανάκτηση stream, στα aliases no-thinking, στην εφεδρική web search, στα όρια sliding-window, στην απόκρυψη log και στις ενισχυμένες ροές launcher.
Προεπιλογές μετασχηματισμού συμβατές με το Claude Code και συμπεριφορά billing header, γενικευμένες στη γέφυρα του OmniRoute που βασίζεται σε ρυθμίσεις.
Οι αντιστοιχίσεις μοντέλων Grok, η γεννήτρια fake-TypeError Statsig, οι προεπιλογές request και device και ο επεξεργαστής απόκρισης NDJSON προσαρμόστηκαν ουσιαστικά στον executor Grok Web του OmniRoute.
Η κύρια transitive πηγή κώδικα πίσω από το grok2api-merged· οι υλοποιήσεις μοντέλου, header, payload, Statsig και processor διατηρούνται στη γραμμή καταγωγής του Grok Web.
Ο υποκείμενος πηγαίος κώδικας MIT για τις προεπιλογές payload και device του Grok, τη γεννήτρια Statsig και τον processor result.response που μεταφέρθηκαν μέσω των TQZHR και grok2api-merged.
Μια transitive πηγή που αναγνωρίζεται από το grok2api-merged για το επίπεδο proxy-pool· το OmniRoute διατηρεί αυτή την αναφορά καταγωγής, αλλά δεν διεκδικεί port proxy-pool στον περιορισμένου εύρους executor Grok Web.
Η αρχική υλοποίηση Grok Web αποτέλεσε σημείο αναφοράς για τον σχεδιασμό HTTP/browser upstream· η άμεση διαδρομή HTTP προέρχεται από το GrokProxy, επομένως δεν διεκδικείται ανεξάρτητο port κώδικα.
Το viral έργο «γιατί να χρησιμοποιείς πολλά token όταν λίγα token κάνουν τη δουλειά» — η φιλοσοφία ομιλίας των caveman τροφοδοτεί την τυπική λειτουργία συμπίεσης και περισσότερους από 30 κανόνες αφαίρεσης/συμπύκνωσης περιττού περιεχομένου.
Συμπίεση εξόδου εντολών υψηλής απόδοσης — ενέπνευσε τη μηχανή RTK, το DSL φίλτρων JSON, την ανάκτηση ακατέργαστης εξόδου και τη στοιβαγμένη διοχέτευση RTK → Caveman.
Η viral δεξιότητα YAGNI-coder του «τεμπέλη senior developer» — ενέπνευσε το στυλ εξόδου less-code: καθοδήγηση με τη μικρότερη λειτουργική αλλαγή, που περιορίζει τον _παραγόμενο_ κώδικα (το αντίστοιχο στον άξονα εξόδου της συνοπτικής πεζής γλώσσας του Caveman).
Συμπίεση εξόδου με επίγνωση περιεχομένου ανά τύπο αρχείου, με πρόωρη εγκατάλειψη σε περίπτωση αποτυχίας — επικύρωσε τη δρομολόγηση ανά τύπο και την παράλειψη όταν το ελάχιστο κέρδος δεν επιτυγχάνεται.
Στηλοθετημένο JSON σε Rust + ανάκτηση βάσει περιεχομένου + αποδιπλοποίηση μεταξύ μηνυμάτων — επικύρωσε τον σχεδιασμό των μηχανών headroom/ccr/session-dedup και το σταθερό ως προς την cache αναλλοίωτο ότι η «συμπιεσμένη μορφή είναι ανεξάρτητη από τη θέση».
Η αναχαίτιση/ανάλυση MITM της κίνησης coding-assistant ↔ LLM ενημέρωσε τις αρχικές απαιτήσεις του Traffic Inspector. Τέσσερις μονάδες που είχαν προηγουμένως παραχθεί — συγχώνευση SSE, κανονικοποίηση συνομιλιών, απόκρυψη μυστικών και απολύμανση κεφαλίδων — έχουν αντικατασταθεί από ανεξάρτητες υλοποιήσεις clean-room, βασισμένες σε δημόσια πρότυπα πρωτοκόλλων. Οι δύο επιφάνειες host-passthrough (passthrough.ts και _internal/bypass.cjs) παραμένουν εσωτερικές υλοποιήσεις του OmniRoute, ταξινομημένες ανεξάρτητα· δεν επανεγγράφηκαν στο πλαίσιο αυτής της αντικατάστασης.
Διαφανής δρομολόγηση proxy ανά διεργασία — ενέπνευσε τον ασφαλή σε περίπτωση κατάρρευσης τερματισμό MITM, τα χρονικά όρια αδράνειας socket, την απόδοση διεργασιών μέσω /proc και τη σύλληψη TPROXY.
Μια επιμελημένη λίστα βιβλιοθηκών με ασφαλείς προεπιλογές, η οποία καθοδηγεί τις επιλογές ασφαλείας μας (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Ενέπνευσε την αποδιπλοποίηση αιτημάτων, την εφεδρική λύση έκτακτης ανάγκης μηδενικού κόστους, τις pluggable στρατηγικές Auto-Combo και την πολυγλωσσική ταξινόμηση προθέσεων.
Η αντιστοίχιση μοντέλων με επίγνωση λογαριασμού, η επικύρωση διαδρομής εκτελέσιμου αρχείου και η συμπεριφορά ετικετών προγράμματος ενημέρωσαν το runtime Antigravity του OmniRoute.
Εντόπισε την επιφάνεια ποσόστωσης του Grok Build· στη συνέχεια το OmniRoute επαλήθευσε και διόρθωσε ανεξάρτητα τη ζωντανή μορφή wire.
## 📄 Άδεια χρήσης
Άδεια MIT - δείτε το [LICENSE](LICENSE) για λεπτομέρειες.
---
**[⬆ Επιστροφή στην κορυφή](#-omniroute)** · Δημιουργήθηκε με ❤️ για την κοινότητα AI ανοιχτού κώδικα.
Δημιουργήθηκε από τον Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Άδεια MIT · omniroute.online