# README (Ελληνικά) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇪🇹 [am](../am/README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/README.md) · 🇧🇦 [bs](../bs/README.md) · 🇨🇿 [cs](../cs/README.md) · 🇩🇰 [da](../da/README.md) · 🇩🇪 [de](../de/README.md) · 🇪🇸 [es](../es/README.md) · 🇪🇪 [et](../et/README.md) · 🇮🇷 [fa](../fa/README.md) · 🇫🇮 [fi](../fi/README.md) · 🇫🇷 [fr](../fr/README.md) · 🇮🇪 [ga](../ga/README.md) · 🇮🇳 [gu](../gu/README.md) · 🇳🇬 [ha](../ha/README.md) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇦🇲 [hy](../hy/README.md) · 🇮🇩 [id](../id/README.md) · 🇳🇬 [ig](../ig/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇬🇪 [ka](../ka/README.md) · 🇰🇭 [km](../km/README.md) · 🇮🇳 [kn](../kn/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [ml](../ml/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇲🇲 [my](../my/README.md) · 🇳🇵 [ne](../ne/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/README.md) · 🇮🇳 [or](../or/README.md) · 🇮🇳 [pa](../pa/README.md) · 🇵🇭 [phi](../phi/README.md) · 🇵🇱 [pl](../pl/README.md) · 🇵🇹 [pt](../pt/README.md) · 🇧🇷 [pt-BR](../pt-BR/README.md) · 🇷🇴 [ro](../ro/README.md) · 🇷🇺 [ru](../ru/README.md) · 🇱🇰 [si](../si/README.md) · 🇸🇰 [sk](../sk/README.md) · 🇸🇮 [sl](../sl/README.md) · 🇷🇸 [sr](../sr/README.md) · 🇸🇪 [sv](../sv/README.md) · 🇰🇪 [sw](../sw/README.md) · 🇮🇳 [ta](../ta/README.md) · 🇮🇳 [te](../te/README.md) · 🇹🇭 [th](../th/README.md) · 🇹🇷 [tr](../tr/README.md) · 🇺🇦 [uk-UA](../uk-UA/README.md) · 🇵🇰 [ur](../ur/README.md) · 🇺🇿 [uz](../uz/README.md) · 🇻🇳 [vi](../vi/README.md) · 🇳🇬 [yo](../yo/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---
Πίνακας ελέγχου του OmniRoute

# 🚀 OmniRoute — Η δωρεάν πύλη AI **Δημιουργήθηκε από τον [Diego Souza](https://github.com/diegosouzapw)** OmniRoute — Μην σταματάς ποτέ να γράφεις κώδικα. Κάθε εργαλείο AI → 388 πάροχοι — 150+ δωρεάν — μέσω ενός endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity σε δωρεάν Claude / GPT / Gemini με αυτόματη εναλλακτική δρομολόγηση. Η συμπιεσμένη διαδοχική συμπίεση RTK + Caveman εξοικονομεί 15–95% των tokens (~89% κατά μέσο όρο) — δεν θα φτάσεις ποτέ τα όρια. 388 πάροχοι AI · 150+ δωρεάν επίπεδα · ~1,62 δισ. δωρεάν tokens/μήνα · 20 στρατηγικές δρομολόγησης · $0 για να ξεκινήσεις.
## 💰 ~1.62B Tokens / Μήνα Σε Δωρεάν Πακέτα Τρίτων
> **Χρησιμοποιήστε τους δικούς σας λογαριασμούς παρόχων.** Πρόκειται για εκτιμώμενο συνολικό άθροισμα από ξεχωριστά επιλέξιμα δωρεάν πακέτα τρίτων και όχι για παροχή tokens από το OmniRoute. Εγγραφείτε, αποκτήστε διαπιστευτήρια όπου απαιτείται και συνδέστε τους παρόχους που μπορείτε να χρησιμοποιήσετε· κάθε πάροχος ελέγχει τα όριά του, τη διαθεσιμότητα και τους όρους του. > > Η χειροκίνητη συνδυασμένη χρήση δωρεάν πακέτων είναι επίπονη — δεκάδες SDK, δεκάδες όρια ρυθμού και καμία σαφής εικόνα για το πόσα διαθέτετε πραγματικά. Το OmniRoute καταγράφει **465 εγγραφές δωρεάν πακέτων σε 34 επαναλαμβανόμενα κλειδιά pool** και υπολογίζει το συνολικό token από τα **17 pool με δημοσιευμένο θετικό μηνιαίο προϋπολογισμό, συν πέντε όρια Groq ανά μοντέλο**, με αποδιπλοποίηση βάσει κοινόχρηστου pool. Οι ποσοστώσεις που ενεργοποιούνται μόνο μετά από έλεγχο ταυτότητας σε περιφερειακό επίπεδο (σήμερα: ModelScope) εμφανίζονται ξεχωριστά, +~6M μετά την επαλήθευση περιφερειακής ταυτότητας, και δεν προστίθενται ποτέ στο συνολικό ποσό. Το αποτέλεσμα παραμένει ορατό στον πίνακα ελέγχου (`/dashboard/free-tiers`). Κάρτα δωρεάν πακέτων του OmniRoute: ~1.62B δωρεάν tokens τον μήνα σταθερά, έως ~2.22B τον πρώτο μήνα με πιστώσεις εγγραφής, από 34 τεκμηριωμένα επαναλαμβανόμενα κλειδιά pool που καλύπτουν 465 καταγεγραμμένες εγγραφές δωρεάν πακέτων μέσω ενός endpoint. Ειλικρινής υπολογισμός με αποδιπλοποίηση pool — κάθε κοινόχρηστο pool υπολογίζεται μία φορά, συμπεριλαμβανομένων 17 επαναλαμβανόμενων pool με δημοσιευμένο θετικό μηνιαίο προϋπολογισμό token, συν πέντε όρια Groq ανά μοντέλο· 12 πάροχοι επισημαίνονται ως προς αποφυγή στον κατάλογο κινδύνων όρων, ώστε να αποφασίζετε εσείς. Η γραμμή προϋπολογισμού περιλαμβάνει Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M (πέντε όρια ανά μοντέλο) και μικρότερα pool, καθώς και πιστώσεις εγγραφής του πρώτου μήνα και παρόχους που είναι μόνιμα δωρεάν χωρίς όριο token, οι οποίοι εμφανίζονται ξεχωριστά ώστε να μην διογκώνουν ποτέ το συνολικό ποσό. Ζωντανή χρήση/υπόλοιπο στο /dashboard/free-tiers. > Κινούμενη σύνοψη της ζωντανής σελίδας `/dashboard/free-tiers`. Πλήρης μεθοδολογία (αποδιπλοποίηση pool, επίπεδα πιστώσεων, όροι παρόχων): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > Τα στοιχεία αυτά ελέγχονται ξανά κάθε δύο εβδομάδες σε σύγκριση με τον ζωντανό κατάλογο και **μεταβάλλονται και προς τις δύο κατευθύνσεις** — ένας πάροχος τερματίζει ένα δωρεάν πακέτο και ο αριθμός μειώνεται· εμφανίζεται ένας νέος και αυξάνεται. Δημοσιεύουμε αυτό που υπολογίζει πραγματικά ο κατάλογος και ποτέ μια στρογγυλοποιημένη προς τα πάνω ιδανική περίπτωση.

⭐ Κάντε star στο repo αν το OMNIROUTE σας βοήθησε να εξοικονομήσετε χρήματα και να κάνετε τη δουλειά σας ευκολότερη.

