mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-18 04:42:30 +03:00

Files

diegosouzapw 461a02b209 chore(providers): reconcile the xKiro counts with the chipotle removal

The branch merged the release tip twice: the first pass carried a stale
origin/release/v3.8.51 that predated #13913, so every derived count was
computed against a provider that had already been retired.

Reconciled against the current tip:

- Provider count is 359 (tip 358 after the chipotle/pepper removal, plus
  xKiro). README, AGENTS.md, llm.txt and its 65 locale mirrors, package.json
  and the six count-bearing SVGs now carry that number; check:docs-counts
  passes with no strict drift.
- docs/reference/PROVIDER_REFERENCE.md regenerated from the live modules.
- RESERVED_PREFIX_COUNT 412 -> 413: xKiro registers id "xkiro" with no
  separate alias, so it adds exactly one REGISTRY member.

2026-09-17 13:32:53 -03:00

docs

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

CHANGELOG.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

CLAUDE.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

CODE_OF_CONDUCT.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

CONTRIBUTING.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

GEMINI.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

llm.txt

chore(providers): reconcile the xKiro counts with the chipotle removal

2026-09-17 13:32:53 -03:00

README.md

fix(docs): re-sync the 65 documentation mirror sets; section-level docs pipeline; drift gate blocking (#13940 )

2026-09-17 02:55:31 -03:00

SECURITY.md

feat(i18n): 7 new locales — Hausa, Yoruba, Igbo, Amharic, Uzbek, Georgian, Armenian (66 locales) (#13727 )

2026-09-15 09:50:01 -03:00

README.md

README (ქართული)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

🚀 OmniRoute — უფასო AI კარიბჭე

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

💰 ~1.47B უფასო ტოკენი / თვეში

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

რეალურ დროში მოქმედი /dashboard/free-tiers გვერდის ანიმაციური შეჯამება. სრული მეთოდოლოგია (პულების დუბლირების გამორიცხვა, კრედიტების დონეები, პროვაიდერების პირობები): docs/reference/FREE_TIERS.md.

_{ეს მონაცემები მოქმედ კატალოგთან მიმართებით ყოველ ორ კვირაში ხელახლა მოწმდება და ორივე მიმართულებით იცვლება — თუ პროვაიდერი უფასო ტარიფს გააუქმებს, რიცხვი მცირდება; თუ ახალი დაემატება, იზრდება. ჩვენ ვაქვეყნებთ იმას, რასაც კატალოგი რეალურად ითვლის და არასოდეს — დამრგვალებულ საუკეთესო შესაძლო შემთხვევას.}

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

💬 შეუერთდით საზოგადოებას

👋 გამოიწერეთ პროექტის ხელმძღვანელი — პირველებმა შეიტყვეთ ახალი პროვაიდერების, გამოშვებებისა და რჩევების შესახებ:

კითხვები, რჩევები პროვაიდერების შესახებ, განვითარების გეგმა და მხარდაჭერა → Discord · Telegram · WhatsApp 🌍 გლობალური / 🇧🇷 ბრაზილია / პორტალი

📈 კარიბჭე განაგრძობს ზრდას

	v3.8.49	v3.8.50	`v3.8.51+`
🌐 პროვაიდერები	290	352	რიგში მეტია
🧠 ჩატის მოდელების უნიკალური ID-ები	1185	1312	—
🖼️ მოდალობების ხიდი	—	🆕 ხედვა + აუდიო + ვიდეო	—
📡 Radar-ის უფასო კატალოგი	—	🆕 სურვილისამებრ ჩასართავი	—
⚖️ კვოტის გათვალისწინებით დაგეგმვა	—	🆕 Quota-Share	—
📊 კვოტის ტელემეტრია	—	🆕 რეალურ დროში	—

→ სამოქმედო გეგმა — გზად v3.9.0 LTS-ისკენ

🧩 ხელმისაწვდომია

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

🌐 64 ენაზე

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

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

# ახალი ინსტალაცია, ავტორიზაციის მონაცემების გარეშე — `auto` უკვე მუშაობს:
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/}

💥 დაპირება

🤔 რატომ OmniRoute?

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

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

გსურთ, შემოგვიერთდეთ როგორც ღია კოდის მეგობარი? ეს ის კომპანიებია, რომლებიც მხარს უჭერენ ღია კოდს და OmniRoute-ის განვითარებას უწყობენ ხელს — ჩვენ კი საჯაროდ ვაცხადებთ, სად იხარჯება მათ მიერ მოწოდებული თითოეული ტოკენი. დაგვიკავშირდით: 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 არის ფასის მიხედვით რანჟირებული კარიბჭე, რომელიც ერთ OpenAI-თან თავსებადი endpoint-ის უკან 42 მოწინავე მოდელს — Claude-ს, GPT-5.x-ს, Gemini-ს, Kimi K3-ს, GLM-ს, DeepSeek-ს, Grok-სა და MiniMax-ს — ხელახლა ყიდის და თითოეულ მოთხოვნას ყველაზე იაფ შესაბამის პროვაიდერთან მიმართავს ისე, რომ მოდელის შემქმნელის ოფიციალურ ფასზე მეტს არასოდეს გაკისრებთ.

სრულფასოვანი მხარდაჭერა OmniRoute-ში: Chat Completions, მშობლიური /v1/responses endpoint, ხედვა, ხელსაწყოების გამოძახება და 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-ის მომხმარებლებს გამოადგება? გახსენით issue და მას აქ დავამატებთ.}

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

