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

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

OmniRoute-ის უფასო ტარიფების ბიუჯეტის ბარათი: სტაბილურად ~1.62 მლრდ უფასო ტოკენი თვეში, ხოლო რეგისტრაციის კრედიტებით პირველ თვეში — ~2.22 მლრდ-მდე, 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.49 | **v3.8.50** | `v3.8.51+` | | ----------------------------------- | :-----: | :------------------------: | :---------: | | 🌐 პროვაიდერები | 290 | **357** | მეტი რიგშია | | 🧠 ჩატის მოდელების უნიკალური ID-ები | 1185 | **1312** | — | | 🖼️ მოდალობების ხიდი | — | 🆕 ხედვა + აუდიო + ვიდეო | — | | 📡 Radar-ის უფასო კატალოგი | — | 🆕 სურვილისამებრ ჩასართავი | — | | ⚖️ კვოტის გათვალისწინებით დაგეგმვა | — | 🆕 Quota-Share | — | | 📊 კვოტის ტელემეტრია | — | 🆕 რეალურ დროში | — | **→ [საგზაო რუკა](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-ები
💚 მხარდაჭერა	💚 მხარდაჭერა / შემოწირულობა	💬 საზოგადოება	💖 სპონსორები
📦 პროექტი	🛠️ ტექნოლოგიური სტეკი	📖 დოკუმენტაცია	👥 კონტრიბუტორები

🌐 66 ენაზე

## 🆓 მუშაობს ინსტალაციისთანავე — არანაირი გასაღები, არანაირი კონფიგურაცია

მუშაობს ინსტალაციისთანავე — ნულოვანი კონფიგურაცია. სამი ნაბიჯი: 1. ინსტალაცია — npm i -g omniroute, სერვერი ირთვება localhost:20128-ზე. 2. მიმართეთ თქვენი ხელსაწყო http://localhost:20128/v1-ზე — ნებისმიერი OpenAI-თან თავსებადი ხელსაწყო (Claude Code, Cursor, Cline). 3. ის პასუხობს — გამოიძახეთ model auto მყისიერი პასუხისთვის, API გასაღების, რეგისტრაციის, კონფიგურაციის გარეშე. Keyless პროვაიდერი OpenCode Free წინასწარ არის ჩართული auto კომბინაციაში, ასე რომ ახალი ინსტალაცია მუშაობს ყუთიდანვე.

```bash # Fresh install, zero credentials — `auto` already works: curl http://localhost:20128/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{გირჩევნიათ კონკრეტული უფასო ბექენდი? გამოიძახეთ `oc/…` (OpenCode Free) პირდაპირ. შემდეგ გადადით `auto`-ზე და მიეცით OmniRoute-ს არჩევის საშუალება.} _{📦 დააკოპირეთ და ჩასვით სწრაფი დაწყების სკრიპტები **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 breakers, TLS stealth, MCP, A2A, დამცავი ზოლები) შეუძლია უკან დაიხიოს 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-ის მომხმარებლებს? გახსენით საკითხი და ჩვენ დავამატებთ მას აქ.}

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

კომბოს მარშრუტიზაციის 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`	🧪 ხარვეზების ხელოვნურად გამოწვევის წონები მდგრადობის შესამოწმებლად (ქაოსური ინჟინერია)

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

_{📖 [ავტოკომბინაციის ძრავა](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`) და `antigravity` OAuth დამხმარით VPS ინსტალაციებისთვის. → [დისტანციური რეჟიმი](docs/guides/REMOTE-MODE.md) - **🧭 უფრო ჭკვიანი ავტომარშრუტიზაცია** — `auto/:` კომბინაციები, **Fusion** (მოდელების პანელი + შემფასებელი), ამოცანის გათვალისწინებით მარშრუტიზაცია, თითოეული მოთხოვნისთვის მოდელის / რეჟიმის / USD ბიუჯეტის გადაწერა. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ გაფართოებადი შეკუმშვა** — 12 კომპოზირებადი ძრავა + Compression Studios: LLMLingua-2, ორდონიანი Ultra, omniglyph, თითოეული ნაბიჯის სიზუსტის შემოწმება, GCF v3.2, გადაადგილებით დალაგების რედაქტორი. → [შეკუმშვა](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ გამჭვირვალე MITM გაშიფვრა (TPROXY)** — იმ CLI-ების ტრაფიკის დაჭერა, რომლებიც პროქსის გარემოს ცვლადებს უგულებელყოფენ, თითოეული SNI-სთვის ცალკე CA-ითა და ნდობის საცავის ინსტალატორით. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 ხარჯების ტელემეტრია ყველგან** — `X-OmniRoute-*` ხარჯის/გამოყენების სათაურები ყველა საბოლოო წერტილზე, cache-HIT დანაზოგის სათაური, თითოეული გასაღებისთვის USD ხარჯვის კვოტები. → [API ცნობარი](docs/reference/API_REFERENCE.md) - **🧠 მეხსიერება, რომელსაც თქვენ აკონტროლებთ** — ნაგულისხმევად გამორთულია, სურვილისამებრ ჩასართავი int8 ვექტორული კვანტიზაციითა და ტიპიზებული დაძველებით, თითოეული მოთხოვნისთვის `x-omniroute-no-memory`. → [მეხსიერება](docs/frameworks/MEMORY.md) - **🛡️ უსაფრთხოება** — prompt-injection-ისგან დაცვა ყველა LLM მარშრუტზე (red-team ტესტების ნაკრები), სურვილისამებრ ჩასართავი ავტორიზაციის მონაცემების შენიღბვის დამცავი მექანიზმი (ორივე მიმართულებით გაჟონილ API გასაღებებს/საიდუმლოებებს ფარავს), უფასო DuckDuckGo ვებძებნა უკიდურესი საჭიროებისთვის და დაფისთვის არასავალდებულო OIDC შესვლის ბარიერი (პაროლით შესვლა ყოველთვის ხელმისაწვდომი რჩება). → [დამცავი მექანიზმები](docs/security/GUARDRAILS.md) - **🖼️ ახალი საბოლოო წერტილები** — `/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)

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

> **357 რეგისტრირებული პროვაიდერი** კანონიკურ ჩატის, მედიის, ძიების, ლოკალური, ღრუბლოვანი აგენტებისა და სისტემურ კოლექციებში, მათ შორის **152-ს აქვს `hasFree: true` აღმოჩენის მეტამონაცემი**. ჩატის მოდელების რეესტრი მოიცავს **229 პროვაიდერს / პროვაიდერ-მოდელის 2,554 უნიკალურ წყვილს / 1,283 დაუმუშავებელ მოდელის 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 1M ტოკენი/დღე}	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%	ყოველთვის ჩართული უსაფრთხო ნაგულისხმევი რეჟიმისთვის
🪨 Standard (Caveman)	~30%	ყოველდღიური კოდირებისთვის
⚡ Aggressive	~50%	ხანგრძლივი, ხელსაწყოებით დატვირთული სესიებისთვის
🔥 Ultra	~75%	მაქსიმალური დანაზოგისთვის
🧰 RTK	60–90%	shell/test/build/git შედეგებისთვის
🔗 Stacked (RTK → Caveman)	78–95%	შერეული მოთხოვნებისა და ხელსაწყოების ჟურნალებისთვის

**რეალური მაგალითი — Standard რეჟიმი:** > **მანამდე (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). მართვის პანელი ხელმისაწვდომია მისამართზე `http://localhost:20128` · API — მისამართზე `http://localhost:20128/v1`. **2) დააკავშირეთ უფასო პროვაიდერი (რეგისტრაციის გარეშე)** მართვის პანელი → **პროვაიდერები** → დააკავშირეთ **Kiro AI** (უფასო Claude, ~50 კრედიტი თვეში თითო ანგარიშზე) ან **OpenCode Free** (ავტორიზაციის გარეშე) → მზადაა. **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 journaling) + LowDB (JSON legacy) — 122 დომენის მოდული, 183 მიგრაცია
მეხსიერება	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 bridge (`/v1/ws`)
კომპრესია	12-ძრავიანი კონვეიერი — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
ავთენტიფიკაცია და უსაფრთხოება	OAuth 2.0 (PKCE) + JWT + API Keys + MCP-ის ფარგლებში ავთენტიფიკაცია · AES-256-GCM მოსვენებულ მდგომარეობაში · DOMPurify
სტელსი	wreq-js — JA3 / JA4 TLS თითის ანაბეჭდის იმიტაცია, 3-დონიანი პროქსი
მდგრადობა	წრედის ამომრთველი, ექსპონენციური უკუდახევა, "anti-thundering-herd", ავტო-კომბო თვითაღდგენა
ლოგირება	pino — სტრუქტურირებული JSON ლოგები მოთხოვნის კონტექსტით
ტესტირება	Node.js test runner + Vitest — 39,000-ზე მეტი სტატიკური ტესტის დეკლარაცია 5,100-ზე მეტ თვალყურის ქვეშ მყოფ სატესტო ფაილში (ერთეული, ინტეგრაცია, E2E, უსაფრთხოება, ეკოსისტემა)
პლატფორმები	დესკტოპი (Electron) · Android (Termux) · PWA (ნებისმიერი ბრაუზერი)
CI/CD	GitHub Actions — ავტომატური npm გამოქვეყნება + Docker Hub გამოშვებისას
ბმულები	ვებგვერდი · npm · Docker Hub

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

### 📘 მუშაობის დაწყება

დოკუმენტი	აღწერა
მომხმარებლის სახელმძღვანელო	პროვაიდერები, კომბინაციები, 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.51 · Node ≥22.22.2 · MIT ლიცენზია · omniroute.online}