# 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 კარიბჭე

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

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

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

OmniRoute-ის უფასო პაკეტის ბიუჯეტის ბარათი: ~1.62B უფასო ტოკენი თვეში სტაბილურად, ~2.22B-მდე პირველ თვეში რეგისტრაციის კრედიტებით, 34 დოკუმენტირებული განმეორებადი პულის გასაღებიდან, რომელიც მოიცავს 467 კატალოგირებულ უფასო პაკეტის ჩანაწერს ერთი ენდპოინტის უკან. გულახდილი, პულ-დედუპლიკაციური არითმეტიკა — თითოეული საერთო პული ერთხელ ჩაითვლება, მათ შორის 17 განმეორებადი პული გამოქვეყნებული დადებითი თვიური ტოკენის ბიუჯეტით, პლუს Groq-ის ხუთი თითო-მოდელის ლიმიტი; 12 პროვაიდერი მონიშნულია როგორც „მოერიდე

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

⭐ მიანიჭეთ ვარსკვლავი რეპოზიტორიას, თუ 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) ### 💬 შეუერთდით საზოგადოებას **👋 გააკვირდით შემქმნელს — პირველებმა მიიღეთ ახალი პროვაიდერები, რელიზები და რჩევები:** [![გააკვირდი 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) [![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 [🌍 გლობალური](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 Brasil](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.53+` | | --------------------------------- | :---------------------------: | :---------: | :-------------------: | | 🌐 პროვაიდერები | 352 | **358** | 375 | | 🧠 უნიკალური ჩატ-მოდელის ID-ები | 1320 | **1374** | 1475 | | 🖼️ მოდალობის ხიდი | 🆕 მხედველობა + აუდიო + ვიდეო | ✓ | ✓ | | 📡 Radar-ის უფასო კატალოგი | 🆕 არჩევითი ჩართვა | ✓ | ✓ | | ⚖️ კვოტაზე ორიენტირებული დაგეგმვა | 🆕 Quota-Share | ✓ | ✓ | | 📊 კვოტის ტელემეტრია | 🆕 რეალურ დროში | ✓ | ✓ | | 🧰 Headless რეჟიმი | — | — | 🆕 `serve --headless` | | 🛤️ LTS რელსის ინფრასტრუქტურა | — | — | 🆕 გამოშვების არხები | | 🔎 მოდელების აღმოჩენის API | — | — | 🆕 `/v1/models/query` | **→ [სამოქმედო გეგმა](ROADMAP.md) — რელსით `v3.9.0 LTS`-ისკენ**

## 🧩 ხელმისაწვდომია [![npm ვერსია](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM ყოველთვიურად](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) [![ლიცენზია: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker ჩამოტვირთვები](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron ჩამოტვირთვები](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 დაწყება	🚀 სწრაფი დაწყება	📦 ინსტალაცია	🆓 პროვაიდერის დაკავშირება
💡 გაცნობა	💥 დაპირება	🤔 რატომ OmniRoute	🏆 რა გამოარჩევს
⚙️ ფუნქციები	🎯 კომბინაციები	🌐 პროვაიდერები	🔌 CLI და MCP
	🗜️ შეკუმშვა	🖥️ სად მუშაობს	🔒 კონფიდენციალური
👀 იხილეთ	🎬 მოქმედებაში	✨ სიახლეები	🤖 თავსებადი CLI-ები
💚 მხარდაჭერა	💚 მხარდაჭერა / შემოწირულობა	💬 საზოგადოება	💖 სპონსორები
📦 პროექტი	🛠️ ტექნოლოგიური სტეკი	📖 დოკუმენტაცია	👥 კონტრიბუტორები

🌐 67 ენაზე

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