კომბოს მარშრუტიზაციის 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.}

🧱 მდგრადობა ჩაშენებულია (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 ან რეჟიმთან დაკავშირებული უარყოფა მხოლოდ იმ მოდელს ბლოკავს — არასოდეს მთელ კავშირს. საბოლოო მდგომარეობები (აკრძალული, ვადაგასული, კრედიტები ამოწურულია) განკუთვნილია ოპერატორისთვის და არა დაყოვნების მექანიზმისთვის.

_{📖 ავტოკომბინაციის ძრავა · მდგრადობის სახელმძღვანელო}

🏆 რით გამოირჩევა OmniRoute

_{📊 სრული მეთოდოლოგია და თითოეული ფუნქციის დეტალური შედარება 9router-თან, OpenRouter-თან, CLIProxyAPI-სა და LiteLLM-თან → 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 — მყისიერი, საკომისიოს გარეშე (ბრაზილია)

გასაღები (შემთხვევითი): 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`

_{⚠️ თითოეული მონეტა გაგზავნეთ მხოლოდ მითითებულ ქსელში — არასწორ ქსელში გაგზავნამ შეიძლება თანხის დაკარგვა გამოიწვიოს.}

🐛 იპოვეთ შეცდომა ან გაქვთ უკუკავშირი? გახსენით დისკუსია.

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

📡 OmniRoute Radar

უფასო დონის მთავარი მაჩვენებელი კვლავ შეადგენს ~1.47B ტოკენს/თვეში ზემოთ აღწერილი, პულების მიხედვით დუბლიკატებისგან გაწმენდილი კატალოგიდან. პროვაიდერების რეგისტრაციის დროებით კრედიტებს შეუძლია, ცალკე, პირველი თვის მაჩვენებელი ~2.10B-მდე გაზარდოს. Radar არის არასავალდებულო, ხელმოწერილი კატალოგის დამატებითი ფენა მათთვის, ვისაც OmniRoute-ის გამოშვებებს შორის უფასო მოდელების ხელმისაწვდომობის შესახებ უფრო ახალი ინფორმაცია სურს; საზოგადოების კატალოგი და ყველა არსებული უფასო ფუნქცია კვლავ უფასოა.

მხარდამჭერებს შეუძლიათ მიიღონ ცოცხალი კატალოგი და პროვაიდერების დამატებითი შესაძლებლობები. მისი ცალკეული, ცვალებადი ზედა ზღვარი არის მაქსიმუმ დაახლოებით 3B ტოკენი/თვეში, პროვაიდერების ხელმისაწვდომობის მიხედვით. ეს ზედა ზღვარი გარანტირებული არ არის: პროვაიდერებს ნებისმიერ დროს შეუძლიათ შეცვალონ კვოტები, დასაშვებობის პირობები, მოდელები ან რეგიონები.

Radar ნებაყოფლობითია და მხოლოდ GET-მოთხოვნებს იყენებს. OmniRoute-ის კლიენტი არ ატვირთავს მოთხოვნებს, ტრაფიკს, პროვაიდერის კონფიგურაციას, გამოყენების ტელემეტრიას ან განცხადების დახურვის მდგომარეობის ადგილობრივ მონაცემებს. დასაშვებობის პირობებისა და მიმდინარე კატალოგის შესახებ იხილეთ radar.omniroute.online/planos.

✨ რა არის ახალი

ბოლო მნიშვნელოვანი ცვლილებები v3.8.20 → v3.8.50 ვერსიებში. სრული ისტორია იხილეთ CHANGELOG.md-ში.

🎛️ OmniConductor — შემომავალი A2A დელეგირება თქვენი აგენტების ფლოტისთვის, Conductor-ის უნარები Agent Card-ზე და დაფის პანელი Faro-ს push-to-talk ხმოვანი ჩატით. → A2A სერვერი
🛂 ადაპტიური დაშვება და გადატვირთვისგან დაცვა — რესურსტევადი ჩატის მოთხოვნები 503 შეცდომის დაბრუნების ნაცვლად რიგში დგება, თითოეული კავშირისთვის ატომური RPM მცოცავი ლიზებით. → მდგრადობის სახელმძღვანელო
🗂️ კანონიკური /v1/models დალაგება — თითოეული პროვაიდერისთვის ერთი უწყვეტი, პროვაიდერის მიხედვით დაჯგუფებული ბლოკი (კომბინაციები პირველ ადგილზეა დამაგრებული), სტაბილური ყველა კატალოგის წყაროში. → API ცნობარი
🗜️ შეკუმშვის გაძლიერებული დაცვა — ნაგულისხმევად ჩართული ინფლაციისგან დამცავი მექანიზმი, Caveman-ის პაკეტები DE / FR / JA + ჩინურისთვის (wényán), RTK ფილტრები Gradle-ისა და .NET-ისთვის. → შეკუმშვა
💸 გამჭვირვალე ფიქსირებული ტარიფის ღირებულება — გამოწერის / კოდირების გეგმის პროვაიდერებისთვის ხარჯების ანალიტიკაში ნაჩვენებია $0; ბიუჯეტის, კვოტისა და მარშრუტიზაციის შეფასება გრძელდება. → API ცნობარი
⚖️ კვოტის წილის მარშრუტიზაცია — საზიარო ანგარიშის კვოტა სამართლიანად ნაწილდება გაერთიანებულ გასაღებებს შორის და რესურსის ეფექტიანად გამოყენებისთვის უმოქმედო წილები დროებით სხვებს გადაეცემა. → მდგრადობის სახელმძღვანელო
🤖 CLI-ის/აგენტის დაყენება ერთი ბრძანებით — 13 რეგისტრირებული setup-* ბრძანება; omniroute run უშვებს 7 CLI-ს (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); omniroute configure მხარს უჭერს 10 სამიზნეს, ინტერაქტიული პროვაიდერისა და მოდელის ამომრჩევლით და თითოეული კონტექსტისთვის რჩეულებით. → CLI ინტეგრაციები
🛰️ დისტანციური რეჟიმი — მართეთ დისტანციური OmniRoute შეზღუდული მოქმედების ტოკენებით (connect / contexts / tokens) და antigravity OAuth დამხმარით VPS ინსტალაციებისთვის. → დისტანციური რეჟიმი
🧭 უფრო ჭკვიანი ავტომარშრუტიზაცია — auto/<category>:<tier> კომბინაციები, Fusion (მოდელების პანელი + შემფასებელი), ამოცანის გათვალისწინებით მარშრუტიზაცია, თითოეული მოთხოვნისთვის მოდელის / რეჟიმის / USD ბიუჯეტის გადაწერა. → Auto-Combo
🗜️ გაფართოებადი შეკუმშვა — 12 კომპოზირებადი ძრავა + Compression Studios: LLMLingua-2, ორდონიანი Ultra, omniglyph, თითოეული ნაბიჯის სიზუსტის შემოწმება, GCF v3.2, გადაადგილებით დალაგების რედაქტორი. → შეკუმშვა
🕵️ გამჭვირვალე MITM გაშიფვრა (TPROXY) — იმ CLI-ების ტრაფიკის დაჭერა, რომლებიც პროქსის გარემოს ცვლადებს უგულებელყოფენ, თითოეული SNI-სთვის ცალკე CA-ითა და ნდობის საცავის ინსტალატორით. → MITM/TPROXY
💸 ხარჯების ტელემეტრია ყველგან — X-OmniRoute-* ხარჯის/გამოყენების სათაურები ყველა საბოლოო წერტილზე, cache-HIT დანაზოგის სათაური, თითოეული გასაღებისთვის USD ხარჯვის კვოტები. → API ცნობარი
🧠 მეხსიერება, რომელსაც თქვენ აკონტროლებთ — ნაგულისხმევად გამორთულია, სურვილისამებრ ჩასართავი int8 ვექტორული კვანტიზაციითა და ტიპიზებული დაძველებით, თითოეული მოთხოვნისთვის x-omniroute-no-memory. → მეხსიერება
🛡️ უსაფრთხოება — prompt-injection-ისგან დაცვა ყველა LLM მარშრუტზე (red-team ტესტების ნაკრები), სურვილისამებრ ჩასართავი ავტორიზაციის მონაცემების შენიღბვის დამცავი მექანიზმი (ორივე მიმართულებით გაჟონილ API გასაღებებს/საიდუმლოებებს ფარავს), უფასო DuckDuckGo ვებძებნა უკიდურესი საჭიროებისთვის და დაფისთვის არასავალდებულო OIDC შესვლის ბარიერი (პაროლით შესვლა ყოველთვის ხელმისაწვდომი რჩება). → დამცავი მექანიზმები
🖼️ ახალი საბოლოო წერტილები — /v1/ocr (Mistral OCR) და /v1/audio/translations (Whisper-ის სტილში) მედიის შესაძლებლობებს სრულყოფს. → API ცნობარი
🎨 სურათის / ვიდეოს / აუდიოს გენერირება — ერთი API მედიისთვის: xAI Grok Imagine და Novita AI ვიდეო, ComfyUI, Magnific, Adobe Firefly, Segmind და მეტყველების ისეთი პროვაიდერები, როგორიცაა ElevenLabs. → API ცნობარი
🌍 განთავსება და ოპერირება — უკუპროქსის basePath, ბრაუზერის ენის ავტომატური ამოცნობა, თითოეული გასაღებისთვის მოწყობილობების თვალყურის დევნება, root-ის გარეშე MITM ნდობა, zh-TW ლოკალიზაცია. → გარემო
🤝 მეტი პროვაიდერი და აგენტი — ღრუბლოვანი აგენტები (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-პროვაიდერიანი კატალოგი. → პროვაიდერები
📡 მარშრუტიზაციის გამჭვირვალობა — ყველა პასუხი შეიცავს X-OmniRoute-Decision სათაურს, რომელიც ასახელებს მის დასამუშავებლად გამოყენებულ სტრატეგიას/პროვაიდერს/დაყოვნებას; ახალი cache-optimized კომბინაციის სტრატეგია და Auto-Combo-ს cacheAffinity ფაქტორი განმეორებით მოთხოვნებს აბრუნებს იმ კავშირზე, სადაც დაკეშილი პრეფიქსია, ხოლო მხოლოდ წაკითხვისთვის განკუთვნილი /v1/auto-combo/{channel}/candidates საბოლოო წერტილი აჩვენებს auto/* არხის მიმდინარე კანდიდატთა ნაკრებს. → Auto-Combo
⚡ ლოკალური წარმადობა და ინფრასტრუქტურა — ერთი დაწკაპუნებით ლოკალური Redis, Cloudflare Workers / Deno Deploy რელეების განმთავსებლები, Bifrost და Mux ზედამხედველობის ქვეშ მყოფ ჩაშენებულ სერვისებად. → ჩაშენებული სერვისები
🧩 ასევე კომპლექტში — პლაგინების ფრეიმვორკი + მარკეტფლეისი, Omni/Agent/GitHub უნარების ფრეიმვორკები, Obsidian საცავის ინტეგრაცია (22 MCP ხელსაწყო), OpenAI-თან თავსებადი Batch და Files API-ები, პასუხების სემანტიკური კეში, გეიმიფიკაცია ლიდერთა ცხრილებით, ACP აგენტების აღმოჩენა (15 ჩაშენებული აგენტი), ჟურნალების დაგეგმილი ექსპორტი BigQuery-ში, auto/chaos ხარვეზების ინექცია, Telegram ბოტის ხიდი, აპში ჩაშენებული ვერსიების მენეჯერი და LMArena-ELO-ს უფასო პროვაიდერების რეიტინგები. → დოკუმენტაცია

🤖 თავსებადი 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}	_{Agent Deck}

＋ ასევე მუშაობს შემდეგებთან · Kiro · Command Code · Antigravity · Windsurf · AMP · OpenAI-სთან თავსებადი ნებისმიერი ინსტრუმენტი

_{📖 თითოეული ხელსაწყოს კონფიგურაცია 36-ვე ხელსაწყოსთვის (26 CLI Code + 10 CLI Agent) → docs/reference/CLI-TOOLS.md · 🧩 OpenCode-ის პლაგინი → @omniroute/opencode-provider}

გაუშვით ნებისმიერი მხარდაჭერილი CLI OmniRoute-ის მეშვეობით ერთი ბრძანებით — კონფიგურაციის ფაილები არ ჩაიწერება, ავტორიზაციის მონაცემები თითოეულ პროცესში ცალკე გადაეცემა, ხოლო Qwen/Gemini მიიღებს დროებით, იზოლირებულ home-ს:

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 <host>), --dry-run შესრულების გარეშე წინასწარ აჩვენებს ზუსტ გარემოსა და არგუმენტებს, ხოლო --api-key-env NAME საიდუმლო მონაცემებს თქვენი shell-ის ისტორიაში მოხვედრისგან იცავს. → CLI ინტეგრაციები

🌐 352 AI პროვაიდერი — 152 კატალოგში მონიშნული, როგორც უფასო

352 რეგისტრირებული პროვაიდერი ჩატის, მედიის, ძიების, ლოკალური, ღრუბლოვანი აგენტებისა და სისტემის კანონიკურ კოლექციებში, მათ შორის 152 პროვაიდერი, რომელსაც აღმოჩენის მეტამონაცემებში მითითებული აქვს hasFree: true. ჩატის მოდელების რეესტრი მოიცავს 229 პროვაიდერს / პროვაიდერისა და მოდელის 2,554 უნიკალურ წყვილს / მოდელის 1,283 დაუმუშავებელ ID-ს; უფასო ბიუჯეტების ცალკე კატალოგში არის 443 მოდელის დონის ჩანაწერი, 34 განახლებადი პული და 53 განახლებადი/გასაღების არმომთხოვნი, სამუდამოდ უფასო პროვაიდერი. ეს მნიშვნელები განზრახ განსხვავებულია; განმარტებები და პულების დუბლიკატების გამორიცხვით შესრულებული გამოთვლები მოცემულია პროვაიდერების ცნობარში და უფასო ტარიფებში.

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

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

_{…და კიდევ 330+ — ყველა ხატულა რეალურ დროში იტვირთება საინფორმაციო დაფის პროვაიდერთა კატალოგიდან. 📖 პროვაიდერების ცნობარი}

🆓 სამუდამოდ უფასო — $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

🖥️ სად მუშაობს 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-ის სახელმძღვანელო · დესკტოპი · მენიუს ზოლის აპი · Termux · PWA · OpenCode}

🧩 სიახლე: OmniRoute VS Code-ის ნატიურ Copilot Chat-ში

არც ახალი გვერდითი პანელი, არც ახალი ჩატის ინტერფეისი — OmniRoute-ის მიერ მოწოდებული ყველა მოდელი პირდაპირ Copilot Chat-ის იმ მოდელების ამომრჩევში გამოჩნდება, რომელსაც უკვე იყენებთ. VS Code 1.122-დან მოყოლებული, პროვაიდერის მოდელები მუშაობს GitHub-ში შესვლისა და Copilot-ის გამოწერის გარეშე — აგენტის რეჟიმი, ხელსაწყოების გამოძახება და ხედვა, უფასოდ.

დააინსტალირეთ 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-ზე.

_{📖 VS Code Copilot Chat-ის სახელმძღვანელო — გამართვა, რას აჩვენებს ამომრჩევი, საინფორმაციო პანელი ჩანართში, პრობლემების მოგვარება}

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

omniroute serve საუკეთესოდ მუშაობს, როცა მუდამ ჩართულია. OmniRouteTray მას macOS-ის „დააყენე და დაივიწყე“ ტიპის მენიუს ზოლის აპად აქცევს: ის უშვებს სერვერს, ინარჩუნებს მის მუშაობას გადატვირთვების შემდეგაც, ადგილზე აახლებს და თქვენი ტოკენების მიმდინარე ბიუჯეტს ერთი დაწკაპუნებით გაჩვენებთ — არ არის საჭირო ტერმინალის ფანჯრის ღიად დატოვება ან npm install -g omniroute-ზე მუდმივი ზრუნვა.

Tauri v2-ზე აგებული (Rust-ის ბირთვით, რომლის ზომაც დამრგვალების ცდომილების ტოლია), ის მოიცავს საკუთარ ხელმოწერილ Node 24 გარემოს და მართავს აპის კუთვნილ OmniRoute ინსტალაციას, ამიტომ ის არასოდეს უქმნის კონფლიქტს თქვენს გლობალურ node/bun-ს. ის იყენებს თქვენს არსებულ ~/.omniroute/ კონფიგურაციასა და მონაცემთა ბაზას — ანუ ეს იგივე OmniRoute-ია, რომელსაც უკვე იყენებთ, უბრალოდ ახლა ქუდით. 🎩

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

brew install --cask zoispag/tap/omniroute-tray

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

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

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

_{📖 ავტორიზაცია · დამცავი მექანიზმები · შესაბამისობა}

🔌 სრულფასოვანი CLI + A2A და MCP

სერვერის გარდა, OmniRoute არის სრულფასოვანი ბრძანების სტრიქონის მართვის პულტი, რომელსაც აქვს 80-ზე მეტი ბრძანება და აგენტების ღია პროტოკოლები, რათა AI აგენტმა მისი მართვა დამოუკიდებლად შეძლოს.

⌨️ ნამდვილი CLI (და არა მხოლოდ `start`)

omniroute               # კარიბჭისა და მართვის პანელის გაშვება (პორტი 20128)
omniroute chat          # ინტერაქციული TUI ჩეთის კლიენტი (სლეშ-ბრძანებები: /model /combo /skill /memory)
omniroute setup         # პირველი გაშვების ინტერაქციული ოსტატი
omniroute doctor        # პროვაიდერების, პორტებისა და ნატიური დამოკიდებულებების დიაგნოსტიკა

🛰️ დისტანციური რეჟიმი — გაუშვით CLI აქ, ხოლო OmniRoute — VPS-ზე

OmniRoute სერვერზე გაქვთ? მართეთ ის თქვენი ლეპტოპიდან იმავე CLI-ით. ერთხელ გაიარეთ ავტორიზაცია შეზღუდული მოქმედების სფეროს მქონე წვდომის ტოკენით; ამის შემდეგ ყველა ბრძანება დისტანციურ სერვერზე შესრულდება.

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-ზე რჩება. _{📖 დისტანციური რეჟიმი}

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`	მართეთ დისტანციური ინსტანცია შეზღუდული მოქმედების სფეროს მქონე წვდომის ტოკენებით

# მიეცით Claude Code-ს OmniRoute-ის ინსტრუმენტების სრული ნაკრები MCP-ის მეშვეობით:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream

_{📖 MCP სერვერი · A2A სერვერი · აგენტების პროტოკოლები}

🗜️ დაზოგეთ ტოკენების 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. როდესაც ორივე ერთსა და იმავე ხელსაწყოს/კონტექსტის მონაცემებზე მოქმედებს, დანაზოგი მრავლდება:

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-ის, Caveman-ის (⭐ 90K+), LLMLingua-2-ისა და 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 რეჟიმი:

მანამდე (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: <mode>; source=<source> სათაურში.

დააყენეთ ავტომატური გააქტიურება ტოკენების ზღვრის მიხედვით, ჩართეთ ადაპტიური რეგულატორი, მიამაგრეთ სახელდებული პროფილი, მიუთითეთ ერთჯერადი პარამეტრი თითოეული მოთხოვნისთვის ან მიანიჭეთ pipeline მარშრუტიზაციის თითოეულ კომბინაციას — აირჩიეთ ის, რაც სამუშაო დატვირთვას შეესაბამება. სურვილისამებრ ჩასართავი, ოფლაინ შეფასების ინსტრუმენტი (npm run eval:compression) ცვლილების დანერგვამდე ფიქსირებულ კორპუსზე აფასებს სიზუსტესა და დანაზოგს.

📖 COMPRESSION_GUIDE.md · RTK_COMPRESSION.md · COMPRESSION_ENGINES.md

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

1) დააინსტალირეთ და გაუშვით

npm install -g omniroute
omniroute

💡 ხედავთ npm warn ERESOLVE-ს ან peer-dep გაფრთხილებებს? ისინი უვნებელია.

მართვის პანელი ხელმისაწვდომია მისამართზე http://localhost:20128 · API — მისამართზე http://localhost:20128/v1.

2) დააკავშირეთ უფასო პროვაიდერი (რეგისტრაციის გარეშე)

მართვის პანელი → პროვაიდერები → დააკავშირეთ Kiro AI (უფასო Claude, ~50 კრედიტი თვეში თითო ანგარიშზე) ან OpenCode Free (ავტორიზაციის გარეშე) → მზადაა.

3) მიუთითეთ მისამართი თქვენს პროგრამირების ხელსაწყოში

საბაზისო URL: http://localhost:20128/v1
API გასაღები: [დააკოპირეთ მართვის პანელიდან → Endpoints]
მოდელი:       auto            (ჭკვიანი მარშრუტიზაცია კონფიგურაციის გარეშე — ან ნებისმიერი პროვაიდერი/მოდელი)

4) გადაამოწმეთ, რომ მუშაობს

curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY"

სიაში თქვენი დაკავშირებული მოდელები უნდა გამოჩნდეს. 🎉 სულ ესაა — დაიწყეთ კოდის წერა, OmniRoute კი ავტომატურად შეარჩევს მარშრუტს და საჭიროებისას სათადარიგო ვარიანტზე გადაერთვება.

თუ თქვენს კლიენტს მორგებული სათაურების გაგზავნა არ შეუძლია, OmniRoute ასევე გთავაზობთ ტოკენიზებულ თავსებადობის ფსევდონიმებს:

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

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-ის გამოშვების არხები.იმიჯში ფიქსირებულია 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

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-ის სახელმძღვანელო — ოპერატიული მეხსიერება მუშაობის დროს.

Docker-ის წინასწარი გამოშვების არხი: diegosouzapw/omniroute:next და diegosouzapw/omniroute:next-web მიჰყვება მიმდინარე ნაგულისხმევ release/v* ბრენჩს. ეს ცვალებადი ტეგები განკუთვნილია მხოლოდ გამოუშვებელი შესწორებების სატესტოდ და არ არის მხარდაჭერილი საწარმოო გარემოში. იხილეთ Docker-ის გამოშვების არხები.

🥟 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 .).

# დააინსტალირეთ და გაუშვით Bun-ით
bun install
bun run dev

🛠️ საწყისი კოდიდან

cp .env.example .env && npm install
PORT=20128 npm run dev

📦 pnpm

pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute

🐧 Arch Linux (AUR)

yay -S omniroute-bin && systemctl --user enable --now omniroute.service

🔧 Nix (Flake)

# Nix flakes-ის გამოყენებით
nix develop
npm run dev

# ან devbox-ის გამოყენებით
devbox run npm run dev

📖 Docker-ის სახელმძღვანელო — Compose პროფილები, Caddy HTTPS, Cloudflare გვირაბები.

🦭 Podman

# 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 და მიჰყევით ტოპოლოგიისთვის სპეციფიკურ მონაცემთა დირექტორიის მითითებებს.

📖 Podman-ის სახელმძღვანელო — 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 ან ნელი მოწყობილობები):

OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute   # CI=1-იც გამოტოვებს მას

ყველაზე სწრაფი ინსტალაციისთვის უპირატესობა მიანიჭეთ pnpm-ს (შიგთავსზე დაფუძნებული საცავი + hard link-ები — იხილეთ ზემოთ). მართვის პანელის გარეშე, headless გაშვების გარემოსთვის გამოიყენეთ Docker-ის base პროფილი (ზემოთ) ან Termux-ის სახელმძღვანელო. 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 — 3,042,474	theopenstack — Instagram — 692,419	milesreevesai — TikTok — 620,400	Vaibhav Sisinty — YouTube — 391,109	buildwithai.club — Instagram — 347,652

#6	#7	#8	#9	#10
nivedan.ai — Instagram — 331,973	vaibhavsisinty — Instagram — 263,744	Nick Automates — YouTube Shorts — 218,174	theroshankrishna — Instagram — 186,786	midudev — TikTok — 177,800

კანონიკური მეტრიკები 2026-08-24-ისთვის: 1.029 უნიკალური ვიდეო · 11.132.922 ცნობილი ნახვა (v > 0) · 639 არხი/პროფილი ქსელების მიხედვით. დაუმუშავებელი პანელი შეიცავს 1.070 სტრიქონს; Instagram-ის 41 დუბლიკატი კანონიკური URL-ის მიხედვით ნორმალიზდა, თითოეული ვიდეოსთვის ნახვების უდიდესი რაოდენობის შენარჩუნებით.

🎬 გადაიღეთ ვიდეო OmniRoute-ის შესახებ? ბმულით გახსენით საკითხი ან დისკუსია — მას აქ გამოვაჩენთ.

📧 საზოგადოება და დახმარება

ყველაფერი ერთ სივრცეშია — გამოიწერეთ პროექტის ხელმძღვანელი, ესაუბრეთ საზოგადოებას ან გახსენით საკითხი.

არხი	სად / როგორ
💼 LinkedIn — მიჰყევით პროექტის ხელმძღვანელს	linkedin.com/in/diegosouzapw
🐙 GitHub — მიჰყევით განახლებებისა და რჩევებისთვის	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 გლობალური	შეუერთდით ჯგუფს
🟢 WhatsApp — 🇧🇷 ბრაზილია	შეუერთდით ჯგუფს
🌍 ვებსაიტი	omniroute.online
🌍 🌍StHub OmniRoute-ის საზოგადოება (უფასო)	StHub-ის პორტალი
📦 საწყისი კოდი	github.com/diegosouzapw/OmniRoute
🐛 შეცდომის შეტყობინება	გახსენით საკითხი — დაურთეთ `npm run system-info`-ის შედეგი
🤝 წვლილის შეტანა	CONTRIBUTING.md · ბრენჩებისა და გამოშვებების მოდელი · აირჩიეთ `good first issue`
💚 პროექტის მხარდაჭერა	მხარდაჭერის გზები ↑ · GitHub Sponsors

🛠️ ტექნოლოგიური სტეკი

ფენა	ტექნოლოგია
შესრულების გარემო	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) — 122 დომენური მოდული, 176 მიგრაცია
მეხსიერება	SQLite FTS5 სრულტექსტური ძიება + int8-კვანტიზებული ვექტორული ჩადგმები, ტიპიზებული დაყოვნება
სქემები	Zod 4 — MCP ხელსაწყოების შემავალი/გამომავალი მონაცემების ვალიდაცია + API კონტრაქტები
პროტოკოლები	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
ნაკადური გადაცემა	Server-Sent Events (SSE) + WebSocket ხიდი (`/v1/ws`)
შეკუმშვა	12-ძრავიანი კონვეიერი — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
ავთენტიფიკაცია და უსაფრთხოება	OAuth 2.0 (PKCE) + JWT + API გასაღებები + მოქმედების არეალით შეზღუდული MCP ავთენტიფიკაცია · AES-256-GCM შენახულ მონაცემებზე · DOMPurify
შენიღბვა	wreq-js — JA3 / JA4 TLS თითის ანაბეჭდის იმიტაცია, 3-დონიანი პროქსი
მდგრადობა	წრედის ამომრთველი, ექსპონენციალური დაყოვნება, ერთდროული მოთხოვნების მოზღვავებისგან დაცვა, ავტომატური კომბინაციების თვითაღდგენა
ჟურნალირება	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
უფასო დონეები	გაერთიანებული კატალოგი: 34 დოკუმენტირებული განმეორებადი პული / უფასო დონის 452 კატალოგიზებული ჩანაწერი
ფუნქციების გალერეა	მართვის პანელის ვიზუალური ტური ეკრანის სურათებით
კოდური ბაზის დოკუმენტაცია	დამწყებთათვის გასაგები კოდური ბაზის მიმოხილვა

🤖 პროტოკოლები და 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+-ზე მეტი კონტრიბუტორი

_{აუდიტი ჩატარდა 2026-08-24-ს გაყინულ საბაზისო ac02c5b42f ვერსიაზე და ხელახლა შემოწმდა აქტიური release/v3.8.50 შტოს ბოლო dafb4ae808 ვერსიაზე: 639 ნორმალიზებული ადამიანის Git-იდენტობა — 407 მათგანი ჩანს კომიტების ავტორად (მათ შორის პროექტის მომვლელიც), ხოლო 232 — მხოლოდ აშკარა Co-authored-by ტრეილერებში. აღრიცხვისას ნორმალიზებულია GitHub-ის noreply სახელები, გამორიცხულია 26 ბოტის/აგენტის/სერვისის/შემავსებელი იდენტობა და ჩვეულებრივი ელფოსტის მისამართები არ არის გაერთიანებული მხოლოდ იმიტომ, რომ მათი საჩვენებელი სახელები ემთხვევა.}

როგორ შეიტანოთ წვლილი

შექმენით რეპოზიტორიის fork
შექმენით შტო აქტიური release/vX.Y.Z შტოს ბოლო ვერსიიდან (არა main-იდან) — იხილეთ შტოებისა და რელიზების მოდელი
შექმენით თქვენი ფუნქციონალის შტო (git checkout -b feat/amazing-feature)
დააკომიტეთ თქვენი ცვლილებები (git commit -m 'feat: add amazing feature')
ატვირთეთ შტოში (git push origin feat/amazing-feature)
გახსენით Pull Request, სადაც base = შესაბამისი release/vX.Y.Z შტო

დეტალური მითითებებისთვის იხილეთ CONTRIBUTING.md.

ახალი ვერსიის გამოშვება

# შექმენით რელიზი — npm publish ავტომატურად შესრულდება
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

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

🌍 StarMapper

🙏 მადლობები

OmniRoute გიგანტების მხრებზე დგას. ის დაიწყო, როგორც 9router-ის fork და Go პროექტის — 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.

⬆ დასაწყისში დაბრუნება · შექმნილია ❤️-ით ღია კოდის AI-საზოგადოებისთვის.

_{OmniRoute v3.8.51 · Node ≥22.22.2 · MIT ლიცენზია · omniroute.online}

README.md Unescape Escape

README (ქართული)

🚀 OmniRoute — უფასო AI კარიბჭე

💰 ~1.47B უფასო ტოკენი / თვეში

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

💬 შეუერთდით საზოგადოებას

📈 კარიბჭე განაგრძობს ზრდას

🧩 ხელმისაწვდომია

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

💥 დაპირება

🤔 რატომ OmniRoute?

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

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

⚡ ნულოვანი კონფიგურაცია — უბრალოდ გამოიყენეთ auto

🔀 ან შექმენით საკუთარი — მარშრუტიზაციის 19 სტრატეგია

🧱 მდგრადობა ჩაშენებულია (3 დამოუკიდებელი შრე)

🏆 რით გამოირჩევა OmniRoute

💚 მხარი დაუჭირეთ OmniRoute-ს

📡 OmniRoute Radar

✨ რა არის ახალი

🤖 თავსებადი CLI-ები და კოდირების აგენტები

🌐 352 AI პროვაიდერი — 152 კატალოგში მონიშნული, როგორც უფასო

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

🆓 სამუდამოდ უფასო — $0, ბარათი არ არის საჭირო

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

🧩 სიახლე: OmniRoute VS Code-ის ნატიურ Copilot Chat-ში

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

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

🔌 სრულფასოვანი CLI + A2A და MCP

⌨️ ნამდვილი CLI (და არა მხოლოდ start)

🛰️ დისტანციური რეჟიმი — გაუშვით CLI აქ, ხოლო OmniRoute — VPS-ზე

🤝 დააკავშირეთ აგენტი — და ის თავად მართავს OmniRoute-ს

🗜️ დაზოგეთ ტოკენების 15–95% — ავტომატურად

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

🧱 12-ძრავიანი ნაკრები

🎚️ ძრავებს მიღმა — გამოტანის სტილები, ადაპტიური რეგულატორი და თითოეული მოთხოვნის მართვა

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

📦 ინსტალაციის სხვა მეთოდები — Docker, საწყისი კოდი, pnpm, Arch

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

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

📧 საზოგადოება და დახმარება

🛠️ ტექნოლოგიური სტეკი

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

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

🔧 ოპერაციები და განთავსება

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

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

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

⭐ მთავარი კონტრიბუტორები

გარე კონტრიბუტორები შერწყმული pull request-ების რაოდენობის მიხედვით

GitHub-ის მიერ მიკუთვნებული კომიტები

💖 სპონსორები

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

როგორ შეიტანოთ წვლილი

ახალი ვერსიის გამოშვება

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

🌍 StarMapper

🙏 მადლობები

🧬 წარმოშობა და gateway

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

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

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

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

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

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

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

📄 ლიცენზია

README.md

⚡ ნულოვანი კონფიგურაცია — უბრალოდ გამოიყენეთ `auto`

⌨️ ნამდვილი CLI (და არა მხოლოდ `start`)