# README (Ελληνικά) 🌐 **Languages:** 🇺🇸 [English](../../../README.md) · 🇸🇦 [ar](../ar/README.md) · 🇦🇿 [az](../az/README.md) · 🇧🇬 [bg](../bg/README.md) · 🇧🇩 [bn](../bn/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) · 🇮🇱 [he](../he/README.md) · 🇮🇳 [hi](../hi/README.md) · 🇭🇷 [hr](../hr/README.md) · 🇭🇺 [hu](../hu/README.md) · 🇮🇩 [id](../id/README.md) · 🇮🇹 [it](../it/README.md) · 🇯🇵 [ja](../ja/README.md) · 🇰🇷 [ko](../ko/README.md) · 🇱🇹 [lt](../lt/README.md) · 🇱🇻 [lv](../lv/README.md) · 🇮🇳 [mr](../mr/README.md) · 🇲🇾 [ms](../ms/README.md) · 🇲🇹 [mt](../mt/README.md) · 🇳🇱 [nl](../nl/README.md) · 🇳🇴 [no](../no/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) · 🇸🇰 [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) · 🇻🇳 [vi](../vi/README.md) · 🇨🇳 [zh-CN](../zh-CN/README.md) · 🇹🇼 [zh-TW](../zh-TW/README.md) ---

# 🚀 OmniRoute — Η Δωρεάν Πύλη AI OmniRoute — Never stop coding. Every AI tool → 355 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 355 AI providers · 150+ free tiers · ~1.51B free tokens/mo · 19 routing strategies · $0 to start.

OmniRoute — Never stop coding. Every AI tool → 355 providers — 150+ free — through one endpoint. Claude Code, Codex, Cursor, Cline, Copilot & Antigravity into FREE Claude / GPT / Gemini with auto-fallback. RTK + Caveman stacked compression saves 15–95% tokens (~89% avg) — never hit limits. 355 AI providers · 150+ free tiers · ~1.51B free tokens/mo · 19 routing strategies · $0 to start.

## 💰 ~1,51 δισ. Δωρεάν Tokens / Μήνα

> Η χειροκίνητη συγκέντρωση δωρεάν επιπέδων είναι επίπονη — δεκάδες SDK, δεκάδες όρια ρυθμού, και καμία ιδέα για το πόσα έχετε πραγματικά. Το OmniRoute καταγράφει **446 καταχωρήσεις δωρεάν επιπέδων σε 38 επαναλαμβανόμενα κλειδιά pool** και υπολογίζει τον αριθμό tokens από τα **20 pool με δημοσιευμένο θετικό μηνιαίο προϋπολογισμό**, αφαιρώντας διπλότυπα ανά κοινό pool. Το αποτέλεσμα παραμένει ορατό στον πίνακα ελέγχου (`/dashboard/free-tiers`).

> Κινούμενη περίληψη της ζωντανής σελίδας `/dashboard/free-tiers`. Πλήρης μεθοδολογία (αφαίρεση διπλότυπων pool, πιστωτικά επίπεδα, όροι παρόχου): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{Αυτά τα στοιχεία επανελέγχονται κάθε δύο εβδομάδες σε σχέση με τον ζωντανό κατάλογο και **κινούνται και προς τις δύο κατευθύνσεις** — ένας πάροχος τερματίζει ένα δωρεάν επίπεδο και ο αριθμός μειώνεται· ένα νέο εμφανίζεται και ανεβαίνει. Δημοσιεύουμε αυτό που ο κατάλογος πραγματικά υπολογίζει, ποτέ μια στρογγυλεμένη προς τα πάνω καλύτερη περίπτωση.}

⭐ Δώστε αστέρι στο repo αν το OMNIROUTE σας βοήθησε να εξοικονομήσετε χρήματα και να κάνετε τη δουλειά σας πιο εύκολη.

[![Stars](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![Star History Rank](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) ### 💬 Γίνετε μέλος της κοινότητας **👋 Ακολουθήστε τον συντηρητή — λάβετε πρώτοι νέους παρόχους, εκδόσεις & συμβουλές:** [![Follow Diego on 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/) [![Follow @diegosouzapw on 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 Brasil](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) [![Website](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **Ερωτήσεις, συμβουλές για παρόχους, οδικός χάρτης & υποστήριξη → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 Global](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [Portal](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 Η Πύλη Συνεχίζει να Μεγαλώνει

| | v3.8.49 | **v3.8.50** | `v3.8.51+` | | ----------------------------------------- | :-----: | :-----------------------: | :--------------------: | | 🌐 Πάροχοι | 290 | **352** | περισσότεροι στην ουρά | | 🧠 Μοναδικά IDs μοντέλων chat | 1185 | **1312** | — | | 🖼️ Γέφυρα Τρόπων | — | 🆕 vision + audio + video | — | | 📡 Δωρεάν κατάλογος Radar | — | 🆕 opt-in | — | | ⚖️ Χρονοπρογραμματισμός με επίγνωση ορίων | — | 🆕 Quota-Share | — | | 📊 Τηλεμετρία ορίων | — | 🆕 ζωντανά | — | **→ [Οδικός Χάρτης](ROADMAP.md) — στον δρόμο προς `v3.9.0 LTS`**

## 🧩 Διαθέσιμο [![npm version](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM Monthly](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) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker Pulls](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron Downloads](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 Έναρξη	🚀 Γρήγορη Εκκίνηση	📦 Εγκατάσταση	🆓 Μηδενική διαμόρφωση
💡 Μάθε	💥 Η Υπόσχεση	🤔 Γιατί OmniRoute	🏆 Τι το Ξεχωρίζει
⚙️ Λειτουργίες	🎯 Combos	🌐 Πάροχοι	🔌 CLI & MCP
	🗜️ Συμπίεση	🖥️ Πού Τρέχει	🔒 Ιδιωτικό
👀 Δες το	🎬 Σε Δράση	✨ Τι Νέο Υπάρχει	🤖 Συμβατά CLIs
💚 Υποστήριξη	💚 Υποστήριξη / Δωρεά	💬 Κοινότητα	💖 Χορηγοί
📦 Έργο	🛠️ Τεχνολογικό Σύνολο	📖 Τεκμηρίωση	👥 Συνεισφέροντες

🌐 Σε 42 γλώσσες

## 🆓 Λειτουργεί αμέσως μετά την εγκατάσταση — χωρίς κλειδιά, χωρίς ρύθμιση

Λειτουργεί αμέσως μετά την εγκατάσταση — μηδενική ρύθμιση. Τρία βήματα: 1. Εγκατάσταση — npm i -g omniroute, ο διακομιστής εκκινεί στο localhost:20128. 2. Κατεύθυνε το εργαλείο σου στο http://localhost:20128/v1 — οποιοδήποτε εργαλείο συμβατό με OpenAI (Claude Code, Cursor, Cline). 3. Απαντά — κάλεσε το μοντέλο auto για άμεση απάντηση, χωρίς κλειδί API, χωρίς εγγραφή, χωρίς ρύθμιση. Ο πάροχος χωρίς κλειδί OpenCode Free είναι προ-συνδεδεμένος στον συνδυασμό auto, οπότε μια νέα εγκατάσταση ανταποκρίνεται αμέσως.

```bash # Νέα εγκατάσταση, χωρίς διαπιστευτήρια — το `auto` λειτουργεί ήδη: curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{Προτιμάς συγκεκριμένο δωρεάν backend; Κάλεσε το `oc/…` (OpenCode Free) απευθείας. Μετά προχώρησε στο `auto` και άσε το OmniRoute να επιλέξει.} _{📦 Σενάρια quickstart για αντιγραφή-επικόλληση για **Python, Node.js, PHP και cURL** → [`examples/quickstart/`](examples/quickstart/)}

# 💥 Η Υπόσχεση

# 🤔 Γιατί OmniRoute;

Ροή αιτήματος OmniRoute: το IDE ή CLI σου (Claude Code, Cursor, Cline…) καλεί ένα τοπικό endpoint (http://localhost:20128/v1)· ο Smart Router OmniRoute (RTK + Caveman compression, 19 στρατηγικές δρομολόγησης, circuit breakers, TLS stealth, MCP, A2A, guardrails) μπορεί να κάνει εναλλακτική δρομολόγηση σε 4 επίπεδα παρόχων όσο υπάρχει κατάλληλος υγιής προορισμός — Επίπεδο 1 Συνδρομή, Επίπεδο 2 Κλειδί API, Επίπεδο 3 Φθηνό και Επίπεδο 4 Δωρεάν.

## 🤝 Υποστηρίζεται από τους Φίλους μας στο Open Source

> **Θέλετε να συμμετάσχετε ως Φίλος Open Source;** Αυτές είναι οι εταιρείες που στηρίζουν το open source και βοηθούν το OmniRoute να συνεχίζει — και δηλώνουμε δημόσια πού πηγαίνει κάθε token που μας δίνουν. Επικοινωνήστε: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} Ευχαριστούμε τον Kimi (Moonshot AI), τον ιδρυτικό μας Φίλο Open Source, για την υποστήριξη αυτού του έργου! Το Kimi είναι το εργαστήριο τεχνητής νοημοσύνης πίσω από τις οικογένειες μοντέλων ανοιχτών βαρών K2 και K3 — το Kimi K3 προσφέρει παράθυρο περιβάλλοντος 1M token, εγγενή όραση και κωδικοποίηση επιπέδου frontier σε κλάσμα του κόστους των κλειστών μοντέλων, και λειτουργεί αμέσως με το Claude Code, το Codex και κάθε εργαλείο κωδικοποίησης που εξυπηρετεί το OmniRoute.

Τι τροφοδοτεί η υποστήριξη του Kimi: Τα API credits του Kimi τροφοδοτούν τον pipeline κυκλοφορίας με επικύρωση AI του OmniRoute — το στάδιο επικύρωσης συγχώνευσης από το Kimi K3 που αξιολογεί κάθε pull request πριν αυτό κυκλοφορήσει — καθώς και την καθημερινή ανάπτυξη λειτουργιών. Η πρωτοβάθμια υποστήριξη Kimi είναι διαθέσιμη και στις δύο γραμμές: το άμεσο Kimi API (kimi-k3) και το πλάνο κωδικοποίησης Kimi Code (OAuth και API key). Το OmniRoute είναι επίσης το πρώτο βραζιλιάνικο έργο ανοιχτού κώδικα στο πρόγραμμα υποστήριξης του Kimi. Αποκτήστε ένα Kimi API key με 15% επιπλέον credits →

Cheaper Inference
_{cheaperinference.com} Ευχαριστούμε το Cheaper Inference, Φίλο Open Source του OmniRoute, για την υποστήριξη αυτού του έργου! Το Cheaper Inference είναι ένα gateway ταξινομημένο βάσει κόστους που μεταπωλεί 42 frontier μοντέλα — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok και MiniMax — πίσω από ένα endpoint συμβατό με OpenAI, δρομολογώντας κάθε αίτημα στον φθηνότερο επιλέξιμο πάροχο χωρίς ποτέ να χρεώνει πάνω από την τιμή καταλόγου του κατασκευαστή μοντέλου.

Πρωτοβάθμια υποστήριξη στο OmniRoute: Chat Completions, το εγγενές endpoint /v1/responses, vision, tool calling και 3 μοντέλα εικόνας (grok-imagine, nano-banana-pro, nano-banana-2, προσβάσιμα ως cheaperinference/<model>). Αποκτήστε ένα API key →

_{Οι σύνδεσμοι με ετικέτα aff=omniroute είναι σύνδεσμοι συνεργατών. Χρηματοδοτούν το έργο χωρίς επιπλέον κόστος για εσάς.}

_{🎟️ Προσφορές Συνεργατών — δωρεάν κουπόνια εγγραφής από παρόχους που δεν μας χορηγούν (κάντε κλικ για ανάπτυξη)}

_{Αυτή η ενότητα αφορά μόνο κωδικούς παραπομπής/κουπόνια. Οι χορηγούμενες συνεργασίες βρίσκονται στην ενότητα 🤝 Υποστηρίζεται από τους Φίλους μας στο Open Source παραπάνω. Το OmniRoute δεν έχει χορηγία ή συνεργασία με τους παρόχους που αναφέρονται εδώ — αυτά είναι δημόσια κουπόνια που μπορεί να χρησιμοποιήσει ο καθένας.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — εγγραφή συνεργάτη · $100 δωρεάν credits κατά την εγγραφή (δωρεάν διακομιστής, αναμένετε υψηλότερη καθυστέρηση — κατάλληλο για δοκιμές, όχι για παραγωγή). Πρωτοβάθμια υποστήριξη στο OmniRoute από την v3.8.50: Chat Completions, η μορφή wire συμβατή με Anthropic και η διαδρομή συμβατή με OpenAI. Τα διαθέσιμα μοντέλα περιλαμβάνουν claude-opus-4-8, claude-opus-5, gpt-5.6-sol και άλλα. Πάρτε τα $100 σας →}

_{⚠️ Σύνδεσμος συνεργάτη — το OmniRoute δεν έχει χορηγία ή συνεργασία με αυτόν τον πάροχο.}

_{Γνωρίζετε άλλον πάροχο με γενναιόδωρο δωρεάν κουπόνι εγγραφής που ωφελεί τους χρήστες του OmniRoute; Ανοίξτε ένα issue και θα το προσθέσουμε εδώ.}

## 🎯 Combos — Η Ναυαρχίδα

Και οι 19 στρατηγικές δρομολόγησης combo σε κίνηση — ένα πλακίδιο ανά στρατηγική: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. Δείτε τον παραπάνω πίνακα για το τι κάνει η καθεμία.

> Ένα **combo** είναι μια αλυσίδα μοντέλων στην οποία το OmniRoute δρομολογεί **αυτόματα**. Αν εξαντληθεί η ποσόστωση, αποτύχει ένας πάροχος ή εκτιναχθεί το κόστος, το combo μπορεί να μεταβεί στο επόμενο υγιές μοντέλο που πληροί τις προϋποθέσεις. 🛡️ ### ⚡ Μηδενική ρύθμιση — απλώς χρησιμοποιήστε το `auto` Δεν χρειάζεται να δημιουργήσετε combo. Ορίστε το μοντέλο σας σε `auto` (ή μια παραλλαγή) και το OmniRoute δημιουργεί ένα εικονικό combo από τους συνδεδεμένους παρόχους σας, βαθμολογημένο σε πραγματικό χρόνο:

ID Μοντέλου	Τι βελτιστοποιεί
`auto`	🎯 Ισορροπημένη προεπιλογή (LKGP — παραμένει στον τελευταίο καλό πάροχό σας)
`auto/coding`	🧑💻 Βάρη με προτεραιότητα στην ποιότητα για παραγωγή κώδικα
`auto/fast`	⚡ Χαμηλότερη λανθάνουσα κατάσταση πρώτα
`auto/cheap`	💰 Φθηνότερο ανά token πρώτα
`auto/offline`	🔋 Μεγαλύτερη ποσόστωση / περιθώριο ορίου ρυθμού πρώτα
`auto/smart`	🔭 Προτεραιότητα στην ποιότητα + 10% εξερεύνηση για ανακάλυψη καλύτερων μοντέλων
`auto/lkgp`	📌 Ρητή παραμονή στον τελευταίο γνωστό-καλό-πάροχο
`auto/chaos`	🧪 Βάρη έγχυσης σφαλμάτων για δοκιμές ανθεκτικότητας (chaos engineering)

## ### 🔀 Ή φτιάξτε το δικό σας — 19 στρατηγικές δρομολόγησης Και οι **19** στρατηγικές — συνδυάστε τις ελεύθερα ανά βήμα combo:

#	Στρατηγική	Τι κάνει
1	`priority`	Διατεταγμένη λίστα με πρώτο στόχο — εξαντλεί τον καθένα πριν προχωρήσει στον επόμενο 🥇
2	`fill-first`	Γεμίζει πλήρως την ποσόστωση κάθε στόχου πριν προχωρήσει
3	`weighted`	Τυχαία επιλογή με βάση βαρύτητα ανά στόχο
4	`round-robin`	Εναλλαγή μεταξύ στόχων με σειρά
5	`p2c`	Τυχαία εξισορρόπηση φόρτου power-of-two-choices
6	`least-used`	Επιλέγει τον στόχο με το χαμηλότερο τρέχον φορτίο
7	`random`	Ομοιόμορφη τυχαία επιλογή (χωρίς επανάληψη)
8	`strict-random`	Τυχαία επιλογή χωρίς αποεπανάληψη 🎲
9	`cost-optimized`	Ελαχιστοποίηση $ ανά αίτημα από τιμοκατάλογο σε πραγματικό χρόνο 💸
10	`headroom`	Επιλέγει τον στόχο με το μεγαλύτερο υπολειπόμενο περιθώριο ποσόστωσης
11	`reset-window`	Προτιμά τον στόχο του οποίου το παράθυρο ποσόστωσης επαναφέρεται συντομότερα
12	`reset-aware`	Κατάταξη με βάση τον χρόνο επαναφοράς ποσόστωσης — πρώτα τα σύντομα παράθυρα 📊
13	`context-relay`	Μεταβίβαση πλαισίου μεταξύ στόχων για μακρές συνομιλίες 🧠
14	`context-optimized`	Επιλέγει τον καλύτερο στόχο για το τρέχον μέγεθος πλαισίου
15	`cache-optimized`	Καρφιτσώνει κάθε επαναχρησιμοποιήσιμο πρόθεμα προτροπής στον ίδιο λογαριασμό — μέγιστες επιτυχίες προσωρινής αποθήκευσης προτροπής 🎯
16	`lkgp`	Τελευταία Γνωστή Καλή Διαδρομή — καρφιτσώνει στον τελευταίο επιτυχή πάροχο, κατόπιν εφαρμόζει εναλλακτικούς κανόνες
17	`auto`	Ζωντανή βαθμολόγηση 16 παραγόντων σε κάθε σύνδεση 🤖
18	`fusion`	Εκπομπή σε ομάδα μοντέλων + ένας κριτής συνθέτει μία απάντηση 🧬
19	`pipeline`	Αλυσίδα βημάτων — η έξοδος κάθε στόχου τροφοδοτεί τον επόμενο 🔗

_{Η μηχανή Auto-Combo βαθμολογεί κάθε υποψήφιο με βάση **16 παράγοντες** (υγεία, ποσόστωση, κόστος, λανθάνουσα κατάσταση, καταλληλότητα εργασίας, ποιότητα, διαθεσιμότητα συνεδρίας…) — δείτε [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 Η ανθεκτικότητα είναι ενσωματωμένη (3 ανεξάρτητα επίπεδα)

Ανθεκτικότητα OmniRoute — 3 ανεξάρτητα επίπεδα αυτο-επούλωσης, το κατάλληλο επίπεδο για κάθε τύπο αποτυχίας. Επίπεδο 1 διακόπτης κυκλώματος παρόχου (ολόκληρος ο πάροχος): ενεργοποιείται μόνο για 408/5xx, κατώφλια OAuth 8× / κλειδί-API 12× / τοπικό 2×, επαναφορά 60s/30s/15s σε δοκιμαστική κατάσταση HALF-OPEN, ανάκτηση με τεμπελιά· ενώ είναι ΑΝΟΙΧΤΟΣ το combo δρομολογεί στον επόμενο πάροχο. Επίπεδο 2 ψύξη σύνδεσης (ένα κλειδί/λογαριασμός): βάση 5s OAuth / 3s κλειδί-API, εκθετική υπαναχώρηση ×2 με προστασία αντι-thundering-herd, το 429 τιμά το Retry-After, η επιτυχία καθαρίζει όλη την κατάσταση σφάλματος· ένα κλειδί που ψύχεται παραλείπεται ενώ τα αδελφά κλειδιά συνεχίζουν να εξυπηρετούν. Επίπεδο 3 αποκλεισμός μοντέλου (ένα μοντέλο): 429 ανά μοντέλο, τοπικό 404 ή αρνήσεις λειτουργίας κλειδώνουν μόνο αυτό το μοντέλο — ποτέ ολόκληρη τη σύνδεση. Τερματικές καταστάσεις (αποκλεισμός, λήξη, εξάντληση πιστώσεων) αφορούν τον χειριστή, όχι ψύξεις.

_{📖 [Μηχανή Auto-Combo](docs/routing/AUTO-COMBO.md) · [Οδηγός Ανθεκτικότητας](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 Τι Ξεχωρίζει το OmniRoute

_{📊 Πλήρης μεθοδολογία & λεπτομέρειες ανά λειτουργία σε σχέση με τα 9router, OpenRouter, CLIProxyAPI & LiteLLM → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 Υποστήριξη του OmniRoute Το OmniRoute διαθέτει άδεια MIT και συντηρείται δημόσια. Αν σας εξοικονομεί χρόνο ή χρήμα, δείτε πώς μπορείτε να το διατηρήσετε ανεξάρτητο — επιλέξτε ό,τι σας ταιριάζει. Η χορηγία δεν επηρεάζει ποτέ την προτεραιότητα δρομολόγησης· αγοράζει ορατότητα, όχι κατάταξη.

⭐ Δώστε αστέρι στο αποθετήριο	Δωρεάν — βοηθά πραγματικά στην ορατότητα	Αστέρι στο 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 (κάντε κλικ για ανάπτυξη)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ Αποστέλλετε κάθε νόμισμα μόνο στο δίκτυο που αναγράφεται — η αποστολή σε λάθος δίκτυο μπορεί να οδηγήσει σε απώλεια των κεφαλαίων.}

🐛 Βρήκατε ένα σφάλμα ή έχετε σχόλια; Ανοίξτε μια [Συζήτηση](https://github.com/diegosouzapw/OmniRoute/discussions).

Σημειώσεις προγραμματιστή: Το έργο ενδέχεται να δημιουργήσει ένα τοπικό αρχείο .env κατά την εκτέλεση npm install/postinstall για την ευκολία των προγραμματιστών. Αυτό το αρχείο αγνοείται σκόπιμα μέσω του .gitignore (δείτε .gitignore) και δεν πρέπει ποτέ να υποβληθεί — αν υποβληθεί κατά λάθος, αντικαταστήστε τυχόν εκτεθειμένα μυστικά και αφαιρέστε το αρχείο από το ιστορικό. Δείτε docs/DEVELOPER-ENVIRONMENT.md για οδηγίες σχετικά με τη διαχείριση τοπικών αρχείων περιβάλλοντος και μυστικών.

## 📡 OmniRoute Radar Η κύρια δωρεάν επικεφαλίδα παραμένει **~1,51 δισ. token/μήνα** από τον τεκμηριωμένο, κατάλογο με αφαίρεση διπλοτύπων παρόχων που αναφέρεται παραπάνω. Προσωρινές πιστώσεις εγγραφής παρόχου μπορούν ξεχωριστά να ανεβάσουν τον πρώτο μήνα στα **~2,13 δισ.**. Το Radar είναι ένα προαιρετικό, υπογεγραμμένο επίστρωμα καταλόγου για άτομα που θέλουν πιο ενημερωμένη διαθεσιμότητα δωρεάν μοντέλων μεταξύ των εκδόσεων OmniRoute· ο κοινοτικός κατάλογος και κάθε υπάρχον δωρεάν χαρακτηριστικό παραμένουν δωρεάν. Οι υποστηρικτές μπορούν να λάβουν τον ζωντανό κατάλογο και επιπλέον ευκαιρίες παρόχων. Το ξεχωριστό, μεταβλητό ανώτατο όριο του είναι **περίπου 3 δισ. token/μήνα κατ' ανώτατο**, ανάλογα με τη διαθεσιμότητα παρόχου. Αυτό το ανώτατο όριο δεν αποτελεί εγγύηση: οι πάροχοι μπορούν να αλλάξουν ποσοστώσεις, επιλεξιμότητα, μοντέλα ή περιοχές ανά πάσα στιγμή. Το Radar είναι προαιρετικό και μόνο GET. Ο client OmniRoute δεν ανεβάζει prompt, κίνηση, ρυθμίσεις παρόχου, τηλεμετρία χρήσης ή τοπική κατάσταση απόρριψης ανακοινώσεων. Μάθετε για την επιλεξιμότητα και τον τρέχοντα κατάλογο στη διεύθυνση **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**.

## ✨ Τι Νέο Υπάρχει

> Πρόσφατες κορυφαίες αλλαγές από την **v3.8.20 → v3.8.50**. Πλήρες ιστορικό στο [`CHANGELOG.md`](CHANGELOG.md). - **🎛️ OmniConductor** — εισερχόμενη ανάθεση A2A στον στόλο agent σας, δεξιότητες Conductor στο Agent Card, και πίνακας dashboard με φωνητική συνομιλία push-to-talk Faro. → [A2A Server](docs/frameworks/A2A-SERVER.md) - **🛂 Προσαρμοστική αποδοχή & προστασία από υπερφόρτωση** — τα βαριά αιτήματα chat μπαίνουν σε ουρά αντί να λαμβάνουν 503, με ατομικές κυλιόμενες εκμισθώσεις RPM ανά σύνδεση. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ Κανονική ταξινόμηση `/v1/models`** — ένα συνεχόμενο μπλοκ ομαδοποιημένο ανά πάροχο για κάθε πάροχο (οι συνδυασμοί καρφιτσωμένοι πρώτα), σταθερό σε κάθε πηγή καταλόγου. → [API Reference](docs/reference/API_REFERENCE.md) - **🗜️ Ενίσχυση συμπίεσης** — inflation guard ενεργό εξ ορισμού, Caveman packs για DE / FR / JA + Κινεζικά (wényán), φίλτρα RTK για Gradle & .NET. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **💸 Ειλικρινής σταθερό κόστος** — οι πάροχοι συνδρομής / προγράμματος κωδικοποίησης εμφανίζουν **$0** στην ανάλυση κόστους· ο προϋπολογισμός, η ποσόστωση και η δρομολόγηση συνεχίζουν να εκτιμούν. → [API Reference](docs/reference/API_REFERENCE.md) - **⚖️ Δρομολόγηση Quota-Share** — διανέμει δίκαια την ποσόστωση ενός κοινού λογαριασμού σε κλειδιά pool, με διατήρηση εργασίας ώστε αδρανείς κατανομές να δανείζονται. → [Resilience Guide](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 Εγκατάσταση CLI/agent με μία εντολή** — 13 καταχωρημένες εντολές `setup-*`· το `omniroute run` εκκινεί 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI)· το `omniroute configure` υποστηρίζει 10 στόχους με διαδραστικό επιλογέα παρόχου+μοντέλου και αγαπημένα ανά πλαίσιο. → [CLI Integrations](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ Απομακρυσμένη λειτουργία** — οδηγήστε ένα απομακρυσμένο OmniRoute με διακριτικά εμβέλειας (`connect` / `contexts` / `tokens`) + έναν βοηθό `antigravity` OAuth για εγκαταστάσεις VPS. → [Remote Mode](docs/guides/REMOTE-MODE.md) - **🧭 Εξυπνότερη αυτόματη δρομολόγηση** — συνδυασμοί `auto/:`, **Fusion** (πίνακας μοντέλων + κριτής), δρομολόγηση ανά εργασία, παρακάμψεις μοντέλου / λειτουργίας / USD-budget ανά αίτημα. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ Συμπίεση με δυνατότητα προσθήκης** — 12 συνδυαστικές μηχανές + Compression Studios: LLMLingua-2, Ultra δύο επιπέδων, omniglyph, πύλη πιστότητας ανά βήμα, GCF v3.2, επεξεργαστής με αναδιάταξη drag. → [Compression](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ Διαφανής αποκρυπτογράφηση MITM (TPROXY)** — καταγράφει CLI που αγνοούν μεταβλητές περιβάλλοντος proxy, με CA ανά SNI + εγκαταστάτη αποθήκης εμπιστοσύνης. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 Τηλεμετρία κόστους παντού** — κεφαλίδες κόστους/χρήσης `X-OmniRoute-*` σε κάθε endpoint, κεφαλίδα εξοικονόμησης cache-HIT, ποσοστώσεις δαπάνης USD ανά κλειδί. → [API Reference](docs/reference/API_REFERENCE.md) - **🧠 Μνήμη υπό τον έλεγχό σας** — ανενεργή εξ ορισμού, προαιρετική κβαντοποίηση διανύσματος int8 + τυποποιημένη φθορά, `x-omniroute-no-memory` ανά αίτημα. → [Memory](docs/frameworks/MEMORY.md) - **🛡️ Ασφάλεια** — φύλακας έγχυσης prompt σε κάθε διαδρομή LLM (σουίτα red-team), προαιρετική ασπίδα απόκρυψης διαπιστευτηρίων (αποκρύπτει διαρρεόντα κλειδιά API/μυστικά και στις δύο κατευθύνσεις), δωρεάν αναζήτηση web DuckDuckGo ως έσχατη λύση, και προαιρετική πύλη σύνδεσης OIDC για το dashboard (η σύνδεση με κωδικό πρόσβασης παραμένει πάντα διαθέσιμη). → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ Νέα endpoint** — `/v1/ocr` (Mistral OCR) και `/v1/audio/translations` (τύπου Whisper) συμπληρώνουν την επιφάνεια πολυμέσων. → [API Reference](docs/reference/API_REFERENCE.md) - **🎨 Δημιουργία εικόνας / βίντεο / ήχου** — ένα API για πολυμέσα: xAI Grok Imagine & Novita AI βίντεο, ComfyUI, Magnific, Adobe Firefly, Segmind, και πάροχοι ομιλίας όπως ElevenLabs. → [API Reference](docs/reference/API_REFERENCE.md) - **🌍 Ανάπτυξη & λειτουργίες** — `basePath` αντίστροφου proxy, αυτόματη ανίχνευση γλώσσας browser, παρακολούθηση συσκευής ανά κλειδί, εμπιστοσύνη MITM χωρίς root, τοπικοποίηση zh-TW. → [Environment](docs/reference/ENVIRONMENT.md) - **🤝 Περισσότεροι πάροχοι & agents** — cloud agents (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… και ανανεωμένος **κατάλογος 352 παρόχων**. → [Providers](docs/reference/PROVIDER_REFERENCE.md) - **📡 Διαφάνεια δρομολόγησης** — κάθε απόκριση φέρει κεφαλίδα `X-OmniRoute-Decision` που ονομάζει τη στρατηγική/πάροχο/καθυστέρηση που την εξυπηρέτησε, νέα στρατηγική συνδυασμού `cache-optimized` + παράγοντας `cacheAffinity` Auto-Combo που δρομολογεί επαναλαμβανόμενα αιτήματα πίσω στη σύνδεση που κατέχει το αποθηκευμένο πρόθεμα, και ένα endpoint μόνο-ανάγνωσης `/v1/auto-combo/{channel}/candidates` που εκθέτει το ζωντανό pool υποψηφίων ενός καναλιού `auto/*`. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ Τοπική απόδοση & υποδομή** — τοπικό Redis με ένα κλικ, αναπτυκτήρες relay Cloudflare Workers / Deno Deploy, Bifrost & Mux ως εποπτευόμενες ενσωματωμένες υπηρεσίες. → [Embedded Services](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 Επίσης στο πακέτο** — πλαίσιο plugin + marketplace, πλαίσια δεξιοτήτων Omni/Agent/GitHub, ενοποίηση αποθήκης Obsidian (22 εργαλεία MCP), API Batch & Files συμβατά με OpenAI, σημασιολογική cache αποκρίσεων, gamification με πίνακες κατάταξης, ανακάλυψη agent ACP (15 ενσωματωμένοι agents), προγραμματισμένη εξαγωγή αρχείων καταγραφής στο BigQuery, έγχυση σφαλμάτων `auto/chaos`, γέφυρα bot Telegram, ενδοεφαρμογικός διαχειριστής εκδόσεων και κατατάξεις δωρεάν παρόχων LMArena-ELO. → [Docs](docs/README.md)

## 🤖 Συμβατά CLIs & Κωδικοί Πράκτορες > Μία ρύθμιση — `http://localhost:20128/v1` — και **κάθε** AI IDE ή CLI τρέχει με δωρεάν και χαμηλού κόστους μοντέλα.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_{Agent Deck}

＋ λειτουργεί επίσης με · Kiro · Command Code · Antigravity · Windsurf · AMP · οποιοδήποτε εργαλείο συμβατό με OpenAI

_{📖 Ρύθμιση ανά εργαλείο για όλα τα 36 εργαλεία (26 CLI Code + 10 CLI Agents) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 Πρόσθετο OpenCode → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**Εκκινήστε οποιοδήποτε υποστηριζόμενο CLI μέσω του OmniRoute με μία εντολή** — χωρίς αρχεία ρυθμίσεων, τα διαπιστευτήρια εισάγονται ανά διεργασία, τα Qwen/Gemini αποκτούν μια μεμονωμένη απομονωμένη αρχική κατάλογο: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # Ή επιλέξτε παρόχο+μοντέλο διαδραστικά και γράψτε τη δική του ρύθμιση του εργαλείου: omniroute configure codex # επίσης: claude opencode qwen aider goose gemini cline continue kilo ``` Κάθε εντολή τιμά το ενεργό απομακρυσμένο πλαίσιο (`omniroute connect `), η `--dry-run` προεπισκοπεί ακριβώς το περιβάλλον/ορίσματα χωρίς εκτέλεση, και η `--api-key-env NAME` κρατά τα μυστικά εκτός του ιστορικού του κελύφους. → [Ενσωματώσεις CLI](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 352 Πάροχοι AI — 152 Σημασμένοι ως Δωρεάν στον Κατάλογο

> **352 καταχωρημένοι πάροχοι** στις κανονικές συλλογές chat, media, search, local, cloud-agent και system, συμπεριλαμβανομένων **152 που φέρουν μεταδεδομένα ανακάλυψης `hasFree: true`**. Το μητρώο μοντέλων chat καλύπτει **229 παρόχους / 2.554 διακριτά ζεύγη παρόχου-μοντέλου / 1.283 ακατέργαστα αναγνωριστικά μοντέλων**· ο ξεχωριστός κατάλογος ελεύθερου προϋπολογισμού έχει **446 γραμμές ανά μοντέλο**, **38 επαναλαμβανόμενες δεξαμενές** και **53 επαναλαμβανόμενους/χωρίς κλειδί παρόχους ελεύθερους για πάντα**. Πρόκειται για διαφορετικούς παρονομαστές εκ σχεδιασμού· οι ορισμοί και οι υπολογισμοί με αφαίρεση διπλοτύπων δεξαμενών βρίσκονται στην [Αναφορά Παρόχων](docs/reference/PROVIDER_REFERENCE.md) και στα [Δωρεάν Επίπεδα](docs/reference/FREE_TIERS.md).

### 🏢 Κάθε μεγάλο εργαστήριο — μέσω ενός endpoint

_OpenAI	_Anthropic	_Gemini	_{xAI Grok}	_DeepSeek	_Mistral
_Qwen	_{Meta Llama}	_Groq	_NVIDIA	_MiniMax	_Cohere
_Perplexity	_HuggingFace	_Together	_Fireworks	_Cloudflare	_Baidu

_{…και 330+ ακόμα — κάθε εικονίδιο φορτώνεται ζωντανά από τον κατάλογο παρόχων του πίνακα ελέγχου. 📖 [Αναφορά Παρόχων](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 Δωρεάν για Πάντα — $0, χωρίς κάρτα

OpenCode Zen _{DeepSeek V4, Nemotron 3 Χωρίς όριο token}	Kilo Code _{Auto-router, Tencent Hy3 Δωρεάν για πάντα}	Requesty _{GPT-OSS 120B, Nemotron Δωρεάν για πάντα}	SiliconFlow _{DeepSeek V3.2 / R1 Δωρεάν επίπεδο}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Δωρεάν για πάντα}	Baidu ERNIE _{ERNIE 4.0 Δωρεάν για πάντα}
Qoder AI _{Qwen3-Max, Kimi-K2 Απεριόριστα ΔΩΡΕΑΝ}	Pollinations _{GPT, Llama, Claude Χωρίς κλειδί}	Cloudflare AI _{50+ μοντέλα 10K neurons/day}	NVIDIA NIM _{GLM, MiniMax ~40 RPM δωρεάν}	Cerebras _{GLM 4.7, GPT-OSS 1M tokens/day}	OpenRouter _{:free μοντέλα +$10 → υψηλότερο RPM}

📖 Πλήρης αναγνώσιμος από μηχανή κατάλογος → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Πού Τρέχει το OmniRoute — Παντού

> Η ίδια εφαρμογή, στο δικό σου μηχάνημα, με τους δικούς σου κανόνες. Από μια καθολική εγκατάσταση npm μέχρι **το τηλέφωνό σου** μέσω Termux.

Πλατφόρμα	Εγκατάσταση	Χαρακτηριστικά
📦 npm (global)	`npm install -g omniroute`	Μία εντολή, οποιοδήποτε ΛΣ
🐳 Docker	`docker run … diegosouzapw/omniroute`	Πολλαπλές αρχιτεκτονικές AMD64 + ARM64
🖥️ Desktop (Electron)	`npm run electron:build`	Εγγενές παράθυρο + system tray — Windows / macOS / Linux
💪 ARM	native `arm64`	Raspberry Pi, διακομιστές ARM, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Τρέχει στο τηλέφωνό σου, 24/7, χωρίς root
📲 PWA	"Προσθήκη στην Αρχική Οθόνη"	Πλήρης οθόνη, offline, εγκαταστάσιμο από το πρόγραμμα περιήγησης
🧩 OpenCode plugin	`@omniroute/opencode-provider`	Εγγενής ενσωμάτωση OpenCode
🤖 VS Code Copilot Chat	εγκατάσταση επέκτασης OmniCopilot	Κάθε μοντέλο OmniRoute στο εγγενές πρόγραμμα επιλογής Copilot Chat — stable & Insiders
🛠️ Από τον πηγαίο κώδικα	`npm install && npm run dev`	Τροποποίησέ το, συνεισέφερε

_{📖 [Οδηγός Docker](docs/guides/DOCKER_GUIDE.md) · [Desktop](electron/README.md) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 Νέο: OmniRoute μέσα στο εγγενές Copilot Chat του VS Code

> Χωρίς νέα πλαϊνή μπάρα, χωρίς νέο περιβάλλον συνομιλίας — κάθε μοντέλο που εξυπηρετεί το OmniRoute εμφανίζεται απευθείας στο > **πρόγραμμα επιλογής μοντέλου Copilot Chat που ήδη χρησιμοποιείς**. Από το VS Code 1.122, τα μοντέλα παρόχου λειτουργούν > χωρίς σύνδεση GitHub ή συνδρομή Copilot — agent mode, κλήση εργαλείων και vision, δωρεάν. Εγκατέστησε την επέκταση **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)**, κατεύθυνέ την στον διακομιστή OmniRoute σου (προεπιλογή `localhost:20128`), και στη συνέχεια άνοιξε Copilot Chat → πρόγραμμα επιλογής μοντέλου → **Manage Models…** → **OmniRoute**.

Κατάστημα	Σύνδεσμος	Λειτουργεί με
🧩 VS Code Marketplace	Εγκατάσταση →	VS Code — stable & Insiders
🔓 Open VSX Registry	Εγκατάσταση →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Μέσα από τον επεξεργαστή: άνοιξε την προβολή **Extensions**, αναζήτησε **"OmniRoute"**, κάνε κλικ στο **Install** — λειτουργεί με τον ίδιο τρόπο και στα δύο καταστήματα. Ο πηγαίος κώδικας, τα ζητήματα και το εγχειρίδιο δημοσίευσης βρίσκονται στο [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot). _{📖 [Οδηγός VS Code Copilot Chat](docs/guides/VSCODE-COPILOT.md) — ρύθμιση, τι εμφανίζει το πρόγραμμα επιλογής, dashboard σε καρτέλα, αντιμετώπιση προβλημάτων}

## 🔒 Ιδιωτικό & Τοπικά-Πρώτα

Ιδιωτικό και τοπικά-πρώτα — η πύλη και το επίπεδο ελέγχου του 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 # εκκίνηση πύλης + dashboard (port 20128) omniroute chat # διαδραστικός TUI chat client (slash: /model /combo /skill /memory) omniroute setup # οδηγός πρώτης εκτέλεσης omniroute doctor # διάγνωση παρόχων, ports, εγγενών εξαρτήσεων ``` ### 🛰️ Απομακρυσμένη λειτουργία — εκτελέστε το CLI εδώ, το OmniRoute σε VPS Το OmniRoute σε διακομιστή; Οδηγήστε το από το laptop σας με το **ίδιο CLI**. Συνδεθείτε μία φορά με ένα scoped access token· κάθε εντολή απευθύνεται στη συνέχεια στο απομακρυσμένο. ```bash omniroute connect 192.168.0.15 # κωδικός πρόσβασης → scoped token, αποθηκεύεται ως context omniroute models list # ← εκτελείται στον ΑΠΟΜΑΚΡΥΣΜΕΝΟ διακομιστή omniroute configure codex # ← επιλέγει απομακρυσμένο μοντέλο, δημιουργεί τοπικό Codex profile omniroute tokens create --name ci --scope read # δημιουργία πιο περιορισμένων tokens για άλλα μηχανήματα omniroute contexts use default # ← επιστροφή στον τοπικό διακομιστή ``` Τα tokens έχουν εμβέλεια `read` / `write` / `admin`· οι διαδρομές εκκίνησης διεργασιών παραμένουν μόνο loopback. _{📖 [Απομακρυσμένη Λειτουργία](docs/guides/REMOTE-MODE.md)}

Κινούμενο terminal που επιδεικνύει το OmniRoute CLI — omniroute providers list, omniroute combo list και omniroute health — κυκλώνοντας την επιφάνεια κορυφαίου επιπέδου 86 εντολών: 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** — οποιοσδήποτε ικανός πράκτορας (ή ο δικός σας κώδικας) αποκτά τα κλειδιά ολόκληρης της πύλης: δρομολόγηση, πάροχοι, combos, cache, συμπίεση, μνήμη — αυτόνομα. Τα HTTP endpoints παρακάτω εξυπηρετούνται στο `http://localhost:20128`.

Διεπαφή	Endpoint / εντολή	Χρήση για
🧰 MCP (stdio)	`omniroute --mcp`	Σύνδεση με Claude Desktop, Cursor, οποιονδήποτε MCP client
🌊 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 — chat, embeddings, εικόνες, ήχος, OCR
🔔 Webhooks	`/api/webhooks`	Αποστολή συμβάντων αιτημάτων / ορίου σε Slack, Discord, Telegram ή οποιοδήποτε URL
🛰️ Απομακρυσμένο CLI	`omniroute connect`	Οδήγηση απομακρυσμένης εγκατάστασης με scoped access tokens

```bash # Δώστε στο Claude Code το πλήρες σύνολο εργαλείων OmniRoute μέσω MCP: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP Server](docs/frameworks/MCP-SERVER.md) · [A2A Server](docs/frameworks/A2A-SERVER.md) · [Πρωτόκολλα Πράκτορα](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ Εξοικονόμηση 15–95% Tokens — Αυτόματα

### 📖 Πώς λειτουργεί — pipeline, αρχιτεκτονική & μαθηματικά εξοικονόμησης

Pipeline συμπίεσης OmniRoute: ένα ενδεικτικό αίτημα πελάτη 10.000 token διέρχεται από 12 συνθέσιμες μηχανές — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra και OmniGlyph — και μπορεί να φτάσει στον πάροχο με περίπου 1.080 token στο τεκμηριωμένο παράδειγμα στοίβαξης. Το δομημένο περιεχόμενο προστατεύεται από guards διατήρησης και πύλες πιστότητας ανά βήμα· οι ρητές lossy ή πειραματικές λειτουργίες μπορεί να μετασχηματίσουν επιλέξιμο περιεχόμενο.

Ο προεπιλεγμένος συνδυασμός στοίβαξης εκτελεί `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% ``` Τα μπλοκ κώδικα, URLs, JSON και δομημένα δεδομένα **προστατεύονται πάντα** από τη μηχανή διατήρησης. > **Γιατί να χρησιμοποιείς πολλά token όταν λίγα αρκούν;** Κάθε αίτημα διέρχεται από το pipeline συμπίεσης του OmniRoute **διαφανώς** — χωρίς αλλαγές στον πελάτη. Είναι πλέον μια **στοίβα από 12 συνθέσιμες μηχανές** που εκτελούνται με σειρά και συνδυάζονται ανά routing combo — βασιζόμενες σε ιδέες από τα [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) και [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR). ### 🧱 Η στοίβα 12 μηχανών Οι μηχανές εκτελούνται με σειρά pipeline· κάθε μία μπορεί να ενεργοποιηθεί/απενεργοποιηθεί ανεξάρτητα και να ρυθμιστεί ανά combo:

#	Μηχανή	Τι κάνει
1	Session-Dedup	Αφαιρεί περιεχόμενο που επαναλαμβάνεται μεταξύ γύρων (content-addressed, cross-turn)
2	CCR	Αρχειοθετεί μεγάλα μπλοκ πίσω από δείκτες ανάκτησης, που λαμβάνονται κατ' απαίτηση
3	Lite	Κλάδεμα κενού χώρου + URLs εικόνων (ελαφριά βάση ως προς καθυστέρηση)
4	RTK	Έξυπνο φιλτράρισμα αποτελεσμάτων εργαλείων, dedup & αποκοπή (command-aware)
5	Responses Tool Output	Συμπίεση JSON με προτεραιότητα lossless + φραγμένη διαγνωστική συμπίεση για εξόδους shell/patch/search/build (Responses API)
6	Headroom	Lossless συμπύκνωση πινάκων JSON arrays (~30%) μέσω ενσωματωμένου κωδικοποιητή GCF
7	Relevance	Εξαγωγική βαθμολόγηση προτάσεων ως προς το τελευταίο ερώτημα χρήστη
8	Caveman	Συμπίεση πεζογραφίας βάσει κανόνων (~65–75% στην έξοδο)
9	Aggressive	Περίληψη + προοδευτική γήρανση παλαιών γύρων
10	LLMLingua-2	ML σημασιολογική κλάδευση μέσω MobileBERT ONNX — code-safe, async
11	Ultra	Ευρετική κλάδευση token με προαιρετικό επίπεδο small-model (SLM)
12	OmniGlyph	Πειραματική κωδικοποίηση πλαισίου-ως-εικόνα για μετρημένο Claude Fable 5 στο άμεσο Anthropic wire· οι μετασχηματιστές GPT 5.6 παραμένουν fail-closed εν αναμονή παραλαβών παρόχου. Τέσσερα προφίλ συμπίεσης (aggressive προεπιλογή, balanced, coding-safe, passthrough) (πιο aggressive· opt-in)

Τα μπλοκ κώδικα, URLs και δομημένα δεδομένα **διατηρούνται πάντα** byte-perfect. Τα **προεπιλεγμένα με ένα κλικ** συνδυάζουν τις μηχανές:

Λειτουργία	Εξοικονόμηση	Κατάλληλο για
🪶 Lite	~15%	Πάντα ενεργή ασφαλής προεπιλογή
🪨 Standard (Caveman)	~30%	Καθημερινό coding
⚡ Aggressive	~50%	Μεγάλες συνεδρίες με πολλά εργαλεία
🔥 Ultra	~75%	Μέγιστη εξοικονόμηση
🧰 RTK	60–90%	Έξοδος shell/test/build/git
🔗 Stacked (RTK → Caveman)	78–95%	Μικτά prompts + αρχεία καταγραφής εργαλείων

**Πραγματικό παράδειγμα — Λειτουργία Standard:** > **Πριν (69 token):** _"The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I would recommend using useMemo to memoize the object."_ > > **Μετά (19 token):** _"New object ref each render. Inline object prop = new ref = re-render. Wrap in useMemo."_ > > **Ίδια απάντηση. 72% λιγότερα token. Μηδενική απώλεια ακρίβειας.** ✅ **Παράδειγμα PT-BR — Λειτουργία [Troglodita](https://github.com/leninejunior/troglodita):** > **Antes (42 token):** _"O problema é que o componente está re-renderizando porque uma nova referência de objeto está sendo criada em cada ciclo de renderização. Eu recomendaria usar useMemo."_ > > **Depois (12 token):** _"Re-render: ref nova cada ciclo (objeto inline recriado). Usar `useMemo`."_ > > **Mesma resposta. ~70% menos tokens. Precisão técnica intacta.** ✅
### 🎚️ Πέρα από τις μηχανές — στυλ εξόδου, το προσαρμοστικό ρυθμιστικό & έλεγχος ανά αίτημα Οι 12 μηχανές παραπάνω συρρικνώνουν αυτό που εισέρχεται. Τρία ακόμη επίπεδα διαμορφώνουν το **πώς**, το **πότε** και αυτό που **εξέρχεται**: - **🪄 Στυλ Εξόδου** _(καθοδήγηση άξονα εξόδου)_ — εισάγουν ντετερμινιστικές, cache-safe οδηγίες διαμόρφωσης απόκρισης· συνδυάσιμα, το καθένα σε ένταση `lite` / `full` / `ultra`. Η προσθήκη ενός στυλ είναι μία γραμμή στο μητρώο: - **Terse prose** — αφαίρεση γεμιστικών / άρθρων / επιφυλάξεων· διατήρηση τεχνικής ουσίας ακριβώς. - **Less code** — "lazy senior dev" YAGNI: ελάχιστη λειτουργική αλλαγή, χωρίς ζητούμενη σκαλωσιά. - **Ponytail (lazy senior dev)** — ανέβαση στη σκάλα YAGNI, διόρθωση της ρίζας του προβλήματος, ελάχιστο λειτουργικό diff. - **I have ADHD (action-first)** — η επόμενη ενέργεια πρώτη, βήματα αριθμημένα, ένα συγκεκριμένο επόμενο βήμα, χωρίς εισαγωγή. - **Terse CJK (文言)** — εξαιρετικά σύντομο ύφος κλασικών κινεζικών (με προϋπόθεση locale `zh`). - **🎯 Προσαρμοστικός προϋπολογισμός πλαισίου** _(το ρυθμιστικό)_ — αντί για ένα on/off κατώφλι token, κλιμακώνει τις φθηνότερες, πιο lossless μηχανές μόνο όσο χρειάζεται για να **χωρέσει στο παράθυρο πλαισίου του μοντέλου**. Πολιτική: `reserve-output` (προεπιλογή, model-aware) · `percentage` · `absolute`. Λειτουργία: `floor` (εγγύηση χωρητικότητας) · `replace-autotrigger` (η ρητή επιλογή σου κερδίζει) · `off` (παλαιό κατώφλι). - **🎛️ Πού αποφασίζεται η συμπίεση** _(προτεραιότητα, υψηλή → χαμηλή)_ — header `x-omniroute-compression` ανά αίτημα › παράκαμψη routing-combo › ενεργό επώνυμο προφίλ › adaptive / auto-trigger › προεπιλογή πίνακα › off. Το εφαρμοζόμενο πλάνο επιστρέφει στο header απόκρισης `X-OmniRoute-Compression: ; source=`. Αυτόματη ενεργοποίηση βάσει κατωφλίου token, ενεργοποίηση του προσαρμοστικού ρυθμιστικού, καρφίτσωμα επώνυμου προφίλ, ορισμός εφάπαξ ανά αίτημα ή ανάθεση pipeline ανά routing combo — όποιο ταιριάζει στο φόρτο εργασίας. Ένα opt-in 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). Πίνακας εργαλείων στο `http://localhost:20128` · API στο `http://localhost:20128/v1`. **2) Σύνδεση ΔΩΡΕΑΝ παρόχου (χωρίς εγγραφή)** Πίνακας εργαλείων → **Providers** → σύνδεση **Kiro AI** (δωρεάν Claude, ~50 credits/μήνα ανά λογαριασμό) ή **OpenCode Free** (χωρίς auth) → έτοιμο. **3) Ρύθμιση εργαλείου coding** ```txt Base URL: http://localhost:20128/v1 API Key: [αντιγραφή από Πίνακα εργαλείων → Endpoints] Model: auto (έξυπνο routing μηδενικής ρύθμισης — ή οποιοσδήποτε πάροχος/μοντέλο) ``` **4) Επαλήθευση λειτουργίας** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` Θα δεις τα συνδεδεμένα μοντέλα σου καταχωρισμένα. 🎉 Αυτό είναι όλο — ξεκίνα να γράφεις κώδικα και το OmniRoute δρομολογεί αυτόματα & κάνει fallback για σένα. Αν ο πελάτης σου δεν μπορεί να στείλει custom headers, το OmniRoute εκθέτει επίσης tokenized ψευδώνυμα συμβατότητας: ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` Χρησιμοποίησε αυτά μόνο για πελάτες που δεν μπορούν να επισυνάψουν `Authorization: Bearer ...`. Η αυθεντικοποίηση μέσω header παραμένει ο προτιμώμενος τρόπος.
## 📦 Περισσότερες μέθοδοι εγκατάστασης — 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-08-24 · Ακατέργαστος κατάλογος: YT 809 | TT 137 | IG 124 · Φρεσκάδα (ημέρες): YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — 3.042.474 προβολές}

🎬 #2 — Instagram
_{theopenstack — 692.419 προβολές}

🎬 #3 — TikTok
_{milesreevesai — 620.400 προβολές}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391.109 προβολές}

🎬 #5 — Instagram
_{buildwithai.club — 347.652 προβολές}

**Πλήρης κατάταξη (κανονικές URL απο-διπλοτυποποιημένες, `v > 0`, μεγαλύτερη εμβέλεια):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3.042.474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692.419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620.400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391.109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347.652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331.973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263.744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218.174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186.786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177.800** | Κανονικές μετρικές στις 2026-08-24: **1.029 μοναδικά βίντεο** · **11.132.922 γνωστές προβολές** (`v > 0`) · **639 κανάλια/προφίλ ανά δίκτυο**. Ο ακατέργαστος πίνακας περιέχει 1.070 γραμμές· 41 διπλότυπα του Instagram κανονικοποιήθηκαν βάσει κανονικής URL, διατηρώντας τον μεγαλύτερο αριθμό ανά βίντεο. > 🎬 **Φτιάξατε βίντεο για το OmniRoute;** Ανοίξτε ένα [issue](https://github.com/diegosouzapw/OmniRoute/issues/new) ή μια [συζήτηση](https://github.com/diegosouzapw/OmniRoute/discussions) με τον σύνδεσμο — θα το προβάλουμε εδώ.

# 📧 Κοινότητα & Βοήθεια > Όλα σε ένα μέρος — ακολουθήστε τον συντηρητή, συνομιλήστε με την κοινότητα ή ανοίξτε ένα issue. | Κανάλι | Πού / πώς | | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | 💼 **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 Community (δωρεάν)** | [portal 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) |

---

## 🛠️ Τεχνολογική Στοίβα

Επίπεδο	Τεχνολογία
Εκτελεστικό Περιβάλλον	Node.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)
Πλαίσιο	Next.js 16 + React 19 + Tailwind CSS 4
Βάση Δεδομένων	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 122 ενότητες τομέα, 168 migrations
Μνήμη	SQLite FTS5 πλήρης αναζήτηση κειμένου + διανυσματικές ενσωματώσεις ποσοτικοποιημένες με 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 + ελεγχόμενη αυθεντικοποίηση MCP · AES-256-GCM κρυπτογράφηση σε ηρεμία · DOMPurify
Απόκρυψη	wreq-js — πλαστοπροσωπία δακτυλικών αποτυπωμάτων JA3 / JA4 TLS, 3-επίπεδο proxy
Ανθεκτικότητα	Διακόπτης κυκλώματος, εκθετική αναμονή, αντι-thundering-herd, αυτόματη αυτο-επιδιόρθωση combo
Καταγραφή	pino — δομημένα JSON αρχεία καταγραφής με πλαίσιο αιτήματος
Δοκιμές	Node.js test runner + Vitest — 39.000+ στατικές δηλώσεις δοκιμών σε 5.100+ παρακολουθούμενα αρχεία δοκιμών (μονάδας, ενσωμάτωσης, E2E, ασφάλειας, οικοσυστήματος)
Πλατφόρμες	Επιτραπέζιος (Electron) · Android (Termux) · PWA (οποιοδήποτε πρόγραμμα περιήγησης)
CI/CD	GitHub Actions — αυτόματη δημοσίευση npm + Docker Hub κατά την κυκλοφορία
Σύνδεσμοι	Ιστότοπος · npm · Docker Hub

## 📖 Τεκμηρίωση

### 📘 Ξεκινώντας

Έγγραφο	Περιγραφή
Οδηγός Χρήστη	Πάροχοι, combos, ενσωμάτωση CLI, ανάπτυξη
Οδηγός Εγκατάστασης	Πλήρεις μέθοδοι εγκατάστασης, διαμορφώσεις εργαλείων CLI, ρύθμιση πρωτοκόλλου, συντονισμός χρονικού ορίου
Οδηγός Εργαλείων CLI	Ρύθμιση ανά εργαλείο για Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Απομακρυσμένη Λειτουργία	Χειρισμός απομακρυσμένου OmniRoute (VPS) από το CLI του φορητού σας υπολογιστή μέσω ελεγχόμενων διακριτικών πρόσβασης
Διαμόρφωση Claude Code	Κατεύθυνση του Claude Code στο OmniRoute (τοπικό/απομακρυσμένο) με `launch` + προφίλ ανά μοντέλο
Γρήγορη Εκκίνηση	Εγκατάσταση σε 3 βήματα → σύνδεση → διαμόρφωση

### 🔧 Λειτουργίες & Ανάπτυξη

Έγγραφο	Περιγραφή
Οδηγός Docker	Εκτέλεση Docker, προφίλ Compose, HTTPS με Caddy, σήραγγες, ετικέτες εικόνας
Οδηγός Podman	Ενσωμάτωση Quadlet systemd, podman-compose, SELinux
Ανάπτυξη σε VM	Πλήρης οδηγός: ρύθμιση VM + nginx + Cloudflare
Ανάπτυξη στο Fly.io	Ανάπτυξη στο Fly.io με μόνιμη αποθήκευση
Οδηγός Termux	Εκτέλεση OmniRoute σε Android μέσω Termux
Οδηγός PWA	Εγκατάσταση Progressive Web App, προσωρινή αποθήκευση, αρχιτεκτονική
Οδηγός Απεγκατάστασης	Καθαρή αφαίρεση για όλες τις μεθόδους εγκατάστασης
Διαμόρφωση Περιβάλλοντος	Πλήρεις μεταβλητές `.env` και αναφορές

### 🧠 Χαρακτηριστικά & Αρχιτεκτονική

Έγγραφο	Περιγραφή
Αρχιτεκτονική	Αρχιτεκτονική συστήματος, ροή δεδομένων και εσωτερική λειτουργία
Οδηγός Συμπίεσης	Αγωγός 7 επιλογών: off / lite / standard / aggressive / ultra / RTK / stacked
Συμπίεση RTK	Συμπίεση εξόδου εντολών, φίλτρα, εμπιστοσύνη, επαλήθευση, ανάκτηση ακατέργαστης εξόδου
Μηχανές Συμπίεσης	Caveman, RTK, αγωγοί stacked, επιφάνειες dashboard/API/MCP
Μορφή Κανόνων Συμπίεσης	Σχήματα JSON rule-pack για φίλτρα Caveman και RTK
Πακέτα Γλωσσών Συμπίεσης	Ανίχνευση γλώσσας και σύνταξη rule-pack Caveman
Οδηγός Ανθεκτικότητας	Διακόπτες κυκλώματος, χρόνοι ψύξης, ουρά, αντι-thundering herd, παραποίηση TLS
Μηχανή Auto-Combo	Βαθμολόγηση 16 παραγόντων, πακέτα λειτουργιών, αυτο-επιδιόρθωση
Οδηγός Proxy	Σύστημα proxy 3 επιπέδων, αγορά 1proxy, CRUD μητρώου
Δωρεάν Επίπεδα	Ενοποιημένος κατάλογος: 38 τεκμηριωμένες επαναλαμβανόμενες δεξαμενές / 446 καταγεγραμμένες εγγραφές δωρεάν επιπέδου
Γκαλερί Χαρακτηριστικών	Οπτική περιήγηση στο dashboard με στιγμιότυπα οθόνης
Τεκμηρίωση Κώδικα	Φιλική για αρχάριους περιήγηση στον κώδικα

### 🤖 Πρωτόκολλα & APIs

Έγγραφο	Περιγραφή
Αναφορά API	Όλα τα endpoints με παραδείγματα
Προδιαγραφή OpenAPI	Προδιαγραφή OpenAPI 3.0
Διακομιστής MCP	110 εργαλεία MCP, διαμορφώσεις IDE, πελάτες Python/TS/Go
Οδηγός Διακομιστή MCP	Εγκατάσταση MCP, μεταφορές και αναφορά εργαλείων
Διακομιστής A2A	Πρωτόκολλο JSON-RPC 2.0, δεξιότητες, ροή, διαχείριση εργασιών
Οδηγός Διακομιστή A2A	Κάρτα πράκτορα A2A, εργασίες, δεξιότητες και ροή

### 📋 Έργο & Ποιότητα

Έγγραφο	Περιγραφή
Συμβολή	Ρύθμιση ανάπτυξης και οδηγίες
Μοντέλο Διακλάδωσης & Κυκλοφορίας	Στόχοι PRs (`release/*`), τι σημαίνουν το `main` και οι ετικέτες
Αρχείο Αλλαγών	Πλήρες ιστορικό κυκλοφοριών ανά έκδοση
Πολιτική Ασφάλειας	Αναφορά ευπαθειών και πρακτικές ασφαλείας
Οδηγός i18n	Υποστήριξη 42 γλωσσών, ροή εργασίας μετάφρασης, RTL
Λίστα Ελέγχου Κυκλοφορίας	Βήματα επικύρωσης πριν την κυκλοφορία
Σχέδιο Κάλυψης	Στρατηγική κάλυψης δοκιμών για 39.000+ στατικές δηλώσεις δοκιμών σε 5.100+ παρακολουθούμενα αρχεία δοκιμών

# ⭐ Κορυφαίοι Συνεισφέροντες > Το OmniRoute διαμορφώνεται από μια παθιασμένη κοινότητα ανοιχτού κώδικα. Αυτά τα άτομα έχουν κάνει εξαιρετικές συνεισφορές που επηρεάζουν άμεσα την ποιότητα, τη σταθερότητα και την εμβέλεια του έργου. **Ευχαριστούμε.** ### Εξωτερικοί συνεισφέροντες βάσει συγχωνευμένων pull requests

Κατάταξη	Συνεισφέρων	Συγχωνευμένα PRs	~Αλλαγμένες γραμμές
1	backryun	190	227.977
2	oyi77	180	407.678
3	rdself	145	80.663
4	JxnLexn	128	387.049
5	KooshaPari	101	125.747
6	herjarsa	88	230.872
7	RaviTharuma	79	55.106
8	maxmad64bis	69	394.715
9	artickc	59	33.260
10	HouMinXi	51	47.334
10	chirag127	51	5.153
12	xz-dev	50	245.976
13	hartmark	47	52.185
14	rqzbeh	39	143.181
15	dhaern	34	19.559
16	Dingding-leo	33	1.986
17	NomenAK	32	13.854
18	MumuTW	30	16.953
19	benzntech	29	11.641
20	pacocartones	24	9.331
20	Prudhvivuda	24	6.312

_{Καταψυγμένο στην κορυφή του release/v3.8.50 με commit dafb4ae808, με συγχωνεύσεις έως 2026-08-24 05:26:03 UTC. Η σελιδοποιημένη απογραφή GitHub GraphQL περιέχει 5.911 συγχωνευμένα PRs: 2.707 από τον ιδιοκτήτη του αποθετηρίου, 179 από το Dependabot, και 3.025 εξωτερικά PRs από 535 διαφορετικούς συνεισφέροντες. «Αλλαγμένες γραμμές» είναι οι προσθήκες + διαγραφές του GitHub και περιλαμβάνουν παραγόμενα αρχεία, lockfiles, καταλόγους, μεταφράσεις και τεκμηρίωση· είναι ανακύκλωση, όχι πραγματικές γραμμές κώδικα. Ισοβαθμίες στο όριο διατηρούνται.} ### Commits που αποδίδονται στο GitHub

backryun _{🥇 220 commits που αποδίδονται στο GitHub}	Paijo _{🥈 219 commits που αποδίδονται στο GitHub}	Randi _{🥉 108 commits που αποδίδονται στο GitHub}	Ravi Tharuma _{🏅 81 commits που αποδίδονται στο GitHub}	Chris _{🏅 70 commits που αποδίδονται στο GitHub}	Markus Hartung _{🏅 69 commits που αποδίδονται στο GitHub · ισοβαθμία #6}
Dizzle _{🏅 69 commits που αποδίδονται στο GitHub · ισοβαθμία #6}	Jan Leon _{🏅 64 commits που αποδίδονται στο GitHub}	zenobit _{🏅 62 commits που αποδίδονται στο GitHub}	Bob.Hou _{🏅 51 commits που αποδίδονται στο GitHub · ισοβαθμία #10}	Xiangzhe _{🏅 51 commits που αποδίδονται στο GitHub · ισοβαθμία #10}

_{Επανελέγχθηκε στις 2026-08-24 06:14:31 UTC: commits που αποδίδονται στο GitHub όπως αναφέρονται από το Contributors API του αποθετηρίου για τον προεπιλεγμένο κλάδο release/v3.8.50. Το API επέστρεψε 525 ταυτότητες (415 χρήστες, 2 bots, 108 ανώνυμοι)· αυτός ο πίνακας εξαιρεί τον συντηρητή, τα bots και τις ανώνυμες ταυτότητες και διατηρεί ισοβαθμίες στον ανταγωνισμό. Διαφέρει τόσο από την κατάταξη συγχωνευμένων PRs παραπάνω όσο και από την απογραφή μεταδεδομένων Git 639 ατόμων παρακάτω.} > 🙏 Τα χαρακτηριστικά, οι διορθώσεις σφαλμάτων και οι βελτιώσεις υποδομής αυτών των συνεισφερόντων αποτελούν **βασικό μέρος** αυτού που κάνει το OmniRoute αξιόπιστο και πλούσιο σε χαρακτηριστικά. Κάθε pull request, κάθε περίπτωση δοκιμής και κάθε αρχείο μετάφρασης i18n έχει σημασία. Ο ανοιχτός κώδικας χτίζεται από ανθρώπους σαν αυτούς.

---
## 💖 Χορηγοί

Ένα ολόθερμο ευχαριστώ στους ανθρώπους που χρηματοδοτούν το OmniRoute από την τσέπη τους — κάθε συνεισφορά κρατά το έργο δωρεάν, ανεξάρτητο και σε κίνηση.

Andrew
_{💛 Ενεργός μηνιαίος χορηγός}

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

Paco Cartones
_{💛 Ενεργός εφάπαξ χορηγός}

Καθ. Igor Morais
_{💛 Παλαιός εφάπαξ υποστηρικτής}

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

_{… και άλλοι που προτιμούν να παραμείνουν ανώνυμοι 💛} _{Δημόσιοι χορηγοί GitHub επαναληπτικά ελεγμένοι στις 2026-08-24. Η κατάσταση activeOnly του GitHub καθορίζει τις ετικέτες ενεργών παραπάνω· οι προηγουμένως αποκαλυφθέντες δημόσιοι εφάπαξ υποστηρικτές εξακολουθούν να ευχαριστούνται, και οι ιδιωτικοί χορηγοί παραμένουν ανώνυμοι.} 💖 Γίνε χορηγός → — κάθε δολάριο κρατά το OmniRoute δωρεάν και ανεξάρτητο.

## 👥 600+ Συνεισφέροντες

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{Ελεγμένο στις 2026-08-24 στη δεσμευμένη βάση ac02c5b42f και επανελεγμένο στο ενεργό άκρο release/v3.8.50 dafb4ae808: 639 κανονικοποιημένες ανθρώπινες Git ταυτότητες — 407 εμφανίζονται ως συγγραφείς commit (συμπεριλαμβανομένου του συντηρητή) και 232 μόνο σε ρητά Co-authored-by trailers. Η απογραφή κανονικοποιεί τα noreply handles του GitHub, εξαιρεί 26 ταυτότητες bot/agent/υπηρεσίας/placeholder, και δεν συγχωνεύει κοινές διευθύνσεις email μόνο και μόνο επειδή τα εμφανιζόμενα ονόματά τους ταιριάζουν.} ### Πώς να Συνεισφέρεις 1. Κάνε fork το αποθετήριο 2. Διακλαδώσου από το **ενεργό** άκρο `release/vX.Y.Z` (όχι από το `main`) — δες [Branching & Release Model](docs/ops/BRANCHING_MODEL.md) 3. Δημιούργησε τον κλάδο της λειτουργίας σου (`git checkout -b feat/amazing-feature`) 4. Κάνε commit τις αλλαγές σου (`git commit -m 'feat: add amazing feature'`) 5. Κάνε push στον κλάδο (`git push origin feat/amazing-feature`) 6. Άνοιξε ένα Pull Request με **base = εκείνον τον κλάδο `release/vX.Y.Z`** Δες το [CONTRIBUTING.md](CONTRIBUTING.md) για λεπτομερείς οδηγίες. ### Κυκλοφορία Νέας Έκδοσης ```bash # Δημιούργησε μια έκδοση — το npm publish γίνεται αυτόματα VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 Αστέρια

## 🌍 StarMapper

## 🙏 Ευχαριστίες

Το OmniRoute στηρίζεται σε γίγαντες. Ξεκίνησε ως fork του **[9router](https://github.com/decolua/9router)** και ως μεταφορά σε TypeScript του έργου Go **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — και από εκεί, κάθε υποσύστημα παρακάτω εμπνεύστηκε από ένα έργο ανοιχτού κώδικα που έφτασε εκεί πρώτο. Καθένα διαμόρφωσε ένα συγκεκριμένο κομμάτι του OmniRoute. Αυτό είναι το ευχαριστώ μας σε όλους τους. 🙏 > ⭐ Οι αριθμοί αστεριών επαληθεύτηκαν από το REST API του GitHub στις 24 Αυγούστου 2026 — πηγαίνετε να δώσετε αστέρι σε αυτά τα έργα. Οι αριθμοί είναι ακριβές χρονολογημένο στιγμιότυπο και θα αλλάξουν φυσικά. ### 🧬 系譜 & πύλη

Έργο	⭐	Πώς ενέπνευσε το OmniRoute
9router	26.161	Το αρχικό έργο πάνω στο οποίο βασίζεται αυτό το fork — επεκτάθηκε εδώ με πολυτροπικά APIs και πλήρη επανεγγραφή σε TypeScript.
CLIProxyAPI	48.497	Η υλοποίηση σε Go που ενέπνευσε αυτή τη μεταφορά σε JavaScript / TypeScript.
LiteLLM	57.100	Η πύλη AI της οποίας το δημόσιο σύνολο δεδομένων τιμολόγησης τροφοδοτεί τον συγχρονισμό παρακολούθησης κόστους και της οποίας το μοντέλο κανονικοποίησης παρόχων ενημέρωσε τη δρομολόγησή μας.
codex-chatgpt-web	1.410	Πηγαίος κώδικας MIT προσαρμοσμένος στη vendored γέφυρα ChatGPT Web → Codex Responses, συμπεριλαμβανομένων προσαρμογέων browser-session, response-framing, χρήσης και web-search.
free-claude-code	48.112	Μοτίβα που μεταφέρθηκαν στην ανάκτηση ροής, ψευδώνυμα χωρίς-σκέψη, εναλλακτική αναζήτηση web, όρια κυλιόμενου παραθύρου, απόκρυψη καταγραφών και ενισχυμένες ροές εκκίνησης.
composer-api	322	Μοτίβα επιλογής εργαλείων, περιορισμού εξόδου και δέσμευσης εργαλείων του Cursor Composer προσαρμοσμένα στον εγγενή εκτελεστή Cursor.
codex-multi-auth	457	Μοτίβα νέας σύνδεσης και εναλλαγής refresh-token μεταφερμένα στην επαναπιστοποίηση Codex OAuth.
opencode-anthropic-auth	510	Προεπιλογές μετασχηματισμού συμβατές με Claude Code και συμπεριφορά billing-header γενικευμένη στη γέφυρα βάσει διαμόρφωσης του OmniRoute.
grok2api-merged	2	Οι αντιστοιχίσεις μοντέλων Grok, ο γεννήτορας Statsig τύπου fake-TypeError, οι προεπιλογές αιτήματος και συσκευής, και ο επεξεργαστής απόκρισης NDJSON προσαρμόστηκαν ουσιαστικά στον εκτελεστή Grok Web του OmniRoute.
TQZHR/grok2api	705	Η κύρια μεταβατική πηγή κώδικα πίσω από το grok2api-merged· οι υλοποιήσεις μοντέλου, κεφαλίδας, payload, Statsig και επεξεργαστή διατηρούνται στη γενεαλογία Grok Web.
chenyme/grok2api	7.520	Η υποκείμενη πηγή MIT για τις προεπιλογές payload και συσκευής Grok, τον γεννήτορα Statsig και τον επεξεργαστή `result.response` που μεταφέρθηκε μέσω TQZHR και grok2api-merged.
grok2api-pro	27	Μια μεταβατική πηγή που αναφέρεται από το grok2api-merged για το επίπεδο proxy-pool· το OmniRoute διατηρεί αυτή την ειδοποίηση γενεαλογίας αλλά δεν ισχυρίζεται μεταφορά proxy-pool στον περιορισμένο εκτελεστή Grok Web.
GrokProxy	50	Ο proxy Grok με πιστοποίηση cookie και το μοτίβο ροής `result.response.token` ενημέρωσαν τη μεταφορά Grok Web του OmniRoute.
GrokBridge	5	Η αρχική υλοποίηση Grok Web συμβουλεύτηκε τον σχεδιασμό HTTP/browser upstream· η άμεση HTTP διαδρομή της προέρχεται από το GrokProxy, οπότε δεν διεκδικείται ανεξάρτητη μεταφορά κώδικα.
grok-web-api	14	Τα σχήματα `ChatOptions` και envelope απόκρισης σε Rust ενημέρωσαν τους τύπους αιτήματος Grok και απόκρισης ροής σε TypeScript του OmniRoute.

### 🗜️ Συμπίεση περιεχομένου & διακριτικών — μηχανές

Έργο	⭐	Πώς ενέπνευσε το OmniRoute
Caveman	100.538	Το viral έργο "γιατί να χρησιμοποιείς πολλά διακριτικά όταν λίγα κάνουν τη δουλειά" — η φιλοσοφία caveman-speak τροφοδοτεί την τυπική λειτουργία συμπίεσης και 30+ κανόνες πλήρωσης/συμπύκνωσης.
RTK – Rust Token Killer	77.185	Συμπίεση εξόδου εντολών υψηλής απόδοσης — ενέπνευσε τη μηχανή RTK, το DSL φίλτρου JSON, την ανάκτηση ακατέργαστης εξόδου και τη στοιβαγμένη αγωγό RTK → Caveman.
headroom	67.310	Αναστρέψιμη συμπίεση περιεχομένου (SmartCrusher) — ενέπνευσε τη μηχανή `headroom` και το μοτίβο ανάκτησης-δείκτη `ccr`.
LLMLingua	6.598	Έρευνα συμπίεσης prompt (LLMLingua / LLMLingua-2) — ενέπνευσε τη μηχανή `llmlingua` που είναι ασύγχρονη, ασφαλής για κώδικα και ανθεκτική σε αποτυχίες.
llmlingua-2-js	31	Η μεταφορά JS/ONNX (MobileBERT / XLM-RoBERTa) που χρησιμοποιείται ως backend worker-thread για τη μηχανή LLMLingua μας.
Troglodita	40	Συμπίεση διακριτικών PT-BR — τροφοδοτεί το γλωσσικό πακέτο pt-BR: μείωση πλεονασμού και αφαίρεση γεμιστικών λέξεων βελτιστοποιημένη για τη βραζιλιάνικη-πορτογαλική γραμματική.
ponytail	108.957	Η viral δεξιότητα YAGNI-coding του "τεμπέλη senior dev" — ενέπνευσε το Στυλ Εξόδου less-code: καθοδήγηση ελάχιστης-λειτουργικής-αλλαγής που μειώνει τον _παραγόμενο_ κώδικα (ο αδελφός στον άξονα εξόδου της πεζολογίας χωρίς περιττές λέξεις του Caveman).
i-have-adhd	23.526	Το στυλ απόκρισης που δίνει προτεραιότητα στη δράση και είναι φιλικό προς το ADHD προσαρμόστηκε στο συνοπτικό στυλ εξόδου του OmniRoute σε πέντε γλώσσες.

### 🧩 Συμπαγείς μορφές, έρευνα διακριτικών & εργαλεία με επίγνωση κώδικα

Έργο	⭐	Πώς ενέπνευσε το OmniRoute
TOON	25.233	Token-Oriented Object Notation — το στηλοθετικό μοντέλο κεφαλίδα-συν-γραμμές διαμόρφωσε το στάδιο πινακοποιημένης συμπύκνωσής μας.
GCF – Graph Compact Format	41	Η συμπαγής μορφή γράφου και ο σχεδιασμός γενικού προφίλ ενημέρωσαν την πινακοποιημένη συμπύκνωση και τη μορφή codec Headroom του OmniRoute.
gcf-typescript	4	Η υλοποίηση MIT TypeScript που ενσωματώθηκε και επεκτάθηκε άμεσα ως codec γενικού προφίλ Headroom.
token-optimizer-mcp	494	Κρυφή μνήμη Brotli/SQLite + context-delta ανά συνεδρία — ενέπνευσε τη μηχανή `session-dedup` μας.
token-savior	1.122	Συμπύκνωση εξόδου Bash + προφίλ MCP — ενέπνευσε την πειθαρχία διακοπής συμπίεσης και τη μείωση manifest εργαλείων MCP.
token-saver	138	Συμπίεση εξόδου με επίγνωση περιεχομένου, ανά τύπο αρχείου, με διακοπή λόγω αποτυχίας — επικύρωσε την αποστολή ανά τύπο και την παράλειψη ελάχιστου κέρδους.
token-optimizer	1.951	"Βρες τα φαντάσματα διακριτικά" — το μοτίβο offload + ανακτήσιμης-λαβής ενημέρωσε τη σκέψη μας για offload CCR.
TokenMizer	28	Ένα σχέδιο session-graph + διαγραμμάτωση γραμμών μεταξύ σειρών που ενημέρωσε τον σχεδιασμό session-dedup μας.
OmniCompress	3	Στηλοθετικό JSON σε Rust + ανάκτηση με αναφορά περιεχομένου + διαγραμμάτωση μεταξύ μηνυμάτων — επικύρωσε τον σχεδιασμό μηχανής `headroom`/`ccr`/`session-dedup` και την αναλλοίωτη "η συμπιεσμένη μορφή είναι ανεξάρτητη θέσης" σταθερής κρυφής μνήμης.
mcp-compressor	113	Συμπίεση σχήματος/περιγραφής εργαλείων MCP — ενημέρωσε τη μείωση πληθυκότητας manifest εργαλείων MCP μας.
RepoMapper	197	Κατάταξη χάρτη αποθετηρίου στυλ Aider — ενημέρωσε τη διερεύνηση χάρτη αποθετηρίου / κατάταξης ανάκτησης.
quiet-shell-mcp	4	Δηλωτική μείωση εξόδου shell μέσω MCP — επικύρωσε τη δηλωτική συμπύκνωση εξόδου bash.
ts-morph	6.162	Εργαλειοθήκη TypeScript Compiler API — ενέπνευσε την αφαίρεση σχολίων βάσει αναλυτή που διατηρεί string, template και regex literals.

### 🧠 Μνήμη & RAG

Έργο	⭐	Πώς ενέπνευσε το OmniRoute
Mem0	63.902	Καθολικό επίπεδο μνήμης — το μοντέλο proxy-ως-όριο-εγγραφής/ανάγνωσης διαμόρφωσε την αρχιτεκτονική μνήμης μας.
Letta (MemGPT)	24.382	Πράκτορες με κατάσταση και διαβαθμισμένη μνήμη — ενέπνευσε το διαβαθμισμένο μοντέλο Ελέγχου και Ανάκτησης Περιεχομένου (CCR).
WFGY	1.781	Η ταξινομία ProblemMap 16 επαναλαμβανόμενων τρόπων αποτυχίας RAG/LLM — το κοινό λεξιλόγιο στον οδηγό αντιμετώπισης προβλημάτων μας.

### 🛰️ Επιθεώρηση κίνησης, MITM & διαφανής proxy

Έργο	⭐	Πώς ενέπνευσε το OmniRoute
llm-interceptor	66	Η υποκλοπή/ανάλυση MITM κίνησης βοηθού κωδικοποίησης ↔ LLM ενημέρωσε τις πρώιμες απαιτήσεις Επιθεωρητή Κίνησης. Τέσσερις προηγουμένως παράγωγες ενότητες — συγχώνευση SSE, κανονικοποίηση συνομιλίας, απόκρυψη μυστικών και εξυγίανση κεφαλίδων — έχουν αντικατασταθεί από ανεξάρτητες υλοποιήσεις καθαρού δωματίου βάσει δημόσιων προτύπων πρωτοκόλλου. Οι δύο επιφάνειες host-passthrough (`passthrough.ts` και `_internal/bypass.cjs`) παραμένουν εσωτερικές υλοποιήσεις OmniRoute που ταξινομούνται ανεξάρτητα· δεν επανεγράφηκαν ως μέρος αυτής της αντικατάστασης.
ProxyBridge	5.995	Διαφανής δρομολόγηση proxy ανά διεργασία — ενέπνευσε την ασφαλή ως προς καταρρεύσεις διακοπή MITM, τα χρονικά όρια αδράνειας socket, την απόδοση διεργασίας `/proc` και τη σύλληψη TPROXY.

### 📚 Δεδομένα μοντέλων, παρατηρησιμότητα & UI

Έργο	⭐	Πώς ενέπνευσε το OmniRoute
models.dev	6.555	Ανοιχτή βάση δεδομένων προδιαγραφών, τιμολόγησης και δυνατοτήτων μοντέλων AI — συγχρονίζεται εγγενώς στον κατάλογο μοντέλων μας.
React Flow / xyflow	38.108	Η βιβλιοθήκη γράφου βάσει κόμβων που τροφοδοτεί το Στούντιο Συμπίεσης και το Στούντιο Combo/Δρομολόγησης σε πραγματικό χρόνο.
LangGraph	40.314	Η οπτικοποίηση ζωντανού γράφου ροής εργασίας του LangGraph Studio ενέπνευσε την προβολή καταρράκτη σε πραγματικό χρόνο των Στούντιο μας.
Langfuse	33.592	Το μοντέλο παρατηρησιμότητας trace → span → generation διαμόρφωσε τον καταρράκτη Στούντιο Συμπίεσης.
Kiali	3.631	Παρατηρησιμότητα πλέγματος υπηρεσιών Istio — ενέπνευσε τα σήματα circuit-breaker και τα οπτικά ακμών σφαλμάτων στο Στούντιο Δρομολόγησης/Combo.
lobe-icons	2.428	Λογότυπα AI/LLM που αποδίδουν τα εικονίδια παρόχων σε ολόκληρο τον πίνακα ελέγχου μας.
flag-icons	12.354	Παρέχει τις σημαίες SVG με άδεια MIT που χρησιμοποιεί ο επιλογέας γλώσσας README.

### 🛡️ Ασφάλεια

Έργο	⭐	Πώς ενέπνευσε το OmniRoute
awesome-secure-defaults	721	Μια επιμελημένη λίστα βιβλιοθηκών ασφαλών εξ ορισμού που καθοδηγεί τις επιλογές ασφαλείας μας (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 Συμπληρωματικά εργαλεία

Έργο	⭐	Πώς ενέπνευσε το OmniRoute
ClawRouter	6.564	Ενέπνευσε την αποπλεονασμάτωση αιτημάτων, εναλλακτική μηδενικού κόστους έκτακτης ανάγκης, τις αρθρωτές στρατηγικές Auto-Combo και την πολύγλωσση ταξινόμηση προθέσεων.
Antigravity-Manager	30.652	Η αντιστοίχιση μοντέλων με επίγνωση λογαριασμού, η επικύρωση διαδρομής εκτελέσιμου και η συμπεριφορά ετικέτας πλάνου ενημέρωσαν το runtime Antigravity του OmniRoute.
vscode-antigravity-cockpit	4.817	Η συμπαγής μορφή αντίστροφης μέτρησης επαναφοράς ποσόστωσης ενέπνευσε την αντίστοιχη εμφάνιση ορίου παρόχου στο OmniRoute.
AionUi	32.230	Οι ενσωματώσεις ACP ενέπνευσαν την αυτόματη ανίχνευση εγκατεστημένων πρακτόρων CLI του OmniRoute.
CodexBar	20.507	Εντόπισε την επιφάνεια ποσόστωσης Grok Build· το OmniRoute επαλήθευσε και διόρθωσε στη συνέχεια ανεξάρτητα τη ζωντανή μορφή wire.

## 📄 Άδεια Χρήσης Άδεια MIT - δείτε το [LICENSE](LICENSE) για λεπτομέρειες. ---

**[⬆ Πίσω στην κορυφή](#-omniroute)** · Φτιαγμένο με ❤️ για την κοινότητα ανοιχτού κώδικα AI. _{OmniRoute v3.8.51 · Node ≥22.22.2 · MIT License · omniroute.online}