> **Χρησιμοποιήστε τους δικούς σας λογαριασμούς παρόχων.** Πρόκειται για μια εκτιμώμενη συνολική ποσότητα από ξεχωριστά διαθέσιμα δωρεάν πακέτα τρίτων παρόχων και όχι για παροχή tokens από το OmniRoute. Εγγραφείτε, αποκτήστε διαπιστευτήρια όπου απαιτείται και συνδέστε τους παρόχους που μπορείτε να χρησιμοποιήσετε· κάθε πάροχος ελέγχει τα όρια, τη διαθεσιμότητα και τους όρους του.
>
> Ο χειροκίνητος συνδυασμός δωρεάν πακέτων είναι επίπονος — δεκάδες SDK, δεκάδες όρια ρυθμού και καμία σαφής εικόνα για το πόσο διαθέσιμο όγκο έχετε πραγματικά. Το OmniRoute καταγράφει **489 καταχωρίσεις δωρεάν πακέτων σε 35 επαναλαμβανόμενα κλειδιά pool** και υπολογίζει τον συνολικό αριθμό tokens από τα **17 pool με δημοσιευμένο θετικό μηνιαίο όριο συν πέντε όρια Groq ανά μοντέλο**, με κατάργηση διπλοεγγραφών ανά κοινόχρηστο pool. Τα όρια που ενεργοποιούνται μόνο μετά από περιφερειακό έλεγχο ταυτότητας (σήμερα: ModelScope) εμφανίζονται ξεχωριστά, +~6 εκατ. πίσω από περιφερειακή επαλήθευση ταυτότητας, και δεν προστίθενται ποτέ στον κύριο συνολικό αριθμό. Το αποτέλεσμα παραμένει ορατό στον πίνακα ελέγχου (`/dashboard/free-tiers`).
> Κινούμενη σύνοψη της ζωντανής σελίδας `/dashboard/free-tiers`. Πλήρης μεθοδολογία (κατάργηση διπλοεγγραφών pool, επίπεδα πιστώσεων, όροι παρόχων): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**.
>
> Αυτά τα στοιχεία επανελέγχονται κάθε δύο εβδομάδες με βάση τον ζωντανό κατάλογο και **μεταβάλλονται και προς τις δύο κατευθύνσεις** — όταν ένας πάροχος καταργεί ένα δωρεάν πακέτο, ο αριθμός μειώνεται· όταν προστίθεται ένα νέο, αυξάνεται. Δημοσιεύουμε ό,τι υπολογίζει πραγματικά ο κατάλογος, ποτέ μια στρογγυλοποιημένη προς τα πάνω βέλτιστη περίπτωση.
⭐ Προσθέστε αστέρι στο αποθετήριο αν το OMNIROUTE σάς βοήθησε να εξοικονομήσετε χρήματα και να κάνετε την εργασία σας ευκολότερη.
[](https://github.com/diegosouzapw/OmniRoute)
[](https://www.star-history.com/diegosouzapw/omniroute)
[](https://olud.ai/project/diegosouzapw-omniroute.html)
### 💬 Γίνετε μέλος της κοινότητας
**👋 Ακολουθήστε τον συντηρητή — ενημερωθείτε πρώτοι για νέους παρόχους, εκδόσεις και συμβουλές:**
[](https://www.linkedin.com/in/diegosouzapw/)
[](https://github.com/diegosouzapw)
[](https://discord.gg/U47eFqAXCn)
[](https://t.me/omnirouteOficial)
[](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4)
[](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4)
[](https://omniroute.online)
**Ερωτήσεις, συμβουλές για παρόχους, οδικός χάρτης και υποστήριξη → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Παγκόσμιο](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Βραζιλία](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Πύλη](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Η Πύλη Συνεχίζει να Αναπτύσσεται
## 🆓 Εγκαταστήστε, συνδέστε έναν πάροχο και έπειτα δρομολογήστε μέσω ενός 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`, συμπεριλαμβανομένων των OpenCode Free και 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/offline
🔋 Πρώτα το μεγαλύτερο περιθώριο ορίου χρήσης / περιορισμού ρυθμού
auto/smart
🔭 Προτεραιότητα στην ποιότητα + 10% εξερεύνηση για την ανακάλυψη καλύτερων μοντέλων
auto/lkgp
📌 Ρητή προσήλωση στον τελευταίο γνωστό αξιόπιστο πάροχο
auto/chaos
🧪 Παράλληλη διανομή σε μια ομάδα μοντέλων (ένα ανά πάροχο, 5 από προεπιλογή), επιστρέφει μία απάντηση· μία κλήση προς ανάντη υπηρεσία ανά μοντέλο της ομάδας, όχι εισαγωγή σφαλμάτων
##
### 🔀 Ή δημιουργήστε το δικό σας — 19 στρατηγικές δρομολόγησης
Και οι **19** στρατηγικές — συνδυάστε τις ελεύθερα ανά βήμα του combo:
#
Στρατηγική
Τι κάνει
1
priority
Ταξινομημένη λίστα με προτεραιότητα στον πρώτο στόχο — εξαντλεί κάθε στόχο πριν προχωρήσει στον επόμενο 🥇
2
fill-first
Εξαντλεί πλήρως το όριο χρήσης κάθε στόχου πριν προχωρήσει στον επόμενο
3
weighted
Σταθμισμένη τυχαία επιλογή βάσει του βάρους κάθε στόχου
4
round-robin
Εναλλάσσεται κυκλικά μεταξύ των στόχων με τη σειρά
5
p2c
Τυχαία εξισορρόπηση φορτίου με επιλογή μεταξύ δύο στόχων
Ελαχιστοποιεί το $ ανά αίτημα βάσει των τιμών του καταλόγου σε πραγματικό χρόνο 💸
10
headroom
Επιλέγει τον στόχο με το μεγαλύτερο υπολειπόμενο όριο χρήσης
11
reset-window
Προτιμά τον στόχο του οποίου το χρονικό παράθυρο ορίου χρήσης επαναφέρεται συντομότερα
12
reset-aware
Κατατάσσει βάσει του χρόνου επαναφοράς του ορίου χρήσης — πρώτα τα σύντομα χρονικά παράθυρα 📊
13
context-relay
Μεταβιβάζει το περιεχόμενο μεταξύ στόχων για μεγάλες συνομιλίες 🧠
14
context-optimized
Επιλέγει την καλύτερη αντιστοίχιση για το τρέχον μέγεθος περιεχομένου
15
cache-optimized
Αντιστοιχίζει κάθε επαναχρησιμοποιήσιμο πρόθεμα προτροπής στον ίδιο λογαριασμό — μεγιστοποιεί τις επιτυχίες στην κρυφή μνήμη προτροπών 🎯
16
lkgp
Τελευταία γνωστή αξιόπιστη διαδρομή — παραμένει στον τελευταίο επιτυχημένο πάροχο και, στη συνέχεια, καταφεύγει στους κανόνες
17
auto
Αξιολόγηση 16 παραγόντων σε πραγματικό χρόνο για κάθε σύνδεση 🤖
18
fusion
Διανέμει το αίτημα σε μια ομάδα μοντέλων + ένας κριτής συνθέτει μία απάντηση 🧬
19
pipeline
Αλυσιδωτά βήματα — η έξοδος κάθε στόχου τροφοδοτεί τον επόμενο 🔗
Η μηχανή Auto-Combo αξιολογεί κάθε υποψήφιο βάσει **16 παραγόντων** (υγεία, όριο χρήσης, κόστος, καθυστέρηση, καταλληλότητα για την εργασία, ποιότητα, διαθεσιμότητα συνεδρίας…) — δείτε το [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).
##
### 🧱 Η ανθεκτικότητα είναι ενσωματωμένη (3 ανεξάρτητα επίπεδα)
📖 [Μηχανή αυτόματου συνδυασμού](docs/routing/AUTO-COMBO.md) · [Οδηγός ανθεκτικότητας](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Τι κάνει το OmniRoute να ξεχωρίζει
📊 Πλήρης μεθοδολογία & λεπτομέρειες ανά λειτουργία έναντι των 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Υποστήριξη του OmniRoute
Το OmniRoute διαθέτει άδεια MIT και συντηρείται δημόσια. Αν σας εξοικονομεί χρόνο ή χρήμα, δείτε πώς μπορείτε να το διατηρήσετε ανεξάρτητο — επιλέξτε ό,τι σας ταιριάζει. Η χορηγία δεν επηρεάζει ποτέ την προτεραιότητα δρομολόγησης· αγοράζει ορατότητα, όχι κατάταξη.
**🇧🇷 PIX** — άμεσα, χωρίς χρεώσεις (Βραζιλία)
Κλειδί (τυχαίο): `5d865059-bc44-483a-962d-43ceb80126eb`
Pix 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.50**. Πλήρες ιστορικό στο [`CHANGELOG.md`](CHANGELOG.md).
- **🎛️ OmniConductor** — εισερχόμενη ανάθεση A2A στον στόλο πρακτόρων σας, δεξιότητες Conductor στην Κάρτα Πράκτορα και ένας πίνακας ελέγχου με φωνητική συνομιλία push-to-talk μέσω Faro. → [Διακομιστής A2A](docs/frameworks/A2A-SERVER.md)
- **🛂 Προσαρμοστικός έλεγχος εισαγωγής & προστασία από υπερφόρτωση** — τα απαιτητικά αιτήματα συνομιλίας μπαίνουν σε ουρά αντί να επιστρέφουν 503, με ατομικές κυλιόμενες μισθώσεις RPM ανά σύνδεση. → [Οδηγός ανθεκτικότητας](docs/architecture/RESILIENCE_GUIDE.md)
- **🗂️ Κανονική ταξινόμηση του `/v1/models`** — ένα συνεχόμενο μπλοκ ομαδοποιημένο ανά πάροχο για κάθε πάροχο (με τα combos πρώτα), σταθερό σε κάθε πηγή καταλόγου. → [Αναφορά API](docs/reference/API_REFERENCE.md)
- **🗜️ Ενίσχυση της συμπίεσης** — προεπιλεγμένη προστασία από υπερβολική αποσυμπίεση, πακέτα Caveman για DE / FR / JA + Κινεζικά (wényán), φίλτρα RTK για Gradle & .NET. → [Συμπίεση](docs/compression/COMPRESSION_ENGINES.md)
- **💸 Ειλικρινές κόστος σταθερής χρέωσης** — οι πάροχοι συνδρομών / προγραμμάτων προγραμματισμού εμφανίζουν κόστος **$0** στις αναλύσεις κόστους· ο προϋπολογισμός, τα όρια χρήσης και η δρομολόγηση εξακολουθούν να κάνουν εκτιμήσεις. → [Αναφορά API](docs/reference/API_REFERENCE.md)
- **⚖️ Δρομολόγηση Quota-Share** — κατανέμει δίκαια το όριο χρήσης ενός κοινόχρηστου λογαριασμού μεταξύ συγκεντρωμένων κλειδιών, αξιοποιώντας πλήρως τους πόρους ώστε τα αδρανή μερίδια να παραχωρούνται προσωρινά. → [Οδηγός ανθεκτικότητας](docs/architecture/RESILIENCE_GUIDE.md)
- **🤖 Ρύθμιση CLI/πράκτορα με μία εντολή** — 13 καταχωρισμένες εντολές `setup-*`· το `omniroute run` εκκινεί 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI)· το `omniroute configure` υποστηρίζει 10 προορισμούς με διαδραστική επιλογή παρόχου+μοντέλου και αγαπημένα ανά περιβάλλον. → [Ενσωματώσεις CLI](docs/guides/CLI-INTEGRATIONS.md)
- **🛰️ Απομακρυσμένη λειτουργία** — χειριστείτε ένα απομακρυσμένο OmniRoute με διακριτικά περιορισμένου πεδίου (`connect` / `contexts` / `tokens`) + ένα βοηθητικό εργαλείο OAuth `antigravity` για εγκαταστάσεις σε VPS. → [Απομακρυσμένη λειτουργία](docs/guides/REMOTE-MODE.md)
- **🧭 Εξυπνότερη αυτόματη δρομολόγηση** — combos `auto/:`, **Fusion** (πάνελ μοντέλων + κριτής), δρομολόγηση με επίγνωση της εργασίας και παρακάμψεις μοντέλου / λειτουργίας / προϋπολογισμού USD ανά αίτημα. → [Auto-Combo](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-*` σε κάθε endpoint, κεφαλίδα εξοικονόμησης από cache-HIT και όρια δαπανών USD ανά κλειδί. → [Αναφορά API](docs/reference/API_REFERENCE.md)
- **🧠 Μνήμη που ελέγχετε εσείς** — απενεργοποιημένη από προεπιλογή, προαιρετική κβαντοποίηση διανυσμάτων int8 + τυποποιημένη εξασθένηση, `x-omniroute-no-memory` ανά αίτημα. → [Μνήμη](docs/frameworks/MEMORY.md)
- **🛡️ Ασφάλεια** — προστασία από prompt injection σε κάθε διαδρομή LLM (σουίτα red-team), προαιρετικός μηχανισμός απόκρυψης διαπιστευτηρίων (απαλείφει κλειδιά API/μυστικά που έχουν διαρρεύσει και προς τις δύο κατευθύνσεις), δωρεάν αναζήτηση ιστού μέσω DuckDuckGo ως έσχατη λύση και προαιρετική πύλη σύνδεσης OIDC για τον πίνακα ελέγχου (η σύνδεση με κωδικό πρόσβασης παραμένει πάντα διαθέσιμη). → [Μηχανισμοί προστασίας](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` αντίστροφου διακομιστή μεσολάβησης, αυτόματος εντοπισμός της γλώσσας του προγράμματος περιήγησης, παρακολούθηση συσκευών ανά κλειδί, εμπιστοσύνη 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… και ένας ανανεωμένος **κατάλογος 352 παρόχων**. → [Πάροχοι](docs/reference/PROVIDER_REFERENCE.md)
- **📡 Διαφάνεια δρομολόγησης** — κάθε απόκριση περιλαμβάνει μια κεφαλίδα `X-OmniRoute-Decision` που κατονομάζει τη στρατηγική/τον πάροχο/την καθυστέρηση που την εξυπηρέτησε, μια νέα στρατηγική combo `cache-optimized` + ο παράγοντας Auto-Combo `cacheAffinity` δρομολογούν τα επαναλαμβανόμενα αιτήματα πίσω στη σύνδεση που διατηρεί το αποθηκευμένο πρόθεμα, ενώ ένα endpoint μόνο για ανάγνωση `/v1/auto-combo/{channel}/candidates` εκθέτει το ενεργό σύνολο υποψηφίων ενός καναλιού `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md)
- **⚡ Τοπική απόδοση & υποδομή** — τοπικό Redis με ένα κλικ, εργαλεία ανάπτυξης relay για Cloudflare Workers / Deno Deploy, Bifrost & Mux ως εποπτευόμενες ενσωματωμένες υπηρεσίες. → [Ενσωματωμένες υπηρεσίες](docs/frameworks/EMBEDDED-SERVICES.md)
- **🧩 Περιλαμβάνονται επίσης** — πλαίσιο προσθηκών + marketplace, πλαίσια δεξιοτήτων Omni/Agent/GitHub, ενσωμάτωση θησαυροφυλακίου Obsidian (22 εργαλεία MCP), API Batch & Files συμβατά με OpenAI, σημασιολογική cache αποκρίσεων, παιχνιδοποίηση με πίνακες κατάταξης, ανακάλυψη πρακτόρων ACP (15 ενσωματωμένοι πράκτορες), προγραμματισμένη εξαγωγή αρχείων καταγραφής στο BigQuery, παράλληλη διασπορά σε πολλαπλά μοντέλα μέσω `auto/chaos`, γέφυρα bot για το Telegram, διαχειριστής εκδόσεων εντός της εφαρμογής και κατατάξεις δωρεάν παρόχων LMArena-ELO. → [Τεκμηρίωση](docs/README.md)
## 🤖 Συμβατά CLI & Agents Προγραμματισμού
> Μία ρύθμιση — `http://localhost:20128/v1` — και **κάθε** AI IDE ή CLI λειτουργεί με δωρεάν μοντέλα και μοντέλα χαμηλού κόστους.
＋ λειτουργεί επίσης με · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · οποιοδήποτε εργαλείο συμβατό με το OpenAI
📖 Ρύθμιση ανά εργαλείο και για τα 36 εργαλεία (26 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
```
Κάθε εντολή χρησιμοποιεί το ενεργό απομακρυσμένο περιβάλλον (`omniroute connect `), η επιλογή `--dry-run`
προβάλλει τις ακριβείς μεταβλητές περιβάλλοντος/ορίσματα χωρίς εκτέλεση, ενώ η επιλογή `--api-key-env NAME` διατηρεί τα μυστικά εκτός
του ιστορικού του κελύφους σας. → [Ενσωματώσεις CLI](docs/guides/CLI-INTEGRATIONS.md)
## 🌐 372 πάροχοι AI — 154 επισημασμένοι στον κατάλογο ως δωρεάν
> **372 καταχωρισμένοι πάροχοι** στις κανονικές συλλογές συνομιλίας, πολυμέσων, αναζήτησης, τοπικών υπηρεσιών, cloud-agent και συστήματος, συμπεριλαμβανομένων **154 που διαθέτουν μεταδεδομένα εντοπισμού `hasFree: true`**. Το μητρώο μοντέλων συνομιλίας καλύπτει **237 παρόχους / 3.009 διακριτά ζεύγη παρόχου-μοντέλου / 1.443 ακατέργαστα αναγνωριστικά μοντέλων**· ο ξεχωριστός κατάλογος δωρεάν προϋπολογισμών περιλαμβάνει **491 εγγραφές ανά μοντέλο**, **35 επαναλαμβανόμενες δεξαμενές** και **54 επαναλαμβανόμενους/χωρίς κλειδί παρόχους που είναι δωρεάν για πάντα**. Αυτοί οι παρονομαστές είναι διαφορετικοί εκ σχεδιασμού· οι ορισμοί και οι υπολογισμοί με κατάργηση διπλοτύπων ανά δεξαμενή βρίσκονται στην [Αναφορά παρόχων](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
…και 330+ ακόμη — κάθε εικονίδιο ανακτάται δυναμικά από τον κατάλογο παρόχων του πίνακα ελέγχου. 📖 [Αναφορά παρόχων](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Δωρεάν για πάντα — $0, χωρίς κάρτα
OpenCode Zen DeepSeek V4, Nemotron 3 Χωρίς όριο διακριτικών
Kilo Code Αυτόματη δρομολόγηση, Tencent Hy3 Δωρεάν για πάντα
Requesty GPT-OSS 120B, Nemotron Δωρεάν για πάντα
SiliconFlow DeepSeek V3.2 / R1 Δωρεάν επίπεδο
Z.AI GLM GLM-4.7 / 4.5-Flash Δωρεάν για πάντα
Baidu ERNIE ERNIE 4.0 Δωρεάν για πάντα
Qoder AI Qwen3-Max, Kimi-K2 Απεριόριστη ΔΩΡΕΑΝ χρήση
Pollinations GPT, Llama, Claude Δεν απαιτείται κλειδί
### 🧩 Νέο: Το 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 # εκκίνηση πύλης + dashboard (port 20128)
omniroute chat # διαδραστικός TUI chat client (slash: /model /combo /skill /memory)
omniroute setup # οδηγός πρώτης εκτέλεσης
omniroute doctor # διάγνωση παρόχων, ports, εγγενών εξαρτήσεων
```
### 🛰️ Απομακρυσμένη λειτουργία — εκτελέστε το CLI εδώ, το OmniRoute σε VPS
Το OmniRoute σε διακομιστή; Οδηγήστε το από το laptop σας με το **ίδιο CLI**. Συνδεθείτε μία φορά
με ένα scoped access token· κάθε εντολή απευθύνεται στη συνέχεια στο απομακρυσμένο.
```bash
omniroute connect 192.168.0.15 # κωδικός πρόσβασης → scoped token, αποθηκεύεται ως context
omniroute models list # ← εκτελείται στον ΑΠΟΜΑΚΡΥΣΜΕΝΟ διακομιστή
omniroute configure codex # ← επιλέγει απομακρυσμένο μοντέλο, δημιουργεί τοπικό Codex profile
omniroute tokens create --name ci --scope read # δημιουργία πιο περιορισμένων tokens για άλλα μηχανήματα
omniroute contexts use default # ← επιστροφή στον τοπικό διακομιστή
```
Τα tokens έχουν εμβέλεια `read` / `write` / `admin`· οι διαδρομές εκκίνησης διεργασιών παραμένουν μόνο loopback.
📖 [Απομακρυσμένη Λειτουργία](docs/guides/REMOTE-MODE.md)
### 🤝 Συνδέστε έναν πράκτορα — και ελέγχει το ίδιο το OmniRoute
Εκθέστε το OmniRoute μέσω **MCP**, **A2A**, **REST API**, **webhooks** ή **απομακρυσμένου CLI** — οποιοσδήποτε ικανός πράκτορας (ή ο δικός σας κώδικας) αποκτά τα κλειδιά ολόκληρης της πύλης: δρομολόγηση, πάροχοι, combos, cache, συμπίεση, μνήμη — αυτόνομα. Τα HTTP endpoints παρακάτω εξυπηρετούνται στο `http://localhost:20128`.
Διεπαφή
Endpoint / εντολή
Χρήση για
🧰 MCP (stdio)
omniroute --mcp
Σύνδεση με Claude Desktop, Cursor, οποιονδήποτε MCP client
Συμβατό με OpenAI — chat, embeddings, εικόνες, ήχος, OCR
🔔 Webhooks
/api/webhooks
Αποστολή συμβάντων αιτημάτων / ορίου σε Slack, Discord, Telegram ή οποιοδήποτε URL
🛰️ Απομακρυσμένο CLI
omniroute connect
Οδήγηση απομακρυσμένης εγκατάστασης με scoped access tokens
```bash
# Δώστε στο Claude Code το πλήρες σύνολο εργαλείων OmniRoute μέσω MCP:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream
```
📖 [MCP Server](docs/frameworks/MCP-SERVER.md) · [A2A Server](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%
```
Τα blocks κώδικα, τα URLs, το JSON και τα δομημένα δεδομένα προστατεύονται **πάντα** από τη μηχανή διατήρησης.
> **Γιατί να χρησιμοποιείτε πολλά tokens όταν αρκούν λίγα;** Κάθε αίτημα περνά **διαφανώς** μέσα από το pipeline συμπίεσης του OmniRoute — χωρίς αλλαγές στον client. Πλέον αποτελεί μια **στοίβα 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
Αφαιρεί περιεχόμενο που επαναλαμβάνεται μεταξύ γύρων (βάσει διευθυνσιοδότησης περιεχομένου, μεταξύ γύρων)
2
CCR
Αρχειοθετεί μεγάλα blocks πίσω από δείκτες ανάκτησης, οι οποίοι ανακτώνται κατόπιν αιτήματος
3
Lite
Περικοπή κενών διαστημάτων + URLs εικόνων (βασική λειτουργία χαμηλής καθυστέρησης)
4
RTK
Έξυπνο φιλτράρισμα, αποδιπλοποίηση και περικοπή αποτελεσμάτων εργαλείων (με επίγνωση εντολών)
5
Responses Tool Output
JSON με προτεραιότητα στη συμπίεση χωρίς απώλειες + οριοθετημένη διαγνωστική συμπίεση για εξόδους shell/patch/search/build (Responses API)
6
Headroom
Συμπαγοποίηση πινάκων JSON χωρίς απώλειες (~30%) μέσω ενός ενσωματωμένου codec GCF
7
Relevance
Εξαγωγική βαθμολόγηση προτάσεων σε σχέση με το τελευταίο ερώτημα του χρήστη
8
Caveman
Συμπίεση πεζού λόγου βάσει κανόνων (~65–75% στην έξοδο)
9
Aggressive
Σύνοψη + προοδευτική παλαίωση παλαιών γύρων
10
LLMLingua-2
Σημασιολογικό κλάδεμα με ML μέσω MobileBERT ONNX — ασφαλές για κώδικα, ασύγχρονο
11
Ultra
Ευρετικό κλάδεμα tokens με προαιρετικό επίπεδο μικρού μοντέλου (SLM)
12
OmniGlyph
Πειραματική κωδικοποίηση του περιβάλλοντος ως εικόνα για το μετρημένο Claude Fable 5 στην απευθείας σύνδεση Anthropic· οι transformers GPT 5.6 παραμένουν σε κατάσταση fail-closed εν αναμονή αποδεικτικών παραλαβής από τον πάροχο. Τέσσερα προφίλ συμπίεσης (aggressive ως προεπιλογή, balanced, coding-safe, passthrough) (το πιο επιθετικό· απαιτεί ρητή ενεργοποίηση)
Τα blocks κώδικα, τα URLs και τα δομημένα δεδομένα διατηρούνται **πάντα** με ακρίβεια byte προς byte. Οι **προεπιλογές ενός κλικ** συνδυάζουν τις μηχανές:
Λειτουργία
Εξοικονόμηση
Ιδανικό για
🪶 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 component σας αποδίδεται ξανά είναι πιθανότατα επειδή δημιουργείτε μια νέα αναφορά αντικειμένου σε κάθε κύκλο απόδοσης. Όταν περνάτε ένα inline αντικείμενο ως prop, η ρηχή σύγκριση του React το αναγνωρίζει ως διαφορετικό αντικείμενο κάθε φορά, γεγονός που προκαλεί νέα απόδοση. Θα συνιστούσα να χρησιμοποιήσετε το useMemo για να απομνημονεύσετε το αντικείμενο."_
>
> **Μετά (19 tokens):** _"Νέα αναφορά αντικειμένου σε κάθε απόδοση. Inline object prop = νέα αναφορά = νέα απόδοση. Τυλίξτε το σε useMemo."_
>
> **Ίδια απάντηση. 72% λιγότερα tokens. Μηδενική απώλεια ακρίβειας.** ✅
**Παράδειγμα PT-BR — λειτουργία [Troglodita](https://github.com/leninejunior/troglodita):**
> **Πριν (42 tokens):** _"Το πρόβλημα είναι ότι το στοιχείο επαναποδίδεται επειδή δημιουργείται μια νέα αναφορά αντικειμένου σε κάθε κύκλο απόδοσης. Θα πρότεινα τη χρήση του useMemo."_
>
> **Μετά (12 tokens):** _"Επαναπόδοση: νέα αναφορά σε κάθε κύκλο (επαναδημιουργία inline αντικειμένου). Χρησιμοποιήστε `useMemo`."_
>
> **Ίδια απάντηση. ~70% λιγότερα tokens. Η τεχνική ακρίβεια παραμένει ανέπαφη.** ✅
### 🎚️ Πέρα από τις μηχανές — στυλ εξόδου, ο προσαρμοζόμενος ρυθμιστής και έλεγχος ανά αίτημα
Οι παραπάνω 12 μηχανές συρρικνώνουν ό,τι **εισέρχεται**. Τρία ακόμη επίπεδα διαμορφώνουν το **πώς**, το **πότε** και το τι **εξέρχεται**:
- **🪄 Στυλ εξόδου** _(καθοδήγηση στον άξονα εξόδου)_ — εισάγουν ντετερμινιστικές οδηγίες διαμόρφωσης της απόκρισης, ασφαλείς για την κρυφή μνήμη· μπορούν να συνδυαστούν, το καθένα με ένταση `lite` / `full` / `ultra`. Η προσθήκη ενός στυλ απαιτεί μία μόνο καταχώριση στο μητρώο:
- **Λιτός πεζός λόγος** — αφαιρεί περιττές εκφράσεις / άρθρα / επιφυλάξεις· διατηρεί απολύτως ακριβή την τεχνική ουσία.
- **Λιγότερος κώδικας** — YAGNI «τεμπέλη έμπειρου προγραμματιστή»: η μικρότερη λειτουργική αλλαγή, χωρίς δομές που δεν ζητήθηκαν.
- **Ponytail (τεμπέλης έμπειρος προγραμματιστής)** — ανεβαίνει τη σκάλα του YAGNI, διορθώνει τη βασική αιτία, με το μικρότερο λειτουργικό diff.
- **Έχω ΔΕΠΥ (πρώτα η ενέργεια)** — ξεκινά με την επόμενη ενέργεια, αριθμημένα βήματα, ένα συγκεκριμένο επόμενο βήμα, χωρίς εισαγωγή.
- **Λιτά CJK (文言)** — εξαιρετικά λιτό στυλ κλασικών κινεζικών (περιορίζεται στην τοπική ρύθμιση `zh`).
- **🎯 Προσαρμοζόμενος προϋπολογισμός περιβάλλοντος** _(ο ρυθμιστής)_ — αντί για ένα ενιαίο όριο tokens ενεργοποίησης/απενεργοποίησης, κλιμακώνει τις οικονομικότερες μηχανές με τις μικρότερες απώλειες μόνο όσο χρειάζεται, ώστε το περιεχόμενο να **χωρά στο παράθυρο περιβάλλοντος του μοντέλου**. Πολιτική: `reserve-output` (προεπιλογή, προσαρμοσμένη στο μοντέλο) · `percentage` · `absolute`. Λειτουργία: `floor` (εγγυάται ότι χωρά) · `replace-autotrigger` (υπερισχύει η ρητή επιλογή σας) · `off` (παλαιότερο όριο).
- **🎛️ Πού αποφασίζεται η συμπίεση** _(προτεραιότητα, υψηλή → χαμηλή)_ — κεφαλίδα `x-omniroute-compression` ανά αίτημα › παράκαμψη συνδυασμού δρομολόγησης › ενεργό ονομαστικό προφίλ › προσαρμοζόμενη / αυτόματη ενεργοποίηση › προεπιλογή πίνακα › απενεργοποίηση. Το εφαρμοσμένο πλάνο επιστρέφεται στην κεφαλίδα απόκρισης `X-OmniRoute-Compression: ; source=`.
Ενεργοποιήστε αυτόματα βάσει ορίου tokens, ανοίξτε τον προσαρμοζόμενο ρυθμιστή, καρφιτσώστε ένα ονομαστικό προφίλ, ορίστε μια εφάπαξ επιλογή ανά αίτημα ή αναθέστε μια διοχέτευση ανά συνδυασμό δρομολόγησης — ό,τι ταιριάζει στον φόρτο εργασίας. Ένα προαιρετικό offline **σύστημα αξιολόγησης** (`npm run eval:compression`) βαθμολογεί την πιστότητα έναντι της εξοικονόμησης σε ένα σταθεροποιημένο σώμα δεδομένων, πριν προωθήσετε μια αλλαγή.
📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)
# ⚡ Γρήγορη εκκίνηση
**1) Εγκατάσταση και εκτέλεση**
```bash
npm install -g omniroute
omniroute
```
> 💡 Βλέπετε `npm warn ERESOLVE` ή προειδοποιήσεις για peer dependencies; [Είναι ακίνδυνες](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated).
> **Χρησιμοποιείτε npm 11 ή νεότερη έκδοση;** Το npm μπορεί να αποκλείει τα scripts κύκλου ζωής πακέτων, εκτός εάν έχουν επιτραπεί. Το `postinstall` του OmniRoute (`node scripts/build/postinstall.mjs`) είναι απαραίτητο για την προετοιμασία των εγγενών αρχείων εκτέλεσής του. Κατά την καθολική εγκατάσταση, επιτρέψτε τα πακέτα που αναφέρονται στην προειδοποίηση του npm. Για το σύνολο πακέτων που αναφέρει το OmniRoute 3.8.51:
>
> ```bash
> npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute
> ```
>
> Για να επαναχρησιμοποιείτε αυτή τη λίστα επιτρεπόμενων πακέτων σε μελλοντικές καθολικές εγκαταστάσεις, ρυθμίστε την μία φορά και έπειτα εγκαταστήστε κανονικά:
>
> ```bash
> npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user
> npm install -g omniroute
> ```
>
> Η λίστα εξαρτήσεων μπορεί να αλλάζει μεταξύ εκδόσεων· αν το npm αναφέρει διαφορετική λίστα, χρησιμοποιήστε τα ονόματα πακέτων από εκείνη την προειδοποίηση. Η παραχώρηση άδειας σε ένα πακέτο επιτρέπει την εκτέλεση των scripts εγκατάστασής του.
> **Χρησιμοποιείτε Gemini Web ή άλλον πάροχο που βασίζεται σε web cookies;** Το πακέτο npm περιλαμβάνει το
> Playwright, αλλά όχι το εκτελέσιμο αρχείο Chromium. Δείτε τη σημείωση
> [ρύθμισης του Playwright Chromium](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium)
> πριν υποβάλετε το πρώτο αίτημα στον πάροχο ιστού.
Πίνακας ελέγχου στη διεύθυνση `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: [αντιγραφή από Πίνακας ελέγχου → Τερματικά σημεία]
Μοντέλο: auto (δρομολογεί μεταξύ κατάλληλων συνδέσεων — ή επιλέξτε πάροχο/μοντέλο)
```
**4) Επαληθεύστε ότι λειτουργεί**
```bash
curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"
```
Θα πρέπει να εμφανίζεται η λίστα των συνδεδεμένων μοντέλων σας. 🎉 Αυτό ήταν — ξεκινήστε τον προγραμματισμό και το OmniRoute θα αναλαμβάνει αυτόματα τη δρομολόγηση και την εναλλακτική μετάπτωση για εσάς.
Αν ο client σας δεν μπορεί να στείλει προσαρμοσμένες κεφαλίδες, το OmniRoute παρέχει επίσης ψευδώνυμα συμβατότητας με ενσωματωμένο 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 σήμερα.
Στρατηγική κάλυψης δοκιμών για 39.000+ στατικές δηλώσεις δοκιμών σε 5.100+ παρακολουθούμενα αρχεία δοκιμών
# ⭐ Κορυφαίοι συνεισφέροντες
> Το OmniRoute διαμορφώνεται από μια παθιασμένη κοινότητα ανοικτού κώδικα. Αυτά τα άτομα έχουν προσφέρει εξαιρετικές συνεισφορές που επηρεάζουν άμεσα την ποιότητα, τη σταθερότητα και την απήχηση του έργου. **Σας ευχαριστούμε.**
### Εξωτερικοί συνεισφέροντες βάσει συγχωνευμένων pull requests
Παγωμένο στην κορυφή του ενεργού release/v3.8.50, dafb4ae808, με συγχωνεύσεις έως τις 2026-08-24 05:26:03 UTC. Η απογραφή μέσω του σελιδοποιημένου GitHub GraphQL περιλαμβάνει 5.911 συγχωνευμένα PR: 2.707 από τον κάτοχο του αποθετηρίου, 179 από το Dependabot και 3.025 εξωτερικά PR από 535 διαφορετικούς συνεισφέροντες. Οι «Γραμμές που άλλαξαν» είναι το άθροισμα προσθηκών και διαγραφών στο GitHub και περιλαμβάνουν δημιουργημένα αρχεία, lockfiles, καταλόγους, μεταφράσεις και τεκμηρίωση· πρόκειται για τον όγκο αλλαγών και όχι για γραμμές κώδικα που συντάχθηκαν. Οι ισοβαθμίες στο όριο διατηρούνται.
### Commits που αποδίδονται από το GitHub
backryun 🥇 220 commits που αποδίδονται από το GitHub
Markus Hartung 🏅 69 commits που αποδίδονται από το GitHub · ισοβαθμία στη θέση #6
Dizzle 🏅 69 commits που αποδίδονται από το GitHub · ισοβαθμία στη θέση #6
Jan Leon 🏅 64 commits που αποδίδονται από το GitHub
zenobit 🏅 62 commits που αποδίδονται από το GitHub
Bob.Hou 🏅 51 commits που αποδίδονται από το GitHub · ισοβαθμία στη θέση #10
Xiangzhe 🏅 51 commits που αποδίδονται από το GitHub · ισοβαθμία στη θέση #10
Επανελέγχθηκε στις 2026-08-24 06:14:31 UTC: commits που αποδίδονται από το GitHub, όπως αναφέρθηκαν από το Contributors API του αποθετηρίου για τον προεπιλεγμένο κλάδο release/v3.8.50. Το API επέστρεψε 525 ταυτότητες (415 χρήστες, 2 bots, 108 ανώνυμες)· αυτός ο πίνακας εξαιρεί τον συντηρητή, τα bots και τις ανώνυμες ταυτότητες και διατηρεί τις ισοβαθμίες της κατάταξης. Διαφέρει τόσο από την παραπάνω κατάταξη συγχωνευμένων PR όσο και από την παρακάτω απογραφή 639 ατόμων βάσει μεταδεδομένων Git.
> 🙏 Οι λειτουργίες, οι διορθώσεις σφαλμάτων και οι βελτιώσεις υποδομής αυτών των συνεισφερόντων αποτελούν **βασικό μέρος** όσων καθιστούν το OmniRoute αξιόπιστο και πλούσιο σε λειτουργίες. Κάθε pull request, κάθε περίπτωση δοκιμής και κάθε αρχείο μετάφρασης i18n έχει σημασία. Το λογισμικό ανοικτού κώδικα δημιουργείται από ανθρώπους σαν κι αυτούς.
---
## 💖 Χορηγοί
Ένα ολόθερμο ευχαριστώ στους ανθρώπους που χρηματοδοτούν το OmniRoute από την τσέπη τους — κάθε συνεισφορά κρατά το έργο δωρεάν, ανεξάρτητο και σε κίνηση.
… και άλλοι που προτιμούν να παραμείνουν ανώνυμοι 💛Δημόσιοι χορηγοί GitHub επαναληπτικά ελεγμένοι στις 2026-08-24. Η κατάσταση activeOnly του GitHub καθορίζει τις ετικέτες ενεργών παραπάνω· οι προηγουμένως αποκαλυφθέντες δημόσιοι εφάπαξ υποστηρικτές εξακολουθούν να ευχαριστούνται, και οι ιδιωτικοί χορηγοί παραμένουν ανώνυμοι.💖 Γίνε χορηγός → — κάθε δολάριο κρατά το OmniRoute δωρεάν και ανεξάρτητο.
## 👥 600+ Συνεισφέροντες
[](https://github.com/diegosouzapw/OmniRoute/graphs/contributors)
Ελεγμένο στις 2026-08-24 στη δεσμευμένη βάση ac02c5b42f και επανελεγμένο στο ενεργό άκρο release/v3.8.50dafb4ae808: 639 κανονικοποιημένες ανθρώπινες Git ταυτότητες — 407 εμφανίζονται ως συγγραφείς commit (συμπεριλαμβανομένου του συντηρητή) και 232 μόνο σε ρητά Co-authored-by trailers. Η απογραφή κανονικοποιεί τα noreply handles του GitHub, εξαιρεί 26 ταυτότητες bot/agent/υπηρεσίας/placeholder, και δεν συγχωνεύει κοινές διευθύνσεις email μόνο και μόνο επειδή τα εμφανιζόμενα ονόματά τους ταιριάζουν.
### Πώς να Συνεισφέρεις
1. Κάνε fork το αποθετήριο
2. Διακλαδώσου από το **ενεργό** άκρο `release/vX.Y.Z` (όχι από το `main`) — δες [Branching & Release Model](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 publish γίνεται αυτόματα
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 στις 24 Αυγούστου 2026 — πηγαίνετε να δώσετε αστέρι σε αυτά τα έργα. Οι αριθμοί είναι ακριβές χρονολογημένο στιγμιότυπο και θα αλλάξουν φυσικά.
### 🧬 系譜 & πύλη
Η πύλη AI της οποίας το δημόσιο σύνολο δεδομένων τιμολόγησης τροφοδοτεί τον συγχρονισμό παρακολούθησης κόστους και της οποίας το μοντέλο κανονικοποίησης παρόχων ενημέρωσε τη δρομολόγησή μας.
Πηγαίος κώδικας MIT προσαρμοσμένος στη vendored γέφυρα ChatGPT Web → Codex Responses, συμπεριλαμβανομένων προσαρμογέων browser-session, response-framing, χρήσης και web-search.
Οι αντιστοιχίσεις μοντέλων Grok, ο γεννήτορας Statsig τύπου fake-TypeError, οι προεπιλογές αιτήματος και συσκευής, και ο επεξεργαστής απόκρισης NDJSON προσαρμόστηκαν ουσιαστικά στον εκτελεστή Grok Web του OmniRoute.
Η κύρια μεταβατική πηγή κώδικα πίσω από το grok2api-merged· οι υλοποιήσεις μοντέλου, κεφαλίδας, payload, Statsig και επεξεργαστή διατηρούνται στη γενεαλογία Grok Web.
Η υποκείμενη πηγή MIT για τις προεπιλογές payload και συσκευής Grok, τον γεννήτορα Statsig και τον επεξεργαστή result.response που μεταφέρθηκε μέσω TQZHR και grok2api-merged.
Μια μεταβατική πηγή που αναφέρεται από το grok2api-merged για το επίπεδο proxy-pool· το OmniRoute διατηρεί αυτή την ειδοποίηση γενεαλογίας αλλά δεν ισχυρίζεται μεταφορά proxy-pool στον περιορισμένο εκτελεστή Grok Web.
Η αρχική υλοποίηση Grok Web συμβουλεύτηκε τον σχεδιασμό HTTP/browser upstream· η άμεση HTTP διαδρομή της προέρχεται από το GrokProxy, οπότε δεν διεκδικείται ανεξάρτητη μεταφορά κώδικα.
Το viral έργο "γιατί να χρησιμοποιείς πολλά διακριτικά όταν λίγα κάνουν τη δουλειά" — η φιλοσοφία caveman-speak τροφοδοτεί την τυπική λειτουργία συμπίεσης και 30+ κανόνες πλήρωσης/συμπύκνωσης.
Συμπίεση εξόδου εντολών υψηλής απόδοσης — ενέπνευσε τη μηχανή RTK, το DSL φίλτρου JSON, την ανάκτηση ακατέργαστης εξόδου και τη στοιβαγμένη αγωγό RTK → Caveman.
Συμπίεση διακριτικών PT-BR — τροφοδοτεί το γλωσσικό πακέτο pt-BR: μείωση πλεονασμού και αφαίρεση γεμιστικών λέξεων βελτιστοποιημένη για τη βραζιλιάνικη-πορτογαλική γραμματική.
Η viral δεξιότητα YAGNI-coding του "τεμπέλη senior dev" — ενέπνευσε το Στυλ Εξόδου less-code: καθοδήγηση ελάχιστης-λειτουργικής-αλλαγής που μειώνει τον _παραγόμενο_ κώδικα (ο αδελφός στον άξονα εξόδου της πεζολογίας χωρίς περιττές λέξεις του Caveman).
Το στυλ απόκρισης που δίνει προτεραιότητα στη δράση και είναι φιλικό προς το ADHD προσαρμόστηκε στο συνοπτικό στυλ εξόδου του OmniRoute σε πέντε γλώσσες.
Συμπίεση εξόδου με επίγνωση περιεχομένου, ανά τύπο αρχείου, με διακοπή λόγω αποτυχίας — επικύρωσε την αποστολή ανά τύπο και την παράλειψη ελάχιστου κέρδους.
Στηλοθετικό JSON σε Rust + ανάκτηση με αναφορά περιεχομένου + διαγραμμάτωση μεταξύ μηνυμάτων — επικύρωσε τον σχεδιασμό μηχανής headroom/ccr/session-dedup και την αναλλοίωτη "η συμπιεσμένη μορφή είναι ανεξάρτητη θέσης" σταθερής κρυφής μνήμης.
Η υποκλοπή/ανάλυση MITM κίνησης βοηθού κωδικοποίησης ↔ LLM ενημέρωσε τις πρώιμες απαιτήσεις Επιθεωρητή Κίνησης. Τέσσερις προηγουμένως παράγωγες ενότητες — συγχώνευση SSE, κανονικοποίηση συνομιλίας, απόκρυψη μυστικών και εξυγίανση κεφαλίδων — έχουν αντικατασταθεί από ανεξάρτητες υλοποιήσεις καθαρού δωματίου βάσει δημόσιων προτύπων πρωτοκόλλου. Οι δύο επιφάνειες host-passthrough (passthrough.ts και _internal/bypass.cjs) παραμένουν εσωτερικές υλοποιήσεις OmniRoute που ταξινομούνται ανεξάρτητα· δεν επανεγράφηκαν ως μέρος αυτής της αντικατάστασης.
Διαφανής δρομολόγηση proxy ανά διεργασία — ενέπνευσε την ασφαλή ως προς καταρρεύσεις διακοπή MITM, τα χρονικά όρια αδράνειας socket, την απόδοση διεργασίας /proc και τη σύλληψη TPROXY.
Μια επιμελημένη λίστα βιβλιοθηκών ασφαλών εξ ορισμού που καθοδηγεί τις επιλογές ασφαλείας μας (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
Ενέπνευσε την αποπλεονασμάτωση αιτημάτων, εναλλακτική μηδενικού κόστους έκτακτης ανάγκης, τις αρθρωτές στρατηγικές Auto-Combo και την πολύγλωσση ταξινόμηση προθέσεων.
Η αντιστοίχιση μοντέλων με επίγνωση λογαριασμού, η επικύρωση διαδρομής εκτελέσιμου και η συμπεριφορά ετικέτας πλάνου ενημέρωσαν το runtime Antigravity του OmniRoute.
Εντόπισε την επιφάνεια ποσόστωσης Grok Build· το OmniRoute επαλήθευσε και διόρθωσε στη συνέχεια ανεξάρτητα τη ζωντανή μορφή wire.
## 📄 Άδεια Χρήσης
Άδεια MIT - δείτε το [LICENSE](LICENSE) για λεπτομέρειες.
---
**[⬆ Πίσω στην κορυφή](#-omniroute)** · Φτιαγμένο με ❤️ για την κοινότητα ανοιχτού κώδικα AI.
OmniRoute v3.8.52 · Node ≥22.22.2 · MIT License · 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`, συμπεριλαμβανομένων των OpenCode Free και 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 από τους συνδεδεμένους παρόχους σας, με αξιολόγηση σε πραγματικό χρόνο:
📖 [Μηχανή αυτόματου συνδυασμού](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)
Ο προεπιλεγμένος διαδοχικός συνδυασμός εκτελεί `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%
```
Τα blocks κώδικα, τα URLs, το JSON και τα δομημένα δεδομένα προστατεύονται **πάντα** από τη μηχανή διατήρησης.
> **Γιατί να χρησιμοποιείτε πολλά tokens όταν αρκούν λίγα;** Κάθε αίτημα περνά **διαφανώς** μέσα από το pipeline συμπίεσης του OmniRoute — χωρίς αλλαγές στον client. Πλέον αποτελεί μια **στοίβα 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:
