# 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) · 🇬🇷 [el](../el/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) · 🇰🇭 [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 — უფასო AI Gateway **შექმნა [Diego Souza](https://github.com/diegosouzapw)-მ**

OmniRoute — არასოდეს შეწყვიტო კოდირება. ყველა AI ინსტრუმენტი → 388 პროვაიდერი — 150-ზე მეტი უფასო — ერთი endpoint-ის გავლით. Claude Code, Codex, Cursor, Cline, Copilot და Antigravity — უფასო Claude / GPT / Gemini-ზე ავტომატური fallback-ით. RTK + Caveman-ის კომბინირებული შეკუმშვა ზოგავს ტოკენების 15–95%-ს (საშუალოდ ~89%) — ლიმიტებს არასოდეს გადააჭარბო. 388 AI პროვაიდერი · 150-ზე მეტი უფასო ტარიფი · ~1.62B უფასო ტოკენი/თვეში · მარშრუტიზაციის 20 სტრატეგია · დასაწყებად $0.

## 💰 ~1.62B ტოკენი / თვე მესამე მხარის უფასო ტარიფებში

> **გამოიყენეთ საკუთარი პროვაიდერის ანგარიშები.** ეს არის ცალკე ხელმისაწვდომი მესამე მხარის უფასო ტარიფების სავარაუდო ჯამური მაჩვენებელი და არა OmniRoute-ის მიერ გაცემული ტოკენების გრანტი. დარეგისტრირდით, საჭიროების შემთხვევაში მიიღეთ ავტორიზაციის მონაცემები და დააკავშირეთ თქვენთვის ხელმისაწვდომი პროვაიდერები; თითოეული პროვაიდერი თავად აკონტროლებს ლიმიტებს, ხელმისაწვდომობასა და პირობებს. > > უფასო ტარიფების ხელით გაერთიანება რთულია — ათობით SDK, ათობით სიჩქარის ლიმიტი და არანაირი წარმოდგენა იმაზე, რეალურად რამდენი რესურსი გაქვთ. OmniRoute კატალოგში აერთიანებს **465 უფასო ტარიფის ჩანაწერს 34 განმეორებად pool key-ში** და ტოკენების მთავარ მაჩვენებელს ითვლის **17 pool-იდან, რომლებსაც გამოქვეყნებული დადებითი თვიური ბიუჯეტი აქვთ, პლუს Groq-ის ხუთი თითოეულ მოდელზე მოქმედი ლიმიტიდან**, საერთო pool-ების მიხედვით დუბლირების მოცილებით. კვოტები, რომლებიც მხოლოდ რეგიონული იდენტობის შემოწმების შემდეგ იხსნება (დღეს: ModelScope), ცალკე არის ნაჩვენები — რეგიონული იდენტობის ვერიფიკაციის შემდეგ დამატებით +~6M — და მთავარ მაჩვენებელში არასოდეს ჯამდება. შედეგი ხილული რჩება dashboard-ზე (`/dashboard/free-tiers`).

OmniRoute-ის უფასო ტარიფის ბიუჯეტის ბარათი: ~1.62B უფასო ტოკენი თვეში სტაბილურად, ხოლო რეგისტრაციის კრედიტებით პირველ თვეში — ~2.22B-მდე; ეს ეფუძნება 34 დოკუმენტირებულ განმეორებად pool key-ს, რომლებიც აერთიანებს კატალოგში შეტანილ 465 უფასო ტარიფის ჩანაწერს ერთი endpoint-ის მიღმა. პატიოსანი, pool-ების მიხედვით დუბლირებისგან გაწმენდილი ანგარიში — თითოეული საერთო pool დათვლილია ერთხელ, მათ შორის 17 განმეორებადი pool, რომლებსაც გამოქვეყნებული დადებითი თვიური ტოკენების ბიუჯეტი აქვთ, პლუს Groq-ის ხუთი თითოეულ მოდელზე მოქმედი ლიმიტი; პირობებთან დაკავშირებული რისკების კატალოგში 12 პროვაიდერი მონიშნულია როგორც ასარიდებელი, ამიტომ გადაწყვეტილებას თქვენ იღებთ. ბიუჯეტის ზოლი მოიცავს Mistral 1B-ს, Nara 210M-ს, LLM7 150M-ს, xKiro 150M-ს, Groq 30M-ს (ხუთი თითოეულ მოდელზე მოქმედი ლიმიტი) და უფრო მცირე pool-ებს, ასევე პირველი თვის რეგისტრაციის კრედიტებსა და მუდმივად უფასო, ტოკენების ლიმიტის არმქონე პროვაიდერებს, რომლებიც ცალკე არის ნაჩვენები, რათა მთავარ მაჩვენებელს არასოდეს ხელოვნურად არ ზრდიდეს. გამოყენებული/დარჩენილი რაოდენობა რეალურ დროში /dashboard/free-tiers-ზე.

> `/dashboard/free-tiers` გვერდის ანიმაციური შეჯამება რეალურ დროში. სრული მეთოდოლოგია (pool-ების დუბლირების მოცილება, საკრედიტო დონეები, პროვაიდერების პირობები): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{ეს მაჩვენებლები ყოველ ორ კვირაში ერთხელ ხელახლა მოწმდება რეალურ კატალოგთან და **ორივე მიმართულებით იცვლება** — თუ პროვაიდერი უფასო ტარიფს აუქმებს, რიცხვი მცირდება; თუ ახალი ემატება, იზრდება. ჩვენ ვაქვეყნებთ იმას, რასაც კატალოგი რეალურად ითვლის და არასოდეს ვამრგვალებთ საუკეთესო შესაძლო სცენარის სასარგებლოდ.}

⭐ დაასტარეთ რეპოზიტორიას, თუ OMNIROUTE დაგეხმარათ თანხის დაზოგვასა და სამუშაოს გამარტივებაში.

[![ვარსკვლავები](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![ვარსკვლავების ისტორიის რეიტინგი](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 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) [![ვებსაიტი](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 [🌍 გლობალური](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)**
## 📈 Gateway კვლავ იზრდება

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | ----------------------------------- | :----------------------: | :---------: | :-------------------: | | 🌐 პროვაიდერები | 352 | **358** | 388 | | 🧠 უნიკალური ჩატის მოდელების ID-ები | 1320 | **1374** | 1491 | | 🖼️ მოდალობების ხიდი | 🆕 ხედვა + აუდიო + ვიდეო | ✓ | ✓ | | 📡 Radar-ის უფასო კატალოგი | 🆕 ჩართვის არჩევანი | ✓ | ✓ | | ⚖️ კვოტის გათვალისწინებით დაგეგმვა | 🆕 Quota-Share | ✓ | ✓ | | 📊 კვოტის ტელემეტრია | 🆕 პირდაპირი | ✓ | ✓ | | 🧰 უთავო რეჟიმი | — | — | 🆕 `serve --headless` | | 🛤️ LTS-ის rail ინფრასტრუქტურა | — | — | 🆕 გამოშვების არხები | | 🔎 მოდელების აღმოჩენის API | — | — | 🆕 `/v1/models/query` | **→ [სამოქმედო გეგმა](ROADMAP.md) — `v3.9.0 LTS`-ისკენ მიმავალ rail-ზე**

## 🧩 ხელმისაწვდომია [![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 ენაზე

## 🆓 დააინსტალირეთ, დააკავშირეთ პროვაიდერი და შემდეგ გაატარეთ მოთხოვნები ერთი endpoint-ის მეშვეობით

სამი ნაბიჯი: დააინსტალირეთ და გაუშვით OmniRoute, დააკავშირეთ შესაბამისი პროვაიდერი საკუთარი ანგარიშით ან API-გასაღებით, შემდეგ კი მიუთითეთ თქვენს ხელსაწყოში localhost:20128/v1, გამოიყენეთ OmniRoute API-გასაღები და მოდელი 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).} _{📦 Python-ის, Node.js-ის, PHP-ისა და **cURL**-ის კოპირებისა და ჩასმისთვის გამზადებული სწრაფი დაწყების სკრიპტები → [`examples/quickstart/`](examples/quickstart/)}

# 💥 დაპირება

# 🤔 რატომ OmniRoute?

OmniRoute-ის მოთხოვნის ნაკადი: თქვენი IDE ან CLI (Claude Code, Cursor, Cline…) იძახებს ერთ ლოკალურ endpoint-ს (http://localhost:20128/v1); OmniRoute Smart Router-ს (RTK + Caveman-ის შეკუმშვა, მარშრუტიზაციის 20 სტრატეგია, circuit breaker-ები, TLS stealth, MCP, A2A, guardrail-ები) შეუძლია fallback-ის გამოყენება პროვაიდერების 4 დონეზე, სანამ შესაბამისი ჯანსაღი სამიზნე არსებობს — Tier 1 Subscription, Tier 2 API Key, Tier 3 Cheap და Tier 4 Free.

## 🤝 მხარდაჭერილია ჩვენი ღია კოდის მეგობრების მიერ

> **გსურთ შეუერთდეთ როგორც ღია კოდის მეგობარი?** ეს არის კომპანიები, რომლებიც მხარს უჭერენ ღია კოდს და ეხმარებიან OmniRoute-ის მუშაობას — და ჩვენ საჯაროდ ვამბობთ, სად მიდის მათ მიერ მოცემული ყოველი ტოკენი. დაგვიკავშირდით: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} მადლობა Kimi (Moonshot AI)-ს, ჩვენს დამფუძნებელ ღია კოდის მეგობარს, ამ პროექტის მხარდაჭერისთვის! Kimi არის AI ლაბორატორია, რომელიც დგას ღია წონის K2 და K3 მოდელების ოჯახების უკან — Kimi K3 გთავაზობთ 1M-ტოკენის კონტექსტურ ფანჯარას, მშობლიურ ხედვას და სასაზღვრო დონის კოდირებას დახურული მოდელების ფასის ნაწილზე, და მუშაობს ყუთიდან Claude Code-თან, Codex-თან და ყველა კოდირების ხელსაწყოსთან, რომელსაც OmniRoute ემსახურება.

რას უზრუნველყოფს Kimi-ის მხარდაჭერა: Kimi-ის API კრედიტები უზრუნველყოფს OmniRoute-ის AI-ვალიდირებულ გამოშვების კონვეიერს — Kimi K3-ის მიერ მხარდაჭერილი შერწყმის ვალიდაციის ეტაპს, რომელიც განიხილავს ყოველ pull request-ს მის გამოშვებამდე — პლუს ყოველდღიური ფუნქციების განვითარებას. პირველი კლასის Kimi-ის მხარდაჭერა მიეწოდება ორივე გზით: პირდაპირი Kimi API (kimi-k3) და Kimi Code კოდირების გეგმა (OAuth და API გასაღები). OmniRoute ასევე არის პირველი ბრაზილიური ღია კოდის პროექტი Kimi-ის მხარდაჭერის პროგრამაში. მიიღეთ Kimi API გასაღები 15% დამატებითი კრედიტებით →

Cheaper Inference
_{cheaperinference.com} მადლობა Cheaper Inference-ს, OmniRoute-ის ღია კოდის მეგობარს, ამ პროექტის მხარდაჭერისთვის! Cheaper Inference არის ხარჯების მიხედვით რანჟირებული კარიბჭე, რომელიც ყიდის 42 სასაზღვრო მოდელს — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok და MiniMax — ერთი OpenAI-თან თავსებადი ბოლო წერტილის უკან, თითოეული მოთხოვნის გადამისამართებით ყველაზე იაფ შესაბამის პროვაიდერთან, მოდელის შემქმნელის ჩამონათვალის ფასზე მაღლა დატენვის გარეშე.

პირველი კლასის მხარდაჭერა OmniRoute-ში: Chat Completions, მშობლიური /v1/responses ბოლო წერტილი, ხედვა, ხელსაწყოების გამოძახება და 3 გამოსახულების მოდელი (grok-imagine, nano-banana-pro, nano-banana-2, ხელმისაწვდომია როგორც cheaperinference/<model>). მიიღეთ API გასაღები →

_{ბმულები, რომლებიც მონიშნულია aff=omniroute, არის პარტნიორული ბმულები. ისინი აფინანსებენ პროექტს თქვენთვის დამატებითი ხარჯების გარეშე.}

_{🎟️ შვილობილი პრომო — უფასო რეგისტრაციის კუპონები პროვაიდერებისგან, რომლებსაც არ ვასპონსორებთ (გასაშლელად დააჭირეთ)}

_{ეს განყოფილება განკუთვნილია მხოლოდ რეფერალური/კუპონის კოდებისთვის. სპონსორირებული პარტნიორობები განთავსებულია ზემოთ 🤝 მხარდაჭერილია ჩვენი ღია კოდის მეგობრების მიერ განყოფილებაში. OmniRoute-ს არ აქვს სპონსორობა ან პარტნიორობა აქ ჩამოთვლილ პროვაიდერებთან — ეს არის საჯარო კუპონები, რომელთა გამოყენება ნებისმიერს შეუძლია.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — შვილობილი რეგისტრაცია · $100 უფასო კრედიტი რეგისტრაციისას (უფასო სერვერი, მოსალოდნელია უფრო მაღალი შეყოვნება — საუკეთესოა ტესტირებისთვის, არა წარმოებისთვის). პირველი კლასის მხარდაჭერა OmniRoute-ში v3.8.50-დან: Chat Completions, Anthropic-თან თავსებადი სადენიანი ფორმატი და OpenAI-თან თავსებადი გზა. ხელმისაწვდომი მოდელები მოიცავს claude-opus-4-8, claude-opus-5, gpt-5.6-sol და სხვა. აიღეთ თქვენი $100 →}

_{⚠️ შვილობილი ბმული — OmniRoute-ს არ აქვს სპონსორობა ან პარტნიორობა ამ პროვაიდერთან.}

_{იცით სხვა პროვაიდერი გულუხვი უფასო რეგისტრაციის კუპონით, რომელიც სარგებელს მოუტანს OmniRoute-ის მომხმარებლებს? გახსენით საკითხი და ჩვენ დავამატებთ მას აქ.}

## 🎯 კომბოები — ფლაგმანი

20 კომბო-მარშრუტიზაციის სტრატეგიიდან 18-ის ანიმაციური მაგალითები — თითო სტრატეგიაზე თითო ფილა: 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 ანიმირებული არ არის; ქვემოთ მოცემულ ცხრილში აღწერილია ოცივე.

> **კომბო** არის მოდელების ჯაჭვი, რომელთა შორისაც OmniRoute მოთხოვნებს **ავტომატურად** მარშრუტიზებს. თუ კვოტა ამოიწურება, პროვაიდერი შეფერხდება ან ხარჯები მკვეთრად გაიზრდება, კომბოს შეუძლია შემდეგ შესაბამის და გამართულ მოდელზე გადასვლა. 🛡️ ### ⚡ ნულოვანი კონფიგურაცია — უბრალოდ გამოიყენეთ `auto` კომბოს შექმნა არ გჭირდებათ. თქვენს მოდელად მიუთითეთ `auto` (ან მისი ვარიანტი) და OmniRoute თქვენი დაკავშირებული პროვაიდერებისგან ვირტუალურ კომბოს შექმნის, რომელსაც რეალურ დროში შეაფასებს:

მოდელის ID	რის ოპტიმიზაციას ახდენს
`auto`	🎯 დაბალანსებული ნაგულისხმევი ვარიანტი (LKGP — რჩება თქვენს ბოლო გამართულ პროვაიდერთან)
`auto/coding`	🧑💻 კოდის გენერაციისთვის ხარისხზე ორიენტირებული წონები
`auto/fast`	⚡ პირველ რიგში ყველაზე დაბალი დაყოვნება
`auto/cheap`	💰 პირველ რიგში ყველაზე იაფი თითო ტოკენზე
`auto/subscription`	🎟️ მხოლოდ ის სააბონენტო კვოტა, რომლის საფასურსაც უკვე იხდით — მიუწვდომლობისას იხურება და არასოდეს გადადის ფასიან სარეზერვო ვარიანტზე (სახელმძღვანელო)
`auto/thrifty`	🪜 ჯერ გეგმის კვოტა, შემდეგ კი თითო საფეხურით ყველაზე იაფ ფასიან ვარიანტებზე გადასვლა — განულების შემდეგ კვლავ გეგმაზე დაბრუნება (სახელმძღვანელო)
`auto/offline`	🔋 პირველ რიგში კვოტის / სიხშირის ლიმიტის ყველაზე დიდი მარაგი
`auto/smart`	🔭 ხარისხი პრიორიტეტულია + 10% კვლევა უკეთესი მოდელების აღმოსაჩენად
`auto/lkgp`	📌 ბოლო ცნობილი გამართული პროვაიდერის აშკარა უპირატესობა
`auto/chaos`	🧪 პარალელური განაწილება მოდელების პანელზე (თითო პროვაიდერზე ერთი, ნაგულისხმევად 5), აბრუნებს ერთ პასუხს; თითო აღმავალ მოდელზე ერთი გამოძახება და არა შეფერხებების ხელოვნური შეტანა

## ### 🔀 ან შექმენით საკუთარი — მარშრუტიზაციის 20 სტრატეგია **ოცივე** სტრატეგია — შეურიეთ და შეუხამეთ კომბოს თითოეულ ნაბიჯზე:

#	სტრატეგია	რას აკეთებს
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× / ლოკალური 2×, 60s/30s/15s-ის შემდეგ გადადის HALF-OPEN საცდელ რეჟიმში, ზარმაცი აღდგენა; OPEN მდგომარეობაში კომბინაცია მოთხოვნას შემდეგ პროვაიდერზე გადაამისამართებს. ფენა 2 — კავშირის დაყოვნება (ერთი გასაღები/ანგარიში): საწყისი 5s OAuth-ისთვის / 3s API-key-ისთვის, ექსპონენციური ×2 უკუდახევა ერთდროული მასობრივი მოთხოვნებისგან დაცვის მექანიზმით, 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-კოდი

გასაღები (შემთხვევითი): `5d865059-bc44-483a-962d-43ceb80126eb` Pix-ის დასაკოპირებელი კოდი: ``` 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).

შენიშვნები დეველოპერებისთვის: დეველოპერების კომფორტისთვის, npm install/postinstall-ის დროს პროექტმა შეიძლება შექმნას ლოკალური .env ფაილი. ეს ფაილი განზრახ იგნორირებულია .gitignore-ის მეშვეობით (იხილეთ .gitignore) და მისი კომიტში დამატება დაუშვებელია — თუ ის შემთხვევით დაემატა კომიტში, შეცვალეთ ყველა გამჟღავნებული საიდუმლო მონაცემი და წაშალეთ ფაილი ისტორიიდან. ლოკალური გარემოს ფაილებისა და საიდუმლო მონაცემების მართვის ინსტრუქციებისთვის იხილეთ docs/DEVELOPER-ENVIRONMENT.md.

## 📡 OmniRoute Radar უფასო დონის მთავარი მაჩვენებელი კვლავ არის **~1.62B ტოკენი/თვეში**, ზემოთ მოცემული დოკუმენტირებული, პულების მიხედვით დუბლიკატებისგან გაწმენდილი კატალოგიდან. პროვაიდერთან რეგისტრაციის დროებით კრედიტებს შეუძლია, ცალკე, პირველი თვის მაჩვენებელი **~2.22B-მდე** გაზარდოს. Radar არის არასავალდებულო, ხელმოწერილი კატალოგის ზედნადები მათთვის, ვისაც OmniRoute-ის გამოშვებებს შორის უფასო მოდელების ხელმისაწვდომობის შესახებ უფრო ახალი ინფორმაცია სურს; საზოგადოების კატალოგი და ყველა არსებული უფასო ფუნქცია კვლავ უფასოა. მხარდამჭერებს შეუძლიათ მიიღონ ცოცხალი კატალოგი და დამატებითი შესაძლებლობები პროვაიდერებისგან. მისი ცალკეული, ცვალებადი ზედა ზღვარი არის **მაქსიმუმ დაახლოებით 3B ტოკენი/თვეში**, პროვაიდერების ხელმისაწვდომობის მიხედვით. ეს ზედა ზღვარი გარანტირებული არ არის: პროვაიდერებს ნებისმიერ დროს შეუძლიათ შეცვალონ კვოტები, შესაბამისობის მოთხოვნები, მოდელები ან რეგიონები. 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 გამოტოვებს ამოწურულ ანგარიშებს, შემდეგ კი დარჩენილებს შორის არჩევანს აკეთებს დარჩენილი კვოტის ÷ მიმდინარე დატვირთვის პროპორციულად და არსებულ საუბრებს იმავე ანგარიშზე ამაგრებს. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 Headless რეჟიმი** — `omniroute serve --headless` (ან `OMNIROUTE_HEADLESS=1`) ამუშავებს მხოლოდ `/v1/*` პროქსის ძრავას და თიშავს დეშბორდსა და მხოლოდ დეშბორდისთვის განკუთვნილ ქვესისტემებს. → [Headless რეჟიმი](docs/guides/HEADLESS.md) - **🔎 მოდელების აღმოჩენა** — `/v1/models` ფილტრავს შესაძლებლობის, კონტექსტის, ტიპისა და ტექსტის მიხედვით, ხოლო `POST /v1/models/query` აბრუნებს მოკლე, დეტერმინისტულ კანდიდატთა სიას, თითოეული გასაღებისთვის იგივე ხილვადობის წესებით. → [API-ის ცნობარი](docs/reference/API_REFERENCE.md) - **🔑 გასაღების მიხედვით მარშრუტიზაციის კონტროლი** — API-გასაღები მიამაგრეთ ერთ მოდელს ან კომბინაციას `forcedModel`-ით და ატომურად დაამატეთ ან წაშალეთ გასაღების მოდელები და კომბინაციები (`/api/keys/{id}/access`). → [API-ის ცნობარი](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ PII-ის უფრო დახვეწილი კონტროლი** — ტიპების მიხედვით არჩევა, მაქსიმუმ 20 დადასტურებული მორგებული დაფარვის ნიმუში და ტიპების მიხედვით აღმოჩენის მრიცხველები; თავად დაფარვა კვლავ ნებაყოფლობითია. → [დამცავი წესები](docs/security/GUARDRAILS.md) - **🌍 67 ენა** — დეშბორდი, დოკუმენტაციის სარკეები და CLI, ხოლო `npm run i18n:add-locale` ერთი ბრძანებით ამატებს ენას ყველგან. → [i18n-ის გზამკვლევი](docs/guides/I18N.md) - **🎛️ OmniConductor** — შემომავალი A2A დელეგირება აგენტების ფლოტისთვის, Conductor-ის უნარები Agent Card-ში და დეშბორდის პანელი Faro-ს push-to-talk ხმოვანი ჩატით. → [A2A სერვერი](docs/frameworks/A2A-SERVER.md) - **🛂 ადაპტური დაშვება და გადატვირთვისგან დაცვა** — მძიმე ჩატ-მოთხოვნები რიგში თავსდება 503 შეცდომის ნაცვლად, თითოეული კავშირისთვის RPM-ის ატომური მოძრავი იჯარებით. → [გამძლეობის გზამკვლევი](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ `/v1/models`-ის კანონიკური დალაგება** — თითოეული პროვაიდერისთვის ერთი უწყვეტი, პროვაიდერების მიხედვით დაჯგუფებული ბლოკი (კომბინაციები პირველად), რომელიც ყველა კატალოგის წყაროში სტაბილური რჩება. → [API-ის ცნობარი](docs/reference/API_REFERENCE.md) - **🗜️ შეკუმშვის გამაგრება** — ნაგულისხმევად ჩართული გაბერვისგან დაცვის მექანიზმი, Caveman-ის პაკეტები DE / FR / JA-სთვის და ჩინურისთვის (wényán), RTK ფილტრები Gradle-ისა და .NET-ისთვის. → [შეკუმშვა](docs/compression/COMPRESSION_ENGINES.md) - **💸 ბრტყელი ტარიფის რეალური ღირებულება** — გამოწერის / კოდირების გეგმის პროვაიდერების ღირებულების ანალიტიკაში ფიქსირდება **$0**; ბიუჯეტი, კვოტა და მარშრუტიზაცია შეფასებას კვლავ აგრძელებს. → [API-ის ცნობარი](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share მარშრუტიზაცია** — საერთო ანგარიშის კვოტას სამართლიანად ანაწილებს გაერთიანებულ გასაღებებს შორის; მექანიზმი სამუშაოს მაქსიმალურად ეფექტურად იყენებს და უმოქმედო ნაწილებს გასცემს. → [გამძლეობის გზამკვლევი](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 CLI/აგენტის ერთბრძანებიანი დაყენება** — რეგისტრირებულია 15 `setup-*` ბრძანება; `omniroute run` უშვებს 7 CLI-ს (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` მხარს უჭერს 11 სამიზნეს ინტერაქტიული პროვაიდერებისა და მოდელების ამომრჩევით და თითოეული კონტექსტისთვის რჩეულებით. → [CLI ინტეგრაციები](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ დისტანციური რეჟიმი** — მართეთ დისტანციური OmniRoute შეზღუდული მოქმედებების მქონე ტოკენებით (`connect` / `contexts` / `tokens`) და გამოიყენეთ `antigravity` OAuth დამხმარე 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 და გადასაადგილებელი რედაქტორი. → [შეკუმშვა](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ გამჭვირვალე MITM გაშიფვრა (TPROXY)** — დაიჭირეთ CLI-ები, რომლებიც პროქსის გარემოს ცვლადებს უგულებელყოფენ, თითოეული SNI-სთვის CA-თი და ნდობის საცავის ინსტალერით. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 ღირებულების ტელემეტრია ყველგან** — `X-OmniRoute-*` ღირებულების/გამოყენების ჰედერები ყველა endpoint-ზე, ქეშის HIT-ით მიღებული დანაზოგის ჰედერი და თითოეული გასაღებისთვის USD-ხარჯვის კვოტები. → [API-ის ცნობარი](docs/reference/API_REFERENCE.md) - **🧠 თქვენ მიერ კონტროლირებადი მეხსიერება** — ნაგულისხმევად გამორთული, ჩართვის შემთხვევაში int8 ვექტორული კვანტიზაცია და ტიპიზებული დაძველება, თითოეული მოთხოვნისთვის `x-omniroute-no-memory`. → [მეხსიერება](docs/frameworks/MEMORY.md) - **🛡️ უსაფრთხოება** — prompt-injection-ისგან დამცავი მექანიზმი ყველა LLM-მარშრუტზე (red-team-ის სატესტო ნაკრებით), სურვილისამებრ ჩასართავი სარეზერვო მონაცემების დაფარვის დამცავი წესი (ორივე მიმართულებით გაჟონილი API-გასაღებების/საიდუმლოებების დაფარვა), უფასო DuckDuckGo-ს საექსტრემო ვებ-ძიება და სურვილისამებრ OIDC-ით შესვლის ბარიერი დეშბორდისთვის (პაროლით შესვლა ყოველთვის ხელმისაწვდომი რჩება). → [დამცავი წესები](docs/security/GUARDRAILS.md) - **🖼️ ახალი endpoint-ები** — `/v1/ocr` (Mistral OCR) და `/v1/audio/translations` (Whisper-ის სტილის) ავსებს მედიის შესაძლებლობებს. → [API-ის ცნობარი](docs/reference/API_REFERENCE.md) - **🎨 სურათების / ვიდეოს / აუდიოს გენერაცია** — მედიისთვის ერთი API: xAI Grok Imagine და Novita AI video, ComfyUI, Magnific, Adobe Firefly, Segmind და მეტყველების პროვაიდერები, მათ შორის ElevenLabs. → [API-ის ცნობარი](docs/reference/API_REFERENCE.md) - **🌍 განთავსება და ოპერაციები** — reverse-proxy `basePath`, ბრაუზერის ენის ავტომატური აღმოჩენა, თითოეული გასაღების მოწყობილობის თვალყურის დევნება, root-ის გარეშე MITM ნდობა და zh-TW ლოკალიზაცია. → [გარემო](docs/reference/ENVIRONMENT.md) - **🤝 მეტი პროვაიდერი და აგენტი** — ღრუბლოვანი აგენტები (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) ბრაუზერითა და OAuth-ით შესვლით, Ollama-ს პირველი კლასის ბარათი, Claude Opus 5 და Sonnet 5, Kimi-ს ოფიციალური პარტნიორობა (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… და განახლებული **388-პროვაიდერიანი კატალოგი**. → [პროვაიდერები](docs/reference/PROVIDER_REFERENCE.md) - **📡 მარშრუტიზაციის გამჭვირვალობა** — თითოეული პასუხი შეიცავს `X-OmniRoute-Decision` ჰედერს, რომელშიც მითითებულია მისი მომსახურე სტრატეგია/პროვაიდერი/დაყოვნება; ახალი `cache-optimized` კომბინირებული სტრატეგია და Auto-Combo-ის `cacheAffinity` ფაქტორი განმეორებით მოთხოვნებს აბრუნებს იმ კავშირზე, რომელსაც ქეშირებული პრეფიქსი აქვს; მხოლოდ წაკითხვისთვის განკუთვნილი `/v1/auto-combo/{channel}/candidates` endpoint-ი კი ავლენს `auto/*` არხის კანდიდატთა ცოცხალ ნაკრებს. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ ლოკალური წარმადობა და ინფრასტრუქტურა** — ლოკალური Redis-ის გაშვება ერთი დაწკაპუნებით, Cloudflare Workers / Deno Deploy relay-ის დიპლოიერები, Bifrost და Mux ზედამხედველობის ქვეშ გაშვებული ჩაშენებული სერვისების სახით. → [ჩაშენებული სერვისები](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 ასევე მოყვება** — პლაგინების ფრეიმვორკი და მარკეტფლეისი, Omni/Agent/GitHub-ის უნარების ფრეიმვორკები, Obsidian vault-ის ინტეგრაცია (22 MCP ხელსაწყო), OpenAI-თან თავსებადი Batch და Files API-ები, სემანტიკური პასუხების ქეში, გეიმიფიკაცია ლიდერბორდებით, ACP აგენტების აღმოჩენა (15 ჩაშენებული აგენტი), ჟურნალების დაგეგმილი ექსპორტი BigQuery-ში, `auto/chaos` პარალელური მრავალმოდელიანი fan-out, Telegram ბოტის ხიდი, აპში ჩაშენებული ვერსიების მენეჯერი და LMArena-ELO-ს უფასო პროვაიდერების რეიტინგები. → [დოკუმენტაცია](docs/README.md)

## 🤖 თავსებადი CLI-ები და კოდირების აგენტები > ერთი კონფიგურაცია — `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}	_deyin.ai

＋ ასევე მუშაობს · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · ნებისმიერ OpenAI-თან თავსებად ხელსაწყოსთან

_{📖 თითოეული ინსტრუმენტის ცალკეული კონფიგურაცია ყველა 39 ინსტრუმენტისთვის (28 CLI Code + 11 CLI Agent) → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode-ის პლაგინი → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**გაუშვით ნებისმიერი მხარდაჭერილი CLI OmniRoute-ით ერთი ბრძანებით** — კონფიგურაციის ფაილები არ იწერება, ავტორიზაციის მონაცემები ინიექცირდება თითოეულ პროცესში, Qwen/Gemini-სთვის იქმნება დროებითი იზოლირებული სახლი: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # ან აირჩიეთ პროვაიდერი და მოდელი ინტერაქტიულად და ჩაწერეთ ინსტრუმენტის საკუთარი კონფიგურაცია: omniroute configure codex # ასევე: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` ყველა ბრძანება ითვალისწინებს აქტიურ დისტანციურ კონტექსტს (`omniroute connect `), `--dry-run` გაჩვენებთ ზუსტ გარემოს/არგუმენტებს შესრულების გარეშე, ხოლო `--api-key-env NAME` საიდუმლოებს იცავს თქვენი შელის ისტორიისგან. → [CLI ინტეგრაციები](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388 AI პროვაიდერი — 153 კატალოგში უფასოდ მონიშნული

> **388 რეგისტრირებული პროვაიდერი** კანონიკური ჩატის, მედიის, ძიების, ლოკალური, cloud-agent და სისტემის კოლექციებში, მათ შორის **153 პროვაიდერი, რომელსაც აღმოჩენის მეტამონაცემებში `hasFree: true` აქვს მითითებული**. ჩატის მოდელების რეესტრი მოიცავს **239 პროვაიდერს / 3,059 უნიკალურ provider-model წყვილს / 1,475 დაუმუშავებელ model ID-ს**; ცალკე უფასო ბიუჯეტის კატალოგში არის **471 ჩანაწერი თითოეულ მოდელზე**, **34 განმეორებადი პული** და **52 განმეორებადი/გასაღების გარეშე სამუდამოდ უფასო პროვაიდერი**. ეს სხვადასხვა მნიშვნელი განზრახ არის გამოყენებული; განსაზღვრებები და პულების დუბლიკატების მოცილებით გამოთვლები მოცემულია [პროვაიდერების ცნობარში](docs/reference/PROVIDER_REFERENCE.md) და [უფასო ტარიფებში](docs/reference/FREE_TIERS.md).

### 🏢 ყველა ძირითადი ლაბორატორია — ერთი endpoint-ის მეშვეობით

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

_{…და კიდევ 350-ზე მეტი — ყველა აიკონი პირდაპირ იტვირთება dashboard-ის პროვაიდერების კატალოგიდან. 📖 [პროვაიდერების ცნობარი](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 სამუდამოდ უფასო — $0, ბარათი საჭირო არ არის

OpenCode Zen _{DeepSeek V4, Nemotron 3 ტოკენების ლიმიტის გარეშე}	Kilo Code _{ავტო-როუტერი, Tencent Hy3 სამუდამოდ უფასო}	Requesty _{GPT-OSS 120B, Nemotron სამუდამოდ უფასო}	SiliconFlow _{DeepSeek V3.2 / R1 უფასო პაკეტი}	Z.AI GLM _{GLM-4.7 / 4.5-Flash სამუდამოდ უფასო}	Baidu ERNIE _{ERNIE 4.0 სამუდამოდ უფასო}
Qoder AI _{Qwen3-Max, Kimi-K2 შეუზღუდავი უფასო}	Pollinations _{GPT, Llama, Claude გასაღები საჭირო არ არის}	Cloudflare AI _{50+ მოდელი 10K ნეირონი/დღე}	NVIDIA NIM _{GLM, MiniMax ~40 RPM უფასოდ}	Cerebras _{GLM 4.7, GPT-OSS ერთჯერადი $5 კრედიტი; ბარათი აუცილებელია}	OpenRouter _{:free მოდელები +$10 → უფრო მაღალი RPM}

📖 სრული, მანქანურად წაკითხვადი კატალოგი → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ Where OmniRoute Runs — სადმე

> იგივე აპლიკაცია, თქვენი მანქანა, თქვენი წესები. გლობალური npm ინსტალაციისგან** თქვენი ტელეფონი** Termux-ის საშუალებით.

პლატფორმა	დააინსტალირე	მაჩვენებლები
📦 npm (გლობალური)	`npm დააინსტალირე -g omniroute`	ერთი ბრძანება, ნებისმიერი OS
⚡ Bun (გლობალური)	`bun დამატება -g omniroute`	იგივე რეესტრის tarball, უფრო სწრაფად ინსტალაცია
🐳 Docker	`docker გაშვება … diegosouzapw/omniroute`	მრავალ თაღოვანი AMD64 + ARM64
🖥️ Desktop (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-provider`	მშობლიური OpenCode ინტეგრაცია
🤖 VS კოდი Copilot ჩატი	დააინსტალირე OmniCopilot გაფართოება	ყოველი OmniRoute მოდელი მშობლიურ Copilot ჩატის ამომრჩეველში — სტაბილური & ინსაიდერები
🛠️ წყაროდან	`npm დააინსტალირე && npm გაუშვით dev`	გატეხეთ იგი, შეიტანეთ წვლილი

_{📖 [Docker სახელმძღვანელო](docs/guides/DOCKER_GUIDE.md) · [სამუშაო მაგიდა](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 VS კოდის მშობლიურ Copilot ჩატში

> არ არის ახალი გვერდითი ზოლი, არ არის ახალი ჩეთის UI - OmniRoute ის ყველა სერვისი გამოჩნდება პირდაპირ**Copilot ჩატის მოდელის ამომრჩევი, რომელსაც უკვე იყენებთ** . VS Code 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"** , დააწკაპუნეთ** დააინსტალირეთ** — მუშაობს ერთნაირად ორივე მაღაზიაში. წყარო, საკითხები და საგამომცემლო სახელმძღვანელო პირდაპირ ეთერში [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) ზე. _{📖 [VS კოდი Copilot ჩატის გზამკვლევი](docs/guides/VSCODE-COPILOT.md) — დაყენება, რას აჩვენებს ამომრჩევი, დაფა-ჩანართში, პრობლემების აღმოფხვრა}

### 🎩 ახალი: OmniRouteTray - თქვენი კარიბჭე, რომელიც ცხოვრობს მენიუს ზოლში

> `omniroute serve` ყველაზე ბედნიერია, როცა ის ყოველთვის ჩართულია.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** აქცევს მას მენიუს ზოლის დაყენების და დავიწყების აპლიკაციად macOS სთვის: ის ამუშავებს სერვერს, ინარჩუნებს მას ცოცხლად გადატვირთვის დროს, განაახლებს მას ადგილზე და აყენებს თქვენს ცოცხალი ტოკენის ბიუჯეტს ერთი დაწკაპუნებით -** არც ტერმინალის ფანჯარა დარჩა ღია, არც `npm install -g omniroute` ძიძისთვის.** აგებულია [Tauri v2-](https://v2.tauri.app/) ით (Rust ბირთვი დამრგვალების შეცდომის ზომით), ის აგზავნის საკუთარ ხელმოწერილ Node 24-ის გაშვებას და მართავს აპლიკაციის საკუთრებაში არსებულ OmniRoute ინსტალაციას, ასე რომ, არასოდეს შეებრძოლება თქვენს გლობალურ `node`/`bun`. ის** იზიარებს თქვენს არსებულ `~/.omniroute/` კონფიგურაციას და მონაცემთა ბაზას** - ეს იგივეა, OmniRoute თქვენ უკვე დარბიხართ, მხოლოდ ქუდით. 🎩

რას აკეთებს	როგორ
🟢 ზედამხედველობს სერვერს	აწარმოებს `omniroute serve` , იღებს უკვე გაშვებულ ინსტანციას მისი დუბლირების ნაცვლად
📊 პირდაპირი გამოყენება ერთი შეხედვით	პროვაიდერის კვოტის ზოლები, Claude session/weekly ლიმიტები გადატვირთვის ათვლაებით, 30-დღიანი ხარჯების ავარია
🔄 ავტომატური განახლებები ადგილზე	ეტაპობრივი ინსტალაცია, ატომური გაცვლა, უკმარისობა - ყოველთვის უახლეს გამოშვებაზე
🚀 შესვლის დაწყება	არჩევითი გაშვება შესვლისას; მხოლოდ უჯრაზე, არ არის dock icon
🩺 Doctor & logs	ერთი დაწკაპუნებით დიაგნოსტიკა და სერვერის ჟურნალში წვდომა

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{გსურთ ჩამოტვირთვა? აიღეთ უახლესი .dmg დან
ავრცელებს . წყარო, საკითხები და აშენება
დოკუმენტები ცხოვრობენ zoispag/omniroute-tray ში.

💛 საზოგადოების პროექტი @zoispag - არ არის OmniRoute ოფიციალური გამოცემა.}

## 🔒 პირადი და ლოკალურ გარემოზე ორიენტირებული

_{📖 [ავტორიზაცია](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)}

OmniRoute CLI-ის ანიმაციური ტერმინალური დემო — 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-ის**, **ვებჰუკების** ან **დისტანციური CLI-ის** მეშვეობით — ნებისმიერი შესაბამისი შესაძლებლობის მქონე აგენტი (ან თქვენი საკუთარი კოდი) მიიღებს მთელი კარიბჭის მართვის გასაღებებს: მარშრუტიზაცია, პროვაიდერები, კომბინაციები, კეში, შეკუმშვა, მეხსიერება — ავტონომიურად. ქვემოთ მოცემული HTTP ბოლო წერტილები ხელმისაწვდომია მისამართზე `http://localhost:20128`.

ინტერფეისი	ბოლო წერტილი / ბრძანება	გამოიყენეთ შემდეგისთვის
🧰 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
🔔 ვებჰუკები	`/api/webhooks`	მოთხოვნების / კვოტის მოვლენების გაგზავნა Slack-ში, Discord-ში, Telegram-ში ან ნებისმიერ URL-ზე
🛰️ დისტანციური CLI	`omniroute connect`	დისტანციური ინსტანციის მართვა შეზღუდული წვდომის ტოკენებით

```bash # მიეცით Claude Code-ს OmniRoute-ის ინსტრუმენტების სრული ნაკრები 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%-ით დაზოგვა — ავტომატურად

### 📖 როგორ მუშაობს — pipeline, არქიტექტურა და დაზოგვის მათემატიკა

OmniRoute-ის compression pipeline: 10,000-ტოკენიანი კლიენტის მოთხოვნა გადის 12 კომპოზირებად engine-ზე — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra და OmniGlyph — და დოკუმენტირებულ, ერთმანეთზე მიბმულ მაგალითში პროვაიდერამდე დაახლოებით 1,080 ტოკენით აღწევს. სტრუქტურირებული კონტენტი დაცულია preservation guard-ებითა და თითოეული ნაბიჯის fidelity gate-ებით; lossless ან experimental რეჟიმებმა შეიძლება გარდაქმნან შესაბამისი კონტენტი.

ნაგულისხმევი stacked კომბინაცია ამუშავებს `RTK → Caveman`-ს. როდესაც ორივე ერთსა და იმავე tool/context 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 და სტრუქტურირებული მონაცემები **ყოველთვის დაცულია** preservation engine-ის მიერ. > **რატომ უნდა გამოიყენოთ ბევრი ტოკენი, როცა საქმეს ცოტა ტოკენიც ართმევს თავს?** ყოველი მოთხოვნა **გამჭვირვალედ** გადის OmniRoute-ის compression pipeline-ში — კლიენტში ცვლილებები საჭირო არ არის. ახლა ეს არის **12 კომპოზირებადი engine-ის stack**, რომლებიც რიგრიგობით მუშაობენ და თითოეული 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-engine-იანი stack Engine-ები pipeline-ის თანმიმდევრობით მუშაობს; თითოეულის ჩართვა/გამორთვა და კონფიგურაცია combo-ს მიხედვით დამოუკიდებლად არის შესაძლებელი:

#	Engine	რას აკეთებს
1	Session-Dedup	შლის turn-ებს შორის განმეორებულ კონტენტს (content-addressed, cross-turn)
2	CCR	დიდ ბლოკებს retrieve marker-ების უკან არქივში ათავსებს და საჭიროებისას იღებს
3	Lite	Whitespace-ისა და image-URL-ების შემცირება (დაბალი latency-ის მქონე საბაზისო ვარიანტი)
4	RTK	Tool-result-ების ჭკვიანური გაფილტვრა, dedup და truncation (command-aware)
5	Responses Tool Output	Lossless-first JSON + შეზღუდული diagnostic compression shell/patch/search/build შედეგებისთვის (Responses API)
6	Headroom	JSON მასივების lossless tabular compaction (~30%) vendored GCF codec-ის მეშვეობით
7	Relevance	ბოლო user query-სთან მიმართებით წინადადებების extractive scoring
8	Caveman	წესებზე დაფუძნებული prose compression (output-ზე ~65–75%)
9	Aggressive	ძველი turn-ების შეჯამება + progressive aging
10	LLMLingua-2	ML semantic pruning MobileBERT ONNX-ის მეშვეობით — code-safe, async
11	Ultra	ევრისტიკულ token pruning-ს არჩევითი small-model (SLM) tier-ით
12	OmniGlyph	ექსპერიმენტული context-as-image encoding, რომელიც გამოიყენება პირდაპირ Anthropic wire-ზე გაზომილი Claude Fable 5-ისთვის; GPT 5.6 transformers provider receipts-ის მოლოდინში fail-closed რჩება. compression-ის ოთხი profile (ნაგულისხმევად aggressive, balanced, coding-safe, passthrough) (ყველაზე აგრესიული; opt-in)

კოდის ბლოკები, URL-ები და სტრუქტურირებული მონაცემები **ყოველთვის შენარჩუნებულია** byte-perfect-ად. **One-click preset-ები** engine-ებს აერთიანებს:

რეჟიმი	დაზოგვა	საუკეთესო გამოყენება
🪶 Lite	~15%	ყოველთვის ჩართული უსაფრთხო ნაგულისხმევი ვარიანტი
🪨 Standard (Caveman)	~30%	ყოველდღიური კოდირება
⚡ Aggressive	~50%	ხანგრძლივი, tool-ებით დატვირთული სესიები
🔥 Ultra	~75%	მაქსიმალური დაზოგვა
🧰 RTK	60–90%	Shell/test/build/git output
🔗 Stacked (RTK → Caveman)	78–95%	შერეული prompt-ები + tool log-ები

**რეალური მაგალითი — Standard რეჟიმი:** > **მანამდე (69 ტოკენი):** _"თქვენი React კომპონენტის ხელახლა რენდერინგის მიზეზი, სავარაუდოდ, ის არის, რომ ყოველი render cycle-ის დროს ახალ object reference-ს ქმნით. როდესაც inline object-ს prop-ის სახით გადასცემთ, React-ის shallow comparison მას ყოველ ჯერზე განსხვავებულ object-ად აღიქვამს, რაც ხელახალ რენდერინგს იწვევს. გირჩევთ, object-ის memoize-სთვის useMemo გამოიყენოთ."_ > > **შემდეგ (19 ტოკენი):** _"ყოველ render-ზე ახალი object ref. Inline object prop = ახალი ref = ხელახალი რენდერი. მოათავსეთ useMemo-ში."_ > > **იგივე პასუხი. 72%-ით ნაკლები ტოკენი. სიზუსტის ნულოვანი დანაკარგი.** ✅ **PT-BR მაგალითი — [Troglodita](https://github.com/leninejunior/troglodita) რეჟიმი:** > **მანამდე (42 ტოკენი):** _"პრობლემა ისაა, რომ კომპონენტი ხელახლა რენდერდება, რადგან რენდერის თითოეულ ციკლში ობიექტის ახალი რეფერენსი იქმნება. გირჩევდით useMemo-ის გამოყენებას."_ > > **შემდეგ (12 ტოკენი):** _"ხელახალი რენდერი: ახალი ref ყოველ ციკლში (ინლაინ-ობიექტი თავიდან იქმნება). გამოიყენეთ `useMemo`."_ > > **იგივე პასუხი. ~70%-ით ნაკლები ტოკენი. ტექნიკური სიზუსტე შენარჩუნებულია.** ✅
### 🎚️ ძრავებს მიღმა — გამოსავლის სტილები, ადაპტური რეგულატორი და მოთხოვნის მიხედვით კონტროლი ზემოთ აღწერილი 12 ძრავა ამცირებს იმას, რაც **შედის**. კიდევ სამი ფენა განსაზღვრავს **როგორ**, **როდის** და რა გამოდის: - **🪄 გამოსავლის სტილები** _(გამოსავლის ღერძის მართვა)_ — ამატებს დეტერმინისტულ, ქეშისთვის უსაფრთხო ინსტრუქციებს პასუხის ფორმირებისთვის; მათი კომბინირება შესაძლებელია, თითოეული კი ხელმისაწვდომია `lite` / `full` / `ultra` ინტენსივობით. სტილის დამატება რეესტრში ერთხაზიანი ჩანაწერით ხდება: - **მოკლე პროზა** — ამოიღეთ შემავსებელი სიტყვები / არტიკლები / მერყევი ფორმულირებები; ტექნიკური შინაარსი ზუსტად შეინარჩუნეთ. - **ნაკლები კოდი** — „ზარმაცი senior dev“-ის YAGNI: უმცირესი მოქმედი ცვლილება, მოუთხოვნელი საყრდენი კოდის გარეშე. - **კუდი (ზარმაცი senior dev)** — მიჰყევით YAGNI-ის საფეხურებს, გამოასწორეთ ძირეული მიზეზი, შეიტანეთ უმცირესი მოქმედი diff. - **ADHD მაქვს (ქმედება უპირველესად)** — შემდეგი ქმედება პირველივე ადგილზეა, ნაბიჯები დანომრილია, ერთი კონკრეტული შემდეგი ნაბიჯი, შესავლის გარეშე. - **მოკლე CJK (文言)** — კლასიკური ჩინურის ულტრამოკლე სტილი (ლოკალით შეზღუდული `zh`-ზე). - **🎯 ადაპტური კონტექსტის ბიუჯეტი** _(რეგულატორი)_ — ერთი ჩართული/გამორთული ტოკენის ზღვრის ნაცვლად, ყველაზე იაფი და ნაკლებად დამაკარგვინებელი ძრავები მხოლოდ იმდენად ძლიერდება, რამდენიც საჭიროა, რათა მოთავსდეს მოდელის კონტექსტის ფანჯარაში. პოლიტიკა: `reserve-output` (ნაგულისხმევი, მოდელზე მორგებული) · `percentage` · `absolute`. რეჟიმი: `floor` (მოთავსების გარანტია) · `replace-autotrigger` (თქვენი აშკარა არჩევანი იმარჯვებს) · `off` (ძველი ზღვარი). - **🎛️ სად წყდება შეკუმშვის გადაწყვეტილება** _(პრიორიტეტი, მაღალი → დაბალი)_ — თითოეული მოთხოვნის `x-omniroute-compression` ჰედერი › routing-combo-ის გადაფარვა › აქტიური სახელდებული პროფილი › adaptive / auto-trigger › პანელის ნაგულისხმევი მნიშვნელობა › off. გამოყენებული გეგმა პასუხში ბრუნდება `X-OmniRoute-Compression: ; source=` ჰედერის სახით. ჩართეთ ავტომატური ტრიგერი ტოკენების ზღვრის მიხედვით, გადართეთ ადაპტური რეგულატორი, მიამაგრეთ სახელდებული პროფილი, დააყენეთ ერთჯერადი მნიშვნელობა მოთხოვნისთვის ან მიანიჭეთ pipeline თითოეულ routing combo-ს — იმის მიხედვით, რაც სამუშაო დატვირთვას შეესაბამება. არჩევითი ოფლაინ **შეფასების ჰარნესი** (`npm run eval:compression`) აფასებს სიზუსტესა და დაზოგვას ფიქსირებულ კორპუსზე, სანამ ცვლილებას გაავრცელებთ. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ სწრაფი დაწყება

**1) ინსტალაცია და გაშვება** ```bash npm install -g omniroute omniroute ``` > 💡 ხედავთ `npm warn ERESOLVE`-ს ან peer-dep გაფრთხილებებს? [ისინი უვნებელია](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **იყენებთ npm 11-ს ან უფრო ახალ ვერსიას?** npm-მა შესაძლოა დაბლოკოს პაკეტის lifecycle სკრიპტები, თუ ისინი დაშვებული არ არის. OmniRoute-ის `postinstall` (`node scripts/build/postinstall.mjs`) საჭიროა მისი native runtime ფაილების მოსამზადებლად. გლობალურად ინსტალაციისას დაუშვით npm-ის გაფრთხილებაში დასახელებული პაკეტები. OmniRoute 3.8.54-ის მიერ მოხსენებული პაკეტებისთვის: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > ამ allowlist-ის მომავალ გლობალურ ინსტალაციებზე ხელახლა გამოსაყენებლად, ერთხელ დააკონფიგურირეთ და შემდეგ ჩვეულებრივად დააინსტალირეთ: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > დამოკიდებულებების სია რელიზებს შორის შეიძლება შეიცვალოს; თუ npm სხვა სიას გამოიტანს, გამოიყენეთ იმ გაფრთხილებაში მითითებული პაკეტების სახელები. პაკეტის დაშვება მის install სკრიპტებს გაშვების უფლებას აძლევს. > **იყენებთ Gemini Web-ს ან ვებ-ქუქიების სხვა პროვაიდერს?** npm პაკეტში შედის > Playwright, თუმცა მისი Chromium ბინარული ფაილი — არა. პირველი web-provider მოთხოვნის შესრულებამდე გაეცანით > [Playwright Chromium-ის დაყენების](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > შენიშვნას. Dashboard ხელმისაწვდომია `http://localhost:20128`-ზე · API — `http://localhost:20128/v1`-ზე. **2) შესაბამისი პროვაიდერის დაკავშირება საკუთარი ანგარიშით** Dashboard → **Providers** → აირჩიეთ პროვაიდერი, რომლის მიმდინარე პირობები და კვოტა თქვენს გამოყენების შემთხვევას შეესაბამება → დაამატეთ მისი API key ან გაიარეთ მისი ანგარიშის პროცესი. უფასო ტარიფებმა შეიძლება მოითხოვოს რეგისტრაცია, დამტკიცება ან გადახდის მეთოდი. გაეცანით [Free Tiers Guide-ს](docs/getting-started/FREE-TIERS-GUIDE.md); keyless ხელმისაწვდომობა გარანტირებული არ არის, ხოლო `tos: avoid` ნიშნით მონიშნული პროვაიდერები ნაგულისხმევად `auto`-დან გამორიცხულია. **3) თქვენი კოდირების ხელსაწყოს მითითება** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) მუშაობის შემოწმება** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` უნდა დაინახოთ თქვენი დაკავშირებული მოდელების სია. 🎉 სულ ეს არის — დაიწყეთ კოდირება, ხოლო OmniRoute ავტომატურად შეარჩევს მარშრუტს და საჭიროების შემთხვევაში გადაერთვება ალტერნატივაზე. თუ თქვენს კლიენტს მორგებული ჰედერების გაგზავნა არ შეუძლია, OmniRoute ასევე გთავაზობთ ტოკენიზებულ თავსებადობის ალაიასებს: ```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 ...`-ის მიმაგრება არ შეუძლიათ. ჰედერზე დაფუძნებული ავტორიზაცია კვლავ სასურველი რეჟიმია.
## 📦 ინსტალაციის სხვა მეთოდები — 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` ბრენჩს. GitOps-ისთვის გამოიყენეთ ფიქსირებული `:X.Y.Z`. იხილეთ [Docker-ის გამოშვების არხები](docs/guides/DOCKER_GUIDE.md#release-channels).იმიჯში ფიქსირებულია **`OMNIROUTE_MEMORY_MB=1024`**. ეს საკმარისია მართვის პანელისა და მსუბუქი ჩატისთვის. **კოდირების აგენტებს** (`POST /v1/responses` Claude Code-იდან, Codex-იდან, Grok-იდან, …) სჭირდებათ გაცილებით დიდი V8 heap, წინააღმდეგ შემთხვევაში ორი გადაფარული გრძელი კონტექსტის დროს პროცესი დაახლოებით 12 GiB-ზე `FATAL ERROR`-ით წყდება. კონტეინერის მეხსიერება heap-ზე მეტი გამოყავით (native ბუფერები V8-ის გარეთ მდებარეობს): | დატვირთვა | Heap (`-e OMNIROUTE_MEMORY_MB`) | კონტეინერი (`--memory`) | | ------------------------------------ | ---------------------------------------- | ----------------------- | | მართვის პანელი / მსუბუქი ჩატი | `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-ის სახელმძღვანელო — ოპერატიული მეხსიერება მუშაობის დროს](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **Docker-ის წინასწარი გამოშვების არხი:** `diegosouzapw/omniroute:next` და > `diegosouzapw/omniroute:next-web` მიჰყვება მიმდინარე ნაგულისხმევ `release/v*` > ბრენჩს. ეს ცვალებადი ტეგები განკუთვნილია მხოლოდ გამოუშვებელი შესწორებების სატესტოდ და > **არ არის მხარდაჭერილი საწარმოო გარემოში**. იხილეთ > [Docker-ის გამოშვების არხები](docs/guides/DOCKER_GUIDE.md#release-channels). **🥟 Bun** სტანდარტული `bun install` და გლობალური ინსტალაცია (`bun install -g omniroute`) მხარდაჭერილია Bun-ის გაშვების გარემოს ამოცნობის მეშვეობით: - **ჩაშენებული `bun:sqlite`**: Bun-ის გარემოში მუშაობისას OmniRoute იყენებს Bun-ის ჩაშენებულ `bun:sqlite` დრაივერს, ხოლო Node.js-ზე — `better-sqlite3`-ს ან `sql.js`-ს. - **Webpack-ის ავტომატური არჩევა დეველოპმენტისას**: დეველოპმენტის რეჟიმი (`bun run dev`) ავტომატურად ამოიცნობს Bun-ს და native V8 binding-ებთან შეუთავსებლობის თავიდან ასაცილებლად Turbopack-ს თიშავს Webpack-ის სასარგებლოდ. საწარმოო build-ები (`bun run build`) `OMNIROUTE_USE_TURBOPACK`-ს ზუსტად ისე ემორჩილება, როგორც Node-ზე: ნაგულისხმევად Turbopack, ხოლო Webpack-ით build-ისთვის — `OMNIROUTE_USE_TURBOPACK=0` (`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-ის სახელმძღვანელო](docs/guides/DOCKER_GUIDE.md) — Compose პროფილები, Caddy HTTPS, Cloudflare გვირაბები. **🦭 Podman** ```bash # 1. მოამზადეთ bind-mounted მონაცემთა დირექტორია mkdir -p data # 2. მხოლოდ Linux + ლოკალური rootless Podman (არასდროს დისტანციური Podman Machine კლიენტი): podman unshare chown 1000:1000 ./data # 3. დააყენეთ გაშვების გარემოს მინიშნება, შექმენით ლოკალური 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-ის სახელმძღვანელო](contrib/podman/README.md) — Compose build-ები, 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 link-ები — იხილეთ ზემოთ). მართვის პანელის გარეშე, headless გაშვების გარემოსთვის გამოიყენეთ Docker-ის `base` პროფილი (ზემოთ) ან [Termux-ის სახელმძღვანელო](docs/guides/TERMUX_GUIDE.md). CLI-სა და ვებ-მართვის პანელს ერთი და იგივე პროცესი ერთ პორტზე ემსახურება, ამიტომ ამჟამად ცალკე, მხოლოდ CLI-სთვის განკუთვნილი პაკეტი არ არსებობს.

# 🎬 OmniRoute მოქმედებაში

## 📹 ვიდეოგზამკვლევები

_{მართვის პანელის სნეპშოტი 2026-10-18 მდგომარეობით · დაუმუშავებელი კატალოგი: YT 1.352 | TT 334 | IG 290 · განახლების სიხშირე (დღეები): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 ნახვა}

🎬 #2 — Instagram
_{nnapier7 — 1,454,535 ნახვა}

🎬 #3 — YouTube
_{Amidia AI & Tech — 794,974 ნახვა}

🎬 #4 — Instagram
_{theopenstack — 692,419 ნახვა}

🎬 #5 — TikTok
_{migue.baena — 685,788 ნახვა}

**სრული რეიტინგი (დედუბლირებული კანონიკური URL-ები, `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) | | 🐛 **შეცდომის შეტყობინება** | [გახსენით საკითხი](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`-ის ნულოვანი გამოყენება core-ში v2.0-დან)
ფრეიმვორკი	Next.js 16 + React 19 + Tailwind CSS 4
მონაცემთა ბაზა	better-sqlite3 (SQLite, WAL journaling) + LowDB (JSON legacy) — 147 დომენური მოდული, 233 მიგრაცია
მეხსიერება	SQLite FTS5 სრული ტექსტის ძიება + int8-quantized ვექტორული ემბედინგები, ტიპიზებული decay
სქემები	Zod 4 — MCP ხელსაწყოების I/O ვალიდაცია + API კონტრაქტები
პროტოკოლები	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
სტრიმინგი	Server-Sent Events (SSE) + WebSocket bridge (`/v1/ws`)
კომპრესია	12-ძრავიანი pipeline — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
ავთენტიფიკაცია და უსაფრთხოება	OAuth 2.0 (PKCE) + JWT + API Keys + MCP scoped auth · AES-256-GCM at rest · DOMPurify
ფარულობა	wreq-js — JA3 / JA4 TLS fingerprint impersonation, 3-დონიანი proxy
მედეგობა	Circuit breaker, exponential backoff, anti-thundering-herd, auto-combo self-healing
ლოგირება	pino — სტრუქტურირებული JSON ლოგები მოთხოვნის კონტექსტით
ტესტირება	Node.js test runner + Vitest — 60,000+ სტატიკური ტესტის დეკლარაცია 8,400+ თვალყურის დევნებულ სატესტო ფაილში (unit, integration, E2E, security, ecosystem)
პლატფორმები	Desktop (Electron) · Android (Termux) · PWA (ნებისმიერი ბრაუზერი)
CI/CD	GitHub 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-ვარიანტიანი კონვეიერი: off / lite / standard / aggressive / ultra / RTK / stacked
RTK შეკუმშვა	ბრძანების გამოსავლის შეკუმშვა, ფილტრები, ნდობა, ვერიფიკაცია, დაუმუშავებელი გამოსავლის აღდგენა
შეკუმშვის ძრავები	Caveman, RTK, ერთმანეთზე გადაბმული კონვეიერები, dashboard/API/MCP ზედაპირები
შეკუმშვის წესების ფორმატი	JSON წესების პაკეტის სქემები Caveman-ისა და RTK-ის ფილტრებისთვის
შეკუმშვის ენობრივი პაკეტები	ენის ამოცნობა და Caveman-ის წესების პაკეტის შექმნა
მედეგობის სახელმძღვანელო	ამომრთველები, გაგრილების პერიოდები, რიგი, ანტითანდერული ნახირი, TLS-ის გაყალბება
ავტო-კომბოს ძრავა	16-ფაქტორიანი შეფასება, რეჟიმების პაკეტები, თვითაღდგენა
პროქსის სახელმძღვანელო	პროქსის 3-დონიანი სისტემა, 1proxy-ის მარკეტპლეისი, რეესტრის CRUD
უფასო დონეები	გაერთიანებული კატალოგი: 34 დოკუმენტირებული განმეორებადი პული / უფასო დონის 465 კატალოგიზებული ჩანაწერი
შესაძლებლობების გალერეა	dashboard-ის ვიზუალური მიმოხილვა ეკრანის ანაბეჭდებით
კოდბეისის დოკუმენტაცია	კოდბეისის დამწყებთათვის გასაგები მიმოხილვა

### 🤖 პროტოკოლები და API-ები

დოკუმენტი	აღწერა
API-ის ცნობარი	ყველა endpoint მაგალითებით
OpenAPI-ის სპეციფიკაცია	OpenAPI 3.0-ის სპეციფიკაცია
MCP სერვერი	110 MCP ხელსაწყო, IDE-ის კონფიგურაციები, Python/TS/Go კლიენტები
MCP სერვერის სახელმძღვანელო	MCP-ის ინსტალაცია, ტრანსპორტები და ხელსაწყოების ცნობარი
A2A სერვერი	JSON-RPC 2.0 პროტოკოლი, უნარები, სტრიმინგი, ამოცანების მართვა
A2A სერვერის სახელმძღვანელო	A2A აგენტის ბარათი, ამოცანები, უნარები და სტრიმინგი

### 📋 პროექტი და ხარისხი

დოკუმენტი	აღწერა
კონტრიბუცია	განვითარების გარემოს გამართვა და მითითებები
ბრენჩებისა და რელიზების მოდელი	სად მიემართება PR-ები (`release/*`), რას ნიშნავს `main` და ტეგები
ცვლილებების ჟურნალი	რელიზების სრული ისტორია ვერსიების მიხედვით
უსაფრთხოების პოლიტიკა	მოწყვლადობების შეტყობინება და უსაფრთხოების პრაქტიკები
i18n სახელმძღვანელო	67 ენის მხარდაჭერა, თარგმნის სამუშაო პროცესი, RTL
რელიზის საკონტროლო სია	რელიზამდე ვალიდაციის ეტაპები
დაფარვის გეგმა	ტესტების დაფარვის სტრატეგია 8,400-ზე მეტ თვალყურის დევნებად სატესტო ფაილში განთავსებული 60,000-ზე მეტი სტატიკური სატესტო დეკლარაციისთვის

# ⭐ საუკეთესო კონტრიბუტორები > OmniRoute-ის ჩამოყალიბებაში დიდი წვლილი მიუძღვის ენთუზიაზმით სავსე ღია კოდის საზოგადოებას. ამ ადამიანებმა განსაკუთრებული წვლილი შეიტანეს, რაც პირდაპირ აისახება პროექტის ხარისხზე, სტაბილურობასა და გავრცელებაზე. **გმადლობთ.** ### გარე კონტრიბუტორები გაერთიანებული pull request-ების მიხედვით

რანგი	კონტრიბუტორი	გაერთიანებული PR-ები	~შეცვლილი ხაზები
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{აღწერა აღებულია 2026-11-03 03:01:19 UTC-ზე, მოქმედი release/v3.8.53 წვერით 05bc048d6c. გვერდებად დაყოფილი GitHub GraphQL-ის აღწერა შეიცავს 9,947 გაერთიანებულ PR-ს: 4,130 საცავის მფლობელისგან, 240 Dependabot-ისგან, 6 სხვა ბოტებისა და აპებისგან და 5,571 გარე PR-ს 883 განსხვავებული კონტრიბუტორისგან. „შეცვლილი ხაზები“ არის GitHub-ის დამატებებისა და წაშლილებების ჯამი და მოიცავს გენერირებულ ფაილებს, lockfile-ებს, კატალოგებს, თარგმანებსა და დოკუმენტაციას; ეს არის ცვლილებების რაოდენობა და არა ავტორის მიერ დაწერილი LOC. 53 PR-ში GitHub-ის diff-ები 500,000 ხაზზე მეტია (მაგალითად, #13399-ში, რომელიც ერთი პროვაიდერის დამატებას წარმოადგენს, მითითებულია 2,347 შეცვლილი ფაილი), რაც ზემოთ მოცემულ რამდენიმე ჯამურ მაჩვენებელს ზრდის. თანაბარი შედეგების მქონე მონაწილეები ერთობლივად არიან რანჟირებული.} ### GitHub-ისთვის მიკუთვნებული კომიტები

Dizzle _{🥇 GitHub-ის მიერ მიკუთვნებული 418 კომიტი}	Bob.Hou _{🥈 GitHub-ის მიერ მიკუთვნებული 294 კომიტი}	Paijo _{🥉 GitHub-ის მიერ მიკუთვნებული 229 კომიტი}	Paco Cartones _{🏅 GitHub-ის მიერ მიკუთვნებული 222 კომიტი}	backryun _{🏅 GitHub-ის მიერ მიკუთვნებული 202 კომიტი}	Jan Leon _{🏅 GitHub-ის მიერ მიკუთვნებული 134 კომიტი}
Ravi Tharuma _{🏅 GitHub-ის მიერ მიკუთვნებული 126 კომიტი}	Markus Hartung _{🏅 GitHub-ის მიერ მიკუთვნებული 115 კომიტი}	Randi _{🏅 GitHub-ის მიერ მიკუთვნებული 108 კომიტი}	Chris _{🏅 GitHub-ის მიერ მიკუთვნებული 70 კომიტი}	WebPerson _{🏅 GitHub-ის მიერ მიკუთვნებული 68 კომიტი}	Koosha Paridehpour _{🏅 GitHub-ის მიერ მიკუთვნებული 68 კომიტი}

_{ხელახლა გადამოწმებულია 2026-11-03 02:09:16 UTC-ზე: GitHub-ის მიერ მიკუთვნებული კომიტები, რომლებიც მოხსენებულია repository Contributors API-ის მიერ release/v3.8.53 ნაგულისხმევი ბრანჩისთვის. API-მ დააბრუნა 903 იდენტობა (429 მომხმარებელი, 2 ბოტი, 472 ანონიმური); ეს ცხრილი გამორიცხავს maintainer-ს, ბოტებსა და ანონიმურ იდენტობებს და ინარჩუნებს კონკურსში თანაბარ შედეგებს. ის განსხვავდება როგორც ზემოთ მოცემული გაერთიანებული PR-ების რეიტინგისგან, ისე ქვემოთ მოცემული Git-მეტამონაცემების აღწერისგან.} > 🙏 ამ კონტრიბუტორების ფუნქციები, ხარვეზების გამოსწორებები და ინფრასტრუქტურის გაუმჯობესებები **იმის ძირითადი ნაწილია**, რაც OmniRoute-ს საიმედოსა და მრავალფუნქციურს ხდის. მნიშვნელოვანია ყოველი pull request, ყოველი სატესტო შემთხვევა და i18n-ის ყოველი თარგმანის ფაილი. ღია კოდს სწორედ ასეთი ადამიანები ქმნიან.

---
## 💖 სპონსორები

გულწრფელი მადლობა იმ ადამიანებს, რომლებიც OmniRoute-ს საკუთარი სახსრებით აფინანსებენ — თითოეული შემოწირულობა პროექტს უფასოს, დამოუკიდებელსა და განვითარებადს უნარჩუნებს.

Andrew _{💛 აქტიური ყოველთვიური სპონსორი}	Vlad I _{💛 აქტიური ყოველთვიური სპონსორი}	小妍儿 _{💛 აქტიური ყოველთვიური სპონსორი}	Guilherme Costa _{💛 აქტიური ერთჯერადი სპონსორი}	Henrique Iurkiv _{💛 აქტიური ერთჯერადი სპონსორი}	Somesh Ghaturle _{💛 აქტიური ერთჯერადი სპონსორი}
Kolonie AI _{💛 ყოფილი ერთჯერადი მხარდამჭერი}	Prof. Igor Morais _{💛 ყოფილი ერთჯერადი მხარდამჭერი}	Pixma _{💛 ყოფილი ერთჯერადი მხარდამჭერი}	Paco Cartones _{💛 ყოფილი ერთჯერადი მხარდამჭერი}	longtao _{💛 ყოფილი ერთჯერადი მხარდამჭერი}

_{… და სხვები, რომლებიც ანონიმურად დარჩენას ამჯობინებენ 💛} _{საჯარო GitHub Sponsors-ის მონაცემები ხელახლა გადამოწმდა 2026-10-18-ს GitHub Sponsors GraphQL API-ის მეშვეობით: სულ 14 სპონსორობიდან 11 საჯაროა (6 აქტიური, 5 ყოფილი). GitHub-ის isActive სტატუსი განსაზღვრავს ზემოთ მოცემულ აქტიურობის აღნიშვნებს; ყოფილ საჯარო ერთჯერად მხარდამჭერებს კვლავ მადლობას ვუხდით, ხოლო კერძო სპონსორები ანონიმურად რჩებიან. 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-ს live release/v3.8.53 tip 1c7135e0fb-ზე (7,972 commit): 1,074 ნორმალიზებული ადამიანის Git-იდენტიფიკატორი — 759 ჩანს commit-ის ავტორებად (მათ შორის, maintainer-იც), ხოლო 315 მხოლოდ მკაფიო Co-authored-by trailer-ებში. აღწერისას გამოყენებულია .mailmap, ელფოსტის მისამართები შედარებულია რეგისტრის გაუთვალისწინებლად, რიცხვითი და ჩვეულებრივი GitHub noreply მისამართები გაერთიანებულია მხოლოდ მაშინ, როცა ისინი ერთსა და იმავე handle-ს განსაზღვრავენ, გამორიცხულია 29 ბოტის/აგენტის/სერვისის/placeholder-ის იდენტიფიკატორი და ჩვეულებრივი ელფოსტის მისამართები არ გაერთიანებულა მხოლოდ display name-ების დამთხვევის საფუძველზე. 2026-08-24-ის აუდიტში გამოქვეყნებული იყო 639; ამ აუდიტის საბაზისო ac02c5b42f-ზე მეთოდის ხელახლა გაშვების შედეგად მიიღება 619, ამიტომ ზრდა ახალი კონტრიბუტორებით არის განპირობებული და არა უფრო ნაკლები შეზღუდვის მქონე მეთოდით.} ### როგორ შევიტანოთ წვლილი 1. შექმენით repository-ის fork 2. განშტოება შექმენით აქტიური `release/vX.Y.Z` tip-იდან (არა `main`-იდან) — იხილეთ [განშტოებისა და რელიზების მოდელი](docs/ops/BRANCHING_MODEL.md) 3. შექმენით თქვენი feature branch (`git checkout -b feat/amazing-feature`) 4. დააკომიტეთ ცვლილებები (`git commit -m 'feat: add amazing feature'`) 5. ატვირთეთ branch-ზე (`git push origin feat/amazing-feature`) 6. გახსენით Pull Request-ი **base = ეს `release/vX.Y.Z` branch** დეტალური მითითებებისთვის იხილეთ [CONTRIBUTING.md](CONTRIBUTING.md). ### ახალი ვერსიის რელიზი ```bash # შექმენით რელიზი — npm publish ავტომატურად შესრულდება VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 ვარსკვლავები

## 🌍 StarMapper

## 🙏 მადლობები

OmniRoute გიგანტების მხრებზე დგას. ის დაიწყო როგორც **[9router](https://github.com/decolua/9router)**-ის fork-ი და Go პროექტის **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** TypeScript-პორტი — შემდეგ კი ქვემოთ ჩამოთვლილი თითოეული ქვესისტემა შთაგონებული იყო open-source პროექტით, რომელმაც ეს გზა პირველმა გაიარა. თითოეულმა მათგანმა OmniRoute-ის კონკრეტული ნაწილი ჩამოაყალიბა. ეს ჩვენი მადლობის გადახდაა ყველა მათგანისთვის. 🙏 > ⭐ ვარსკვლავების რაოდენობა დადასტურებულია GitHub-ის REST API-დან 2026 წლის 3 ნოემბერს — ეწვიეთ ამ პროექტებს და დაუმატეთ ვარსკვლავი. რაოდენობები წარმოადგენს კონკრეტული თარიღის ზუსტ სურათს და ბუნებრივად შეიცვლება. ### 🧬 წარმომავლობა და gateway

პროექტი	⭐	როგორ შთააგონა OmniRoute
9router	31,861	ორიგინალი პროექტი, რომელზეც ეს fork-ია აგებული — აქ გაფართოებულია მრავალმოდალური API-ებით და სრულად არის გადაწერილი TypeScript-ზე.
CLIProxyAPI	57,329	Go-თი განხორციელებული იმპლემენტაცია, რომელმაც შთააგონა ეს JavaScript / TypeScript პორტი.
LiteLLM	62,580	AI gateway, რომლის საჯარო ფასების მონაცემთა ნაკრები ამარაგებს ჩვენი ხარჯების აღრიცხვის სინქრონიზაციას და რომლის პროვაიდერების ნორმალიზაციის მოდელმა გავლენა მოახდინა ჩვენს მარშრუტიზაციაზე.
codex-chatgpt-web	15,435	MIT-ის წყარო ადაპტირებულია vendored ChatGPT Web → Codex Responses bridge-ში, მათ შორის ბრაუზერის სესიის, პასუხების framing-ის, გამოყენების და ვებძიების ადაპტერები.
free-claude-code	65,966	პატერნები გადატანილია stream recovery-ში, no-thinking alias-ებში, fallback ვებძიებაში, sliding-window ლიმიტებში, ჟურნალების რედაქტირებასა და გამაგრებულ launcher-ის ნაკადებში.
composer-api	347	Cursor Composer-ის tool-choice, output-constraint და tool-commit პატერნები ადაპტირებულია native Cursor executor-ში.
codex-multi-auth	561	Fresh-login-ისა და refresh-token-ის როტაციის პატერნები გადატანილია Codex OAuth-ის ხელახალ ავთენტიფიკაციაში.
opencode-anthropic-auth	562	Claude Code-თან თავსებადი transform-ის ნაგულისხმევი პარამეტრები და billing-header-ის ქცევა განზოგადებულია OmniRoute-ის კონფიგურაციაზე დაფუძნებულ bridge-ში.
grok2api-merged	2	მისი Grok-ის მოდელების mapping-ები, fake-TypeError Statsig generator, request-ისა და device-ის ნაგულისხმევი პარამეტრები და NDJSON response processor არსებითად იქნა ადაპტირებული OmniRoute-ის Grok Web executor-ში.
TQZHR/grok2api	707	grok2api-merged-ის ძირითადი ტრანზიტული კოდის წყარო; მისი model, header, payload, Statsig და processor-ის იმპლემენტაციები შენარჩუნებულია Grok Web-ის წარმომავლობაში.
chenyme/grok2api	7,874	Grok-ის payload-ისა და device-ის ნაგულისხმევი პარამეტრების, Statsig generator-ისა და `result.response` processor-ის საფუძვლად არსებული MIT-ის წყარო, რომელიც TQZHR-ისა და grok2api-merged-ის გავლით გადმოვიდა.
grok2api-pro	27	grok2api-merged-ის მიერ მისი proxy-pool ფენისთვის მითითებული ტრანზიტული წყარო; OmniRoute ინარჩუნებს ამ წარმომავლობის მითითებას, თუმცა თავის bounded Grok Web executor-ში proxy-pool-ის პორტირებას არ იჩემებს.
GrokProxy	52	მისმა cookie-ით ავთენტიფიცირებულმა Grok proxy-მ და `result.response.token`-ის streaming პატერნმა გავლენა მოახდინა OmniRoute-ის Grok Web transport-ზე.
GrokBridge	5	Grok Web-ის ორიგინალურ იმპლემენტაციას გაეცნენ მისი HTTP/browser upstream-ის დიზაინისთვის; მისი პირდაპირი HTTP გზა GrokProxy-დან მომდინარეობს, ამიტომ კოდის დამოუკიდებელი პორტირება არ არის მითითებული.

### 🗜️ კონტექსტისა და token-ის შეკუმშვა — engines

პროექტი	⭐	როგორ შთააგონა OmniRoute
Caveman	116,957	ვირუსული პროექტი — „რატომ გამოვიყენოთ ბევრი ტოკენი, როცა ცოტაოდენი ტოკენიც ასრულებს საქმეს“ — მისი გამოქვაბულის ადამიანის მეტყველების ფილოსოფია ამუშავებს ჩვენს სტანდარტულ შეკუმშვის რეჟიმს და 30-ზე მეტ შემავსებლის/კონდენსაციის წესს.
RTK – Rust Token Killer	85,350	ბრძანებების გამოსავლის მაღალი წარმადობის შეკუმშვამ შთააგონა ჩვენი RTK ძრავა, JSON-ის ფილტრაციის DSL, დაუმუშავებელი გამოსავლის აღდგენა და ერთმანეთზე დაწყობილი RTK → Caveman კონვეიერი.
headroom	78,672	კონტექსტის შექცევადმა შეკუმშვამ (SmartCrusher) შთააგონა ჩვენი `headroom` ძრავა და `ccr` აღდგენის მარკერის შაბლონი.
LLMLingua	6,797	პრომპტების შეკუმშვის კვლევამ (LLMLingua / LLMLingua-2) შთააგონა ჩვენი ასინქრონული, კოდისთვის უსაფრთხო, შეცდომისას ღია `llmlingua` ძრავა.
llmlingua-2-js	33	JS/ONNX პორტი (MobileBERT / XLM-RoBERTa), რომელიც ჩვენი LLMLingua ძრავისთვის worker-thread-ის ბექენდად გამოიყენება.
Troglodita	50	PT-BR ტოკენების შეკუმშვა — ამუშავებს ჩვენს pt-BR ენობრივ პაკეტს: ბრაზილიური პორტუგალიური გრამატიკისთვის მორგებულ პლეონაზმების შემცირებასა და შემავსებლების მოცილებას.
ponytail	182,929	ვირუსულმა „ზარმაცი უფროსი დეველოპერის“ YAGNI-კოდერის უნარმა შთააგონა ჩვენი less-code Output Style: უმცირესი სამუშაო ცვლილების მართვა, რომელიც ამცირებს _გენერირებულ_ კოდს (გამოსავლის ღერძზე Caveman-ის ლაკონური პროზის მეწყვილე).
i-have-adhd	59,838	მისი მოქმედებაზე ორიენტირებული, ADHD-სთვის მოსახერხებელი პასუხების სტილი ადაპტირდა OmniRoute-ის ლაკონურ გამოსავლის სტილად ხუთ ენაზე.

### 🧩 კომპაქტური ფორმატები, ტოკენების კვლევა და კოდისადმი გააზრებული ხელსაწყოები

პროექტი	⭐	როგორ შთააგონა OmniRoute
TOON	25,602	Token-Oriented Object Notation — მისმა სვეტებზე დაფუძნებულმა, სათაურისა და მწკრივების მოდელმა ჩამოაყალიბა ჩვენი ტაბულარული კომპაქტაციის ეტაპი.
GCF – Graph Compact Format	61	მისმა კომპაქტურმა გრაფის ფორმატმა და ზოგადი პროფილის დიზაინმა გავლენა მოახდინა OmniRoute-ის ტაბულარულ კომპაქტაციასა და Headroom კოდეკის ფორმატზე.
gcf-typescript	4	MIT-ის ლიცენზიით გამოქვეყნებული TypeScript-ის იმპლემენტაცია, რომელიც პირდაპირ იქნა ჩაშენებული და გაფართოებული Headroom-ის ზოგადი პროფილის კოდეკად.
token-optimizer-mcp	566	Brotli/SQLite-ის ქეში + სესიებზე დაყოფილი კონტექსტის სხვაობა — შთააგონა ჩვენი `session-dedup` ძრავა.
token-savior	1,203	Bash-ის გამოსავლის კომპაქტაციამ + MCP-ის პროფილებმა შთააგონა ჩვენი შეკუმშვაზე უარის თქმის დისციპლინა და MCP ხელსაწყოების მანიფესტის შემცირება.
token-saver	162	შიგთავსზე ორიენტირებულმა, თითოეული ფაილის ტიპისთვის ცალ-ცალკე გამოსავლის შეკუმშვამ, მარცხის გათვალისწინებით უარის თქმამ, დაადასტურა ჩვენი ტიპების მიხედვით დისპეტჩინგი და მინიმალური მოგებისას გამოტოვება.
token-optimizer	2,853	„იპოვე მოჩვენება ტოკენები“ — მისმა გადატვირთვისა და აღდგენადი დესკრიპტორის შაბლონმა გავლენა მოახდინა ჩვენს CCR გადატვირთვის კონცეფციაზე.
TokenMizer	34	სესიების გრაფისა და სხვადასხვა turn-ს შორის სტრიქონების დუბლიკატების მოცილების სქემამ გავლენა მოახდინა ჩვენს session-dedup დიზაინზე.
OmniCompress	3	Rust-ის სვეტოვანმა JSON-მა + შიგთავსის მისამართზე დაფუძნებულმა მიღებამ + შეტყობინებებს შორის დუბლიკატების მოცილებამ დაადასტურა ჩვენი `headroom`/`ccr`/`session-dedup` ძრავების დიზაინი და ქეშისთვის სტაბილური ინვარიანტი „შეკუმშული ფორმა პოზიციისგან დამოუკიდებელია“.
mcp-compressor	140	MCP ხელსაწყოს სქემისა და აღწერის შეკუმშვამ გავლენა მოახდინა ჩვენს MCP ხელსაწყოების მანიფესტის კარდინალურობის შემცირებაზე.
RepoMapper	218	Aider-ის სტილის რეპოზიტორიის რუკის რანჟირებამ გავლენა მოახდინა ჩვენი რეპოზიტორიის რუკისა და მიღების რანჟირების კვლევაზე.
quiet-shell-mcp	4	MCP-ის გავლით დეკლარაციულმა shell-ის გამოსავლის შემცირებამ დაადასტურა ჩვენი დეკლარაციული bash-ის გამოსავლის კომპაქტაცია.
ts-morph	6,222	TypeScript Compiler API-ის ხელსაწყოთა ნაკრებმა შთააგონა ჩვენი პარსერზე დაფუძნებული კომენტარების მოცილება, რომელიც ინარჩუნებს სტრიქონულ, template- და regex-ლიტერალებს.

### 🧠 მეხსიერება და RAG

პროექტი	⭐	როგორ შთააგონა OmniRoute-ს
Mem0	68,294	უნივერსალური მეხსიერების ფენა — მისმა proxy-as-write/read-boundary მოდელმა ჩამოაყალიბა ჩვენი მეხსიერების არქიტექტურა.
Letta (MemGPT)	25,321	მდგომარეობის მქონე აგენტები იერარქიული მეხსიერებით — შთააგონა ჩვენს Context Control & Recovery (CCR) იერარქიულ მოდელს.
WFGY	1,804	ProblemMap-ის ტაქსონომია RAG/LLM-ის 16 განმეორებადი წარუმატებლობის რეჟიმისთვის — საერთო ლექსიკა ჩვენს პრობლემების აღმოფხვრის სახელმძღვანელოში.

### 🛰️ ტრაფიკის ინსპექტირება, MITM და გამჭვირვალე პროქსი

პროექტი	⭐	როგორ შთააგონა OmniRoute-ს
llm-interceptor	81	კოდირების ასისტენტსა და LLM-ს შორის ტრაფიკის MITM-ით გადაჭერამ/ანალიზმა განსაზღვრა Traffic Inspector-ის ადრეული მოთხოვნები. ადრე მიღებული ოთხი მოდული — SSE-ის გაერთიანება, საუბრების ნორმალიზაცია, საიდუმლოებების დაფარვა და ჰედერების გასუფთავება — ჩანაცვლებულია დამოუკიდებელი, clean-room პრინციპით განხორციელებული რეალიზაციებით, რომლებიც საჯარო პროტოკოლის სტანდარტებს ეფუძნება. ჰოსტებზე passthrough-ის ორი ზედაპირი (`passthrough.ts` და `_internal/bypass.cjs`) კვლავ OmniRoute-ის შიდა რეალიზაციებად რჩება და დამოუკიდებლად არის კლასიფიცირებული; ისინი ამ ჩანაცვლების ფარგლებში ხელახლა არ დაწერილა.
ProxyBridge	6,978	თითოეული პროცესისთვის გამჭვირვალე პროქსით მარშრუტიზაციამ შთააგონა ავარიის მიმართ უსაფრთხო MITM-ის დასრულება, სოკეტის უმოქმედობის ტაიმ-აუტები, პროცესების ატრიბუცია `/proc`-ის მეშვეობით და TPROXY-ის დაჭერა.

### 📚 მოდელების მონაცემები, დაკვირვებადობა და UI

პროექტი	⭐	როგორ შთააგონა OmniRoute-ს
models.dev	7,486	AI მოდელების სპეციფიკაციების, ფასებისა და შესაძლებლობების ღია მონაცემთა ბაზა — ბუნებრივად სინქრონიზებულია ჩვენს მოდელების კატალოგთან.
React Flow / xyflow	38,874	კვანძებზე დაფუძნებული გრაფების ბიბლიოთეკა, რომელიც უზრუნველყოფს ჩვენს რეალურ დროში მოქმედ Compression Studio-სა და Combo/Routing Studio-ს.
LangGraph	44,349	LangGraph Studio-ს რეალურ დროში სამუშაო პროცესის გრაფის ვიზუალიზაციამ შთააგონა ჩვენი Studio-ების რეალურ დროში კასკადური ხედი.
Langfuse	36,907	მისმა trace → span → generation დაკვირვებადობის მოდელმა ჩამოაყალიბა ჩვენი Compression Studio-ს waterfall.
Kiali	3,647	Istio-ს სერვის-მეშის დაკვირვებადობამ შთააგონა ჩვენი circuit-breaker-ის ბეიჯები და შეცდომების წიბოების ვიზუალიზაცია Routing/Combo Studio-ში.
lobe-icons	2,666	AI/LLM-ის ბრენდების ლოგოები, რომლებიც ჩვენი dashboard-ის მასშტაბით პროვაიდერების ხატულებს ასახავს.
flag-icons	12,499	უზრუნველყოფს MIT-ლიცენზირებულ SVG დროშებს, რომლებსაც README-ის ენის ამომრჩეველი იყენებს.

### 🛡️ უსაფრთხოება

პროექტი	⭐	როგორ შთააგონა OmniRoute-ს
awesome-secure-defaults	723	უსაფრთხო ნაგულისხმევი პარამეტრებით ბიბლიოთეკების კურირებული სია, რომელიც წარმართავს ჩვენს უსაფრთხოების არჩევანს (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

### 🧭 დამატებითი ხელსაწყოები

პროექტი	⭐	როგორ შთააგონა OmniRoute-ს
ClawRouter	6,649	შთააგონა მოთხოვნების დუბლიკატების აღმოფხვრა, საგანგებო ნულოვანი ღირებულების fallback, პლაგინირებადი Auto-Combo სტრატეგიები და მრავალენოვანი ინტენტის კლასიფიკაცია.
Antigravity-Manager	32,785	მისმა ანგარიშზე დამოკიდებულმა მოდელების გადამისამართებამ, შესრულებადი ფაილების გზების ვალიდაციამ და გეგმის იარლიყების ქცევამ გავლენა მოახდინა OmniRoute-ის Antigravity runtime-ზე.
vscode-antigravity-cockpit	4,852	მისმა კვოტის განულებამდე დარჩენილი დროის კომპაქტურმა ათვლის ფორმატმა შთააგონა შესაბამისი პროვაიდერის ლიმიტის ჩვენება OmniRoute-ში.
AionUi	33,996	მისმა ACP ინტეგრაციებმა შთააგონა OmniRoute-ში დაინსტალირებული CLI აგენტების ავტომატური აღმოჩენა.
CodexBar	22,955	გამოავლინა Grok Build-ის კვოტის ზედაპირი; OmniRoute-მა შემდეგ დამოუკიდებლად გადაამოწმა და შეასწორა wire-ის ცოცხალი ფორმატი.

## 📄 ლიცენზია MIT ლიცენზია — დეტალებისთვის იხილეთ [LICENSE](LICENSE). ---

**[⬆ თავში დაბრუნება](#-omniroute)** · შექმნილია ❤️-ით ღია კოდის AI-საზოგადოებისთვის. _{შექმნა Diego Souza-მ · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT ლიცენზია · omniroute.online}