[![Stars](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute) diegosouzapw%2FOmniRoute | Trendshift [![Κατάταξη ιστορικού star](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 Γίνετε μέλος της κοινότητας **👋 Ακολουθήστε τον maintainer — μάθετε πρώτοι για νέους παρόχους, εκδόσεις και συμβουλές:** [![Ακολουθήστε τον Diego στο LinkedIn](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![Ακολουθήστε το @diegosouzapw στο GitHub](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp Global](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp Βραζιλία](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![Ιστότοπος](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](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)**
## 📈 Η πύλη συνεχίζει να μεγαλώνει
| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | --------------------------------------------- | :----------------------: | :---------: | :-------------------: | | 🌐 Πάροχοι | 352 | **358** | 388 | | 🧠 Μοναδικά αναγνωριστικά μοντέλων συνομιλίας | 1320 | **1374** | 1491 | | 🖼️ Γέφυρα τροπικοτήτων | 🆕 όραση + ήχος + βίντεο | ✓ | ✓ | | 📡 Δωρεάν κατάλογος Radar | 🆕 προαιρετική συμμετοχή | ✓ | ✓ | | ⚖️ Προγραμματισμός με επίγνωση ποσοστώσεων | 🆕 Quota-Share | ✓ | ✓ | | 📊 Τηλεμετρία ποσοστώσεων | 🆕 ζωντανή | ✓ | ✓ | | 🧰 Λειτουργία χωρίς γραφικό περιβάλλον | — | — | 🆕 `serve --headless` | | 🛤️ Υποδομή τροχιάς LTS | — | — | 🆕 κανάλια εκδόσεων | | 🔎 API ανακάλυψης μοντέλων | — | — | 🆕 `/v1/models/query` | **→ [Οδικός χάρτης](ROADMAP.md) — ακολουθώντας τη διαδρομή προς το `v3.9.0 LTS`**

## 🧩 Διαθέσιμο [![έκδοση npm](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![Μηνιαίες λήψεις NPM](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![Άδεια χρήσης: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Λήψεις Docker](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Λήψεις Electron](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)
🚀 Έναρξη 🚀 Γρήγορη έναρξη 📦 Εγκατάσταση 🆓 Σύνδεση παρόχου
💡 Μάθετε 💥 Η υπόσχεση 🤔 Γιατί το OmniRoute 🏆 Τι το ξεχωρίζει
⚙️ Δυνατότητες 🎯 Συνδυασμοί 🌐 Πάροχοι 🔌 CLI & MCP
🗜️ Συμπίεση 🖥️ Πού εκτελείται 🔒 Ιδιωτικό
👀 Δείτε το 🎬 Σε δράση ✨ Τι νέο υπάρχει 🤖 Συμβατά CLI
💚 Υποστήριξη 💚 Υποστήριξη / Δωρεά 💬 Κοινότητα 💖 Χορηγοί
📦 Έργο 🛠️ Τεχνολογίες 📖 Τεκμηρίωση 👥 Συνεισφέροντες
🌐 Σε 67 γλώσσες

Αγγλικά (en) Πορτογαλικά — Βραζιλία (pt-BR) Πορτογαλικά (pt) Ισπανικά (es) Γαλλικά (fr) Ιταλικά (it) Γερμανικά (de) Ολλανδικά (nl) Ρωσικά (ru) Ουκρανικά (uk-UA) Πολωνικά (pl) Τσεχικά (cs) Σλοβακικά (sk) Ρουμανικά (ro) Ουγγρικά (hu) Βουλγαρικά (bg) Δανικά (da) Φινλανδικά (fi) Νορβηγικά (no) Σουηδικά (sv) Κινεζικά — Απλοποιημένα (zh-CN) Κινεζικά — Παραδοσιακά (zh-TW) Ιαπωνικά (ja) Κορεατικά (ko) Ταϊλανδικά (th) Βιετναμικά (vi) Ινδονησιακά (id) Μαλαισιανά (ms) Φιλιππινέζικα (phi) Χίντι (hi) Γκουτζαράτι (gu) Μαράτι (mr) Ταμίλ (ta) Τελούγκου (te) Μπενγκάλι (bn) Ουρντού (ur) Περσικά (fa) Αραβικά (ar) Εβραϊκά (he) Τουρκικά (tr) Αζερικά (az) Σουαχίλι (sw) Ελληνικά (el) Κροατικά (hr) Σερβικά (sr) Λιθουανικά (lt) Εσθονικά (et) Λετονικά (lv) Σλοβενικά (sl) Μαλτεζικά (mt) Ιρλανδικά (ga) Κανάντα (kn) Μαλαγιαλαμικά (ml) Οντία (or) Παντζαμπικά (pa) Νεπαλικά (ne) Σινχαλεζικά (si) Βιρμανικά (my) Χμερ (km) Χάουσα (ha) Γιορούμπα (yo) Ίγκμπο (ig) Αμχαρικά (am) Ουζμπεκικά (uz) Γεωργιανά (ka) Αρμενικά (hy) Βοσνιακά (bs)


## 🆓 Εγκαταστήστε, συνδέστε έναν πάροχο και, στη συνέχεια, δρομολογήστε μέσω ενός endpoint
Τρία βήματα: εγκαταστήστε και εκκινήστε το OmniRoute, συνδέστε έναν κατάλληλο πάροχο με τον δικό σας λογαριασμό ή κλειδί API και, στη συνέχεια, ρυθμίστε το εργαλείο σας ώστε να χρησιμοποιεί το localhost:20128/v1 με ένα κλειδί API του OmniRoute και το μοντέλο auto. Η δρομολόγηση εξαρτάται από τις διαθέσιμες κατάλληλες συνδέσεις και τα όρια των παρόχων. ```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/)
# 💥 Η υπόσχεση
Η υπόσχεση — Ένα endpoint και 388 πάροχοι. Η αυτόματη εφεδρική μετάβαση διατηρεί τη δρομολόγηση όσο υπάρχει διαθέσιμος άλλος υγιής στόχος. Έξι πυλώνες: ανθεκτική εφεδρική μετάβαση μεταξύ 388 παρόχων · έως και 95% εξοικονόμηση token σε κατάλληλους φόρτους εργασίας · $0 για εκκίνηση με περισσότερα από 150 δωρεάν προγράμματα και 52 επαναλαμβανόμενους/χωρίς κλειδί παρόχους που είναι δωρεάν για πάντα · 39 ενσωματώσεις CLI/agent μέσω μίας ρύθμισης · συμβατότητα με τα OpenAI, Claude, Gemini και Responses API στο /v1 · έλεγχοι παραγωγής, όπως circuit breakers, TLS stealth, MCP με 110 εργαλεία, A2A, μνήμη, guardrails, evals και περισσότερες από 56.000 δηλώσεις στατικών δοκιμών σε περισσότερα από 7.800 καταγεγραμμένα αρχεία δοκιμών.

# 🤔 Γιατί OmniRoute;
Γιατί OmniRoute — σταματήστε να εναλλάσσεστε μεταξύ 10 dashboard, ανενεργών κλειδιών API και απρόβλεπτων χρεώσεων. Δέκα καθημερινά προβλήματα και οι λύσεις τους: λήξη ποσοστώσεων που παραμένουν αχρησιμοποίητες → αξιοποιήστε στο έπακρο τις συνδρομές· όρια ρυθμού στη μέση της συγγραφής κώδικα → αυτόματη εφεδρική μετάβαση 4 επιπέδων (Συνδρομή → API → Οικονομικό → Δωρεάν)· έξοδοι εργαλείων που καταναλώνουν token → συμπίεση RTK + Caveman (15–95%)· ακριβά API → δρομολόγηση με βελτιστοποίηση κόστους· κάθε εργαλείο με τη δική του ρύθμιση → ένα endpoint, ένα dashboard· αποκλεισμός της AI → proxy 3 επιπέδων + TLS stealth· ανενεργά κλειδιά → ανθεκτικότητα 3 επιπέδων (circuit breakers, ψύξη κλειδιού, αποκλεισμός μοντέλου)· ομάδα που μοιράζεται μία συνδρομή → pools κλειδιών με ποσοστώσεις δίκαιου μεριδίου· προτροπές μέσω του cloud κάποιου άλλου → τοπική προτεραιότητα με κρυπτογραφημένα κλειδιά AES-256-GCM· απουσία ορατότητας στις δαπάνες → ζωντανά αναλυτικά στοιχεία (χρήση, ποσόστωση, εξοικονόμηση, λανθάνων χρόνος p95).
Ροή αιτήματος OmniRoute: το IDE ή το CLI σας (Claude Code, Cursor, Cline…) καλεί ένα τοπικό endpoint (http://localhost:20128/v1)· ο Έξυπνος Δρομολογητής του OmniRoute (συμπίεση RTK + Caveman, 20 στρατηγικές δρομολόγησης, circuit breakers, TLS stealth, MCP, A2A, guardrails) μπορεί να πραγματοποιήσει εφεδρική μετάβαση μεταξύ 4 επιπέδων παρόχων όσο παραμένει διαθέσιμος ένας κατάλληλος υγιής στόχος — Επίπεδο 1 Συνδρομή, Επίπεδο 2 Κλειδί API, Επίπεδο 3 Οικονομικό και Επίπεδο 4 Δωρεάν.

## 🤝 Με την υποστήριξη των Φίλων μας στον Ανοιχτό Κώδικα

Kimi K3 — Νοημοσύνη αιχμής ανοιχτού κώδικα · 2.8T παράμετροι · περιβάλλον 1M token

> **Θέλετε να γίνετε Φίλος του Ανοιχτού Κώδικα;** Αυτές είναι οι εταιρείες που στηρίζουν τον ανοιχτό κώδικα και βοηθούν το OmniRoute να συνεχίσει να εξελίσσεται — και εμείς δηλώνουμε δημόσια πού αξιοποιείται κάθε token που μας παρέχουν. Επικοινωνήστε μαζί μας: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)
Kimi (Moonshot AI)
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
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
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 — Η ναυαρχίδα
Κινούμενα παραδείγματα για 18 από τις 20 στρατηγικές δρομολόγησης combo — ένα πλακίδιο ανά στρατηγική: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. Οι cache-optimized και quota-weighted δεν είναι κινούμενες· ο παρακάτω πίνακας περιγράφει και τις 20. > Ένα **combo** είναι μια αλυσίδα μοντέλων μεταξύ των οποίων το OmniRoute δρομολογεί **αυτόματα**. Αν εξαντληθεί το όριο χρήσης, αποτύχει ένας πάροχος ή αυξηθεί απότομα το κόστος, το combo μπορεί να μεταβεί στο επόμενο κατάλληλο και λειτουργικό μοντέλο. 🛡️ ### ⚡ Χωρίς ρυθμίσεις — χρησιμοποιήστε απλώς το `auto` Δεν χρειάζεται να δημιουργήσετε combo. Ορίστε το μοντέλο σας σε `auto` (ή σε μια παραλλαγή του) και το OmniRoute δημιουργεί ένα εικονικό combo από τους συνδεδεμένους παρόχους σας, με αξιολόγηση σε πραγματικό χρόνο:
Αναγνωριστικό μοντέλουΤι βελτιστοποιεί
auto🎯 Ισορροπημένη προεπιλογή (LKGP — παραμένει στον τελευταίο αξιόπιστο πάροχό σας)
auto/coding🧑💻 Συντελεστές με προτεραιότητα στην ποιότητα για παραγωγή κώδικα
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 Τυχαία εξισορρόπηση φορτίου με τη μέθοδο επιλογής μεταξύ δύο
6 least-used Επιλέγει τον στόχο με το χαμηλότερο τρέχον φορτίο
7 random Ομοιόμορφη τυχαία επιλογή (με αφαίρεση διπλοτύπων)
8 strict-random Τυχαία επιλογή χωρίς αφαίρεση επαναλήψεων 🎲
9 cost-optimized Ελαχιστοποιεί το κόστος $ ανά αίτημα βάσει των τιμών του καταλόγου σε πραγματικό χρόνο 💸
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 ανεξάρτητα επίπεδα) Ανθεκτικότητα του OmniRoute — 3 ανεξάρτητα επίπεδα αυτοΐασης, το κατάλληλο επίπεδο για την κατάλληλη αστοχία. Επίπεδο 1: διακόπτης κυκλώματος παρόχου (ολόκληρος ο πάροχος): ενεργοποιείται μόνο σε 408/5xx, κατώφλια OAuth 8× / API-key 12× / local 2×, επαναφέρεται έπειτα από 60s/30s/15s σε δοκιμή HALF-OPEN, οκνηρή ανάκαμψη· όσο βρίσκεται σε κατάσταση OPEN, ο συνδυασμός αναδρομολογεί στον επόμενο πάροχο. Επίπεδο 2: περίοδος αναμονής σύνδεσης (ένα κλειδί/ένας λογαριασμός): βάση 5s για OAuth / 3s για API-key, εκθετική υποχώρηση ×2 με προστασία κατά του φαινομένου thundering herd, το 429 τηρεί το Retry-After, η επιτυχία εκκαθαρίζει όλη την κατάσταση σφαλμάτων· ένα κλειδί σε αναμονή παραλείπεται, ενώ τα συγγενικά κλειδιά συνεχίζουν να εξυπηρετούν. Επίπεδο 3: αποκλεισμός μοντέλου (ένα μοντέλο): το 429 ανά μοντέλο, το τοπικό 404 ή οι απορρίψεις λειτουργίας αποκλείουν μόνο το συγκεκριμένο μοντέλο — ποτέ ολόκληρη τη σύνδεση. Οι τερματικές καταστάσεις (αποκλεισμός, λήξη, εξάντληση πιστώσεων) αφορούν τον διαχειριστή και όχι τις περιόδους αναμονής. 📖 [Μηχανή Auto-Combo](docs/routing/AUTO-COMBO.md) · [Οδηγός ανθεκτικότητας](docs/architecture/RESILIENCE_GUIDE.md)
## 🏆 Τι ξεχωρίζει το OmniRoute
Τι ξεχωρίζει το OmniRoute — ένα στιγμιότυπο δυνατοτήτων με ημερομηνία σε σύγκριση με τα 9router, OpenRouter, CLIProxyAPI και LiteLLM σε 13 δυνατότητες. Το OmniRoute: 388 πάροχοι, ενσωματωμένα 150+ δωρεάν επίπεδα, 20 στρατηγικές δρομολόγησης, συμπίεση token με 12 μηχανές, ενσωματωμένος διακομιστής MCP με 110 εργαλεία, πρωτόκολλο πρακτόρων A2A, μόνιμη μνήμη, guardrails, cloud agents, stealth αποτύπωμα TLS, Desktop/Termux/PWA και 67 τοπικές ρυθμίσεις διεπαφής χρήστη i18n. Το OmniRoute διαθέτει άδεια MIT και μπορεί να φιλοξενηθεί από τον ίδιο τον χρήστη. Οι δυνατότητες και οι μετρήσεις των ανταγωνιστών ενδέχεται να αλλάξουν· ανατρέξτε στη συνδεδεμένη μεθοδολογία. 📊 Πλήρης μεθοδολογία και λεπτομέρειες ανά δυνατότητα σε σύγκριση με τα 9router, OpenRouter, CLIProxyAPI και LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)
## 💚 Υποστήριξη του OmniRoute Το OmniRoute διαθέτει άδεια MIT και συντηρείται δημόσια. Αν σας εξοικονομεί χρόνο ή χρήμα, δείτε πώς μπορείτε να το διατηρήσετε ανεξάρτητο — επιλέξτε ό,τι σας ταιριάζει. Η χορηγία δεν επηρεάζει ποτέ την προτεραιότητα δρομολόγησης· αγοράζει ορατότητα, όχι κατάταξη.
⭐ Δώστε αστέρι στο αποθετήριοΔωρεάν — βοηθά πραγματικά στην ορατότηταΑστέρι στο OmniRoute
🐙 GitHub SponsorsΕφάπαξ ή μηνιαία · χωρίς χρέωση πλατφόρμαςgithub.com/sponsors/diegosouzapw
☕ Ko-fiΓρήγορη εφάπαξ συνεισφορά, χωρίς εγγραφή για τον δωρητήko-fi.com/diegosouzapw
🧋 Buy Me a CoffeeΜικρή, ανεπίσημη χειρονομίαbuymeacoffee.com/diegosouzapw
🖐 LiberapayΕπαναλαμβανόμενη · μη κερδοσκοπική · ανοιχτού κώδικαliberapay.com/diegosouzapw
🇧🇷 PIX (Βραζιλία)Άμεσα, χωρίς χρεώσειςκλειδί & QR παρακάτω
₿ ΚρυπτονόμισμαBTC · ETH · USDT-TRC20 · USDC-Solanaδιευθύνσεις παρακάτω
**🇧🇷 PIX** — άμεσα, χωρίς χρεώσεις (Βραζιλία) OmniRoute PIX QR code Κλειδί (τυχαίο): `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 (κάντε κλικ για ανάπτυξη)
₿ BTCBitcoin (SegWit)bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd
Ξ ETHEthereum (ERC20)0x64Cf6B68A6Ff34288e89172950a2d00102337a84
₮ USDTTron (TRC20)TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2
$ USDCSolana2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu
⚠️ Αποστέλλετε κάθε νόμισμα μόνο στο δίκτυο που αναγράφεται — η αποστολή σε λάθος δίκτυο μπορεί να οδηγήσει σε απώλεια των κεφαλαίων.
🐛 Βρήκατε ένα σφάλμα ή έχετε σχόλια; Ανοίξτε μια [Συζήτηση](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 λειτουργεί με δωρεάν & οικονομικά μοντέλα.
Claude Code
Claude Code
                           
Codex CLI
Codex CLI
                           
Cline
Cline
                           
Kilo Code
Kilo Code
Zoo Code
Zoo Code
Continue
Continue
                           
Aider
Aider
                           
ForgeCode
ForgeCode
                           
jcode
jcode
                           
DeepSeek TUI
DeepSeek TUI
                           
CodeWhale
CodeWhale
                           
OpenCode
OpenCode
                           
Factory Droid
Factory Droid
                           
GitHub Copilot CLI
Copilot CLI
                           
Cursor CLI
Cursor CLI
                           
Smelt
Smelt
                           
Pi (pi-coding-agent)
Pi
                           
Grok Build (xAI)
Grok Build
                           
Hermes Agent (Nous Research)
Hermes Agent
                           
OpenClaw
OpenClaw
                           
Goose
Goose
                           
Open Interpreter
Open Interpreter
                           
Warp AI
Warp AI
                           
deyin.ai
deyin.ai
                           
+ λειτουργεί επίσης με · 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
OpenAI
                           
Anthropic
Anthropic
                           
Gemini
Gemini
                           
xAI Grok
xAI Grok
                           
DeepSeek
DeepSeek
                           
Mistral
Mistral
                           
Qwen
Qwen
                           
Meta Llama
Meta Llama
                           
Groq
Groq
                           
NVIDIA
NVIDIA
                           
MiniMax
MiniMax
                           
Cohere
Cohere
                           
Perplexity
Perplexity
                           
Hugging Face
HuggingFace
                           
Together
Together
                           
Fireworks
Fireworks
                           
Cloudflare
Cloudflare
                           
Baidu
Baidu
                           
…και 350+ ακόμη — κάθε εικονίδιο επιλύεται ζωντανά από τον κατάλογο παρόχων του dashboard. 📖 [Αναφορά παρόχων](docs/reference/PROVIDER_REFERENCE.md)
### 🆓 Δωρεάν για πάντα — $0, χωρίς κάρτα OpenCode Zen
OpenCode Zen
DeepSeek V4, Nemotron 3
Χωρίς όριο token
Kilo Code
Kilo Code
Αυτόματος δρομολογητής, Tencent Hy3
Δωρεάν για πάντα
Requesty
Requesty
GPT-OSS 120B, Nemotron
Δωρεάν για πάντα
SiliconFlow
SiliconFlow
DeepSeek V3.2 / R1
Δωρεάν επίπεδο
Z.AI GLM
Z.AI GLM
GLM-4.7 / 4.5-Flash
Δωρεάν για πάντα
Baidu ERNIE
Baidu ERNIE
ERNIE 4.0
Δωρεάν για πάντα
Qoder AI
Qoder AI
Qwen3-Max, Kimi-K2
Απεριόριστη ΔΩΡΕΑΝ χρήση
Pollinations
Pollinations
GPT, Llama, Claude
Δεν απαιτείται κλειδί
Cloudflare AI
Cloudflare AI
50+ μοντέλα
10K neurons/ημέρα
NVIDIA NIM
NVIDIA NIM
GLM, MiniMax
~40 RPM δωρεάν
Cerebras
Cerebras
GLM 4.7, GPT-OSS
Πίστωση $5 μίας φοράς· απαιτείται κάρτα
OpenRouter
OpenRouter
Μοντέλα :free
+$10 → υψηλότερο RPM
📖 Πλήρης κατάλογος σε μορφή αναγνώσιμη από μηχανές → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)
## 🖥️ Όπου τρέχει OmniRoute — Οπουδήποτε
> Ίδια εφαρμογή, το μηχάνημά σας, οι κανόνες σας. Από μια παγκόσμια εγκατάσταση npm σε** το τηλέφωνό σας** μέσω Termux.
Πλατφόρμα Εγκατάσταση Χαρακτηριστικά
📦 npm (παγκόσμια) npm εγκατάσταση -g omniroute Μία εντολή, οποιαδήποτε OS
⚡ Bun (παγκόσμια) bun προσθήκη -g omniroute Ίδιο tarball μητρώου, ταχύτερες εγκαταστάσεις
🐳 Docker docker τρέξιμο … diegosouzapw/omniroute Multi-arch AMD64 + ARM64
🖥️ Επιτραπέζιος υπολογιστής (Electron) npm εκτέλεση ηλεκτρονίων: κατασκευή Δίσκος συστήματος εγγενούς παραθύρου + — Windows / macOS / Linux
🎩 γραμμή μενού (OmniRouteTray) brew εγκατάσταση --cask zoispag/tap/omniroute-tray Επιβλέπει & ενημερώνει αυτόματα τον διακομιστή — macOS
💪 ARM εγγενές arm64 Raspberry Pi, διακομιστές ARM, Apple Silicon
📱 Android (Termux) pkg εγκατάσταση nodejs && npx -y omniroute Εκτελεί στο τηλέφωνό σας , 24/7, χωρίς root
📲 PWA"Προσθήκη στην αρχική οθόνη" Πλήρης οθόνη, εκτός σύνδεσης, με δυνατότητα εγκατάστασης από το πρόγραμμα περιήγησης
🧩 OpenCode @omniroute/opencode-providerOpenCode ενσωμάτωση
🤖 VS κωδικός Copilot Συζήτηση εγκατάσταση OmniCopilot επέκταση Κάθε μοντέλο OmniRoute στο εγγενές πρόγραμμα επιλογής συνομιλίας Copilot — σταθερό & Insiders
🛠️ Από την πηγή npm εγκατάσταση && npm τρέξτε dev Hack σε αυτό, συνεισφέρετε
[Docker](docs/guides/DOCKER_GUIDE.md)📖 zqc · [Επιτραπέζιος υπολογιστής](electron/README.md) · [Δίσκος γραμμής μενού](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)
### 🧩 Νέο: 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** . < td στοίχιση ="αριστερά">VS κώδικας — σταθερός & Insiders < td στοίχιση ="αριστερά">Cursor, Windsurf, VSCodium, Theia διακομιστής κώδικα Gitpod, Antigravity, Kiro…
Κατάστημα Σύνδεσμος Λειτουργεί με
🧩 VS κώδικας Αγορά Εγκατάσταση →
🔓 Άνοιγμα μητρώου VSX Εγκατάσταση →
Από το εσωτερικό του επεξεργαστή: ανοίξτε το** Επεκτάσεις** προβολή, αναζήτηση** "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 εκτελούνται στο μηχάνημά σας. Τα prompts αποστέλλονται στον upstream πάροχο που επιλέγεται για κάθε αίτημα· το OmniRoute δεν προσθέτει κανένα hosted hop επεξεργασίας prompt και η τηλεμετρία είναι απενεργοποιημένη από προεπιλογή. Τα διαπιστευτήρια κρυπτογραφούνται σε κατάσταση ηρεμίας με AES-256-GCM· οι έλεγχοι περιλαμβάνουν περιορισμό εμβέλειας API-key, φιλτράρισμα IP, όρια ρυθμού, προστασία από έγχυση prompt, καθαρισμό upstream-header, προαιρετική απόκρυψη PII, εξυγιασμένα σφάλματα και τοπικό ίχνος ελέγχου SQLite. Το OmniRoute διαθέτει άδεια MIT και είναι αυτο-φιλοξενούμενο. 📖 [Εξουσιοδότηση](docs/architecture/AUTHZ_GUIDE.md) · [Προστατευτικά Μέτρα](docs/security/GUARDRAILS.md) · [Συμμόρφωση](docs/security/COMPLIANCE.md)
## 🔌 Πλήρες CLI + A2A & MCP
> Πέρα από τον διακομιστή, το 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)
Κινούμενη επίδειξη τερματικού για το CLI του OmniRoute — omniroute providers list, omniroute combo list και omniroute health — με εναλλαγή στις 89 εντολές ανώτατου επιπέδου: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …
### 🤝 Συνδέστε έναν πράκτορα — και θα ελέγχει το ίδιο το OmniRoute Εκθέστε το OmniRoute μέσω **MCP**, **A2A**, ενός **REST API**, **webhooks** ή ενός **απομακρυσμένου CLI** — οποιοσδήποτε κατάλληλος πράκτορας (ή ο δικός σας κώδικας) αποκτά τα κλειδιά για ολόκληρη την πύλη: δρομολόγηση, παρόχους, συνδυασμούς, κρυφή μνήμη, συμπίεση, μνήμη — αυτόνομα. Τα παρακάτω HTTP endpoints παρέχονται στη διεύθυνση `http://localhost:20128`.
ΔιεπαφήEndpoint / εντολήΧρησιμοποιήστε το για
🧰 MCP (stdio)omniroute --mcpΣύνδεση με Claude Desktop, Cursor ή οποιοδήποτε πρόγραμμα-πελάτη MCP
🌊 MCP (HTTP)/api/mcp/streamΑπομακρυσμένο MCP — 110 εργαλεία, 33 εύρη (προαιρετική επιβολή), πλήρες ιστορικό ελέγχου
📡 MCP (SSE)/api/mcp/sseΜεταφορά MCP με ροή δεδομένων
🤝 A2A/.well-known/agent.jsonΕπικοινωνία πράκτορα προς πράκτορα, JSON-RPC 2.0 + SSE, 6 δεξιότητες
🌐 REST API/v1/*Συμβατό με OpenAI — συνομιλία, ενσωματώσεις, εικόνες, ήχος, OCR
🔔 Webhooks/api/webhooksΠροώθηση συμβάντων αιτημάτων / ορίων χρήσης στο Slack, Discord, Telegram ή σε οποιοδήποτε URL
🛰️ Απομακρυσμένο CLIomniroute 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, αρχιτεκτονική και υπολογισμός εξοικονόμησης Pipeline συμπίεσης του OmniRoute: ένα ενδεικτικό αίτημα πελάτη 10.000 tokens περνά από 12 συνθέσιμες μηχανές — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra και OmniGlyph — και μπορεί να φτάσει στον πάροχο με περίπου 1.080 tokens στο τεκμηριωμένο παράδειγμα διαδοχικής εφαρμογής. Το δομημένο περιεχόμενο προστατεύεται από μηχανισμούς διατήρησης και ελέγχους πιστότητας ανά βήμα· οι ρητές λειτουργίες με απώλειες ή πειραματικές λειτουργίες ενδέχεται να μετασχηματίζουν επιλέξιμο περιεχόμενο. Ο προεπιλεγμένος συνδυασμός διαδοχικής εφαρμογής εκτελεί `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· καθεμία μπορεί να ενεργοποιείται ή να απενεργοποιείται και να ρυθμίζεται ανεξάρτητα ανά συνδυασμό:
#ΜηχανήΛειτουργία
1Session-DedupΑφαιρεί περιεχόμενο που επαναλαμβάνεται μεταξύ διαδοχικών μηνυμάτων (με βάση το περιεχόμενο, μεταξύ διαδοχικών μηνυμάτων)
2CCRΑρχειοθετεί μεγάλα μπλοκ πίσω από δείκτες ανάκτησης, τα οποία ανακτώνται κατ’ απαίτηση
3LiteΠερικοπή κενών και URL εικόνων (βασική λειτουργία με μικρή επιβάρυνση καθυστέρησης)
4RTKΈξυπνο φιλτράρισμα, απαλοιφή διπλοτύπων και περικοπή αποτελεσμάτων εργαλείων (με επίγνωση εντολών)
5Responses Tool OutputΠρώτα χωρίς απώλειες JSON και περιορισμένη διαγνωστική συμπίεση για αποτελέσματα shell/patch/search/build (Responses API)
6HeadroomΣυμπύκνωση πινάκων JSON χωρίς απώλειες (~30%) μέσω ενός ενσωματωμένου codec GCF
7RelevanceΕξαγωγική βαθμολόγηση προτάσεων σε σχέση με το τελευταίο ερώτημα του χρήστη
8CavemanΣυμπίεση πεζού λόγου βάσει κανόνων (~65–75% στα αποτελέσματα)
9AggressiveΣύνοψη και προοδευτική «γήρανση» παλαιότερων μηνυμάτων
10LLMLingua-2Σημασιολογική αφαίρεση μέσω ML με MobileBERT ONNX — ασφαλές για κώδικα, ασύγχρονο
11UltraΕυρετική αφαίρεση tokens με προαιρετική βαθμίδα μικρού μοντέλου (SLM)
12OmniGlyphΠειραματική κωδικοποίηση του περιβάλλοντος ως εικόνας για μετρημένο Claude Fable 5 μέσω του απευθείας wire της Anthropic· οι μετασχηματιστές GPT 5.6 παραμένουν σε κατάσταση ασφαλούς αποτυχίας εν αναμονή αποδείξεων από τον πάροχο. Τέσσερα προφίλ συμπίεσης (προεπιλεγμένο επιθετικό, ισορροπημένο, ασφαλές για κώδικα, passthrough) (το πιο επιθετικό· απαιτεί ρητή ενεργοποίηση)
Τα μπλοκ κώδικα, τα URL και τα δομημένα δεδομένα **διατηρούνται πάντα** byte-perfect. Τα **προκαθορισμένα με ένα κλικ** συνδυάζουν τις μηχανές:
ΛειτουργίαΕξοικονόμησηΙδανική για
🪶 Lite~15%Ασφαλής προεπιλογή που παραμένει πάντα ενεργή
🪨 Standard (Caveman)~30%Καθημερινή ανάπτυξη κώδικα
⚡ Aggressive~50%Μεγάλες συνεδρίες με πολλά εργαλεία
🔥 Ultra~75%Μέγιστη εξοικονόμηση
🧰 RTK60–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 σήμερα.
# 🎬 Το OmniRoute σε Δράση
## 📹 Οδηγοί βίντεο
Στιγμιότυπο του πίνακα στις 2026-10-18 · Ακατέργαστος κατάλογος: YT 1.352 | TT 334 | IG 290 · Επικαιρότητα (ημέρες): YT 5 | TT 48 | IG 49
Instagram Reel — nick_saraev
🎬 #1 — Instagram
nick_saraev — 3,042,474 προβολές
Instagram Reel — nnapier7
🎬 #2 — Instagram
nnapier7 — 1,454,535 προβολές
YouTube — Amidia AI & Tech
🎬 #3 — YouTube
Amidia AI & Tech — 794,974 προβολές
Instagram Reel — theopenstack
🎬 #4 — Instagram
theopenstack — 692,419 προβολές
TikTok — migue.baena
🎬 #5 — TikTok
migue.baena — 685,788 προβολές
**Πλήρης κατάταξη (αποδιπλοποιημένα κανονικά URLs, `v > 0`, μεγαλύτερη απήχηση):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | Κανονικές μετρήσεις στις 2026-10-18: **1.976 μοναδικά βίντεο** · **20.220.289 γνωστές προβολές** (`v > 0`) · **1.210 κανάλια/προφίλ ανά δίκτυο**. Ο ακατέργαστος πίνακας περιέχει 1.976 γραμμές (YouTube 1.352 = 740 βίντεο μεγάλης διάρκειας + 612 Shorts · TikTok 334 · Instagram 290)· δεν απέμειναν διπλότυπα μετά την κανονικοποίηση βάσει του κανονικού URL, η οποία διατηρεί τον μεγαλύτερο αριθμό προβολών ανά βίντεο. Η συλλογή δεδομένων από το YouTube έχει παγώσει στις 2026-10-13 (το όριο χρήσης του API εξαντλήθηκε από τις 14 έως τις 18/10) και από το TikTok/Instagram από τις 2026-09-02 (χωρίς μονάδες συλλογής δεδομένων)· 76 βίντεο δεν έχουν ακόμη αριθμό προβολών. > 🎬 **Δημιουργήσατε ένα βίντεο για το OmniRoute;** Ανοίξτε ένα [ζήτημα](https://github.com/diegosouzapw/OmniRoute/issues/new) ή μια [συζήτηση](https://github.com/diegosouzapw/OmniRoute/discussions) με τον σύνδεσμο — θα το προβάλλουμε εδώ.
# 📧 Κοινότητα & Βοήθεια > Όλα σε ένα μέρος — ακολουθήστε τον συντηρητή, συνομιλήστε με την κοινότητα ή ανοίξτε ένα ζήτημα. | Κανάλι | Πού / πώς | | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — ακολουθήστε τον συντηρητή | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — ακολουθήστε για εκδόσεις & συμβουλές | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 Παγκόσμια κοινότητα** | [εγγραφείτε στην ομάδα](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 Βραζιλία** | [εγγραφείτε στην ομάδα](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **Ιστότοπος** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍Κοινότητα StHub OmniRoute (δωρεάν)** | [πύλη StHub](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **Πηγαίος κώδικας** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **Αναφορά σφάλματος** | [ανοίξτε ένα issue](https://github.com/diegosouzapw/OmniRoute/issues) — επισυνάψτε την έξοδο του `npm run system-info` | | 🤝 **Συνεισφορά** | [CONTRIBUTING.md](CONTRIBUTING.md) · [Μοντέλο διακλαδώσεων & εκδόσεων](docs/ops/BRANCHING_MODEL.md) · επιλέξτε ένα `good first issue` | | 💚 **Υποστήριξη του έργου** | [Τρόποι υποστήριξης ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |
---
## 🛠️ Τεχνολογικό Stack
ΕπίπεδοΤεχνολογία
RuntimeNode.js 22.x / 24.x LTS — >=22.22.2 <23 || >=24.0.0 <27
ΓλώσσαTypeScript 6.0 — 100% TypeScript στα src/ και open-sse/ (μηδενικά any στον πυρήνα από την v2.0)
FrameworkNext.js 16 + React 19 + Tailwind CSS 4
Βάση δεδομένωνbetter-sqlite3 (SQLite, καταγραφή WAL) + LowDB (παλαιού τύπου JSON) — 147 αρθρώματα τομέα, 233 μεταναστεύσεις
ΜνήμηΠλήρες κείμενο SQLite FTS5 + διανυσματικά embeddings κβαντισμένα σε int8, τυποποιημένη εξασθένηση
ΣχήματαZod 4 — επικύρωση I/O εργαλείων MCP + συμβάσεις API
ΠρωτόκολλαMCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Ροή δεδομένωνServer-Sent Events (SSE) + γέφυρα WebSocket (/v1/ws)
ΣυμπίεσηΑγωγός 12 μηχανών — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Έλεγχος ταυτότητας & ασφάλειαOAuth 2.0 (PKCE) + JWT + API Keys + εξουσιοδότηση MCP με περιορισμένη εμβέλεια · AES-256-GCM σε κατάσταση ηρεμίας · DOMPurify
Απόκρυψηwreq-js — πλαστογράφηση αποτυπώματος TLS JA3 / JA4, διαμεσολαβητής 3 επιπέδων
ΑνθεκτικότηταΔιακόπτης κυκλώματος, εκθετική υποχώρηση, αποτροπή ταυτόχρονων αιτημάτων, αυτοΐαση auto-combo
Καταγραφήpino — δομημένα αρχεία καταγραφής JSON με πλαίσιο αιτήματος
ΔοκιμέςΕκτελεστής δοκιμών Node.js + Vitest — 60.000+ στατικές δηλώσεις δοκιμών σε περισσότερα από 8.400 καταγεγραμμένα αρχεία δοκιμών (μονάδας, ενοποίησης, E2E, ασφάλειας, οικοσυστήματος)
ΠλατφόρμεςΥπολογιστές (Electron) · Android (Termux) · PWA (οποιοδήποτε πρόγραμμα περιήγησης)
CI/CDGitHub Actions — αυτόματη δημοσίευση στο npm + στο Docker Hub κατά την κυκλοφορία
ΣύνδεσμοιΙστότοπος · npm · Docker Hub

## 📖 Τεκμηρίωση
### 📘 Ξεκινώντας
ΈγγραφοΠεριγραφή
Οδηγός χρήστηΠάροχοι, συνδυασμοί, ενσωμάτωση CLI, ανάπτυξη
Οδηγός ρύθμισηςΠλήρεις μέθοδοι εγκατάστασης, διαμορφώσεις εργαλείων CLI, ρύθμιση πρωτοκόλλων, προσαρμογή χρονικών ορίων
Οδηγός εργαλείων CLIΡύθμιση ανά εργαλείο για Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Απομακρυσμένη λειτουργίαΧειρισμός ενός απομακρυσμένου OmniRoute (VPS) από το CLI του φορητού υπολογιστή σας μέσω διακριτών διακριτικών πρόσβασης
Διαμόρφωση Claude CodeΣύνδεση του Claude Code στο OmniRoute (τοπικά/απομακρυσμένα) με launch + προφίλ ανά μοντέλο
Γρήγορη έναρξηΕγκατάσταση → σύνδεση → διαμόρφωση σε 3 βήματα
### 🔧 Λειτουργίες και ανάπτυξη
ΈγγραφοΠεριγραφή
Οδηγός DockerΕκτέλεση Docker, προφίλ Compose, Caddy HTTPS, διοχετεύσεις, ετικέτες εικόνων
Οδηγός PodmanΕνσωμάτωση Quadlet με systemd, podman-compose, SELinux
Ανάπτυξη σε VMΠλήρης οδηγός: ρύθμιση VM + nginx + Cloudflare
Ανάπτυξη στο Fly.ioΑνάπτυξη στο Fly.io με μόνιμο χώρο αποθήκευσης
Οδηγός TermuxΕκτέλεση του OmniRoute σε Android μέσω Termux
Οδηγός PWAΕγκατάσταση Progressive Web App, προσωρινή αποθήκευση, αρχιτεκτονική
Οδηγός απεγκατάστασηςΠλήρης αφαίρεση για όλες τις μεθόδους εγκατάστασης
Διαμόρφωση περιβάλλοντοςΠλήρεις μεταβλητές και αναφορές του .env
### 🧠 Δυνατότητες και αρχιτεκτονική
ΈγγραφοΠεριγραφή
ΑρχιτεκτονικήΑρχιτεκτονική συστήματος, ροή δεδομένων και εσωτερική λειτουργία
Οδηγός συμπίεσηςΑγωγός 7 επιλογών: απενεργοποιημένο / ελαφρύ / τυπικό / επιθετικό / ultra / RTK / στοιβαγμένο
Συμπίεση RTKΣυμπίεση εξόδου εντολών, φίλτρα, αξιοπιστία, επαλήθευση, ανάκτηση μη επεξεργασμένης εξόδου
Μηχανές συμπίεσηςCaveman, RTK, στοιβαγμένοι αγωγοί, επιφάνειες dashboard/API/MCP
Μορφή κανόνων συμπίεσηςΣχήματα πακέτων κανόνων JSON για φίλτρα Caveman και RTK
Πακέτα γλωσσών συμπίεσηςΑνίχνευση γλώσσας και συγγραφή πακέτων κανόνων Caveman
Οδηγός ανθεκτικότηταςΑσφάλειες κυκλώματος, περίοδοι ψύξης, ουρά, αποτροπή υπερφόρτωσης από ταυτόχρονες επαναλήψεις, πλαστογράφηση TLS
Μηχανή αυτόματων συνδυασμώνΒαθμολόγηση 16 παραγόντων, πακέτα λειτουργιών, αυτοΐαση
Οδηγός proxyΣύστημα proxy 3 επιπέδων, αγορά 1proxy, CRUD μητρώου
Δωρεάν επίπεδαΕνοποιημένος κατάλογος: 34 τεκμηριωμένες επαναλαμβανόμενες δεξαμενές / 465 καταγεγραμμένες καταχωρίσεις δωρεάν επιπέδων
Συλλογή δυνατοτήτωνΟπτική περιήγηση στο dashboard με στιγμιότυπα οθόνης
Τεκμηρίωση βάσης κώδικαΠεριήγηση στη βάση κώδικα φιλική για αρχάριους
### 🤖 Πρωτόκολλα και API
ΈγγραφοΠεριγραφή
Αναφορά APIΌλα τα endpoints με παραδείγματα
Προδιαγραφή OpenAPIΠροδιαγραφή OpenAPI 3.0
Διακομιστής MCP110 εργαλεία MCP, διαμορφώσεις IDE, πελάτες Python/TS/Go
Οδηγός διακομιστή MCPΕγκατάσταση MCP, μεταφορές και αναφορά εργαλείων
Διακομιστής A2AΠρωτόκολλο JSON-RPC 2.0, δεξιότητες, ροή δεδομένων, διαχείριση εργασιών
Οδηγός διακομιστή A2AΚάρτα agent A2A, εργασίες, δεξιότητες και ροή δεδομένων
### 📋 Έργο και ποιότητα
ΈγγραφοΠεριγραφή
ΣυνεισφοράΡύθμιση περιβάλλοντος ανάπτυξης και οδηγίες
Μοντέλο διακλάδωσης και κυκλοφοριώνΠού στοχεύουν τα PR (release/*), τι σημαίνουν τα main και τα tags
Ιστορικό αλλαγώνΠλήρες ιστορικό κυκλοφοριών ανά έκδοση
Πολιτική ασφάλειαςΑναφορά ευπαθειών και πρακτικές ασφάλειας
Οδηγός i18nΥποστήριξη 67 γλωσσών, ροή εργασίας μετάφρασης, RTL
Λίστα ελέγχου κυκλοφορίαςΒήματα επικύρωσης πριν από την κυκλοφορία
Σχέδιο κάλυψηςΣτρατηγική κάλυψης δοκιμών για περισσότερες από 60.000 στατικές δηλώσεις δοκιμών σε περισσότερα από 8.400 καταγεγραμμένα αρχεία δοκιμών

# ⭐ Κορυφαίοι συνεισφέροντες > Το OmniRoute διαμορφώνεται από μια παθιασμένη κοινότητα ανοιχτού κώδικα. Αυτά τα άτομα έχουν πραγματοποιήσει εξαιρετικές συνεισφορές που επηρεάζουν άμεσα την ποιότητα, τη σταθερότητα και την απήχηση του έργου. **Σας ευχαριστούμε.** ### Εξωτερικοί συνεισφέροντες ανά συγχωνευμένα pull requests
ΚατάταξηΣυνεισφέρωνΣυγχωνευμένα PR~Αλλαγμένες γραμμές
1maxmad64bis41825,367,739
2HouMinXi29513,557,796
3pacocartones22281,551
4backryun210270,562
5JxnLexn1983,570,623
6oyi77190411,243
7KooshaPari1515,972,314
8rdself14580,663
9RaviTharuma123500,065
10herjarsa88230,872
11hartmark852,849,623
12jonlwheat2-gif6869,097
13artickc6243,502
14xiaoyaner020159126,220
15chirag127526,661
16xz-dev50245,976
17woodsonl48811,771
18rqzbeh46151,229
19MumuTW4328,166
19QuangBlue4313,112
Η απογραφή πραγματοποιήθηκε στις 2026-11-03 03:01:19 UTC με την τρέχουσα κορυφή του release/v3.8.53 05bc048d6c. Η σελιδοποιημένη απογραφή 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
Dizzle
Dizzle

🥇 418 commit αποδιδόμενα στο GitHub
Bob.Hou
Bob.Hou

🥈 294 commit αποδιδόμενα στο GitHub
Paijo
Paijo

🥉 229 commit αποδιδόμενα στο GitHub
Paco Cartones
Paco Cartones

🏅 222 commit αποδιδόμενα στο GitHub
backryun
backryun

🏅 202 commit αποδιδόμενα στο GitHub
Jan Leon
Jan Leon

🏅 134 commit αποδιδόμενα στο GitHub
Ravi Tharuma
Ravi Tharuma

🏅 126 commit αποδιδόμενα στο GitHub
Markus Hartung
Markus Hartung

🏅 115 commit αποδιδόμενα στο GitHub
Randi
Randi

🏅 108 commit αποδιδόμενα στο GitHub
Chris
Chris

🏅 70 commit αποδιδόμενα στο GitHub
WebPerson
WebPerson

🏅 68 commit αποδιδόμενα στο GitHub
Koosha Paridehpour
Koosha Paridehpour

🏅 68 commit αποδιδόμενα στο 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 από την τσέπη τους — κάθε συνεισφορά διατηρεί το έργο δωρεάν, ανεξάρτητο και σε διαρκή εξέλιξη.
Andrew
Andrew

💛 Ενεργός μηνιαίος χορηγός
Vlad I
Vlad I

💛 Ενεργός μηνιαίος χορηγός
小妍儿
小妍儿

💛 Ενεργός μηνιαίος χορηγός
Guilherme Costa
Guilherme Costa

💛 Ενεργός εφάπαξ χορηγός
Henrique Triches Iurkiv
Henrique Iurkiv

💛 Ενεργός εφάπαξ χορηγός
Somesh Ghaturle
Somesh Ghaturle

💛 Ενεργός εφάπαξ χορηγός
Kolonie AI
Kolonie AI

💛 Παλαιότερος εφάπαξ υποστηρικτής
Professor Igor Morais Vasconcelos
Prof. Igor Morais

💛 Παλαιότερος εφάπαξ υποστηρικτής
Pixma
Pixma

💛 Παλαιότερος εφάπαξ υποστηρικτής
Paco Cartones
Paco Cartones

💛 Παλαιότερος εφάπαξ υποστηρικτής
longtao
longtao

💛 Παλαιότερος εφάπαξ υποστηρικτής
… και άλλοι που προτιμούν να παραμείνουν ανώνυμοι 💛 Οι δημόσιοι Χορηγοί 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://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) Ελεγχθεί στις 2026-11-02 στην ενεργή κορυφή release/v3.8.53 1c7135e0fb (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 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
Project⭐Πώς ενέπνευσε το OmniRoute
9router31,861Το αρχικό project στο οποίο βασίζεται αυτό το fork — επεκτάθηκε εδώ με multi-modal APIs και πλήρη επανεγγραφή σε TypeScript.
CLIProxyAPI57,329Η υλοποίηση σε Go που ενέπνευσε αυτό το port σε JavaScript / TypeScript.
LiteLLM62,580Το AI gateway του οποίου το δημόσιο dataset τιμολόγησης τροφοδοτεί τον συγχρονισμό παρακολούθησης κόστους και του οποίου το μοντέλο κανονικοποίησης παρόχων επηρέασε το routing μας.
codex-chatgpt-web15,435Πηγαίος κώδικας MIT, προσαρμοσμένος στη vendored γέφυρα ChatGPT Web → Codex Responses, συμπεριλαμβανομένων των adapters για browser session, framing αποκρίσεων, usage και web search.
free-claude-code65,966Patterns που μεταφέρθηκαν στην ανάκτηση stream, στα aliases no-thinking, στην εφεδρική web search, στα όρια sliding-window, στην απόκρυψη log και στις ενισχυμένες ροές launcher.
composer-api347Patterns επιλογής εργαλείων, περιορισμών εξόδου και commit εργαλείων του Cursor Composer, προσαρμοσμένα στον native executor του Cursor.
codex-multi-auth561Patterns νέας σύνδεσης και εναλλαγής refresh token, μεταφερμένα στην επανεπαλήθευση ταυτότητας OAuth του Codex.
opencode-anthropic-auth562Προεπιλογές μετασχηματισμού συμβατές με το Claude Code και συμπεριφορά billing header, γενικευμένες στη γέφυρα του OmniRoute που βασίζεται σε ρυθμίσεις.
grok2api-merged2Οι αντιστοιχίσεις μοντέλων Grok, η γεννήτρια fake-TypeError Statsig, οι προεπιλογές request και device και ο επεξεργαστής απόκρισης NDJSON προσαρμόστηκαν ουσιαστικά στον executor Grok Web του OmniRoute.
TQZHR/grok2api707Η κύρια transitive πηγή κώδικα πίσω από το grok2api-merged· οι υλοποιήσεις μοντέλου, header, payload, Statsig και processor διατηρούνται στη γραμμή καταγωγής του Grok Web.
chenyme/grok2api7,874Ο υποκείμενος πηγαίος κώδικας MIT για τις προεπιλογές payload και device του Grok, τη γεννήτρια Statsig και τον processor result.response που μεταφέρθηκαν μέσω των TQZHR και grok2api-merged.
grok2api-pro27Μια transitive πηγή που αναγνωρίζεται από το grok2api-merged για το επίπεδο proxy-pool· το OmniRoute διατηρεί αυτή την αναφορά καταγωγής, αλλά δεν διεκδικεί port proxy-pool στον περιορισμένου εύρους executor Grok Web.
GrokProxy52Το cookie-authenticated Grok proxy του και το pattern streaming result.response.token επηρέασαν το transport Grok Web του OmniRoute.
GrokBridge5Η αρχική υλοποίηση Grok Web αποτέλεσε σημείο αναφοράς για τον σχεδιασμό HTTP/browser upstream· η άμεση διαδρομή HTTP προέρχεται από το GrokProxy, επομένως δεν διεκδικείται ανεξάρτητο port κώδικα.
### 🗜️ Συμπίεση context & token — engines
Έργο⭐Πώς ενέπνευσε το OmniRoute
Caveman116,957Το viral έργο «γιατί να χρησιμοποιείς πολλά token όταν λίγα token κάνουν τη δουλειά» — η φιλοσοφία ομιλίας των caveman τροφοδοτεί την τυπική λειτουργία συμπίεσης και περισσότερους από 30 κανόνες αφαίρεσης/συμπύκνωσης περιττού περιεχομένου.
RTK – Rust Token Killer85,350Συμπίεση εξόδου εντολών υψηλής απόδοσης — ενέπνευσε τη μηχανή RTK, το DSL φίλτρων JSON, την ανάκτηση ακατέργαστης εξόδου και τη στοιβαγμένη διοχέτευση RTK → Caveman.
headroom78,672Αντιστρέψιμη συμπίεση περιβάλλοντος (SmartCrusher) — ενέπνευσε τη μηχανή headroom και το μοτίβο δείκτη ανάκτησης ccr.
LLMLingua6,797Έρευνα συμπίεσης prompt (LLMLingua / LLMLingua-2) — ενέπνευσε την ασύγχρονη, ασφαλή για κώδικα και fail-open μηχανή llmlingua.
llmlingua-2-js33Η θύρα JS/ONNX (MobileBERT / XLM-RoBERTa), η οποία χρησιμοποιείται ως backend worker-thread για τη μηχανή LLMLingua.
Troglodita50Συμπίεση token PT-BR — τροφοδοτεί το πακέτο γλώσσας pt-BR: μείωση πλεονασμών και αφαίρεση περιττού περιεχομένου προσαρμοσμένες στη γραμματική της βραζιλιάνικης πορτογαλικής.
ponytail182,929Η viral δεξιότητα YAGNI-coder του «τεμπέλη senior developer» — ενέπνευσε το στυλ εξόδου less-code: καθοδήγηση με τη μικρότερη λειτουργική αλλαγή, που περιορίζει τον _παραγόμενο_ κώδικα (το αντίστοιχο στον άξονα εξόδου της συνοπτικής πεζής γλώσσας του Caveman).
i-have-adhd59,838Το στυλ απαντήσεων με προτεραιότητα στη δράση και φιλικό προς άτομα με ADHD προσαρμόστηκε στο συνοπτικό στυλ εξόδου του OmniRoute σε πέντε γλώσσες.
### 🧩 Συμπαγείς μορφές, έρευνα token και εργαλεία με επίγνωση κώδικα
Έργο⭐Πώς ενέπνευσε το OmniRoute
TOON25,602Token-Oriented Object Notation — το στηλοθετημένο μοντέλο του με κεφαλίδα και γραμμές διαμόρφωσε το στάδιο πινακοειδούς συμπύκνωσης.
GCF – Graph Compact Format61Η συμπαγής μορφή γράφου και ο σχεδιασμός γενικού προφίλ του ενημέρωσαν την πινακοειδή συμπύκνωση και τη μορφή codec του Headroom.
gcf-typescript4Η υλοποίηση MIT TypeScript ενσωματώθηκε απευθείας και επεκτάθηκε ως codec γενικού προφίλ του Headroom.
token-optimizer-mcp566Cache Brotli/SQLite + delta περιβάλλοντος ανά συνεδρία — ενέπνευσε τη μηχανή session-dedup.
token-savior1,203Συμπύκνωση εξόδου Bash + προφίλ MCP — ενέπνευσε την πειθαρχία πρόωρης εγκατάλειψης της συμπίεσης και τη μείωση του manifest εργαλείων MCP.
token-saver162Συμπίεση εξόδου με επίγνωση περιεχομένου ανά τύπο αρχείου, με πρόωρη εγκατάλειψη σε περίπτωση αποτυχίας — επικύρωσε τη δρομολόγηση ανά τύπο και την παράλειψη όταν το ελάχιστο κέρδος δεν επιτυγχάνεται.
token-optimizer2,853«Βρες τα ghost token» — το μοτίβο offload + ανακτήσιμου handle ενημέρωσε τη σκέψη μας για το offload του CCR.
TokenMizer34Ένα προσχέδιο γραφήματος συνεδρίας + αποδιπλοποίησης γραμμών μεταξύ διαδοχικών turns, που ενημέρωσε τον σχεδιασμό του session-dedup.
OmniCompress3Στηλοθετημένο JSON σε Rust + ανάκτηση βάσει περιεχομένου + αποδιπλοποίηση μεταξύ μηνυμάτων — επικύρωσε τον σχεδιασμό των μηχανών headroom/ccr/session-dedup και το σταθερό ως προς την cache αναλλοίωτο ότι η «συμπιεσμένη μορφή είναι ανεξάρτητη από τη θέση».
mcp-compressor140Συμπίεση σχήματος/περιγραφής εργαλείων MCP — ενημέρωσε τη μείωση της πληθικότητας του manifest εργαλείων MCP.
RepoMapper218Κατάταξη repo-map τύπου Aider — ενημέρωσε τη διερεύνηση του repo-map και της κατάταξης ανάκτησης.
quiet-shell-mcp4Δηλωτική μείωση εξόδου shell μέσω MCP — επικύρωσε τη δηλωτική συμπύκνωση εξόδου bash.
ts-morph6,222Εργαλειοθήκη TypeScript Compiler API — ενέπνευσε την αφαίρεση σχολίων βάσει parser, η οποία διατηρεί τα λεκτικά συμβολοσειρών, template και regex.
### 🧠 Μνήμη και RAG
Έργο⭐Πώς ενέπνευσε το OmniRoute
Mem068,294Καθολικό επίπεδο μνήμης — το μοντέλο του ως proxy-ορίου εγγραφής/ανάγνωσης διαμόρφωσε την αρχιτεκτονική μνήμης μας.
Letta (MemGPT)25,321Κατάστασης agents με ιεραρχική μνήμη — ενέπνευσε το ιεραρχικό μοντέλο Context Control & Recovery (CCR).
WFGY1,804Η ταξινομία ProblemMap των 16 επαναλαμβανόμενων λειτουργικών αποτυχιών RAG/LLM — το κοινό λεξιλόγιο στον οδηγό αντιμετώπισης προβλημάτων μας.
### 🛰️ Επιθεώρηση κίνησης, MITM & διαφανής proxy
Έργο⭐Πώς ενέπνευσε το OmniRoute
llm-interceptor81Η αναχαίτιση/ανάλυση MITM της κίνησης coding-assistant ↔ LLM ενημέρωσε τις αρχικές απαιτήσεις του Traffic Inspector. Τέσσερις μονάδες που είχαν προηγουμένως παραχθεί — συγχώνευση SSE, κανονικοποίηση συνομιλιών, απόκρυψη μυστικών και απολύμανση κεφαλίδων — έχουν αντικατασταθεί από ανεξάρτητες υλοποιήσεις clean-room, βασισμένες σε δημόσια πρότυπα πρωτοκόλλων. Οι δύο επιφάνειες host-passthrough (passthrough.ts και _internal/bypass.cjs) παραμένουν εσωτερικές υλοποιήσεις του OmniRoute, ταξινομημένες ανεξάρτητα· δεν επανεγγράφηκαν στο πλαίσιο αυτής της αντικατάστασης.
ProxyBridge6,978Διαφανής δρομολόγηση proxy ανά διεργασία — ενέπνευσε τον ασφαλή σε περίπτωση κατάρρευσης τερματισμό MITM, τα χρονικά όρια αδράνειας socket, την απόδοση διεργασιών μέσω /proc και τη σύλληψη TPROXY.
### 📚 Δεδομένα μοντέλων, παρατηρησιμότητα & UI
Έργο⭐Πώς ενέπνευσε το OmniRoute
models.dev7,486Ανοιχτή βάση δεδομένων με προδιαγραφές, τιμές και δυνατότητες μοντέλων AI — συγχρονίζεται εγγενώς με τον κατάλογο μοντέλων μας.
React Flow / xyflow38,874Η βιβλιοθήκη γραφημάτων που βασίζεται σε κόμβους και τροφοδοτεί το Compression Studio και το Combo/Routing Studio σε πραγματικό χρόνο.
LangGraph44,349Η οπτικοποίηση γραφήματος ζωντανής ροής εργασίας του LangGraph Studio ενέπνευσε την προβολή καταρράκτη σε πραγματικό χρόνο των Studios μας.
Langfuse36,907Το μοντέλο παρατηρησιμότητας trace → span → generation διαμόρφωσε τον καταρράκτη του Compression Studio.
Kiali3,647Παρατηρησιμότητα service mesh του Istio — ενέπνευσε τις ενδείξεις circuit breaker και τις απεικονίσεις ακμών σφαλμάτων στο Routing/Combo Studio.
lobe-icons2,666Λογότυπα επωνυμιών AI/LLM που αποδίδουν τα εικονίδια παρόχων σε ολόκληρο τον πίνακα ελέγχου μας.
flag-icons12,499Παρέχει τις σημαίες SVG με άδεια MIT που χρησιμοποιούνται στον επιλογέα γλώσσας του README.
### 🛡️ Ασφάλεια
Έργο⭐Πώς ενέπνευσε το OmniRoute
awesome-secure-defaults723Μια επιμελημένη λίστα βιβλιοθηκών με ασφαλείς προεπιλογές, η οποία καθοδηγεί τις επιλογές ασφαλείας μας (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).
### 🧭 Συμπληρωματικά εργαλεία
Έργο⭐Πώς ενέπνευσε το OmniRoute
ClawRouter6,649Ενέπνευσε την αποδιπλοποίηση αιτημάτων, την εφεδρική λύση έκτακτης ανάγκης μηδενικού κόστους, τις pluggable στρατηγικές Auto-Combo και την πολυγλωσσική ταξινόμηση προθέσεων.
Antigravity-Manager32,785Η αντιστοίχιση μοντέλων με επίγνωση λογαριασμού, η επικύρωση διαδρομής εκτελέσιμου αρχείου και η συμπεριφορά ετικετών προγράμματος ενημέρωσαν το runtime Antigravity του OmniRoute.
vscode-antigravity-cockpit4,852Η συμπαγής μορφή αντίστροφης μέτρησης επαναφοράς ποσόστωσης ενέπνευσε την αντίστοιχη εμφάνιση ορίου παρόχου στο OmniRoute.
AionUi33,996Οι ενσωματώσεις ACP ενέπνευσαν την αυτόματη ανίχνευση εγκατεστημένων agents CLI από το OmniRoute.
CodexBar22,955Εντόπισε την επιφάνεια ποσόστωσης του Grok Build· στη συνέχεια το OmniRoute επαλήθευσε και διόρθωσε ανεξάρτητα τη ζωντανή μορφή wire.
## 📄 Άδεια χρήσης Άδεια MIT - δείτε το [LICENSE](LICENSE) για λεπτομέρειες. ---
**[⬆ Επιστροφή στην κορυφή](#-omniroute)** · Δημιουργήθηκε με ❤️ για την κοινότητα AI ανοιχτού κώδικα. Δημιουργήθηκε από τον Diego Souza · OmniRoute v3.8.54 · Node ≥22.22.2 · Άδεια MIT · omniroute.online