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

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

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

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

> `/dashboard/free-tiers` გვერდის მიმდინარე მონაცემების ანიმაციური შეჯამება. სრული მეთოდოლოგია (პულების დუბლირების გამორიცხვა, კრედიტების დონეები, პროვაიდერების პირობები): **[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) ### 💬 შემოუერთდით საზოგადოებას **👋 გამოიწერეთ პროექტის ავტორი — პირველებმა შეიტყვეთ ახალი პროვაიდერების, გამოშვებებისა და რჩევების შესახებ:** [![გამოიწერეთ 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 გლობალური](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp ბრაზილია](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![ვებსაიტი](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **კითხვები, რჩევები პროვაიდერების შესახებ, განვითარების გეგმა და მხარდაჭერა → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 გლობალური](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 ბრაზილია](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [პორტალი](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 გეითვეი განაგრძობს ზრდას

| | v3.8.50 | **v3.8.51** | `v3.8.52+` | | ----------------------------------- | :----------------------: | :---------: | :-------------------: | | 🌐 პროვაიდერები | 352 | **358** | 372 | | 🧠 ჩატის მოდელების უნიკალური ID-ები | 1320 | **1374** | 1443 | | 🖼️ მოდალობების ხიდი | 🆕 ხედვა + აუდიო + ვიდეო | ✓ | ✓ | | 📡 Radar-ის უფასო კატალოგი | 🆕 სურვილისამებრ | ✓ | ✓ | | ⚖️ კვოტის გათვალისწინებით დაგეგმვა | 🆕 Quota-Share | ✓ | ✓ | | 📊 კვოტის ტელემეტრია | 🆕 რეალურ დროში | ✓ | ✓ | | 🧰 Headless რეჟიმი | — | — | 🆕 `serve --headless` | | 🛤️ LTS ხაზის ინფრასტრუქტურა | — | — | 🆕 გამოშვების არხები | **→ [სამოქმედო გეგმა](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 გასაღებით, შემდეგ OmniRoute-ის API გასაღებისა და auto მოდელის გამოყენებით თქვენი ხელსაწყო localhost:20128/v1-ზე მიუთითეთ. მარშრუტიზაცია დამოკიდებულია ხელმისაწვდომ შესაბამის კავშირებსა და პროვაიდერის ლიმიტებზე.

```bash # პროვაიდერის დაკავშირების შემდეგ დააკოპირეთ თქვენი OmniRoute გასაღები Dashboard → Endpoints-დან: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto`-ს შესაბამისი მარშრუტი სჭირდება. ახალ ინსტალაციას შესაძლოა არ ჰქონდეს გასაღების გარეშე გამოსაყენებელი შესაბამისი სამიზნეები, ხოლო გასაღების გარეშე მომუშავე პროვაიდერმა შესაძლოა მესამე მხარის კლიენტები უარყოს. `tos: avoid` ნიშნით მონიშნული პროვაიდერები, მათ შორის OpenCode Free და Kiro, ნაგულისხმევად გამორიცხულია ავტომატური მარშრუტიზაციიდან; ანგარიშის დაკავშირება ამ პარამეტრს არ ცვლის. პროვაიდერის არჩევამდე გაეცანით [უფასო ტარიფების სახელმძღვანელოს](docs/getting-started/FREE-TIERS-GUIDE.md).} _{📦 დასაკოპირებლად და ჩასასმელად გამზადებული სწრაფი დაწყების სკრიპტები **Python, Node.js, PHP და cURL**-ისთვის → [`examples/quickstart/`](examples/quickstart/)}

# 💥 დაპირება

# 🤔 რატომ OmniRoute?

OmniRoute-ის მოთხოვნის ნაკადი: თქვენი IDE ან CLI (Claude Code, Cursor, Cline…) ერთ ლოკალურ საბოლოო წერტილს (http://localhost:20128/v1) იძახებს; OmniRoute Smart Router-ს (RTK + Caveman შეკუმშვა, მარშრუტიზაციის 19 სტრატეგია, circuit breaker-ები, TLS stealth, MCP, A2A, დამცავი შეზღუდვები) შეუძლია 4 პროვაიდერის დონეს შორის სარეზერვო გადართვა, სანამ შესაბამისი გამართული სამიზნე ხელმისაწვდომია — დონე 1 Subscription, დონე 2 API Key, დონე 3 Cheap და დონე 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-ის მომხმარებლებს? გახსენით საკითხი და ჩვენ დავამატებთ მას აქ.}

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

19-ვე კომბოს მარშრუტიზაციის სტრატეგია ანიმირებულად — თითო სტრატეგია თითო ფილაზე: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, cache-optimized, lkgp, auto, fusion, pipeline. თითოეულის დანიშნულებისთვის იხილეთ ზემოთ მოცემული ცხრილი.

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

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

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

#	სტრატეგია	რას აკეთებს
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	`reset-window`	უპირატესობა ენიჭება სამიზნეს, რომლის კვოტის ფანჯარაც ყველაზე მალე განულდება
12	`reset-aware`	რანჟირება კვოტის განულების დროის მიხედვით — ჯერ მოკლე ფანჯრები 📊
13	`context-relay`	ხანგრძლივი საუბრებისთვის კონტექსტის სამიზნეებს შორის გადაცემა 🧠
14	`context-optimized`	მიმდინარე კონტექსტის ზომისთვის ყველაზე შესაფერისი ვარიანტის არჩევა
15	`cache-optimized`	თითოეული ხელახლა გამოყენებადი პრომპტის პრეფიქსის ერთსა და იმავე ანგარიშზე მიბმა — პრომპტის კეშის დამთხვევების მაქსიმიზაცია 🎯
16	`lkgp`	ბოლო ცნობილი გამართული გზა — ინარჩუნებს ბოლო წარმატებულ პროვაიდერს, შემდეგ კი სარეზერვო წესებზე გადადის
17	`auto`	16-ფაქტორიანი შეფასება რეალურ დროში ყველა კავშირზე 🤖
18	`fusion`	მოთხოვნის მოდელების პანელზე განაწილება + მსაჯი აერთიანებს შედეგებს ერთ პასუხად 🧬
19	`pipeline`	ნაბიჯების ჯაჭვი — თითოეული სამიზნის გამომავალი მონაცემები შემდეგს მიეწოდება 🔗

_{Auto-Combo ძრავა თითოეულ კანდიდატს **16 ფაქტორის** მიხედვით აფასებს (გამართულობა, კვოტა, ღირებულება, დაყოვნება, ამოცანასთან შესაბამისობა, ხარისხი, სესიის ხელმისაწვდომობა…) — იხილეთ [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md).} ## ### 🧱 მდგრადობა ჩაშენებულია (3 დამოუკიდებელი შრე)

OmniRoute-ის მდგრადობა — თვითაღდგენის 3 დამოუკიდებელი ფენა, შესაბამისი ფენა შესაბამისი შეფერხებისთვის. ფენა 1 — პროვაიდერის circuit breaker (მთლიანი პროვაიდერი): აქტიურდება მხოლოდ 408/5xx-ზე; ზღვრული მნიშვნელობებია OAuth 8× / API-key 12× / local 2×; 60s/30s/15s-ის შემდეგ გადადის HALF-OPEN საცდელ მოთხოვნაზე, აღდგენა ხდება საჭიროებისას; OPEN მდგომარეობაში combo მარშრუტს შემდეგ პროვაიდერზე გადართავს. ფენა 2 — კავშირის cooldown (ერთი გასაღები/ანგარიში): საბაზისო დროა 5s OAuth-ისთვის / 3s API-key-ისთვის; ექსპონენციალური ×2 backoff ერთდროული მოთხოვნების მოზღვავებისგან დაცვის მექანიზმით; 429 ითვალისწინებს Retry-After-ს; წარმატებული მოთხოვნა შეცდომის მთელ მდგომარეობას ასუფთავებს; cooldown-ში მყოფი ერთი გასაღები გამოტოვებულია, ხოლო დანარჩენი გასაღებები მომსახურებას აგრძელებენ. ფენა 3 — მოდელის lockout (ერთი მოდელი): თითოეულ მოდელზე მიღებული 429, ლოკალური 404 ან რეჟიმის აკრძალვები მხოლოდ ამ მოდელს ბლოკავს — და არა მთელ კავშირს. საბოლოო მდგომარეობები (დაბლოკილი, ვადაგასული, კრედიტები ამოწურულია) ოპერატორის ჩარევას მოითხოვს და cooldown-ები არ არის.

_{📖 [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.50** ვერსიების ბოლოდროინდელი მნიშვნელოვანი სიახლეები. სრული ისტორია იხილეთ [`CHANGELOG.md`](CHANGELOG.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) - **⚖️ კვოტის გაზიარებაზე დაფუძნებული მარშრუტიზაცია** — საერთო ანგარიშის კვოტა სამართლიანად ნაწილდება გაერთიანებულ გასაღებებს შორის, ხოლო რესურსის ეფექტიანი გამოყენებისთვის უმოქმედო წილები დროებით სხვებს გადაეცემა. → [მდგრადობის სახელმძღვანელო](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 CLI-ის/აგენტის გამართვა ერთი ბრძანებით** — 13 რეგისტრირებული `setup-*` ბრძანება; `omniroute run` უშვებს 7 CLI-ს (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); `omniroute configure` მხარს უჭერს 10 სამიზნეს, ინტერაქციული პროვაიდერისა და მოდელის ამრჩევით და თითოეული კონტექსტის რჩეულებით. → [CLI ინტეგრაციები](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ დისტანციური რეჟიმი** — მართეთ დისტანციური OmniRoute შეზღუდული უფლებების მქონე ტოკენებით (`connect` / `contexts` / `tokens`) და VPS ინსტალაციებისთვის განკუთვნილი `antigravity` OAuth დამხმარით. → [დისტანციური რეჟიმი](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-*` ღირებულების/გამოყენების სათაურები ყველა საბოლოო წერტილზე, ქეშში მოხვედრით დაზოგილი თანხის სათაური და თითოეული გასაღების 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) - **🖼️ ახალი საბოლოო წერტილები** — `/v1/ocr` (Mistral OCR) და `/v1/audio/translations` (Whisper-ის სტილში) ავსებს მედიაფუნქციების სპექტრს. → [API-ის ცნობარი](docs/reference/API_REFERENCE.md) - **🎨 გამოსახულების / ვიდეოს / აუდიოს გენერაცია** — ერთი API მედიაკონტენტისთვის: xAI Grok Imagine და Novita AI-ის ვიდეო, ComfyUI, Magnific, Adobe Firefly, Segmind და მეტყველების პროვაიდერები, როგორიცაა ElevenLabs. → [API-ის ცნობარი](docs/reference/API_REFERENCE.md) - **🌍 განთავსება და ოპერაციები** — უკუპროქსის `basePath`, ბრაუზერის ენის ავტომატური ამოცნობა, მოწყობილობების თვალყურის დევნება თითოეული გასაღებისთვის, 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… და განახლებული **352-პროვაიდერიანი კატალოგი**. → [პროვაიდერები](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-ის რელეების განმთავსებლები, Bifrost და Mux ზედამხედველობის ქვეშ მყოფ ჩაშენებულ სერვისებად. → [ჩაშენებული სერვისები](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 კომპლექტში ასევე შედის** — პლაგინების ფრეიმვორკი + მარკეტპლეისი, Omni/Agent/GitHub უნარების ფრეიმვორკები, Obsidian საცავის ინტეგრაცია (22 MCP ხელსაწყო), OpenAI-სთან თავსებადი Batch და Files API-ები, პასუხების სემანტიკური ქეში, გეიმიფიკაცია ლიდერბორდებით, ACP აგენტების აღმოჩენა (15 ჩაშენებული აგენტი), ჟურნალების BigQuery-ში გეგმური ექსპორტი, `auto/chaos`-ის პარალელური მრავალმოდელიანი განშტოება, 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-სთან თავსებადი ნებისმიერი ხელსაწყო

_{📖 თითოეული ხელსაწყოს კონფიგურაცია 36-ვე ხელსაწყოსთვის (26 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 ``` ყველა ბრძანება ითვალისწინებს აქტიურ დისტანციურ კონტექსტს (`omniroute connect `), `--dry-run` შესრულების გარეშე წინასწარ აჩვენებს ზუსტ გარემოს ცვლადებსა და არგუმენტებს, ხოლო `--api-key-env NAME` საიდუმლო მონაცემებს თქვენი shell-ის ისტორიაში მოხვედრისგან იცავს. → [CLI ინტეგრაციები](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 372 AI-პროვაიდერი — 154 კატალოგში მონიშნული, როგორც უფასო

> **372 რეგისტრირებული პროვაიდერი** ჩატის, მედიის, ძიების, ლოკალური, ღრუბლოვანი აგენტებისა და სისტემის კანონიკურ კოლექციებში, მათ შორის **154 პროვაიდერი, რომლებსაც აღმოჩენის მეტამონაცემებში მითითებული აქვთ `hasFree: true`**. ჩატის მოდელების რეესტრი მოიცავს **237 პროვაიდერს / პროვაიდერისა და მოდელის 3,009 უნიკალურ წყვილს / მოდელის 1,443 დაუმუშავებელ ID-ს**; უფასო ბიუჯეტების ცალკე კატალოგში არის **491 ჩანაწერი ცალკეული მოდელებისთვის**, **35 პერიოდულად განახლებადი პული** და **54 პერიოდულად განახლებადი/გასაღების არმომთხოვნი, სამუდამოდ უფასო პროვაიდერი**. ეს მნიშვნელი განზრახ განსხვავდება ერთმანეთისგან; განმარტებები და პულების დუბლირების გამორიცხვით შესრულებული გამოთვლები იხილეთ [პროვაიდერების ცნობარში](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

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

OpenCode Zen _{DeepSeek V4, Nemotron 3 ტოკენების ლიმიტის გარეშე}	Kilo Code _{ავტომარშრუტიზატორი, Tencent Hy3 სამუდამოდ უფასო}	Requesty _{GPT-OSS 120B, Nemotron სამუდამოდ უფასო}	SiliconFlow _{DeepSeek V3.2 / R1 უფასო დონე}	Z.AI GLM _{GLM-4.7 / 4.5-Flash სამუდამოდ უფასო}	Baidu ERNIE _{ERNIE 4.0 სამუდამოდ უფასო}
Qoder AI _{Qwen3-Max, Kimi-K2 შეუზღუდავად უფასო}	Pollinations _{GPT, Llama, Claude გასაღები არ არის საჭირო}	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 list # ← სრულდება დისტანციურ სერვერზე 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 — ზედა დონის 86-ბრძანებიანი შესაძლებლობების ციკლური ჩვენებით: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 დააკავშირეთ აგენტი — და ის თავად მართავს OmniRoute-ს გახადეთ OmniRoute ხელმისაწვდომი **MCP-ის**, **A2A-ის**, **REST API-ის**, **ვებჰუკების** ან **დისტანციური 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 ტრანსფორმერები პროვაიდერის დასტურების მიღებამდე დახურულად რჩება. შეკუმშვის ოთხი პროფილი (ნაგულისხმევად აგრესიული, დაბალანსებული, კოდისთვის უსაფრთხო, უცვლელად გატარება) (ყველაზე აგრესიული; საჭიროებს ცალკე ჩართვას)

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

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

**რეალური მაგალითი — სტანდარტული რეჟიმი:** > **მანამდე (69 ტოკენი):** _"თქვენი React კომპონენტის ხელახლა რენდერის სავარაუდო მიზეზი ისაა, რომ რენდერის თითოეულ ციკლში ობიექტის ახალ ბმულს ქმნით. როდესაც inline ობიექტს prop-ის სახით გადასცემთ, React-ის ზედაპირული შედარება მას ყოველ ჯერზე განსხვავებულ ობიექტად აღიქვამს, რაც ხელახლა რენდერს იწვევს. გირჩევდით, ობიექტის დასამახსოვრებლად useMemo გამოიყენოთ."_ > > **შემდეგ (19 ტოკენი):** _"ყოველ რენდერზე ობიექტის ახალი ბმული. Inline ობიექტი prop-ში = ახალი ბმული = ხელახალი რენდერი. გამოიყენეთ useMemo."_ > > **იგივე პასუხი. 72%-ით ნაკლები ტოკენი. სიზუსტის ნულოვანი დანაკარგი.** ✅ **PT-BR მაგალითი — [Troglodita](https://github.com/leninejunior/troglodita) რეჟიმი:** > **მანამდე (42 ტოკენი):** _"პრობლემა ისაა, რომ კომპონენტი ხელახლა რენდერდება, რადგან რენდერის ყოველ ციკლში ობიექტის ახალი ბმული იქმნება. გირჩევდით useMemo-ს გამოყენებას."_ > > **შემდეგ (12 ტოკენი):** _"ხელახალი რენდერი: ახალი ბმული ყოველ ციკლში (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` სათაური › მარშრუტიზაციის კომბინაციის გადაფარვა › აქტიური სახელდებული პროფილი › ადაპტური / ავტომატური გააქტიურება › პანელის ნაგულისხმევი პარამეტრი › გამორთული. გამოყენებული გეგმა პასუხად ბრუნდება `X-OmniRoute-Compression: ; source=` სათაურში. გამოიყენეთ ავტომატური გააქტიურება ტოკენების ზღვრის მიხედვით, ჩართეთ ადაპტური მარეგულირებელი, დაამაგრეთ სახელდებული პროფილი, ერთჯერადად მიუთითეთ პარამეტრი თითოეულ მოთხოვნაზე ან მარშრუტიზაციის თითოეულ კომბინაციას მიანიჭეთ pipeline — აირჩიეთ ის, რაც დატვირთვას შეესაბამება. სურვილისამებრ ჩასართავი, ოფლაინ **შეფასების სისტემა** (`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`) საჭიროა მისი ნატიური გაშვების გარემოს ფაილების მოსამზადებლად. გლობალური ინსტალაციისას დაუშვით npm-ის გაფრთხილებაში ჩამოთვლილი პაკეტები. OmniRoute 3.8.51-ის მიერ მითითებული პაკეტების ნაკრებისთვის: > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > მომავალი გლობალური ინსტალაციებისთვის ამ ნებადართული სიის ხელახლა გამოსაყენებლად ერთხელ გამართეთ იგი, შემდეგ კი ჩვეულებრივ დააინსტალირეთ: > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > დამოკიდებულებების სია რელიზებს შორის შეიძლება შეიცვალოს; თუ npm სხვა სიას აჩვენებს, გამოიყენეთ იმ გაფრთხილებაში მითითებული პაკეტების სახელები. პაკეტის დაშვება მის საინსტალაციო სკრიპტებს გაშვების უფლებას აძლევს. > **იყენებთ Gemini Web-ს ან ვებ-cookie-ზე დაფუძნებულ სხვა პროვაიდერს?** npm პაკეტი შეიცავს > Playwright-ს, მაგრამ არა მის Chromium-ის ბინარულ ფაილს. ვებ-პროვაიდერისთვის პირველი მოთხოვნის გაგზავნამდე გაეცანით > [Playwright Chromium-ის გამართვის](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > შენიშვნას. მართვის პანელი ხელმისაწვდომია მისამართზე `http://localhost:20128` · API — მისამართზე `http://localhost:20128/v1`. **2) დააკავშირეთ შესაბამისი პროვაიდერი საკუთარი ანგარიშით** მართვის პანელი → **პროვაიდერები** → აირჩიეთ პროვაიდერი, რომლის მიმდინარე პირობები და კვოტა თქვენს გამოყენების შემთხვევას შეესაბამება → დაამატეთ მისი API გასაღები ან გაიარეთ ანგარიშის დაკავშირების პროცესი. უფასო ტარიფებმა შეიძლება მოითხოვოს რეგისტრაცია, დამტკიცება ან გადახდის მეთოდი. გაეცანით [უფასო ტარიფების სახელმძღვანელოს](docs/getting-started/FREE-TIERS-GUIDE.md); გასაღების გარეშე ხელმისაწვდომობა გარანტირებული არ არის, ხოლო `tos: avoid` ნიშნით მონიშნული პროვაიდერები ნაგულისხმევად გამორიცხულია `auto`-დან. **3) მიუთითეთ მისამართი თქვენს პროგრამირების ხელსაწყოში** ```txt საბაზისო URL: http://localhost:20128/v1 API გასაღები: [დააკოპირეთ მართვის პანელიდან → Endpoints] მოდელი: auto (ანაწილებს შესაბამის კავშირებს შორის — ან აირჩიეთ პროვაიდერი/მოდელი) ``` **4) შეამოწმეთ, რომ მუშაობს** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` სიაში თქვენი დაკავშირებული მოდელები უნდა გამოჩნდეს. 🎉 სულ ესაა — დაიწყეთ კოდის წერა, OmniRoute კი ავტომატურად შეარჩევს მარშრუტს და საჭიროებისას სარეზერვო ვარიანტზე გადავა. თუ თქვენს კლიენტს მორგებული სათაურების გაგზავნა არ შეუძლია, OmniRoute ასევე გთავაზობთ ტოკენიზებულ თავსებადობის ფსევდონიმებს: ```txt OpenAI კატალოგი: http://localhost:20128/vscode/YOUR_KEY/ OpenAI მოდელები: http://localhost:20128/vscode/YOUR_KEY/models OpenAI ჩატი: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI პასუხები: http://localhost:20128/vscode/YOUR_KEY/responses Ollama ჩატი: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama ტეგები: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` ეს მისამართები გამოიყენეთ მხოლოდ იმ კლიენტებისთვის, რომლებსაც `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-08-24-ისთვის · დაუმუშავებელი კატალოგი: YT 809 | TT 137 | IG 124 · განახლების სიხალე (დღეები): YT 1 | TT 21 | IG 22}

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

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

🎬 #3 — TikTok
_{milesreevesai — 620,400 ნახვა}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 ნახვა}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 ნახვა}

**სრული რეიტინგი (დუბლიკატებისგან გასუფთავებული კანონიკური URL-ები, `v > 0`, უდიდესი წვდომა):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **391,109** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | | #6 | #7 | #8 | #9 | #10 | | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | [vaibhavsisinty — Instagram](https://www.instagram.com/reel/Dae05TSAK1l/) — **263,744** | [Nick Automates — YouTube Shorts](https://www.youtube.com/shorts/fZIBK_4fKq8) — **218,174** | [theroshankrishna — Instagram](https://www.instagram.com/reel/Dapjs58z0P0/) — **186,786** | [midudev — TikTok](https://www.tiktok.com/@midudev/video/7664636453544152342) — **177,800** | კანონიკური მეტრიკები 2026-08-24-ისთვის: **1.029 უნიკალური ვიდეო** · **11.132.922 ცნობილი ნახვა** (`v > 0`) · **639 არხი/პროფილი ქსელების მიხედვით**. დაუმუშავებელი პანელი შეიცავს 1.070 სტრიქონს; Instagram-ის 41 დუბლიკატი კანონიკური URL-ის მიხედვით ნორმალიზდა, თითოეული ვიდეოსთვის ნახვების უდიდესი რაოდენობის შენარჩუნებით. > 🎬 **გადაიღეთ ვიდეო 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) — 137 დომენური მოდული, 202 მიგრაცია
მეხსიერება	SQLite FTS5 სრული ტექსტის ძიება + int8-კვანტიზებული ვექტორული ჩაშენებები, ტიპიზებული დაქვეითება
სქემები	Zod 4 — MCP ხელსაწყოების I/O ვალიდაცია + 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-დონიანი პროქსი
მდგრადობა	ავარიული გამთიშველი, ექსპონენციალური დაყოვნება, ერთდროული მოთხოვნების მოზღვავების საწინააღმდეგო მექანიზმი, ავტომატური კომბინაციების თვითაღდგენა
ჟურნალირება	pino — სტრუქტურირებული JSON ჟურნალები მოთხოვნის კონტექსტით
ტესტირება	Node.js ტესტების გამშვები + Vitest — 39,000+ სტატიკური ტესტის დეკლარაცია 5,100+-ზე მეტ თვალყურისდევნებად სატესტო ფაილში (მოდულური, ინტეგრაციული, E2E, უსაფრთხოების, ეკოსისტემის)
პლატფორმები	დესკტოპი (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-ს სახელმძღვანელო	პროგრესული ვებაპლიკაციის ინსტალაცია, კეშირება, არქიტექტურა
დეინსტალაციის სახელმძღვანელო	სრული წაშლა ინსტალაციის ყველა მეთოდისთვის
გარემოს კონფიგურაცია	`.env`-ის ცვლადებისა და ცნობარების სრული სია

### 🧠 ფუნქციები და არქიტექტურა

დოკუმენტი	აღწერა
არქიტექტურა	სისტემის არქიტექტურა, მონაცემთა ნაკადი და შიდა მექანიზმები
შეკუმშვის სახელმძღვანელო	7-ვარიანტიანი კონვეიერი: გამორთული / მსუბუქი / სტანდარტული / აგრესიული / ულტრა / RTK / კომბინირებული
RTK შეკუმშვა	ბრძანებების გამოტანილი მონაცემების შეკუმშვა, ფილტრები, ნდობა, შემოწმება, დაუმუშავებელი გამოტანილი მონაცემების აღდგენა
შეკუმშვის ძრავები	Caveman, RTK, კომბინირებული კონვეიერები, მართვის პანელის/API/MCP ინტერფეისები
შეკუმშვის წესების ფორმატი	JSON წესების პაკეტების სქემები Caveman-ისა და RTK-ის ფილტრებისთვის
შეკუმშვის ენობრივი პაკეტები	ენის ამოცნობა და Caveman-ის წესების პაკეტების შექმნა
მდგრადობის სახელმძღვანელო	ავარიული ამომრთველები, დაყოვნების პერიოდები, რიგი, ერთდროული მოთხოვნების მოზღვავების პრევენცია, TLS-ის გაყალბება
ავტომატური კომბინაციების ძრავა	16-ფაქტორიანი შეფასება, რეჟიმების პაკეტები, თვითაღდგენა
პროქსის სახელმძღვანელო	3-დონიანი პროქსი-სისტემა, 1proxy-ის მარკეტპლეისი, რეესტრის CRUD ოპერაციები
უფასო დონეები	გაერთიანებული კატალოგი: 35 დოკუმენტირებული განმეორებადი პული / უფასო დონის 489 კატალოგიზებული ჩანაწერი
ფუნქციების გალერეა	მართვის პანელის ვიზუალური მიმოხილვა ეკრანის ანაბეჭდებით
კოდის ბაზის დოკუმენტაცია	დამწყებებისთვის გასაგები კოდის ბაზის მიმოხილვა

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

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

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

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

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

ადგილი	კონტრიბუტორი	გაერთიანებული PR-ები	~შეცვლილი ხაზები
1	backryun	190	227,977
2	oyi77	180	407,678
3	rdself	145	80,663
4	JxnLexn	128	387,049
5	KooshaPari	101	125,747
6	herjarsa	88	230,872
7	RaviTharuma	79	55,106
8	maxmad64bis	69	394,715
9	artickc	59	33,260
10	HouMinXi	51	47,334
10	chirag127	51	5,153
12	xz-dev	50	245,976
13	hartmark	47	52,185
14	rqzbeh	39	143,181
15	dhaern	34	19,559
16	Dingding-leo	33	1,986
17	NomenAK	32	13,854
18	MumuTW	30	16,953
19	benzntech	29	11,641
20	pacocartones	24	9,331
20	Prudhvivuda	24	6,312

_{მონაცემები დაფიქსირებულია აქტიური release/v3.8.50 ბრენჩის ბოლო კომიტზე dafb4ae808, 2026-08-24 05:26:03 UTC-მდე შესრულებული გაერთიანებების ჩათვლით. გვერდებად დაყოფილი GitHub GraphQL აღწერა მოიცავს 5,911 გაერთიანებულ PR-ს: 2,707 — რეპოზიტორიის მფლობელისგან, 179 — Dependabot-ისგან და 3,025 გარე PR-ს 535 სხვადასხვა კონტრიბუტორისგან. „შეცვლილი ხაზები“ არის GitHub-ში დამატებული და წაშლილი ხაზების ჯამი და მოიცავს გენერირებულ ფაილებს, lockfile-ებს, კატალოგებს, თარგმანებსა და დოკუმენტაციას; ეს ცვლილებების მოცულობაა და არა ავტორის მიერ დაწერილი კოდის ხაზების რაოდენობა. ზღვარზე თანაბარი შედეგები შენარჩუნებულია.} ### GitHub-ის მიერ მიკუთვნებული კომიტები

backryun _{🥇 GitHub-ზე მიკუთვნებული 220 კომიტი}	Paijo _{🥈 GitHub-ზე მიკუთვნებული 219 კომიტი}	Randi _{🥉 GitHub-ზე მიკუთვნებული 108 კომიტი}	Ravi Tharuma _{🏅 GitHub-ზე მიკუთვნებული 81 კომიტი}	Chris _{🏅 GitHub-ზე მიკუთვნებული 70 კომიტი}	Markus Hartung _{🏅 GitHub-ზე მიკუთვნებული 69 კომიტი · თანაბრად #6 ადგილზე}
Dizzle _{🏅 GitHub-ზე მიკუთვნებული 69 კომიტი · თანაბრად #6 ადგილზე}	Jan Leon _{🏅 GitHub-ზე მიკუთვნებული 64 კომიტი}	zenobit _{🏅 GitHub-ზე მიკუთვნებული 62 კომიტი}	Bob.Hou _{🏅 GitHub-ზე მიკუთვნებული 51 კომიტი · თანაბრად #10 ადგილზე}	Xiangzhe _{🏅 GitHub-ზე მიკუთვნებული 51 კომიტი · თანაბრად #10 ადგილზე}

_{ხელახლა შემოწმდა 2026-08-24 06:14:31 UTC-ზე: რეპოზიტორიის Contributors API-ის მიერ release/v3.8.50 ნაგულისხმევი ბრენჩისთვის მოხსენებული GitHub-ზე მიკუთვნებული კომიტები. API-მ დააბრუნა 525 იდენტობა (415 მომხმარებელი, 2 ბოტი, 108 ანონიმური); ეს ცხრილი გამორიცხავს პროექტის მმართველს, ბოტებსა და ანონიმურ იდენტობებს და ინარჩუნებს თანაბარ პოზიციებს. ის განსხვავდება როგორც ზემოთ მოცემული გაერთიანებული PR-ების რეიტინგისგან, ისე ქვემოთ მოცემული Git-ის მეტამონაცემებზე დაფუძნებული 639-პირიანი აღწერისგან.} > 🙏 ამ კონტრიბუტორების ფუნქციები, შეცდომების გამოსწორებები და ინფრასტრუქტურის გაუმჯობესებები არის იმის **უმნიშვნელოვანესი ნაწილი**, რაც OmniRoute-ს საიმედოსა და ფუნქციებით მდიდარს ხდის. მნიშვნელოვანია ყოველი pull request, ყოველი სატესტო შემთხვევა და ყოველი i18n თარგმანის ფაილი. ღია კოდს მათნაირი ადამიანები ქმნიან.

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

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

Andrew
_{💛 აქტიური ყოველთვიური სპონსორი}

Vlad I
_{💛 აქტიური ყოველთვიური სპონსორი}

Paco Cartones
_{💛 აქტიური ერთჯერადი სპონსორი}

Prof. Igor Morais
_{💛 ყოფილი ერთჯერადი მხარდამჭერი}

longtao
_{💛 ყოფილი ერთჯერადი მხარდამჭერი}

_{… და სხვები, რომლებიც ანონიმურობას ამჯობინებენ 💛} _{GitHub-ის საჯარო სპონსორები ხელახლა გადამოწმდა 2026-08-24-ს. GitHub-ის activeOnly სტატუსი განსაზღვრავს ზემოთ მოცემულ აქტიურობის აღნიშვნებს; ადრე გასაჯაროებული ერთჯერადი საჯარო მხარდამჭერები კვლავ მადლიერებით არიან მოხსენიებული, ხოლო კერძო სპონსორები ანონიმურებად რჩებიან.} 💖 გახდით სპონსორი → — თითოეული დოლარი OmniRoute-ს უფასოსა და დამოუკიდებელს უნარჩუნებს.

## 👥 600+-ზე მეტი კონტრიბუტორი

[![კონტრიბუტორები](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=639&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{აუდიტი ჩატარდა 2026-08-24-ს გაყინულ საბაზისო ac02c5b42f ვერსიაზე და ხელახლა შემოწმდა აქტიური release/v3.8.50 შტოს ბოლო dafb4ae808 ვერსიაზე: 639 ნორმალიზებული ადამიანის Git-იდენტობა — 407 მათგანი ჩანს კომიტების ავტორად (მათ შორის პროექტის მომვლელიც), ხოლო 232 — მხოლოდ აშკარა Co-authored-by ტრეილერებში. აღრიცხვისას ნორმალიზებულია GitHub-ის noreply სახელები, გამორიცხულია 26 ბოტის/აგენტის/სერვისის/შემავსებელი იდენტობა და ჩვეულებრივი ელფოსტის მისამართები არ არის გაერთიანებული მხოლოდ იმიტომ, რომ მათი საჩვენებელი სახელები ემთხვევა.} ### როგორ შეიტანოთ წვლილი 1. შექმენით რეპოზიტორიის fork 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)**-ის fork და Go პროექტის — **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)** — TypeScript-ზე პორტირებული ვერსია; ამის შემდეგ კი ქვემოთ ჩამოთვლილი თითოეული ქვესისტემა შთაგონებული იყო ღია კოდის პროექტით, რომელმაც ეს პირველად გააკეთა. თითოეულმა მათგანმა OmniRoute-ის კონკრეტული ნაწილის ჩამოყალიბებაში შეიტანა წვლილი. ამით ყველა მათგანს მადლობას ვუხდით. 🙏 > ⭐ ვარსკვლავების რაოდენობა გადამოწმებულია GitHub-ის REST API-ის მეშვეობით 2026 წლის 24 აგვისტოს — აუცილებლად მიანიჭეთ ამ პროექტებს ვარსკვლავი. ეს რაოდენობები კონკრეტული თარიღისთვის შექმნილი ზუსტი სურათია და დროთა განმავლობაში, ბუნებრივია, შეიცვლება. ### 🧬 წარმოშობა და gateway

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
9router	26,161	საწყისი პროექტი, რომელზეც ეს fork არის აგებული — აქ გაფართოებულია მულტიმოდალური API-ებით და სრულად გადაწერილია TypeScript-ზე.
CLIProxyAPI	48,497	Go-ზე შექმნილი იმპლემენტაცია, რომელმაც JavaScript / TypeScript-ზე ამ პორტის შექმნა შთააგონა.
LiteLLM	57,100	AI-კარიბჭე, რომლის ფასების საჯარო მონაცემთა ნაკრები ჩვენი ხარჯების აღრიცხვის სინქრონიზაციას ამარაგებს, ხოლო პროვაიდერების ნორმალიზაციის მოდელმა ჩვენს მარშრუტიზაციაზე იქონია გავლენა.
codex-chatgpt-web	1,410	MIT-ის საწყისი კოდი, რომელიც ადაპტირებულია პროექტში ჩაშენებულ ChatGPT Web → Codex Responses ხიდში, მათ შორის ბრაუზერის სესიის, პასუხის ჩარჩოების, გამოყენებისა და ვებ-ძიების ადაპტერები.
free-claude-code	48,112	ნიმუშები, რომლებიც გადატანილია ნაკადის აღდგენაში, აზროვნების გარეშე მეტსახელებში, სარეზერვო ვებ-ძიებაში, მცოცავი ფანჯრის შეზღუდვებში, ჟურნალის მონაცემების დაფარვასა და გაძლიერებულ გამშვებ პროცესებში.
composer-api	322	Cursor Composer-ის ხელსაწყოს არჩევის, გამომავალი მონაცემების შეზღუდვისა და ხელსაწყოს დაფიქსირების ნიმუშები, რომლებიც ადაპტირებულია Cursor-ის მშობლიურ შემსრულებელში.
codex-multi-auth	457	ახალი ავტორიზაციისა და refresh-token-ის როტაციის ნიმუშები, რომლებიც გადატანილია Codex OAuth-ის ხელახალ ავთენტიფიკაციაში.
opencode-anthropic-auth	510	Claude Code-თან თავსებადი გარდაქმნის ნაგულისხმევი პარამეტრები და ბილინგის სათაურის ქცევა, რომლებიც განზოგადებულია OmniRoute-ის კონფიგურაციით მართვად ხიდში.
grok2api-merged	2	მისი Grok მოდელების შესაბამისობები, ყალბი TypeError-ის მქონე Statsig გენერატორი, მოთხოვნისა და მოწყობილობის ნაგულისხმევი პარამეტრები და NDJSON პასუხების დამმუშავებელი არსებითად ადაპტირდა OmniRoute-ის Grok Web შემსრულებელში.
TQZHR/grok2api	705	grok2api-merged-ის მთავარი ტრანზიტიული კოდის წყარო; მისი მოდელის, სათაურის, სასარგებლო დატვირთვის, Statsig-ისა და დამმუშავებლის იმპლემენტაციები შენარჩუნებულია Grok Web-ის წარმოშობის ხაზში.
chenyme/grok2api	7,520	Grok-ის სასარგებლო დატვირთვისა და მოწყობილობის ნაგულისხმევი პარამეტრების, Statsig გენერატორისა და `result.response` დამმუშავებლის საფუძვლად არსებული MIT-ის საწყისი კოდი, რომელიც გადმოტანილია TQZHR-ისა და grok2api-merged-ის გავლით.
grok2api-pro	27	ტრანზიტიული წყარო, რომელსაც grok2api-merged თავის proxy-pool ფენასთან დაკავშირებით უთითებს; OmniRoute ინარჩუნებს წარმოშობის ამ მითითებას, თუმცა არ აცხადებს proxy-pool-ის პორტირებას თავის შეზღუდულ Grok Web შემსრულებელში.
GrokProxy	50	მისმა cookie-თი ავთენტიფიცირებულმა Grok პროქსიმ და `result.response.token` ნაკადის ნიმუშმა OmniRoute-ის Grok Web ტრანსპორტის შექმნაზე იქონია გავლენა.
GrokBridge	5	Grok Web-ის თავდაპირველი იმპლემენტაციისთვის შესწავლილ იქნა მისი HTTP/ბრაუზერის აღმავალი სერვერის დიზაინი; მისი პირდაპირი HTTP გზა GrokProxy-დან მომდინარეობს, ამიტომ დამოუკიდებელი კოდის პორტირება არ ივარაუდება.
grok-web-api	14	მისმა Rust-ის `ChatOptions` და პასუხის კონვერტის სქემებმა OmniRoute-ის TypeScript-ზე შექმნილი Grok მოთხოვნისა და ნაკადური პასუხის ტიპებზე იქონია გავლენა.

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

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
Caveman	100,538	ვირუსული პროექტი „რატომ გამოიყენო ბევრი ტოკენი, როცა ცოტაც საქმეს აკეთებს“ — მისი გამოქვაბულის ადამიანის მეტყველების ფილოსოფია საფუძვლად უდევს ჩვენს სტანდარტულ შეკუმშვის რეჟიმსა და შემავსებელი სიტყვების მოცილების/კონდენსაციის 30-ზე მეტ წესს.
RTK – Rust Token Killer	77,185	ბრძანებების გამომავალი მონაცემების მაღალი წარმადობის შეკუმშვა — შთააგონა ჩვენი RTK ძრავა, JSON ფილტრების DSL, დაუმუშავებელი გამომავალი მონაცემების აღდგენა და კომბინირებული RTK → Caveman კონვეიერი.
headroom	67,310	შექცევადი კონტექსტის შეკუმშვა (SmartCrusher) — შთააგონა ჩვენი `headroom` ძრავა და `ccr` აღდგენის მარკერის შაბლონი.
LLMLingua	6,598	მინიშნებების შეკუმშვის კვლევა (LLMLingua / LLMLingua-2) — შთააგონა ჩვენი ასინქრონული, კოდისთვის უსაფრთხო და შეცდომისას ღია `llmlingua` ძრავა.
llmlingua-2-js	31	JS/ONNX პორტი (MobileBERT / XLM-RoBERTa), რომელიც ჩვენი LLMLingua ძრავისთვის სამუშაო ნაკადის ბექენდად გამოიყენება.
Troglodita	40	PT-BR ტოკენების შეკუმშვა — უზრუნველყოფს ჩვენი pt-BR ენის პაკეტის მუშაობას: პლეონაზმების შემცირებასა და ბრაზილიურ-პორტუგალიურ გრამატიკაზე მორგებულ შემავსებელი სიტყვების მოცილებას.
ponytail	108,957	ვირუსული „ზარმაცი უფროსი დეველოპერის“ YAGNI-კოდირების უნარი — შთააგონა ჩვენი less-code გამომავალი სტილი: მინიმალური მუშა ცვლილებისკენ მიმართვა, რომელიც ამცირებს _გენერირებულ_ კოდს (Caveman-ის ლაკონიური პროზის გამომავალზე ორიენტირებული ანალოგი).
i-have-adhd	23,526	მისი მოქმედებაზე ორიენტირებული, ADHD-მეგობრული პასუხის სტილი ადაპტირდა OmniRoute-ის ლაკონიურ გამომავალ სტილად ხუთ ენაზე.

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

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
TOON	25,233	ტოკენებზე ორიენტირებული ობიექტური ნოტაცია — მისმა სვეტურმა, სათაურისა და მწკრივების მოდელმა განსაზღვრა ჩვენი ცხრილური კომპაქტიზაციის ეტაპი.
GCF – Graph Compact Format	41	მისმა კომპაქტურმა გრაფის ფორმატმა და ზოგადი პროფილის დიზაინმა გავლენა მოახდინა OmniRoute-ის ცხრილურ კომპაქტიზაციასა და Headroom კოდეკის ფორმატზე.
gcf-typescript	4	MIT TypeScript იმპლემენტაცია, რომელიც პირდაპირ ჩაირთო პროექტში და გაფართოვდა Headroom-ის ზოგადი პროფილის კოდეკის სახით.
token-optimizer-mcp	494	Brotli/SQLite კეში + სესიაზე მორგებული კონტექსტის სხვაობა — შთააგონა ჩვენი `session-dedup` ძრავა.
token-savior	1,122	Bash გამომავალი მონაცემების კომპაქტიზაცია + MCP პროფილები — შთააგონა შეკუმშვის შეწყვეტის ჩვენი დისციპლინა და MCP ხელსაწყოების მანიფესტის შემცირება.
token-saver	138	შიგთავსის გამთვალისწინებელი, ფაილის ტიპზე მორგებული გამომავალი მონაცემების შეკუმშვა, შეცდომების გამთვალისწინებელი შეწყვეტით — დაადასტურა ჩვენი ტიპზე მორგებული გადანაწილებისა და მინიმალური სარგებლისას გამოტოვების მიდგომა.
token-optimizer	1,951	„იპოვე მოჩვენება-ტოკენები“ — მისმა გატანისა და აღდგენადი სახელურის შაბლონმა გავლენა მოახდინა CCR გატანის შესახებ ჩვენს ხედვაზე.
TokenMizer	28	სესიის გრაფისა და სხვადასხვა ნაბიჯს შორის სტრიქონების დუბლიკატების მოცილების სქემა, რომელმაც გავლენა მოახდინა ჩვენს session-dedup დიზაინზე.
OmniCompress	3	Rust სვეტური JSON + შიგთავსზე მისამართებული აღდგენა + შეტყობინებებს შორის დუბლიკატების მოცილება — დაადასტურა ჩვენი `headroom`/`ccr`/`session-dedup` ძრავების დიზაინი და კეშისთვის სტაბილური უცვლელი წესი: „შეკუმშული ფორმა პოზიციისგან დამოუკიდებელია“.
mcp-compressor	113	MCP ხელსაწყოების სქემის/აღწერის შეკუმშვა — გავლენა მოახდინა MCP ხელსაწყოების მანიფესტის კარდინალურობის შემცირების ჩვენს მიდგომაზე.
RepoMapper	197	Aider-ის სტილის რეპოზიტორიის რუკის რანჟირება — გავლენა მოახდინა რეპოზიტორიის რუკისა და მოძიების რანჟირების ჩვენს კვლევაზე.
quiet-shell-mcp	4	დეკლარაციული shell გამომავალი მონაცემების შემცირება MCP-ის მეშვეობით — დაადასტურა Bash გამომავალი მონაცემების დეკლარაციული კომპაქტიზაციის ჩვენი მიდგომა.
ts-morph	6,162	TypeScript Compiler API ხელსაწყოთა ნაკრები — შთააგონა პარსერზე დაფუძნებული კომენტარების მოცილების ჩვენი მიდგომა, რომელიც ინარჩუნებს სტრიქონულ, შაბლონურ და რეგულარული გამოსახულებების ლიტერალებს.

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

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

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

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

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

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
models.dev	6,555	AI-მოდელების სპეციფიკაციების, ფასებისა და შესაძლებლობების ღია მონაცემთა ბაზა — ნატიურად სინქრონიზდება ჩვენი მოდელების კატალოგში.
React Flow / xyflow	38,108	კვანძებზე დაფუძნებული გრაფების ბიბლიოთეკა, რომელიც უზრუნველყოფს ჩვენი რეალურ დროში მომუშავე Compression Studio-სა და Combo/Routing Studio-ს მუშაობას.
LangGraph	40,314	LangGraph Studio-ს სამუშაო პროცესის გრაფის ცოცხალმა ვიზუალიზაციამ შთააგონა ჩვენი Studios-ის რეალურ დროში კასკადური ხედი.
Langfuse	33,592	მისმა trace → span → generation დაკვირვებადობის მოდელმა განსაზღვრა ჩვენი Compression Studio-ს ჩანჩქერული ხედი.
Kiali	3,631	Istio-ს სერვისული ბადის დაკვირვებადობა — შთააგონა ჩვენი circuit-breaker ნიშნები და შეცდომის წიბოების ვიზუალები Routing/Combo Studio-ში.
lobe-icons	2,428	AI/LLM-ბრენდების ლოგოები, რომლებიც ჩვენს მართვის პანელზე პროვაიდერების ხატულებს ასახავს.
flag-icons	12,354	უზრუნველყოფს MIT-ლიცენზირებულ SVG-დროშებს, რომლებსაც README-ის ენის ამომრჩევი იყენებს.

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

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

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

პროექტი	⭐	როგორ შთააგონა მან OmniRoute
ClawRouter	6,564	შთააგონა მოთხოვნების დუბლირების აღმოფხვრა, საგანგებო ნულოვანი ღირებულების სარეზერვო ვარიანტი, ჩანაცვლებადი Auto-Combo სტრატეგიები და მრავალენოვანი განზრახვის კლასიფიკაცია.
Antigravity-Manager	30,652	მისმა ანგარიშის გათვალისწინებით მოდელების ხელახალმა მიბმამ, შესრულებადი ფაილის ბილიკის ვალიდაციამ და გეგმის ჭდის ქცევამ გავლენა მოახდინა OmniRoute-ის Antigravity-ის გაშვების გარემოზე.
vscode-antigravity-cockpit	4,817	მისმა კვოტის განულებამდე დარჩენილი დროის კომპაქტურმა ფორმატმა შთააგონა OmniRoute-ში პროვაიდერის შესაბამისი ლიმიტის ჩვენება.
AionUi	32,230	მისმა ACP-ინტეგრაციებმა შთააგონა OmniRoute-ის მიერ დაინსტალირებული CLI-აგენტების ავტომატური აღმოჩენა.
CodexBar	20,507	გამოავლინა Grok Build-ის კვოტის ზედაპირი; შემდეგ OmniRoute-მა დამოუკიდებლად გადაამოწმა და შეასწორა აქტიური სადენური ფორმატი.

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

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