სამი ნაბიჯი: დააინსტალირეთ და გაუშვით 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…) უკავშირდება ერთ ლოკალურ ენდპოინტს (http://localhost:20128/v1); OmniRoute Smart Router-ს (RTK + Caveman შეკუმშვა, 20 მარშრუტიზაციის სტრატეგია, circuit breakers, TLS stealth, MCP, A2A, guardrails) შეუძლია fallback-ი 4 პროვაიდერის დონეზე, სანამ შესაბამისი ჯანსაღი მიზანი რჩება — დონე 1 გამოწერა, დონე 2 API გასაღები, დონე 3 იაფი და დონე 4 უფასო.

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

> **გსურთ შეუერთდეთ როგორც ღია კოდის მეგობარი?** ეს არის კომპანიები, რომლებიც მხარს უჭერენ ღია კოდს და ეხმარებიან 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.53**-დან. სრული ისტორია — [`CHANGELOG.md`](CHANGELOG.md)-ში. - **⚖️ `quota-weighted` მარშრუტიზაცია** — მე-20 კომბო-სტრატეგია გამოტოვებს ამოწურულ ანგარიშებს, შემდეგ ირჩევს დარჩენილებს შორის დარჩენილი კვოტისა და მიმდინარე (in-flight) დატვირთვის თანაფარდობით, არსებული საუბრების მიმაგრებულად შენარჩუნებით. → [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-მდე ვალიდირებული მორგებული დამალვის შაბლონი და აღმოჩენის მთვლელები ტიპების მიხედვით; თავად დამალვა რჩება არჩევითად (opt-in). → [Guardrails](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 მოძრავი იჯარებით (rolling leases) თითო კავშირზე. → [გამძლეობის გზამკვლევი](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 მარშრუტიზაცია** — გაზიარებული ანგარიშის კვოტის სამართლიანი დაყოფა გაერთიანებულ გასაღებებზე, მუშაობის შენარჩუნებით (work-conserving), რათა უსაქმური წილები სხვებს გადაეცეს. → [გამძლეობის გზამკვლევი](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, თითო-ნაბიჯის სიზუსტის კარი (fidelity gate), GCF v3.2, გადაადგილებით დალაგების რედაქტორი. → [შეკუმშვა](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ გამჭვირვალე MITM დეშიფრაცია (TPROXY)** — დაიჭირეთ CLI-ები, რომლებიც უგულებელყოფენ პროქსის გარემოს ცვლადებს, თითო-SNI CA + trust-store ინსტალერით. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 ღირებულების ტელემეტრია ყველგან** — `X-OmniRoute-*` ღირებულების/მოხმარების თავსართები ყველა ბოლო-წერტილზე, cache-HIT დაზოგვის თავსართი, USD დანახარჯების კვოტები თითო გასაღებზე. → [API მითითება](docs/reference/API_REFERENCE.md) - **🧠 მეხსიერება, რომელსაც თქვენ მართავთ** — ნაგულისხმევად გამორთული, opt-in int8 ვექტორული კვანტიზაცია + ტიპიზებული დაცხრება (typed decay), თითო-მოთხოვნის `x-omniroute-no-memory`. → [მეხსიერება](docs/frameworks/MEMORY.md) - **🛡️ უსაფრთხოება** — პრომპტ-ინექციის დამცავი ყველა LLM მარშრუტზე (red-team ნაკრები), opt-in რწმუნებათა სიგნალების დამალვის გზამკვლევი (მალავს გაჟონილ API-გასაღებებს/საიდუმლოებებს ორივე მიმართულებით), უფასო DuckDuckGo ბოლო საშუალების ვებ-ძიება და არჩევითი OIDC შესვლის კარი დაშბორდისთვის (პაროლით შესვლა ყოველთვის ხელმისაწვდომი რჩება). → [Guardrails](docs/security/GUARDRAILS.md) - **🖼️ ახალი ბოლო-წერტილები** — `/v1/ocr` (Mistral OCR) და `/v1/audio/translations` (Whisper-სტილის) ავსებს მედია-ზედაპირს. → [API მითითება](docs/reference/API_REFERENCE.md) - **🎨 გამოსახულების / ვიდეოს / აუდიოს გენერაცია** — ერთი API მედიისთვის: xAI Grok Imagine და Novita AI ვიდეო, ComfyUI, Magnific, Adobe Firefly, Segmind და მეტყველების პროვაიდერები, როგორიცაა ElevenLabs. → [API მითითება](docs/reference/API_REFERENCE.md) - **🌍 განლაგება და ოპერაციები** — 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… და განახლებული **375-პროვაიდერის კატალოგი**. → [პროვაიდერები](docs/reference/PROVIDER_REFERENCE.md) - **📡 მარშრუტიზაციის გამჭვირვალობა** — ყველა პასუხი ატარებს `X-OmniRoute-Decision` თავსართს, რომელიც ასახელებს მომსახურე სტრატეგიას/პროვაიდერს/ლატენტობას, ახალი `cache-optimized` კომბო-სტრატეგია + Auto-Combo `cacheAffinity` ფაქტორი განმეორებით მოთხოვნებს ქეშირებული პრეფიქსის მქონე კავშირზე აბრუნებს, ხოლო მხოლოდ-წაკითხვის `/v1/auto-combo/{channel}/candidates` ბოლო-წერტილი აჩვენებს `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-სთან თავსებადი ნებისმიერი ინსტრუმენტი

_{📖 თითოეული ხელსაწყოს დაყენება 37-ვე ხელსაწყოსთვის (27 CLI Code + 10 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 დროებით იზოლირებულ home-ს იღებს: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # ან ინტერაქტიულად აირჩიეთ პროვაიდერი+მოდელი და ჩაწერეთ ხელსაწყოს საკუთარი კონფიგურაცია: omniroute configure codex # ასევე: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` ყველა ბრძანება ითვალისწინებს აქტიურ დისტანციურ კონტექსტს (`omniroute connect `), `--dry-run` შესრულების გარეშე წინასწარ აჩვენებს ზუსტ გარემოს ცვლადებს/არგუმენტებს, ხოლო `--api-key-env NAME` საიდუმლო მონაცემებს თქვენი shell-ის ისტორიაში მოხვედრისგან იცავს. → [CLI ინტეგრაციები](docs/guides/CLI-INTEGRATIONS.md)

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

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

### 🏢 ყველა წამყვანი ლაბორატორია — ერთი ენდპოინტის მეშვეობით

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

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

OpenCode Zen _{DeepSeek V4, Nemotron 3 ტოკენების ლიმიტის გარეშე}	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 ნეირონი/დღეში}	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)

## 🖥️ სად მუშაობს OmniRoute — ყველგან

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

პლატფორმა	ინსტალაცია	უპირატესობები
📦 npm (გლობალური)	`npm install -g omniroute`	ერთი ბრძანება, ნებისმიერი OS
🐳 Docker	`docker run … diegosouzapw/omniroute`	მრავალარქიტექტურული AMD64 + ARM64
🖥️ დესკტოპი (Electron)	`npm run electron:build`	ნატიური ფანჯარა + სისტემური არე — Windows / macOS / Linux
🎩 მენიუს ზოლი (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	სერვერის ზედამხედველობა და ავტომატური განახლება — macOS
💪 ARM	ნატიური `arm64`	Raspberry Pi, ARM სერვერები, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	მუშაობს თქვენს ტელეფონზე, 24/7, root-ის გარეშე
📲 PWA	"მთავარ ეკრანზე დამატება"	სრულეკრანიანი, ოფლაინ რეჟიმით, ბრაუზერიდან ინსტალირებადი
🧩 OpenCode პლაგინი	`@omniroute/opencode-provider`	ნატიური OpenCode ინტეგრაცია
🤖 VS Code Copilot Chat	დააინსტალირეთ OmniCopilot გაფართოება	OmniRoute-ის ყველა მოდელი Copilot Chat-ის ნატიურ ამომრჩევში — სტაბილური და Insiders
🛠️ საწყისი კოდიდან	`npm install && npm run 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 Code-ის ნატიურ Copilot Chat-ში

> არც ახალი გვერდითი პანელი, არც ახალი ჩატის ინტერფეისი — OmniRoute-ის მიერ მოწოდებული ყველა მოდელი პირდაპირ > **Copilot Chat-ის იმ მოდელების ამომრჩევში გამოჩნდება, რომელსაც უკვე იყენებთ**. VS Code 1.122-დან მოყოლებული, პროვაიდერის მოდელები მუშაობს > GitHub-ში შესვლისა და Copilot-ის გამოწერის გარეშე — აგენტის რეჟიმი, ხელსაწყოების გამოძახება და ხედვა, > უფასოდ. დააინსტალირეთ **[OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** გაფართოება, მიუთითეთ თქვენი OmniRoute სერვერი (ნაგულისხმევად `localhost:20128`), შემდეგ გახსენით Copilot Chat → მოდელების ამომრჩევი → **მოდელების მართვა…** → **OmniRoute**.

მაღაზია	ბმული	თავსებადია
🧩 VS Code Marketplace	ინსტალაცია →	VS Code — სტაბილური და Insiders
🔓 Open VSX Registry	ინსტალაცია →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

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

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

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

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

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

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

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

_{📖 [ავტორიზაცია](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% — ავტომატურად

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

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

ნაგულისხმევი დაწყვილებული კომბო იყენებს `RTK → Caveman`-ს. როდესაც ორივე მოქმედებს ერთსა და იმავე ინსტრუმენტის/კონტექსტის მონაცემებზე, დაზოგვა ერთდება: ```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 და სტრუქტურირებული მონაცემები შენარჩუნების ძრავის მიერ **ყოველთვის დაცულია**. > **რატომ ვხარჯოთ ბევრი ტოკენი, როცა ცოტაც კმარა?** ყოველი მოთხოვნა OmniRoute-ის შეკუმშვის პაიპლაინს **გამჭვირვალედ** გადის — კლიენტში ცვლილებების გარეშე. ეს ახლა **12 კომპონირებადი ძრავის სტეკია**, რომელიც მიმდევრობით მუშაობს და თითოეული მარშრუტიზაციის კომბოსთვის ირჩევა და ირევა — იდეებით [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) და [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR) პროექტებიდან. ### 🧱 12 ძრავის სტეკი ძრავები პაიპლაინის მიმდევრობით მუშაობს; თითოეული დამოუკიდებლად ჩაირთვება/გამოირთვება და კონფიგურირდება კომბოზე:

#	ძრავი	რას აკეთებს
1	Session-Dedup	შლის ბრუნებში განმეორებულ შინაარსს (შინაარსით მისამართებული, ბრუნებთაშორისი)
2	CCR	არქივავს დიდ ბლოკებს აღდგენის მარკერების უკან; მოთხოვნისას მოიპოვება
3	Lite	ცარიელი სივრცეებისა და სურათის URL-ების მოჭრა (დაბალი დაგვიანების საბაზო რეჟიმი)
4	RTK	ინსტრუმენტის შედეგების ჭკვიანური ფილტრაცია, დედუპლიკაცია და მოჭრა (ბრძანების კონტექსტით)
5	Responses Tool Output	უდანაკარგო-პირველადი JSON + შეზღუდული დიაგნოსტიკური შეკუმშვა shell/patch/search/build გამოტანებისთვის (Responses API)
6	Headroom	JSON მასივების უდანაკარგო ცხრილური კომპაქტიზაცია (~30%) ჩაშენებული GCF კოდეკით
7	Relevance	ექსტრაქტიული წინადადებების შეფასება ბოლო მომხმარებლის მოთხოვნასთან მიმართებაში
8	Caveman	წესებზე დაფუძნებული პროზის შეკუმშვა (~65–75% გამოტანაზე)
9	Aggressive	შეჯამება + ძველი ბრუნების პროგრესული დაძველება
10	LLMLingua-2	ML სემანტიკური გასხვლა MobileBERT ONNX-ით — კოდისთვის უსაფრთხო, ასინქრონული
11	Ultra	ევრისტიკული ტოკენების გასხვლა სურვილისამებრ პატარა მოდელის (SLM) დონით
12	OmniGlyph	ექსპერიმენტული კონტექსტის სურათად კოდირება გაზომილი Claude Fable 5-ისთვის პირდაპირ Anthropic-ის არხზე; GPT 5.6 ტრანსფორმერები რჩება fail-closed მდგომარეობაში პროვაიდერის დადასტურებების მოლოდინში. ოთხი შეკუმშვის პროფილი (აგრესიული ნაგულისხმევი, დაბალანსებული, კოდირებისთვის უსაფრთხო, გამტარი) (ყველაზე აგრესიული; სურვილისამებრ)

კოდის ბლოკები, URL-ები და სტრუქტურირებული მონაცემები **ყოველთვის ინახება** ბაიტურად უცვლელად. **ერთი დაწკაპუნების პრესეტები** აერთიანებს ძრავებს:

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

**რეალური მაგალითი — სტანდარტული რეჟიმი:** > **მანამდე (69 ტოკენი):** _„თქვენი React კომპონენტის ხელახალი რენდერის მიზეზი სავარაუდოდ ისაა, რომ ყოველ რენდერის ციკლზე ობიექტის ახალ მითითებას ქმნით. როდესაც ინლაინ ობიექტს გადასცემთ prop-ად, React-ის ზედაპირული შედარება ყოველჯერზე მას განსხვავებულ ობიექტად აღიქვამს, რაც ხელახალ რენდერს იწვევს. გირჩევდით, გამოიყენოთ useMemo ობიექტის მემოიზაციისთვის."_ > > **შემდეგ (19 ტოკენი):** _„ობიექტის ახალი მითითება ყოველ რენდერზე. ინლაინ ობიექტის prop = ახალი მითითება = ხელახალი რენდერი. გადაახვიეთ useMemo-ში."_ > > **იგივე პასუხი. 72%-ით ნაკლები ტოკენი. ზუსტობის დაკარგვა ნულის ტოლია.** ✅ **PT-BR მაგალითი — [Troglodita](https://github.com/leninejunior/troglodita) რეჟიმი:** > **მანამ (42 ტოკენი):** _"პრობლემა ისაა, რომ კომპონენტი ხელახლა რენდერდება, რადგან ყოველ რენდერინგის ციკლში იქმნება ობიექტის ახალი მითითება. გირჩევდი გამოიყენო useMemo."_ > > **შემდეგ (12 ტოკენი):** _"ხელახალი რენდერი: ახალი ref ყოველ ციკლში (inline ობიექტი თავიდან იქმნება). გამოიყენე `useMemo`."_ > > **იგივე პასუხი. ~70%-ით ნაკლები ტოკენი. ტექნიკური სიზუსტე ხელუხლებელი.** ✅
### 🎚️ ძრავებს მიღმა — გამომავალი სტილები, ადაპტიური რეგულატორი და თითო მოთხოვნის კონტროლი ზემოთ მოყვანილი 12 ძრავა ამცირებს იმას, რაც **შედის**. კიდევ სამი ფენა აყალიბებს, **როგორ**, **როდის** და რა **გამოდის**: - **🪄 გამომავალი სტილები** _(გამომავალი ღერძის მართვა)_ — შეაქვს დეტერმინისტული, ქეშთან თავსებადი პასუხის-ფორმირების ინსტრუქციები; კომბინირებადია, თითოეული `lite` / `full` / `ultra` ინტენსივობით. სტილის დამატება რეესტრის ერთი ხაზის ჩანაწერია: - **ლაკონური პროზა** — შემავსებელი / არტიკლები / თავის არიდების ფრაზები იშლება; ტექნიკური არსი ზუსტად რჩება. - **ნაკლები კოდი** — „ზარმაცი გამოცდილი დეველოპერის" YAGNI: ყველაზე პატარა მომუშავე ცვლილება, მოუთხოვნელი სქაფოლდინგის გარეშე. - **Ponytail (ზარმაცი გამოცდილი დეველოპერი)** — ადი YAGNI-ის კიბით ზემოთ, გაასწორე ძირეული მიზეზი, ყველაზე პატარა მომუშავე diff. - **მე მაქვს ADHD (ჯერ მოქმედება)** — პირველ რიგშია შემდეგი მოქმედება, ნაბიჯები დანომრილია, ერთი კონკრეტული შემდეგი ნაბიჯი, შესავლის გარეშე. - **ლაკონური CJK (文言)** — კლასიკური ჩინური ულტრა-ლაკონური სტილი (ლოკალურად შეზღუდული `zh`-ით). - **🎯 ადაპტიური კონტექსტის ბიუჯეტი** _(რეგულატორი)_ — ერთი ჩართული/გამორთული ტოკენის ზღვარის ნაცვლად, ესკალაცია ხდება ყველაზე იაფი, ყველაზე უნაკლო ძრავებით მხოლოდ იმდენად, რამდენადაც საჭიროა **მოდელის კონტექსტის ფანჯარაში მოთავსებისთვის**. პოლიტიკა: `reserve-output` (ნაგულისხმევი, მოდელზე მორგებული) · `percentage` · `absolute`. რეჟიმი: `floor` (მოთავსების გარანტია) · `replace-autotrigger` (შენი ექსპლიციტური არჩევანი იგებს) · `off` (მემკვიდრეობითი ზღვარი). - **🎛️ სად იღება შეკუმშვის გადაწყვეტილება** _(პრიორიტეტი, მაღალი → დაბალი)_ — თითო მოთხოვნის `x-omniroute-compression` ჰედერი › routing-combo-ს გადაფარვა › აქტიური დასახელებული პროფილი › ადაპტიური / ავტო-ტრიგერი › პანელის ნაგულისხმევი › გამორთული. გამოყენებული გეგმა ბრუნდება `X-OmniRoute-Compression: ; source=` პასუხის ჰედერში. ჩართე ავტო-ტრიგერი ტოკენის ზღვარით, მოაბრუნე ადაპტიური რეგულატორი, მიმაგრე დასახელებული პროფილი, დააყენე ერთჯერადი მნიშვნელობა თითო მოთხოვნაზე ან მიანიჭე პაიპლაინი თითო routing combo-ს — რაც შენს სამუშაო დატვირთვას უხდება. ოფციონალური ოფლაინ **eval harness** (`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-მ შეიძლება დაბლოკოს პაკეტის სასიცოცხლო ციკლის სკრიპტები, თუ ისინი ნებადართული არ არის. OmniRoute-ის `postinstall` (`node scripts/build/postinstall.mjs`) აუცილებელია მისი ნატივური runtime ფაილების მოსამზადებლად. გლობალური ინსტალაციისას ნება დართე npm-ის გაფრთხილებაში ნახსენებ პაკეტებს. OmniRoute 3.8.53-ის მიერ მოცემული პაკეტების ნაკრებისთვის: > > ```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 სხვა სიას გვაჩვენებს, გამოიყენე იმ გაფრთხილებიდან პაკეტების სახელები. პაკეტის დაშვება ნიშნავს მისი ინსტალაციის სკრიპტების გაშვების ნებართვას. > **იყენებ Gemini Web-ს ან სხვა ვებ-ქუქის პროვაიდერს?** npm პაკეტი შეიცავს > Playwright-ს, მაგრამ არა მის Chromium ბინარულ ფაილს. იხილე > [Playwright Chromium-ის დაყენების](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > შენიშვნა პირველი ვებ-პროვაიდერის მოთხოვნის გაკეთებამდე. Dashboard: `http://localhost:20128` · API: `http://localhost:20128/v1`. **2) დააკავშირე შესაბამისი პროვაიდერი შენი საკუთარი ანგარიშით** Dashboard → **Providers** → აირჩიე პროვაიდერი, რომლის მიმდინარე პირობები და კვოტა შენს შემთხვევას ერგება → დაამატე მისი API გასაღები ან დაასრულე მისი ანგარიშის პროცესი. უფასო ტარიფებს შეიძლება დასჭირდეს რეგისტრაცია, დამტკიცება ან გადახდის მეთოდი. გადახედე [უფასო ტარიფების გზამკვლევს](docs/getting-started/FREE-TIERS-GUIDE.md); გასაღების გარეშე ხელმისაწვდომობა გარანტირებული არ არის და `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` v2.0-დან)
ფრეიმვორკი	Next.js 16 + React 19 + Tailwind CSS 4
მონაცემთა ბაზა	better-sqlite3 (SQLite, WAL ჟურნალირება) + LowDB (JSON მემკვიდრეობითი) — 147 დომენური მოდული, 209 მიგრაცია
მეხსიერება	SQLite FTS5 სრულტექსტური ძიება + int8-კვანტიზებული ვექტორული ემბედინგები, ტიპიზებული დაქვეითება
სქემები	Zod 4 — 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-დონიანი პროქსი
მდგრადობა	Circuit breaker, ექსპონენციური შეყოვნება, anti-thundering-herd, ავტოკომბინირებული თვითაღდგენა
ლოგირება	pino — სტრუქტურირებული JSON ლოგები მოთხოვნის კონტექსტით
ტესტირება	Node.js test runner + Vitest — 56,000+ სტატიკური ტესტის დეკლარაცია 7,800+ თვალყურადევნებულ ტესტ-ფაილში (ერთეულობითი, ინტეგრაციული, E2E, უსაფრთხოების, ეკოსისტემის)
პლატფორმები	Desktop (Electron) · Android (Termux) · PWA (ნებისმიერი ბრაუზერი)
CI/CD	GitHub Actions — ავტომატური npm-გამოქვეყნება + Docker Hub რელიზისას
ბმულები	ვებსაიტი · npm · Docker Hub

## 📖 დოკუმენტაცია

### 📘 დასაწყისი

დოკუმენტი	აღწერა
მომხმარებლის სახელმძღვანელო	პროვაიდერები, კომბოები, CLI ინტეგრაცია, განლაგება
ინსტალაციის სახელმძღვანელო	ინსტალაციის ყველა მეთოდი, CLI ინსტრუმენტების კონფიგურაციები, პროტოკოლის მორგება, timeout-ების რეგულირება
CLI ინსტრუმენტების სახელმძღვანელო	თითოეული ინსტრუმენტის მორგება: Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
დისტანციური რეჟიმი	მართეთ დისტანციური OmniRoute (VPS) თქვენი ლეპტოპის CLI-დან შეზღუდული უფლებების მქონე ტოკენებით
Claude Code-ის კონფიგურაცია	მიმართეთ Claude Code OmniRoute-ს (ლოკალური/დისტანციური) `launch`-ით და თითოეული მოდელის პროფილებით
სწრაფი დაწყება	3 ნაბიჯი: ინსტალაცია → დაკავშირება → კონფიგურაცია

### 🔧 ოპერაციები და განლაგება

დოკუმენტი	აღწერა
Docker-ის სახელმძღვანელო	Docker run, 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, stacked პაიპლაინები, dashboard/API/MCP ზედაპირები
შეკუმშვის წესების ფორმატი	JSON წესების პაკეტების სქემები Caveman-ისა და RTK ფილტრებისთვის
შეკუმშვის ენობრივი პაკეტები	ენის განსაზღვრა და Caveman-ის წესების პაკეტების შედგენა
მდგრადობის სახელმძღვანელო	Circuit breaker-ები, cooldown-ები, რიგი, thundering herd-ის პრევენცია, TLS spoofing
Auto-Combo ძრავა	16-ფაქტორიანი შეფასება, რეჟიმის პაკეტები, თვითაღდგენა
პროქსის სახელმძღვანელო	3-დონიანი პროქსის სისტემა, 1proxy მარკეტპლეისი, რეესტრის CRUD
უფასო დონეები	კონსოლიდირებული კატალოგი: 34 დოკუმენტირებული რეგულარული პული / 467 კატალოგში შეტანილი უფასო ჩანაწერი
ფუნქციების გალერეა	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
რელიზის სამოწმებელი სია	რელიზამდე ვალიდაციის ნაბიჯები
დაფარვის გეგმა	ტესტების დაფარვის სტრატეგია 56,000+ სტატიკური ტესტის დეკლარაციისთვის 7,800+ თვალყურადდევნებად ტესტის ფაილში

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

ადგილი	კონტრიბუტორი	გაერთიანებული PR-ები	~შეცვლილი ხაზები
1	maxmad64bis	371	25,326,561
2	HouMinXi	269	13,456,272
3	backryun	210	270,562
4	oyi77	190	411,243
5	pacocartones	174	78,276
6	JxnLexn	151	3,562,936
6	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	84	2,849,554
12	jonlwheat2-gif	67	68,548
13	artickc	62	43,502
14	chirag127	52	6,661
15	xz-dev	50	245,976
16	xiaoyaner0201	47	33,626
17	woodsonl	46	809,391
18	rqzbeh	44	147,896
19	QuangBlue	43	13,112
20	MumuTW	40	26,093

_{აღწერა ჩატარდა 2026-10-18 15:09:09 UTC-ზე მოქმედი release/v3.8.52 tip-ით 656f01cb43. გვერდებად დაყოფილი GitHub GraphQL აღწერა შეიცავს 9,191 გაერთიანებულ PR-ს: 3,834 რეპოზიტორიის მფლობელისგან, 229 Dependabot-ისგან, 6 სხვა ბოტების/აპლიკაციებისგან და 5,122 გარე PR 835 განსხვავებული კონტრიბუტორისგან. „შეცვლილი ხაზები“ არის GitHub-ის დამატებული + წაშლილი ხაზები და მოიცავს გენერირებულ ფაილებს, lockfile-ებს, კატალოგებს, თარგმანებსა და დოკუმენტაციას; ეს ცვლილებების მოცულობაა და არა ავტორის მიერ დაწერილი LOC. 49 PR ასახავს GitHub diff-ებს 500,000 ხაზზე მეტით (მაგალითად #13399, ერთი პროვაიდერის დამატება, 2,347 შეცვლილ ფაილს შეიცავს), რაც ზემოთ მოყვანილ რამდენიმე ჯამურ მაჩვენებელს ზრდის. გათანაბრებული შედეგები რეიტინგში ერთად ჯდება.} ### GitHub-ის მიერ მიკუთვნებული კომიტები

Dizzle _{🥇 367 GitHub-ით მინიჭებული კომიტი}	Bob.Hou _{🥈 269 GitHub-ით მინიჭებული კომიტი}	Paijo _{🥉 229 GitHub-ით მინიჭებული კომიტი}	backryun _{🏅 202 GitHub-ით მინიჭებული კომიტი}	Paco Cartones _{🏅 174 GitHub-ით მინიჭებული კომიტი}	Ravi Tharuma _{🏅 126 GitHub-ით მინიჭებული კომიტი}
Markus Hartung _{🏅 114 GitHub-ით მინიჭებული კომიტი}	Randi _{🏅 108 GitHub-ით მინიჭებული კომიტი}	Jan Leon _{🏅 87 GitHub-ით მინიჭებული კომიტი}	Chris _{🏅 70 GitHub-ით მინიჭებული კომიტი}	Koosha Paridehpour _{🏅 68 GitHub-ით მინიჭებული კომიტი}

_{ხელახლა შემოწმებულია 2026-10-18 14:44:45 UTC-ზე: GitHub-ით მინიჭებული კომიტები, რომლებსაც რეპოზიტორიის Contributors API აწვდის release/v3.8.52 ნაგულისხმევი ბრენჩისთვის. API-მ დააბრუნა 849 იდენტობა (429 მომხმარებელი, 2 ბოტი, 418 ანონიმური); ეს ცხრილი გამორიცხავს მეინტეინერს, ბოტებსა და ანონიმურ იდენტობებს და ინარჩუნებს თანაბარ ადგილებს. ის განსხვავდება როგორც ზემოთ მოყვანილი შერწყმული 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-ს უფასოსა და დამოუკიდებელს უნარჩუნებს.

## 👥 900+ კონტრიბუტორი

[![კონტრიბუტორები](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=993&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{აუდიტი ჩატარდა 2026-10-18-ს, მოქმედი release/v3.8.52 ვერსიის ბოლო ad160ab2d1 კომიტზე (6,826 კომიტი): 993 ნორმალიზებული, ადამიანის კუთვნილი Git-იდენტობა — 707 წარმოდგენილია კომიტის ავტორად (მათ შორის, პროექტის შემნახველი), ხოლო 286 — მხოლოდ აშკარა Co-authored-by ჩანაწერებში. აღწერისას გამოიყენება .mailmap, ელფოსტის მისამართები შედარებულია რეგისტრის გაუთვალისწინებლად, GitHub-ის რიცხვითი და ჩვეულებრივი noreply მისამართები ერთიანდება მხოლოდ მაშინ, როდესაც ისინი იმავე მომხმარებლის სახელს შეიცავს, გამორიცხულია ბოტის/აგენტის/სერვისის/ადგილმჭერის 26 იდენტობა და ჩვეულებრივი ელფოსტის მისამართები არ ერთიანდება მხოლოდ იმიტომ, რომ მათი საჩვენებელი სახელები ემთხვევა. 2026-08-24-ის აუდიტში გამოქვეყნებული იყო 639; ამ მეთოდის ხელახლა გამოყენება იმ აუდიტის საბაზისო ac02c5b42f კომიტზე იძლევა 619-ს, ამიტომ ზრდა ახალი კონტრიბუტორების დამსახურებაა და არა ნაკლებად მკაცრი მეთოდის.} ### როგორ შეიტანოთ წვლილი 1. შექმენით რეპოზიტორიის ფორკი 2. შექმენით განშტოება **აქტიური** `release/vX.Y.Z` განშტოების ბოლო მდგომარეობიდან (არა `main`-იდან) — იხილეთ [განშტოებებისა და გამოშვების მოდელი](docs/ops/BRANCHING_MODEL.md) 3. შექმენით თქვენი ფუნქციონალის განშტოება (`git checkout -b feat/amazing-feature`) 4. დააკომიტეთ თქვენი ცვლილებები (`git commit -m 'feat: add amazing feature'`) 5. ატვირთეთ ცვლილებები განშტოებაში (`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 გიგანტების მხრებზე დგას. ის დაიწყო, როგორც **[9router](https://github.com/decolua/9router)**-ის ფორკი და Go პროექტის, **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**-ის, TypeScript-ზე პორტი — შემდგომ კი ქვემოთ ჩამოთვლილი თითოეული ქვესისტემა შთაგონებული იყო ღია კოდის პროექტით, რომელმაც ეს მანამდე გააკეთა. თითოეულმა მათგანმა OmniRoute-ის კონკრეტული ნაწილი ჩამოაყალიბა. ამით ყველა მათგანს მადლობას ვუხდით. 🙏 > ⭐ ვარსკვლავების რაოდენობა გადამოწმებულია GitHub-ის REST API-ის მეშვეობით 2026 წლის 18 ოქტომბერს — დაუჭირეთ მხარი ამ პროექტებს ვარსკვლავით. რაოდენობები კონკრეტული თარიღისთვის დაფიქსირებული ზუსტი მონაცემებია და, ბუნებრივია, შეიცვლება. ### 🧬 წარმომავლობა და კარიბჭე

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
9router	31,004	საწყისი პროექტი, რომელზეც ეს ფორკია აგებული — აქ გაფართოებულია მრავალმოდალური API-ებით და სრულად გადაწერილია TypeScript-ზე.
CLIProxyAPI	55,591	Go-ზე შექმნილი იმპლემენტაცია, რომელმაც JavaScript / TypeScript-ზე ამ პორტის შექმნა შთააგონა.
LiteLLM	61,482	AI-კარიბჭე, რომლის საჯარო ფასების მონაცემთა ნაკრები ჩვენი ხარჯების აღრიცხვის სინქრონიზაციას ამარაგებს, ხოლო პროვაიდერების ნორმალიზაციის მოდელმა ჩვენი მარშრუტიზაცია განსაზღვრა.
codex-chatgpt-web	14,526	MIT-ლიცენზირებული საწყისი კოდი, რომელიც ადაპტირდა ჩაშენებულ ChatGPT Web → Codex Responses ხიდში, მათ შორის ბრაუზერის სესიის, პასუხის ჩარჩოების ფორმირების, გამოყენების აღრიცხვისა და ვებძიების ადაპტერები.
free-claude-code	61,430	ნიმუშები, რომლებიც პორტირდა ნაკადის აღდგენაში, აზროვნების გარეშე მოქმედ ფსევდონიმებში, სარეზერვო ვებძიებაში, მცოცავი ფანჯრის ლიმიტებში, ჟურნალების მონაცემთა დაფარვასა და გაძლიერებულ გამშვებ პროცესებში.
composer-api	346	Cursor Composer-ის ხელსაწყოს არჩევის, გამომავალი მონაცემების შეზღუდვისა და ხელსაწყოს დაფიქსირების ნიმუშები, რომლებიც ადაპტირდა Cursor-ის ნატიურ შემსრულებელში.
codex-multi-auth	553	ახალი შესვლისა და განახლების ტოკენის როტაციის ნიმუშები, რომლებიც პორტირდა Codex OAuth-ის ხელახალ ავთენტიფიკაციაში.
opencode-anthropic-auth	558	Claude Code-თან თავსებადი გარდაქმნის ნაგულისხმევი პარამეტრები და ბილინგის სათაურების ქცევა, რომლებიც განზოგადდა OmniRoute-ის კონფიგურაციით მართვად ხიდში.
grok2api-merged	2	მისი Grok მოდელების შესაბამისობები, ყალბი TypeError-ის Statsig-გენერატორი, მოთხოვნისა და მოწყობილობის ნაგულისხმევი პარამეტრები და NDJSON პასუხების დამმუშავებელი მნიშვნელოვნად ადაპტირდა OmniRoute-ის Grok Web შემსრულებელში.
TQZHR/grok2api	706	grok2api-merged-ის უკან მდგომი მთავარი ტრანზიტული კოდის წყარო; მისი მოდელის, სათაურის, დატვირთვის, Statsig-ისა და დამმუშავებლის იმპლემენტაციები შენარჩუნებულია Grok Web-ის წარმომავლობაში.
chenyme/grok2api	7,819	MIT-ლიცენზირებული საბაზისო წყარო Grok-ის დატვირთვისა და მოწყობილობის ნაგულისხმევი პარამეტრებისთვის, Statsig-გენერატორისა და `result.response` დამმუშავებლისთვის, რომლებიც TQZHR-ისა და grok2api-merged-ის გავლით გადმოვიდა.
grok2api-pro	27	grok2api-merged-ის მიერ მისი პროქსი-პულის შრის წყაროდ მითითებული ტრანზიტული წყარო; OmniRoute ინარჩუნებს წარმომავლობის ამ მითითებას, თუმცა თავის შეზღუდული შესაძლებლობების Grok Web შემსრულებელში პროქსი-პულის პორტზე პრეტენზიას არ აცხადებს.
GrokProxy	51	მისმა ქუქით ავთენტიფიცირებულმა Grok პროქსიმ და `result.response.token` ნაკადური გადაცემის ნიმუშმა OmniRoute-ის Grok Web ტრანსპორტის შექმნაზე მოახდინა გავლენა.
GrokBridge	5	Grok Web-ის საწყისი იმპლემენტაციის შექმნისას გათვალისწინებული იყო მისი HTTP/ბრაუზერის ზედა დონის სერვისის დიზაინი; მისი პირდაპირი HTTP გზა GrokProxy-დან მომდინარეობს, ამიტომ დამოუკიდებელი კოდის პორტზე პრეტენზია არ არის გაცხადებული.

### 🗜️ კონტექსტისა და ტოკენების შეკუმშვა — ძრავები

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
Caveman	113,396	ვირუსული პროექტი „რატომ გამოიყენო ბევრი ტოკენი, როცა ცოტაც აკეთებს საქმეს“ — მისი გამოქვაბულის კაცის მეტყველების ფილოსოფია საფუძვლად უდევს ჩვენს სტანდარტულ შეკუმშვის რეჟიმსა და შემავსებელი სიტყვების მოცილების/კონდენსაციის 30-ზე მეტ წესს.
RTK – Rust Token Killer	83,835	ბრძანებების გამოტანილი მონაცემების მაღალწარმადობრივი შეკუმშვა — შთააგონა ჩვენი RTK ძრავა, JSON ფილტრების DSL, დაუმუშავებელი გამოტანილი მონაცემების აღდგენა და კასკადური RTK → Caveman კონვეიერი.
headroom	75,741	კონტექსტის შექცევადი შეკუმშვა (SmartCrusher) — შთააგონა ჩვენი `headroom` ძრავა და `ccr` აღდგენის მარკერის შაბლონი.
LLMLingua	6,757	პრომპტების შეკუმშვის კვლევა (LLMLingua / LLMLingua-2) — შთააგონა ჩვენი ასინქრონული, კოდისთვის უსაფრთხო და შეცდომისას საწყის მონაცემებზე დაბრუნებადი `llmlingua` ძრავა.
llmlingua-2-js	32	JS/ONNX პორტი (MobileBERT / XLM-RoBERTa), რომელიც ჩვენი LLMLingua ძრავის მუშა ნაკადის ბექენდად გამოიყენება.
Troglodita	50	pt-BR ტოკენების შეკუმშვა — უზრუნველყოფს ჩვენს pt-BR ენობრივ პაკეტს: ბრაზილიურ-პორტუგალიურ გრამატიკაზე მორგებულ პლეონაზმების შემცირებასა და შემავსებელი სიტყვების მოცილებას.
ponytail	166,731	ვირუსული „ზარმაცი უფროსი დეველოპერის“ YAGNI-კოდერის უნარი — შთააგონა ჩვენი less-code გამოტანის სტილი: უმცირეს მუშა ცვლილებაზე ორიენტირება, რომელიც ამცირებს _გენერირებულ_ კოდს (Caveman-ის ლაკონიური პროზის ანალოგი გამოტანის ღერძზე).
i-have-adhd	57,628	მისი მოქმედებაზე ორიენტირებული, ADHD-ის მქონე ადამიანებისთვის მოსახერხებელი პასუხის სტილი ადაპტირდა OmniRoute-ის ლაკონიურ გამოტანის სტილად ხუთ ენაზე.

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

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
TOON	25,509	ტოკენებზე ორიენტირებული ობიექტების ნოტაცია — მისმა სვეტოვანმა, სათაურისა და სტრიქონების მოდელმა ჩამოაყალიბა ჩვენი ცხრილური კომპაქტირების ეტაპი.
GCF – Graph Compact Format	59	მისმა კომპაქტურმა გრაფის ფორმატმა და ზოგადი პროფილის დიზაინმა გავლენა მოახდინა OmniRoute-ის ცხრილურ კომპაქტირებასა და Headroom კოდეკის ფორმატზე.
gcf-typescript	4	MIT TypeScript იმპლემენტაცია, რომელიც უშუალოდ ჩავაშენეთ და გავაფართოეთ, როგორც Headroom-ის ზოგადი პროფილის კოდეკი.
token-optimizer-mcp	551	Brotli/SQLite ქეში + თითოეული სესიის კონტექსტის დელტა — შთააგონა ჩვენი `session-dedup` ძრავა.
token-savior	1,182	Bash-ის გამოტანილი მონაცემების კომპაქტირება + MCP პროფილები — შთააგონა შეკუმშვის შეწყვეტის ჩვენი დისციპლინა და MCP ხელსაწყოების მანიფესტის შემცირება.
token-saver	154	შიგთავსის გათვალისწინებით, ფაილის თითოეული ტიპისთვის გამოტანილი მონაცემების შეკუმშვა და წარუმატებლობის გათვალისწინებით პროცესის შეწყვეტა — დაადასტურა ჩვენი ტიპების მიხედვით გადანაწილება და მინიმალური მოგებისას გამოტოვება.
token-optimizer	2,595	„იპოვე მოჩვენებითი ტოკენები“ — მისმა გატანისა და აღდგენადი მაჩვენებლის შაბლონმა გავლენა მოახდინა CCR-ის გატანის ჩვენს მიდგომაზე.
TokenMizer	33	სესიის გრაფისა და სხვადასხვა ბიჯს შორის სტრიქონების დუბლიკატების მოცილების გეგმა, რომელმაც გავლენა მოახდინა ჩვენს session-dedup დიზაინზე.
OmniCompress	3	Rust-ის სვეტოვანი JSON + შიგთავსის მისამართით აღდგენა + შეტყობინებებს შორის დუბლიკატების მოცილება — დაადასტურა ჩვენი `headroom`/`ccr`/`session-dedup` ძრავების დიზაინი და ქეშისადმი სტაბილური ინვარიანტი „შეკუმშული ფორმა პოზიციისგან დამოუკიდებელია“.
mcp-compressor	133	MCP ხელსაწყოების სქემების/აღწერების შეკუმშვა — გავლენა მოახდინა MCP ხელსაწყოების მანიფესტის კარდინალურობის შემცირებაზე.
RepoMapper	217	Aider-ის სტილის რეპოზიტორიის რუკის რანჟირება — გავლენა მოახდინა რეპოზიტორიის რუკის / მოძიების რანჟირების ჩვენს კვლევაზე.
quiet-shell-mcp	4	Shell-ის გამოტანილი მონაცემების დეკლარაციული შემცირება MCP-ის მეშვეობით — დაადასტურა Bash-ის გამოტანილი მონაცემების ჩვენი დეკლარაციული კომპაქტირება.
ts-morph	6,205	TypeScript Compiler API-ის ხელსაწყოთა ნაკრები — შთააგონა პარსერზე დაფუძნებული კომენტარების მოცილება, რომელიც ინარჩუნებს სტრიქონულ, შაბლონურ და რეგულარული გამოსახულებების ლიტერალებს.

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

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
Mem0	67,385	უნივერსალური მეხსიერების შრე — მისმა პროქსიზე, როგორც ჩაწერა/წაკითხვის საზღვარზე დაფუძნებულმა მოდელმა, ჩვენი მეხსიერების არქიტექტურა ჩამოაყალიბა.
Letta (MemGPT)	25,179	მდგომარეობის მქონე აგენტები დონეებად დაყოფილი მეხსიერებით — ჩვენი დონეებად დაყოფილი Context Control & Recovery (CCR) მოდელის შთაგონების წყარო.
WFGY	1,800	ProblemMap-ის ტაქსონომია, რომელიც RAG/LLM-ის 16 განმეორებად შეფერხების რეჟიმს მოიცავს — საერთო ტერმინოლოგია ჩვენს პრობლემების აღმოფხვრის სახელმძღვანელოში.

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

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

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

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
models.dev	7,286	AI-მოდელების სპეციფიკაციების, ფასებისა და შესაძლებლობების ღია მონაცემთა ბაზა — ბუნებრივად სინქრონიზებულია ჩვენი მოდელების კატალოგთან.
React Flow / xyflow	38,705	კვანძებზე დაფუძნებული გრაფების ბიბლიოთეკა, რომელიც საფუძვლად უდევს ჩვენს რეალურ დროში მომუშავე Compression Studio-სა და Combo/Routing Studio-ს.
LangGraph	43,443	LangGraph Studio-ს სამუშაო პროცესის გრაფის ცოცხალმა ვიზუალიზაციამ შთააგონა ჩვენი Studio-ების რეალურ დროში კასკადური ხედი.
Langfuse	35,990	მისმა დაკვირვებადობის მოდელმა „ტრასა → შუალედი → გენერაცია“ ჩვენი Compression Studio-ს ჩანჩქერული წარმოდგენა ჩამოაყალიბა.
Kiali	3,645	Istio-ს სერვისების ბადის დაკვირვებადობა — შთააგონა ჩვენი ავტომატური ამომრთველის ნიშნები და შეცდომის წიბოების ვიზუალიზაცია Routing/Combo Studio-ში.
lobe-icons	2,615	AI/LLM ბრენდების ლოგოები, რომლებიც ჩვენი მართვის პანელის მასშტაბით პროვაიდერების ხატულებს ასახავს.
flag-icons	12,473	უზრუნველყოფს MIT-ლიცენზირებულ SVG დროშებს, რომლებსაც README-ის ენის ამომრჩევი იყენებს.

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

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

### 🧭 დამატებითი ინსტრუმენტები

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

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

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