mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-09-18 21:02:50 +03:00

Files

Diego Rodrigues de Sa e Souza c3e966eeb9 docs(changelog): reconcile the v3.8.51 living section — round 2 (2026-09-15) (#13731 )

Second `npm run release:reconcile` pass on `release/v3.8.50..release/v3.8.51`
(091589089c..c0f92ec98a, 916 non-merge commits, 877 merged PRs):

- fold the 173 changelog.d fragments accumulated since #12971 under
  `## [3.8.51]` and delete them
- generate bullets for the 58 cycle commits that had no fragment
  (4 features / 42 fixes / 12 maintenance), each with the merged PR link and
  `— thanks @author`
- link 137 fragment bullets to the PR of the commit that added them and
  credit the author; two prefix/origin mismatches reviewed (#12945→#13392,
  #13001→#13379, both maintainer rebaselines of other people's PRs)
- refresh "Release by the numbers" + Top-25 and regenerate the
  `### 🙌 Contributors` hall (112 external contributors + maintainer; every
  non-bot author of the 877 merged PRs present)
- closed-PR credit audit for the window: nothing to add (#13215→#13361 and
  #13059→#13690 are still open, #12998 was independently fixed earlier by
  #12853); no human co-author trailers, no commits without a PR
- resync the 58 i18n CHANGELOG mirrors

Gates: check:changelog-integrity OK, check:docs-sync PASS.

2026-09-17 10:47:11 -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

docs(changelog): reconcile the v3.8.51 living section — round 2 (2026-09-15) (#13731 )

2026-09-17 10:47:11 -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

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

CONTRIBUTING.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

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

fix(db): bound health scans and isolate native diagnostics (#13717 )

2026-09-16 12:59:45 -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

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

README.md

README (Tiếng Việt)

🌐 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 · 🇬🇪 ka · 🇰🇭 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 · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

🚀 OmniRoute — Cổng AI Miễn Phí

OmniRoute — Không bao giờ phải ngừng lập trình. Mọi công cụ AI → 359 nhà cung cấp — hơn 150 miễn phí — thông qua một endpoint duy nhất. Kết nối Claude Code, Codex, Cursor, Cline, Copilot & Antigravity với Claude / GPT / Gemini MIỄN PHÍ cùng khả năng tự động chuyển đổi dự phòng. Tính năng nén kết hợp RTK + Caveman giúp tiết kiệm 15–95% token (trung bình ~89%) — không bao giờ chạm giới hạn. 359 nhà cung cấp AI · hơn 150 gói miễn phí · ~1,47 tỷ token miễn phí/tháng · 19 chiến lược định tuyến · bắt đầu với $0.

💰 ~1.47B Token Miễn phí / Tháng

Việc gộp các gói miễn phí theo cách thủ công rất phiền phức — hàng chục SDK, hàng chục giới hạn tốc độ và không thể biết chính xác bạn thực sự có bao nhiêu. OmniRoute lập danh mục 452 mục gói miễn phí trên 34 khóa nhóm định kỳ và tính toán con số token nổi bật từ 16 nhóm có ngân sách hằng tháng dương được công bố cùng năm hạn mức Groq theo từng mô hình, đồng thời loại bỏ trùng lặp theo nhóm dùng chung. Các hạn ngạch chỉ được mở sau khi xác minh danh tính theo khu vực (hiện tại: ModelScope) được hiển thị riêng, +~6M sau bước xác minh danh tính theo khu vực và không bao giờ được cộng vào con số nổi bật. Kết quả luôn hiển thị trên bảng điều khiển (/dashboard/free-tiers).

Thẻ ngân sách gói miễn phí của OmniRoute: ~1.47B token miễn phí ổn định mỗi tháng, lên đến ~2.07B trong tháng đầu tiên nhờ tín dụng đăng ký, từ 34 khóa nhóm định kỳ đã được ghi nhận, bao phủ 452 mục gói miễn phí trong danh mục phía sau một endpoint duy nhất. Phép tính minh bạch đã loại bỏ trùng lặp theo nhóm — mỗi nhóm dùng chung chỉ được tính một lần, bao gồm 16 nhóm định kỳ có ngân sách token hằng tháng dương được công bố cùng năm hạn mức Groq theo từng mô hình; 13 nhà cung cấp được đánh dấu nên tránh trong danh mục rủi ro điều khoản để bạn tự quyết định. Thanh ngân sách bao gồm Mistral 1B, Nara 210M, LLM7 150M, Groq 30M (năm hạn mức theo từng mô hình) và các nhóm nhỏ hơn, cùng với tín dụng đăng ký trong tháng đầu tiên và các nhà cung cấp miễn phí vĩnh viễn không có hạn mức token được hiển thị riêng để không bao giờ làm tăng sai lệch con số nổi bật. Lượng đã dùng/còn lại theo thời gian thực tại /dashboard/free-tiers.

Bản tóm tắt động của trang /dashboard/free-tiers trực tiếp. Phương pháp đầy đủ (loại bỏ trùng lặp theo nhóm, các bậc tín dụng, điều khoản của nhà cung cấp): docs/reference/FREE_TIERS.md.

_{Các số liệu này được kiểm toán lại hai tuần một lần dựa trên danh mục trực tiếp và có thể thay đổi theo cả hai chiều — khi một nhà cung cấp kết thúc gói miễn phí, con số sẽ giảm; khi có nhà cung cấp mới, con số sẽ tăng. Chúng tôi công bố đúng những gì danh mục thực sự tính toán, không bao giờ làm tròn lên theo kịch bản tốt nhất.}

⭐ Hãy gắn sao cho kho mã nếu OMNIROUTE đã giúp bạn tiết kiệm tiền và làm việc dễ dàng hơn.

💬 Tham gia cộng đồng

👋 Theo dõi người bảo trì — nhận thông tin về nhà cung cấp mới, bản phát hành và mẹo sớm nhất:

Câu hỏi, thông tin về nhà cung cấp, lộ trình và hỗ trợ → Discord · Telegram · WhatsApp 🌍 Toàn cầu / 🇧🇷 Brasil / Cổng thông tin

📈 Gateway Không Ngừng Phát Triển

	v3.8.49	v3.8.50	`v3.8.51+`
🌐 Nhà cung cấp	290	352	còn nhiều hơn trong hàng đợi
🧠 ID mô hình chat duy nhất	1185	1312	—
🖼️ Cầu nối phương thức	—	🆕 hình ảnh + âm thanh + video	—
📡 Danh mục miễn phí Radar	—	🆕 tùy chọn tham gia	—
⚖️ Lập lịch theo hạn ngạch	—	🆕 Quota-Share	—
📊 Dữ liệu đo lường hạn ngạch	—	🆕 theo thời gian thực	—

→ Lộ trình — tiến thẳng tới v3.9.0 LTS

🧩 Khả dụng

🚀 Bắt đầu	🚀 Bắt đầu nhanh	📦 Cài đặt	🆓 Không cần cấu hình
💡 Tìm hiểu	💥 Cam kết	🤔 Tại sao chọn OmniRoute	🏆 Điểm khác biệt
⚙️ Tính năng	🎯 Combo	🌐 Nhà cung cấp	🔌 CLI & MCP
	🗜️ Nén	🖥️ Nơi có thể chạy	🔒 Riêng tư
👀 Xem thử	🎬 Hoạt động thực tế	✨ Có gì mới	🤖 CLI tương thích
💚 Hỗ trợ	💚 Hỗ trợ / Quyên góp	💬 Cộng đồng	💖 Nhà tài trợ
📦 Dự án	🛠️ Ngăn xếp công nghệ	📖 Tài liệu	👥 Người đóng góp

🌐 Có sẵn bằng 66 ngôn ngữ

🆓 Hoạt động ngay sau khi cài đặt — không cần khóa, không cần cấu hình

Hoạt động ngay sau khi cài đặt — không cần cấu hình. Ba bước: 1. Cài đặt — npm i -g omniroute, máy chủ khởi động tại localhost:20128. 2. Trỏ công cụ của bạn đến http://localhost:20128/v1 — bất kỳ công cụ nào tương thích với OpenAI (Claude Code, Cursor, Cline). 3. Nhận phản hồi — gọi model auto để có câu trả lời tức thì mà không cần khóa API, đăng ký hay cấu hình. Nhà cung cấp không cần khóa OpenCode Free đã được tích hợp sẵn vào tổ hợp auto, vì vậy bản cài đặt mới có thể phản hồi ngay lập tức.

# Cài đặt mới, không cần thông tin xác thực — `auto` đã hoạt động:
curl http://localhost:20128/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}'

_{Muốn dùng một backend miễn phí cụ thể? Hãy gọi trực tiếp oc/… (OpenCode Free). Sau đó chuyển sang auto và để OmniRoute tự lựa chọn.}

_{📦 Các tập lệnh bắt đầu nhanh có thể sao chép-dán dành cho Python, Node.js, PHP và cURL → examples/quickstart/}

💥 Cam kết

🤔 Tại sao chọn OmniRoute?

Luồng yêu cầu OmniRoute: IDE hoặc CLI của bạn (Claude Code, Cursor, Cline…) gọi một endpoint cục bộ duy nhất (http://localhost:20128/v1); Bộ định tuyến thông minh OmniRoute (nén RTK + Caveman, 19 chiến lược định tuyến, bộ ngắt mạch, ẩn mình TLS, MCP, A2A, rào chắn) có thể chuyển sang phương án dự phòng trên 4 tầng nhà cung cấp miễn là vẫn còn một đích đủ điều kiện và hoạt động tốt — Tầng 1 Gói đăng ký, Tầng 2 Khóa API, Tầng 3 Giá rẻ và Tầng 4 Miễn phí.

🤝 Được hỗ trợ bởi những Người bạn Mã nguồn Mở của chúng tôi

Bạn muốn tham gia với tư cách Người bạn Mã nguồn Mở? Đây là những công ty ủng hộ mã nguồn mở và giúp OmniRoute tiếp tục phát triển — đồng thời chúng tôi công khai mục đích sử dụng của mọi token mà họ cung cấp. Hãy liên hệ: diegosouza.pw@outlook.com

Kimi
_{Moonshot AI} Xin cảm ơn Kimi (Moonshot AI), Người bạn Mã nguồn Mở sáng lập của chúng tôi, vì đã ủng hộ dự án này! Kimi là phòng thí nghiệm AI đứng sau các dòng mô hình trọng số mở K2 và K3 — Kimi K3 cung cấp cửa sổ ngữ cảnh 1 triệu token, khả năng thị giác nguyên bản và năng lực lập trình ở cấp độ tiên phong với chi phí chỉ bằng một phần nhỏ so với các mô hình đóng, đồng thời hoạt động ngay lập tức với Claude Code, Codex và mọi công cụ lập trình mà OmniRoute phục vụ.

Sự hỗ trợ của Kimi mang lại điều gì: Tín dụng API của Kimi vận hành quy trình phát hành được AI xác thực của OmniRoute — giai đoạn xác thực hợp nhất do Kimi K3 hỗ trợ, nơi mọi pull request đều được xem xét trước khi phát hành — cùng với hoạt động phát triển tính năng hằng ngày. Hỗ trợ hạng nhất dành cho Kimi được cung cấp trên cả hai phương thức: Kimi API trực tiếp (kimi-k3) và gói lập trình Kimi Code (OAuth và khóa API). OmniRoute cũng là dự án mã nguồn mở đầu tiên của Brazil tham gia chương trình hỗ trợ của Kimi. Nhận khóa Kimi API kèm thêm 15% tín dụng →

Cheaper Inference
_{cheaperinference.com} Xin cảm ơn Cheaper Inference, một Người bạn Mã nguồn Mở của OmniRoute, vì đã ủng hộ dự án này! Cheaper Inference là một cổng được xếp hạng theo chi phí, bán lại 42 mô hình tiên phong — Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok và MiniMax — thông qua một điểm cuối tương thích với OpenAI duy nhất, định tuyến từng yêu cầu đến nhà cung cấp đủ điều kiện có giá rẻ nhất mà không bao giờ tính phí cao hơn giá niêm yết của nhà sản xuất mô hình.

Hỗ trợ hạng nhất trong OmniRoute: Chat Completions, điểm cuối /v1/responses nguyên bản, thị giác, gọi công cụ và 3 mô hình hình ảnh (grok-imagine, nano-banana-pro, nano-banana-2, có thể truy cập dưới dạng cheaperinference/<model>). Nhận khóa API →

_{Các liên kết được gắn thẻ aff=omniroute là liên kết đối tác. Chúng tài trợ cho dự án mà không làm phát sinh thêm chi phí cho bạn.}

_{🎟️ Khuyến mãi liên kết — phiếu ưu đãi đăng ký miễn phí từ các nhà cung cấp không tài trợ cho chúng tôi (nhấp để mở rộng)}

_{Phần này chỉ dành cho mã giới thiệu/phiếu ưu đãi. Các mối quan hệ đối tác được tài trợ nằm trong phần 🤝 Được hỗ trợ bởi những Người bạn Mã nguồn Mở của chúng tôi ở trên. OmniRoute không có quan hệ tài trợ hoặc đối tác với các nhà cung cấp được liệt kê tại đây — đây là các phiếu ưu đãi công khai mà bất kỳ ai cũng có thể sử dụng.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — đăng ký qua liên kết giới thiệu · $100 tín dụng miễn phí khi đăng ký (máy chủ miễn phí, có thể có độ trễ cao hơn — phù hợp nhất để thử nghiệm, không dành cho môi trường production). Được hỗ trợ hạng nhất trong OmniRoute kể từ v3.8.50: Chat Completions, định dạng truyền tương thích với Anthropic và đường dẫn tương thích với OpenAI. Các mô hình có sẵn bao gồm claude-opus-4-8, claude-opus-5, gpt-5.6-sol và nhiều mô hình khác. Nhận $100 của bạn →}

_{⚠️ Liên kết liên kết — OmniRoute không có quan hệ tài trợ hoặc đối tác với nhà cung cấp này.}

_{Bạn biết nhà cung cấp nào khác có phiếu ưu đãi đăng ký miễn phí hào phóng, mang lại lợi ích cho người dùng OmniRoute không? Hãy mở một issue và chúng tôi sẽ thêm nhà cung cấp đó vào đây.}

🎯 Combo — Tính năng chủ lực

Ảnh động minh họa toàn bộ 19 chiến lược định tuyến combo — mỗi ô tương ứng với một chiến lược: 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. Xem bảng phía trên để biết chức năng của từng chiến lược.

Combo là một chuỗi mô hình mà OmniRoute định tuyến qua tự động. Nếu hết hạn mức, nhà cung cấp gặp sự cố hoặc chi phí tăng đột biến, combo có thể chuyển sang mô hình đủ điều kiện và hoạt động ổn định tiếp theo. 🛡️

⚡ Không cần cấu hình — chỉ cần dùng `auto`

Không cần tạo combo. Đặt mô hình thành auto (hoặc một biến thể) và OmniRoute sẽ xây dựng một combo ảo từ các nhà cung cấp đã kết nối của bạn, được chấm điểm theo thời gian thực:

ID mô hình	Mục tiêu tối ưu hóa
`auto`	🎯 Mặc định cân bằng (LKGP — duy trì nhà cung cấp hoạt động tốt gần nhất)
`auto/coding`	🧑💻 Trọng số ưu tiên chất lượng cho việc sinh mã
`auto/fast`	⚡ Ưu tiên độ trễ thấp nhất
`auto/cheap`	💰 Ưu tiên chi phí thấp nhất trên mỗi token
`auto/offline`	🔋 Ưu tiên phần hạn mức / giới hạn tốc độ còn dư nhiều nhất
`auto/smart`	🔭 Ưu tiên chất lượng + 10% thăm dò để tìm các mô hình tốt hơn
`auto/lkgp`	📌 Duy trì rõ ràng nhà cung cấp hoạt động tốt gần nhất
`auto/chaos`	🧪 Trọng số chèn lỗi để kiểm thử khả năng phục hồi (chaos engineering)

🔀 Hoặc tự xây dựng — 19 chiến lược định tuyến

Toàn bộ 19 chiến lược — kết hợp linh hoạt ở từng bước của combo:

#	Chiến lược	Chức năng
1	`priority`	Danh sách có thứ tự ưu tiên mục tiêu đầu tiên — dùng hết từng mục tiêu trước khi chuyển sang mục tiêu tiếp theo 🥇
2	`fill-first`	Dùng hết hạn mức của từng mục tiêu trước khi chuyển tiếp
3	`weighted`	Chọn ngẫu nhiên có trọng số theo trọng số của từng mục tiêu
4	`round-robin`	Luân phiên qua các mục tiêu theo thứ tự
5	`p2c`	Cân bằng tải ngẫu nhiên theo phương pháp chọn hai mục tiêu
6	`least-used`	Chọn mục tiêu có tải hiện tại thấp nhất
7	`random`	Chọn ngẫu nhiên đồng đều (loại bỏ mục trùng lặp)
8	`strict-random`	Chọn ngẫu nhiên mà không loại bỏ các lần lặp lại 🎲
9	`cost-optimized`	Giảm thiểu chi phí $ cho mỗi yêu cầu dựa trên giá trực tiếp trong danh mục 💸
10	`headroom`	Chọn mục tiêu có hạn mức còn lại nhiều nhất
11	`reset-window`	Ưu tiên mục tiêu có khoảng thời gian hạn mức được đặt lại sớm nhất
12	`reset-aware`	Xếp hạng theo thời điểm đặt lại hạn mức — ưu tiên khoảng thời gian ngắn 📊
13	`context-relay`	Chuyển giao ngữ cảnh giữa các mục tiêu cho những cuộc hội thoại dài 🧠
14	`context-optimized`	Chọn mục tiêu phù hợp nhất với kích thước ngữ cảnh hiện tại
15	`cache-optimized`	Gắn từng tiền tố prompt có thể tái sử dụng vào cùng một tài khoản — tối đa hóa số lần truy cập thành công vào bộ nhớ đệm prompt 🎯
16	`lkgp`	Đường dẫn hoạt động tốt gần nhất — gắn với nhà cung cấp thành công gần nhất, sau đó chuyển dự phòng theo các quy tắc
17	`auto`	Chấm điểm trực tiếp dựa trên 16 yếu tố trên mọi kết nối 🤖
18	`fusion`	Phân phối đến một nhóm mô hình + một mô hình giám khảo tổng hợp thành một câu trả lời 🧬
19	`pipeline`	Chuỗi các bước — đầu ra của mỗi mục tiêu được chuyển vào mục tiêu tiếp theo 🔗

_{Công cụ Auto-Combo chấm điểm từng ứng viên dựa trên 16 yếu tố (tình trạng hoạt động, hạn mức, chi phí, độ trễ, mức độ phù hợp với tác vụ, chất lượng, tính khả dụng của phiên…) — xem docs/routing/AUTO-COMBO.md.}

🧱 Khả năng phục hồi được tích hợp sẵn (3 lớp độc lập)

Khả năng phục hồi của OmniRoute — 3 lớp tự phục hồi độc lập, đúng lớp cho đúng lỗi. Lớp 1: bộ ngắt mạch nhà cung cấp (toàn bộ nhà cung cấp): chỉ kích hoạt khi gặp 408/5xx, ngưỡng OAuth 8× / API-key 12× / cục bộ 2×, đặt lại sau 60s/30s/15s để chuyển sang thăm dò HALF-OPEN, phục hồi trì hoãn; khi ở trạng thái OPEN, tổ hợp sẽ định tuyến lại đến nhà cung cấp tiếp theo. Lớp 2: thời gian chờ kết nối (một khóa/tài khoản): cơ sở 5s với OAuth / 3s với API-key, thời gian chờ tăng theo cấp số nhân ×2 với cơ chế chống hiệu ứng đám đông, 429 tuân theo Retry-After, khi thành công sẽ xóa toàn bộ trạng thái lỗi; một khóa đang trong thời gian chờ sẽ bị bỏ qua trong khi các khóa cùng cấp vẫn tiếp tục phục vụ. Lớp 3: khóa mô hình (một mô hình): lỗi 429 theo từng mô hình, lỗi 404 cục bộ hoặc từ chối chế độ chỉ khóa mô hình đó — không bao giờ khóa toàn bộ kết nối. Các trạng thái kết thúc (bị cấm, hết hạn, cạn tín dụng) dành cho người vận hành xử lý, không phải thời gian chờ.

_{📖 Công cụ Auto-Combo · Hướng dẫn về khả năng phục hồi}

🏆 Điều gì khiến OmniRoute khác biệt

Điều khiến OmniRoute khác biệt — ảnh chụp tính năng tại một thời điểm so với 9router, OpenRouter, CLIProxyAPI và LiteLLM trên 13 khả năng. OmniRoute: 359 nhà cung cấp, tích hợp sẵn hơn 150 gói miễn phí, 19 chiến lược định tuyến, nén token với 12 công cụ, máy chủ MCP tích hợp với 110 công cụ, giao thức tác nhân A2A, bộ nhớ liên tục, các biện pháp bảo vệ, tác nhân đám mây, che giấu dấu vân tay TLS, Desktop/Termux/PWA và giao diện hỗ trợ 42 ngôn ngữ. OmniRoute được cấp phép theo MIT và có thể tự lưu trữ. Khả năng và số liệu của các đối thủ có thể thay đổi; hãy xem phương pháp được liên kết.

_{📊 Phương pháp đầy đủ & thông tin chi tiết theo từng tính năng so với 9router, OpenRouter, CLIProxyAPI & LiteLLM → docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md}

💚 Hỗ trợ OmniRoute

OmniRoute được cấp phép theo MIT và được duy trì công khai. Nếu dự án giúp bạn tiết kiệm thời gian hoặc tiền bạc, đây là cách để giúp dự án duy trì tính độc lập — hãy chọn phương thức phù hợp với bạn. Việc tài trợ không bao giờ ảnh hưởng đến mức độ ưu tiên định tuyến; nó mang lại khả năng hiển thị, không phải thứ hạng.

⭐ Gắn sao cho kho mã nguồn	Miễn phí — thực sự giúp tăng khả năng hiển thị	Gắn sao cho OmniRoute
🐙 GitHub Sponsors	Một lần hoặc hằng tháng · không mất phí nền tảng	github.com/sponsors/diegosouzapw
☕ Ko-fi	Ủng hộ nhanh một lần, người ủng hộ không cần đăng ký	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	Một cử chỉ nhỏ, không trang trọng	buymeacoffee.com/diegosouzapw
🖐 Liberapay	Định kỳ · phi lợi nhuận · mã nguồn mở	liberapay.com/diegosouzapw
🇧🇷 PIX (Brazil)	Tức thì, không mất phí	khóa & mã QR bên dưới
₿ Tiền mã hóa	BTC · ETH · USDT-TRC20 · USDC-Solana	địa chỉ bên dưới

🇧🇷 PIX — tức thì, không mất phí (Brazil)

Khóa (ngẫu nhiên): 5d865059-bc44-483a-962d-43ceb80126eb

Pix sao chép và dán:

00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD

₿ Tiền mã hóa — BTC · ETH · USDT-TRC20 · USDC-Solana (nhấp để mở rộng)

₿ BTC	Bitcoin (SegWit)	`bc1qh00smz004sy85wyl28v77tenkt3ckl6eaep7fd`
Ξ ETH	Ethereum (ERC20)	`0x64Cf6B68A6Ff34288e89172950a2d00102337a84`
₮ USDT	Tron (TRC20)	`TKAF41JpuQrHbKTnsQa9svJE2T192Hvsc2`
$ USDC	Solana	`2emNNZzVVWQc3FQ2wk9M6qXUQmW8AKdjjL174fXR28Tu`

_{⚠️ Chỉ gửi từng loại tiền trên đúng mạng được hiển thị — gửi sai mạng có thể làm mất tiền.}

🐛 Bạn phát hiện lỗi hoặc có phản hồi? Hãy mở một Thảo luận.

Ghi chú dành cho nhà phát triển: Dự án có thể tạo tệp .env cục bộ trong quá trình npm install/postinstall để thuận tiện cho nhà phát triển. Tệp này được chủ ý bỏ qua thông qua .gitignore (xem .gitignore) và tuyệt đối không được commit — nếu vô tình commit, hãy thay đổi mọi thông tin bí mật đã bị lộ và xóa tệp khỏi lịch sử. Xem docs/DEVELOPER-ENVIRONMENT.md để biết hướng dẫn về cách quản lý các tệp môi trường cục bộ và thông tin bí mật.

📡 OmniRoute Radar

Tiêu điểm chính của gói miễn phí vẫn là ~1.47B token/tháng từ danh mục đã được lập tài liệu và loại bỏ trùng lặp giữa các nhóm ở trên. Các khoản tín dụng đăng ký tạm thời từ nhà cung cấp có thể giúp nâng riêng tháng đầu tiên lên ~2.07B. Radar là một lớp phủ danh mục tùy chọn, có chữ ký, dành cho những người muốn cập nhật nhanh hơn về tình trạng sẵn có của các mô hình miễn phí giữa các bản phát hành OmniRoute; danh mục cộng đồng và mọi tính năng miễn phí hiện có vẫn hoàn toàn miễn phí.

Người ủng hộ có thể nhận danh mục trực tiếp và các cơ hội bổ sung từ nhà cung cấp. Mức trần riêng biệt, có thể thay đổi của danh mục này là tối đa khoảng 3B token/tháng, tùy thuộc vào tình trạng sẵn có của nhà cung cấp. Mức trần đó không phải là sự bảo đảm: các nhà cung cấp có thể thay đổi hạn ngạch, điều kiện đủ tư cách, mô hình hoặc khu vực bất kỳ lúc nào.

Radar là tính năng tùy chọn tham gia và chỉ sử dụng GET. Ứng dụng OmniRoute không tải lên prompt, lưu lượng truy cập, cấu hình nhà cung cấp, dữ liệu đo từ xa về mức sử dụng hoặc trạng thái ẩn thông báo cục bộ. Tìm hiểu về điều kiện đủ tư cách và danh mục hiện tại tại radar.omniroute.online/planos.

✨ Có gì mới

Những điểm nổi bật gần đây từ v3.8.20 → v3.8.50. Toàn bộ lịch sử có trong CHANGELOG.md.

🎛️ OmniConductor — ủy quyền A2A đầu vào cho đội tác nhân của bạn, các kỹ năng Conductor trên Agent Card và bảng điều khiển với tính năng trò chuyện thoại nhấn-để-nói Faro. → Máy chủ A2A
🛂 Kiểm soát tiếp nhận thích ứng & bảo vệ quá tải — các yêu cầu trò chuyện nặng được đưa vào hàng đợi thay vì trả về lỗi 503, với lease cuộn RPM nguyên tử cho mỗi kết nối. → Hướng dẫn về khả năng phục hồi
🗂️ Thứ tự /v1/models chuẩn hóa — mỗi nhà cung cấp có một khối liền mạch được nhóm riêng (các combo được ghim lên đầu), ổn định trên mọi nguồn danh mục. → Tài liệu tham khảo API
🗜️ Tăng cường độ an toàn của tính năng nén — cơ chế bảo vệ chống bung nén được bật mặc định, các gói Caveman cho DE / FR / JA + tiếng Trung (wényán), bộ lọc RTK cho Gradle & .NET. → Nén
💸 Chi phí gói cố định trung thực — các nhà cung cấp theo gói đăng ký / gói lập trình hiển thị chi phí là $0 trong phân tích chi phí; ngân sách, hạn ngạch & định tuyến vẫn tiếp tục ước tính. → Tài liệu tham khảo API
⚖️ Định tuyến Quota-Share — phân chia công bằng hạn ngạch của một tài khoản dùng chung giữa các khóa được gộp, đồng thời duy trì hiệu quả sử dụng bằng cách cho mượn các phần hạn ngạch đang nhàn rỗi. → Hướng dẫn về khả năng phục hồi
🤖 Thiết lập CLI/tác nhân bằng một lệnh — 13 lệnh setup-* đã đăng ký; omniroute run khởi chạy 7 CLI (Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI); omniroute configure hỗ trợ 10 đích với bộ chọn nhà cung cấp+mô hình tương tác và các mục yêu thích theo từng ngữ cảnh. → Tích hợp CLI
🛰️ Chế độ từ xa — điều khiển một OmniRoute từ xa bằng các token có phạm vi (connect / contexts / tokens) + trình trợ giúp OAuth antigravity dành cho cài đặt trên VPS. → Chế độ từ xa
🧭 Tự động định tuyến thông minh hơn — các combo auto/<category>:<tier>, Fusion (hội đồng mô hình + giám khảo), định tuyến nhận biết tác vụ, ghi đè mô hình / chế độ / ngân sách USD theo từng yêu cầu. → Auto-Combo
🗜️ Nén có thể mở rộng bằng mô-đun — 12 engine có thể kết hợp + Compression Studios: LLMLingua-2, Ultra hai tầng, omniglyph, cổng kiểm tra độ trung thực theo từng bước, GCF v3.2, trình chỉnh sửa kéo-thả để sắp xếp lại. → Nén
🕵️ Giải mã MITM trong suốt (TPROXY) — thu nhận lưu lượng từ các CLI bỏ qua biến môi trường proxy, với CA theo từng SNI + trình cài đặt kho tin cậy. → MITM/TPROXY
💸 Đo lường chi phí ở mọi nơi — các header chi phí/mức sử dụng X-OmniRoute-* trên mọi endpoint, header khoản tiết kiệm do cache-HIT, hạn ngạch chi tiêu USD theo từng khóa. → Tài liệu tham khảo API
🧠 Bộ nhớ do bạn kiểm soát — tắt theo mặc định, tùy chọn bật lượng tử hóa vector int8 + cơ chế suy giảm theo kiểu, x-omniroute-no-memory theo từng yêu cầu. → Bộ nhớ
🛡️ Bảo mật — cơ chế bảo vệ chống chèn prompt trên mọi tuyến LLM (bộ kiểm thử red-team), rào chắn che thông tin xác thực có thể tùy chọn bật (ẩn các khóa API/bí mật bị rò rỉ theo cả hai chiều), tìm kiếm web DuckDuckGo miễn phí như phương án cuối cùng và cổng đăng nhập OIDC tùy chọn cho bảng điều khiển (đăng nhập bằng mật khẩu luôn khả dụng). → Rào chắn
🖼️ Các endpoint mới — /v1/ocr (Mistral OCR) và /v1/audio/translations (kiểu Whisper) hoàn thiện phạm vi tính năng đa phương tiện. → Tài liệu tham khảo API
🎨 Tạo hình ảnh / video / âm thanh — một API duy nhất cho đa phương tiện: video xAI Grok Imagine & Novita AI, ComfyUI, Magnific, Adobe Firefly, Segmind và các nhà cung cấp giọng nói như ElevenLabs. → Tài liệu tham khảo API
🌍 Triển khai & vận hành — basePath cho reverse proxy, tự động phát hiện ngôn ngữ trình duyệt, theo dõi thiết bị theo từng khóa, thiết lập tin cậy MITM không cần quyền root, bản địa hóa zh-TW. → Môi trường
🤝 Thêm nhiều nhà cung cấp & tác nhân — tác nhân đám mây (Codex Cloud, Cursor, Devin, Jules), Grok Build (xAI) với trình duyệt + đăng nhập OAuth, thẻ Ollama hạng nhất, Claude Opus 5 & Sonnet 5, quan hệ đối tác chính thức với Kimi (Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… cùng danh mục 352 nhà cung cấp được làm mới. → Nhà cung cấp
📡 Tính minh bạch trong định tuyến — mọi phản hồi đều chứa header X-OmniRoute-Decision nêu rõ chiến lược/nhà cung cấp/độ trễ đã phục vụ phản hồi đó, một chiến lược combo cache-optimized mới + hệ số cacheAffinity của Auto-Combo định tuyến các yêu cầu lặp lại trở về kết nối đang giữ tiền tố trong bộ nhớ đệm, và endpoint chỉ đọc /v1/auto-combo/{channel}/candidates cho biết nhóm ứng viên trực tiếp của một kênh auto/*. → Auto-Combo
⚡ Hiệu năng cục bộ & hạ tầng — Redis cục bộ bằng một cú nhấp, các trình triển khai relay cho Cloudflare Workers / Deno Deploy, Bifrost & Mux dưới dạng dịch vụ nhúng được giám sát. → Dịch vụ nhúng
🧩 Ngoài ra còn có — framework plugin + marketplace, các framework kỹ năng Omni/Agent/GitHub, tích hợp kho Obsidian (22 công cụ MCP), API Batch & Files tương thích OpenAI, bộ nhớ đệm phản hồi ngữ nghĩa, trò chơi hóa với bảng xếp hạng, khám phá tác nhân ACP (15 tác nhân tích hợp sẵn), xuất nhật ký theo lịch sang BigQuery, chèn lỗi auto/chaos, cầu nối bot Telegram, trình quản lý phiên bản trong ứng dụng và bảng xếp hạng nhà cung cấp miễn phí LMArena-ELO. → Tài liệu

🤖 Các CLI & tác nhân lập trình tương thích

Một cấu hình duy nhất — http://localhost:20128/v1 — và mọi IDE hoặc CLI AI đều chạy được với các mô hình miễn phí & chi phí thấp.

_{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}

＋ cũng hoạt động với · Kiro · Command Code · Antigravity · Windsurf · AMP · mọi công cụ tương thích với OpenAI

_{📖 Thiết lập riêng cho từng công cụ trong số 36 công cụ (26 CLI Code + 10 CLI Agent) → docs/reference/CLI-TOOLS.md · 🧩 Plugin OpenCode → @omniroute/opencode-provider}

Khởi chạy bất kỳ CLI nào được hỗ trợ thông qua OmniRoute chỉ bằng một lệnh — không ghi tệp cấu hình, thông tin xác thực được chèn riêng cho từng tiến trình, Qwen/Gemini sử dụng thư mục home cô lập dùng một lần:

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"

# Hoặc chọn nhà cung cấp+mô hình theo cách tương tác và ghi cấu hình riêng của công cụ:
omniroute configure codex          # cũng hỗ trợ: claude opencode qwen aider goose gemini cline continue kilo

Mọi lệnh đều tuân theo ngữ cảnh từ xa đang hoạt động (omniroute connect <host>), --dry-run cho phép xem trước chính xác các biến môi trường/tham số mà không thực thi, và --api-key-env NAME giúp giữ bí mật khỏi lịch sử shell của bạn. → Tích hợp CLI

🌐 352 Nhà cung cấp AI — 152 nhà cung cấp được đánh dấu miễn phí trong danh mục

352 nhà cung cấp đã đăng ký trong các bộ sưu tập chính thức về trò chuyện, phương tiện, tìm kiếm, cục bộ, tác tử đám mây và hệ thống, trong đó có 152 nhà cung cấp mang siêu dữ liệu khám phá hasFree: true. Registry mô hình trò chuyện bao gồm 229 nhà cung cấp / 2.554 cặp nhà cung cấp-mô hình riêng biệt / 1.283 ID mô hình thô; danh mục ngân sách miễn phí riêng biệt có 443 hàng theo mô hình, 34 nhóm hạn mức định kỳ và 53 nhà cung cấp miễn phí vĩnh viễn theo định kỳ/không cần khóa. Các mẫu số này khác nhau theo chủ đích; định nghĩa và phép tính đã loại bỏ trùng lặp theo nhóm nằm trong Tài liệu tham khảo về nhà cung cấp và Các gói miễn phí.

🏢 Mọi phòng thí nghiệm lớn — thông qua một endpoint duy nhất

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

_{…và hơn 330 nhà cung cấp khác — mọi biểu tượng đều được phân giải trực tiếp từ danh mục nhà cung cấp của bảng điều khiển. 📖 Tài liệu tham khảo về nhà cung cấp}

🆓 Miễn phí vĩnh viễn — $0, không cần thẻ

OpenCode Zen _{DeepSeek V4, Nemotron 3 Không giới hạn token}	Kilo Code _{Bộ định tuyến tự động, Tencent Hy3 Miễn phí vĩnh viễn}	Requesty _{GPT-OSS 120B, Nemotron Miễn phí vĩnh viễn}	SiliconFlow _{DeepSeek V3.2 / R1 Gói miễn phí}	Z.AI GLM _{GLM-4.7 / 4.5-Flash Miễn phí vĩnh viễn}	Baidu ERNIE _{ERNIE 4.0 Miễn phí vĩnh viễn}
Qoder AI _{Qwen3-Max, Kimi-K2 MIỄN PHÍ không giới hạn}	Pollinations _{GPT, Llama, Claude Không cần khóa}	Cloudflare AI _{Hơn 50 mô hình 10K nơ-ron/ngày}	NVIDIA NIM _{GLM, MiniMax ~40 RPM miễn phí}	Cerebras _{GLM 4.7, GPT-OSS 1M token/ngày}	OpenRouter _{Các mô hình :free +$10 → RPM cao hơn}

📖 Danh mục đầy đủ có thể đọc bằng máy → docs/reference/PROVIDER_REFERENCE.md

🖥️ OmniRoute Chạy Ở Đâu — Mọi Nơi

Cùng một ứng dụng, máy của bạn, quy tắc của bạn. Từ cài đặt npm toàn cục đến điện thoại của bạn thông qua Termux.

Nền tảng	Cài đặt	Điểm nổi bật
📦 npm (toàn cục)	`npm install -g omniroute`	Một lệnh, mọi hệ điều hành
🐳 Docker	`docker run … diegosouzapw/omniroute`	Đa kiến trúc AMD64 + ARM64
🖥️ Máy tính để bàn (Electron)	`npm run electron:build`	Cửa sổ gốc + khay hệ thống — Windows / macOS / Linux
🎩 Thanh menu (OmniRouteTray)	`brew install --cask zoispag/tap/omniroute-tray`	Giám sát & tự động cập nhật máy chủ — macOS
💪 ARM	`arm64` nguyên bản	Raspberry Pi, máy chủ ARM, Apple Silicon
📱 Android (Termux)	`pkg install nodejs && npx -y omniroute`	Chạy trên điện thoại của bạn, 24/7, không cần root
📲 PWA	"Thêm vào màn hình chính"	Toàn màn hình, ngoại tuyến, có thể cài đặt từ trình duyệt
🧩 Plugin OpenCode	`@omniroute/opencode-provider`	Tích hợp OpenCode nguyên bản
🤖 VS Code Copilot Chat	cài đặt tiện ích mở rộng OmniCopilot	Mọi mô hình OmniRoute trong bộ chọn Copilot Chat nguyên bản — bản ổn định & Insiders
🛠️ Từ mã nguồn	`npm install && npm run dev`	Tùy biến, đóng góp

_{📖 Hướng dẫn Docker · Máy tính để bàn · Khay thanh menu · Termux · PWA · OpenCode}

🧩 Mới: OmniRoute bên trong Copilot Chat nguyên bản của VS Code

Không có thanh bên mới, không có giao diện trò chuyện mới — mọi mô hình do OmniRoute cung cấp đều xuất hiện ngay trong bộ chọn mô hình Copilot Chat mà bạn đã sử dụng. Kể từ VS Code 1.122, các mô hình của nhà cung cấp hoạt động mà không cần đăng nhập GitHub hoặc đăng ký Copilot — chế độ tác nhân, gọi công cụ và thị giác, hoàn toàn miễn phí.

Cài đặt tiện ích mở rộng OmniCopilot, trỏ tiện ích đến máy chủ OmniRoute của bạn (mặc định là localhost:20128), sau đó mở Copilot Chat → bộ chọn mô hình → Quản lý mô hình… → OmniRoute.

Cửa hàng	Liên kết	Hoạt động với
🧩 VS Code Marketplace	Cài đặt →	VS Code — bản ổn định & Insiders
🔓 Open VSX Registry	Cài đặt →	Cursor, Windsurf, VSCodium, Theia, code-server, Gitpod, Antigravity, Kiro…

Từ bên trong trình soạn thảo: mở chế độ xem Tiện ích mở rộng, tìm kiếm "OmniRoute", nhấp vào Cài đặt — hoạt động theo cùng một cách trên cả hai cửa hàng. Mã nguồn, các vấn đề và tài liệu quy trình phát hành nằm tại diegosouzapw/OmniCopilot.

_{📖 Hướng dẫn VS Code Copilot Chat — thiết lập, nội dung bộ chọn hiển thị, bảng điều khiển trong một tab, khắc phục sự cố}

omniroute serve hoạt động tốt nhất khi luôn được bật. OmniRouteTray biến việc đó thành một ứng dụng thanh menu chỉ cần thiết lập một lần trên macOS: ứng dụng khởi động máy chủ, duy trì hoạt động sau khi khởi động lại, cập nhật tại chỗ và giúp bạn xem ngân sách token trực tiếp chỉ với một cú nhấp chuột — không cần để cửa sổ dòng lệnh mở, không cần trông chừng npm install -g omniroute.

Được xây dựng bằng Tauri v2 (lõi Rust nhỏ đến mức có thể xem như sai số làm tròn), ứng dụng đi kèm môi trường chạy Node 24 đã được ký riêng và quản lý bản cài đặt OmniRoute thuộc sở hữu của ứng dụng, vì vậy không bao giờ xung đột với node/bun toàn cục của bạn. Ứng dụng dùng chung cấu hình và cơ sở dữ liệu ~/.omniroute/ hiện có của bạn — vì vậy đây vẫn là OmniRoute mà bạn đang chạy, chỉ là được đội thêm một chiếc mũ. 🎩

Chức năng	Cách thức
🟢 Giám sát máy chủ	Khởi tạo `omniroute serve`, tiếp quản phiên bản đang chạy thay vì tạo bản trùng lặp
📊 Xem nhanh mức sử dụng trực tiếp	Thanh hạn mức nhà cung cấp, giới hạn phiên/hàng tuần của Claude kèm đếm ngược thời gian đặt lại, phân tích chi phí trong 30 ngày
🔄 Tự động cập nhật tại chỗ	Cài đặt theo giai đoạn, hoán đổi nguyên tử, hoàn tác khi thất bại — luôn sử dụng bản phát hành mới nhất
🚀 Khởi động khi đăng nhập	Tùy chọn khởi chạy khi đăng nhập; chỉ hiển thị ở khay, không có biểu tượng trên dock
🩺 Chẩn đoán & nhật ký	Chẩn đoán chỉ với một cú nhấp chuột và truy cập nhật ký máy chủ

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

_{Muốn tải xuống? Hãy lấy tệp .dmg mới nhất từ
Bản phát hành. Mã nguồn, các vấn đề và tài liệu
hướng dẫn build có tại zoispag/omniroute-tray.

💛 Một dự án cộng đồng của @zoispag — không phải là bản phát hành OmniRoute chính thức.}

🔒 Riêng tư & Ưu tiên cục bộ

Riêng tư và ưu tiên cục bộ — cổng kết nối và mặt phẳng điều khiển của OmniRoute chạy trên máy của bạn. Prompt được gửi đến nhà cung cấp thượng nguồn được chọn cho từng yêu cầu; OmniRoute không thêm bất kỳ chặng xử lý prompt được lưu trữ nào và tính năng đo từ xa bị tắt theo mặc định. Thông tin xác thực được mã hóa khi lưu trữ bằng AES-256-GCM; các biện pháp kiểm soát bao gồm phân phạm vi khóa API, lọc IP, giới hạn tốc độ, cơ chế bảo vệ chống prompt injection, loại bỏ header thượng nguồn, biên tập PII theo cơ chế tùy chọn, lỗi đã được làm sạch và nhật ký kiểm tra SQLite cục bộ. OmniRoute được cấp phép theo MIT và có thể tự lưu trữ.

_{📖 Ủy quyền · Cơ chế bảo vệ · Tuân thủ}

🔌 CLI đầy đủ + A2A & MCP

Ngoài máy chủ, OmniRoute còn là một buồng điều khiển dòng lệnh đầy đủ với hơn 80 lệnh, cùng các giao thức tác nhân mở để một tác nhân AI có thể tự mình vận hành nó.

⌨️ Một CLI thực thụ (không chỉ có `start`)

omniroute               # phục vụ cổng kết nối + bảng điều khiển (cổng 20128)
omniroute chat          # trình trò chuyện TUI tương tác (lệnh gạch chéo: /model /combo /skill /memory)
omniroute setup         # trình hướng dẫn có chỉ dẫn cho lần chạy đầu tiên
omniroute doctor        # chẩn đoán nhà cung cấp, cổng, phần phụ thuộc native

🛰️ Chế độ từ xa — chạy CLI tại đây, OmniRoute trên VPS

OmniRoute đang chạy trên máy chủ? Điều khiển nó từ máy tính xách tay của bạn bằng chính CLI đó. Đăng nhập một lần bằng token truy cập có phạm vi; sau đó mọi lệnh sẽ nhắm đến máy chủ từ xa.

omniroute connect 192.168.0.15            # mật khẩu → token có phạm vi, được lưu dưới dạng ngữ cảnh
omniroute models list                     # ← chạy trên máy chủ TỪ XA
omniroute configure codex                 # ← chọn một mô hình từ xa, ghi một hồ sơ Codex cục bộ
omniroute tokens create --name ci --scope read   # tạo token có phạm vi hẹp hơn cho các máy khác
omniroute contexts use default            # ← chuyển trở lại máy chủ cục bộ

Token có các phạm vi read / write / admin; các tuyến khởi chạy tiến trình chỉ khả dụng trên loopback. _{📖 Chế độ từ xa}

Bản trình diễn terminal động về OmniRoute CLI — omniroute providers list, omniroute combo list và omniroute health — luân phiên qua bề mặt cấp cao nhất gồm 86 lệnh: 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 …

🤝 Kết nối một tác nhân — và tác nhân đó tự điều khiển OmniRoute

Cung cấp OmniRoute qua MCP, A2A, REST API, webhook hoặc CLI từ xa — bất kỳ tác nhân đủ năng lực nào (hoặc mã của riêng bạn) đều có quyền điều khiển toàn bộ cổng kết nối: định tuyến, nhà cung cấp, tổ hợp, bộ nhớ đệm, nén, bộ nhớ — một cách tự động. Các endpoint HTTP bên dưới được phục vụ tại http://localhost:20128.

Giao diện	Endpoint / lệnh	Dùng cho
🧰 MCP (stdio)	`omniroute --mcp`	Tích hợp vào Claude Desktop, Cursor hoặc bất kỳ trình khách MCP nào
🌊 MCP (HTTP)	`/api/mcp/stream`	MCP từ xa — 110 công cụ, 33 phạm vi (tùy chọn bật thực thi), nhật ký kiểm tra đầy đủ
📡 MCP (SSE)	`/api/mcp/sse`	Phương thức truyền tải MCP dạng luồng
🤝 A2A	`/.well-known/agent.json`	Tác nhân với tác nhân, JSON-RPC 2.0 + SSE, 6 kỹ năng
🌐 REST API	`/v1/*`	Tương thích với OpenAI — trò chuyện, embedding, hình ảnh, âm thanh, OCR
🔔 Webhook	`/api/webhooks`	Đẩy các sự kiện yêu cầu / hạn ngạch đến Slack, Discord, Telegram hoặc bất kỳ URL nào
🛰️ CLI từ xa	`omniroute connect`	Điều khiển một phiên bản từ xa bằng token truy cập có phạm vi

# Cung cấp cho Claude Code toàn bộ bộ công cụ OmniRoute qua MCP:
claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream

_{📖 Máy chủ MCP · Máy chủ A2A · Giao thức tác nhân}

🗜️ Tiết kiệm 15–95% token — Tự động

📖 Cách hoạt động — quy trình, kiến trúc & phép tính mức tiết kiệm

Quy trình nén OmniRoute: một yêu cầu minh họa gồm 10.000 token từ máy khách đi qua 12 công cụ có thể kết hợp — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra và OmniGlyph — rồi có thể đến nhà cung cấp với khoảng 1.080 token trong ví dụ kết hợp được trình bày. Nội dung có cấu trúc được bảo vệ bằng các cơ chế bảo toàn và cổng kiểm tra độ trung thực ở từng bước; các chế độ mất dữ liệu hoặc thử nghiệm được bật rõ ràng có thể biến đổi nội dung phù hợp.

Tổ hợp kết hợp mặc định chạy RTK → Caveman. Khi cả hai cùng xử lý một tải trọng công cụ/ngữ cảnh, mức tiết kiệm được nhân lên:

combined = 1 − (1 − RTK) × (1 − Caveman_input)
average  = 1 − (1 − 0.80) × (1 − 0.46) = 89.2%
range    = 78.4 – 94.6%

Các khối mã, URL, JSON và dữ liệu có cấu trúc luôn được bảo vệ bởi công cụ bảo toàn.

Tại sao phải dùng nhiều token khi chỉ cần vài token là đủ? Mọi yêu cầu đều đi qua quy trình nén của OmniRoute một cách minh bạch — không cần thay đổi phía máy khách. Giờ đây, đây là một ngăn xếp gồm 12 công cụ có thể kết hợp, chạy theo thứ tự và có thể phối hợp tùy theo từng tổ hợp định tuyến — được xây dựng dựa trên các ý tưởng từ RTK, Caveman (⭐ 90K+), LLMLingua-2, và Troglodita (PT-BR).

🧱 Ngăn xếp 12 công cụ

Các công cụ chạy theo thứ tự trong quy trình; mỗi công cụ có thể được bật/tắt và cấu hình độc lập cho từng tổ hợp:

#	Công cụ	Chức năng
1	Session-Dedup	Loại bỏ nội dung lặp lại giữa các lượt (định địa chỉ theo nội dung, xuyên lượt)
2	CCR	Lưu trữ các khối lớn phía sau dấu truy xuất, được lấy về khi cần
3	Lite	Rút gọn khoảng trắng + URL hình ảnh (đường cơ sở có độ trễ thấp)
4	RTK	Lọc, khử trùng lặp & cắt bớt kết quả công cụ một cách thông minh (nhận biết lệnh)
5	Responses Tool Output	Ưu tiên không mất dữ liệu với JSON + nén chẩn đoán có giới hạn cho đầu ra shell/patch/search/build (Responses API)
6	Headroom	Thu gọn dạng bảng không mất dữ liệu đối với mảng JSON (~30%) thông qua codec GCF được tích hợp sẵn
7	Relevance	Chấm điểm và trích xuất câu dựa trên truy vấn gần nhất của người dùng
8	Caveman	Nén văn xuôi dựa trên quy tắc (~65–75% đối với đầu ra)
9	Aggressive	Tóm tắt + làm cũ dần các lượt trước
10	LLMLingua-2	Lược bỏ ngữ nghĩa bằng ML thông qua MobileBERT ONNX — an toàn cho mã, bất đồng bộ
11	Ultra	Lược bỏ token theo phương pháp heuristic với tầng mô hình nhỏ (SLM) tùy chọn
12	OmniGlyph	Mã hóa ngữ cảnh thành hình ảnh ở mức thử nghiệm dành cho Claude Fable 5 đã được đo lường trên kết nối Anthropic trực tiếp; các transformer GPT 5.6 vẫn ở trạng thái đóng an toàn trong khi chờ biên nhận từ nhà cung cấp. Bốn cấu hình nén (mặc định mạnh tay, cân bằng, an toàn cho lập trình, truyền nguyên trạng) (mạnh tay nhất; cần chủ động bật)

Các khối mã, URL và dữ liệu có cấu trúc luôn được bảo toàn chính xác từng byte. Các cấu hình cài sẵn chỉ với một cú nhấp kết hợp các công cụ:

Chế độ	Mức tiết kiệm	Phù hợp nhất cho
🪶 Lite	~15%	Mặc định an toàn, luôn bật
🪨 Standard (Caveman)	~30%	Lập trình hằng ngày
⚡ Aggressive	~50%	Các phiên dài sử dụng nhiều công cụ
🔥 Ultra	~75%	Tiết kiệm tối đa
🧰 RTK	60–90%	Đầu ra shell/test/build/git
🔗 Stacked (RTK → Caveman)	78–95%	Prompt hỗn hợp + nhật ký công cụ

Ví dụ thực tế — chế độ Standard:

Trước (69 token): "Lý do component React của bạn kết xuất lại có thể là vì bạn đang tạo một tham chiếu đối tượng mới trong mỗi chu kỳ kết xuất. Khi bạn truyền một đối tượng nội tuyến dưới dạng prop, phép so sánh nông của React sẽ luôn coi đó là một đối tượng khác, từ đó kích hoạt việc kết xuất lại. Tôi khuyên bạn nên sử dụng useMemo để ghi nhớ đối tượng."

Sau (19 token): "Tham chiếu đối tượng mới mỗi lần kết xuất. Prop đối tượng nội tuyến = tham chiếu mới = kết xuất lại. Bọc bằng useMemo."

Cùng một câu trả lời. Ít hơn 72% token. Không suy giảm độ chính xác. ✅

Ví dụ PT-BR — chế độ Troglodita:

Trước (42 token): "Vấn đề là thành phần đang kết xuất lại vì một tham chiếu đối tượng mới được tạo trong mỗi chu kỳ kết xuất. Tôi khuyên bạn nên sử dụng useMemo."

Sau (12 token): "Kết xuất lại: tham chiếu mới mỗi chu kỳ (đối tượng nội tuyến được tạo lại). Dùng useMemo."

Cùng một câu trả lời. Ít hơn ~70% token. Độ chính xác kỹ thuật không đổi. ✅

🎚️ Không chỉ các engine — kiểu đầu ra, nút điều chỉnh thích ứng & khả năng kiểm soát theo từng yêu cầu

12 engine trên thu gọn nội dung đầu vào. Ba lớp khác định hình cách thức, thời điểm và nội dung đầu ra:

🪄 Kiểu đầu ra (điều hướng theo trục đầu ra) — chèn các chỉ dẫn định hình phản hồi có tính xác định, an toàn với bộ nhớ đệm; có thể kết hợp, mỗi kiểu có cường độ lite / full / ultra. Thêm một kiểu chỉ cần một dòng trong registry:
- Văn phong súc tích — loại bỏ từ thừa / mạo từ / cách nói dè dặt; giữ nguyên độ chính xác của nội dung kỹ thuật.
- Ít mã hơn — YAGNI kiểu "lập trình viên cấp cao lười biếng": thay đổi hoạt động được ở mức nhỏ nhất, không dựng thêm cấu trúc ngoài yêu cầu.
- Ponytail (lập trình viên cấp cao lười biếng) — đi theo từng nấc YAGNI, khắc phục nguyên nhân gốc rễ, tạo diff hoạt động được ở mức nhỏ nhất.
- Tôi mắc ADHD (ưu tiên hành động) — mở đầu bằng hành động tiếp theo, đánh số các bước, một bước tiếp theo cụ thể, không có lời dẫn.
- CJK súc tích (文言) — phong cách Hán văn cổ điển siêu súc tích (chỉ bật cho locale zh).
🎯 Ngân sách ngữ cảnh thích ứng (nút điều chỉnh) — thay vì một ngưỡng token bật/tắt duy nhất, chỉ tăng dần các engine rẻ nhất, ít mất mát nhất đến mức cần thiết để vừa với cửa sổ ngữ cảnh của mô hình. Chính sách: reserve-output (mặc định, nhận biết mô hình) · percentage · absolute. Chế độ: floor (đảm bảo vừa) · replace-autotrigger (lựa chọn rõ ràng của bạn được ưu tiên) · off (ngưỡng cũ).
🎛️ Nơi quyết định việc nén (thứ tự ưu tiên, cao → thấp) — header x-omniroute-compression theo từng yêu cầu › ghi đè của tổ hợp định tuyến › hồ sơ có tên đang hoạt động › thích ứng / tự động kích hoạt › mặc định trên bảng điều khiển › tắt. Kế hoạch được áp dụng sẽ được phản hồi trong header phản hồi X-OmniRoute-Compression: <mode>; source=<source>.

Tự động kích hoạt theo ngưỡng token, bật nút điều chỉnh thích ứng, ghim một hồ sơ có tên, thiết lập dùng một lần theo từng yêu cầu hoặc gán một pipeline cho mỗi tổ hợp định tuyến — tùy lựa chọn nào phù hợp với khối lượng công việc. Một bộ công cụ đánh giá ngoại tuyến tùy chọn (npm run eval:compression) chấm điểm độ trung thực so với mức tiết kiệm trên một tập dữ liệu cố định trước khi bạn đưa thay đổi vào sử dụng.

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

⚡ Bắt đầu nhanh

1) Cài đặt & chạy

npm install -g omniroute
omniroute

💡 Thấy npm warn ERESOLVE hoặc cảnh báo peer-dep? Chúng không gây ảnh hưởng.

Bảng điều khiển tại http://localhost:20128 · API tại http://localhost:20128/v1.

2) Kết nối một nhà cung cấp MIỄN PHÍ (không cần đăng ký)

Bảng điều khiển → Nhà cung cấp → kết nối Kiro AI (Claude miễn phí, ~50 tín dụng/tháng cho mỗi tài khoản) hoặc OpenCode Free (không cần xác thực) → hoàn tất.

3) Cấu hình công cụ lập trình của bạn

URL cơ sở: http://localhost:20128/v1
Khóa API:  [sao chép từ Bảng điều khiển → Điểm cuối]
Mô hình:   auto            (định tuyến thông minh không cần cấu hình — hoặc bất kỳ nhà cung cấp/mô hình nào)

4) Xác minh hệ thống đang hoạt động

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

Bạn sẽ thấy danh sách các mô hình đã kết nối. 🎉 Vậy là xong — bắt đầu lập trình, OmniRoute sẽ tự động định tuyến và chuyển sang phương án dự phòng cho bạn.

Nếu máy khách của bạn không thể gửi header tùy chỉnh, OmniRoute cũng cung cấp các bí danh tương thích được mã hóa bằng token:

Danh mục OpenAI:   http://localhost:20128/vscode/YOUR_KEY/
Mô hình OpenAI:    http://localhost:20128/vscode/YOUR_KEY/models
Trò chuyện OpenAI: http://localhost:20128/vscode/YOUR_KEY/chat/completions
Phản hồi OpenAI:   http://localhost:20128/vscode/YOUR_KEY/responses
Trò chuyện Ollama: http://localhost:20128/vscode/YOUR_KEY/api/chat
Thẻ Ollama:        http://localhost:20128/vscode/YOUR_KEY/api/tags

Chỉ sử dụng các bí danh này cho những máy khách không thể đính kèm Authorization: Bearer .... Xác thực bằng header vẫn là chế độ được ưu tiên.

📦 Các phương thức cài đặt khác — Docker, mã nguồn, 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 luôn trỏ đến phiên bản SemVer ổn định đã phát hành cao nhất. Thẻ này không theo dõi nhánh git main. Hãy ghim :X.Y.Z khi dùng GitOps. Xem Các kênh phát hành Docker. Image ghim OMNIROUTE_MEMORY_MB=1024. Mức này đủ cho bảng điều khiển và các cuộc trò chuyện nhẹ. Các tác nhân lập trình (POST /v1/responses từ Claude Code, Codex, Grok, …) cần heap V8 lớn hơn nhiều, nếu không tiến trình sẽ gặp FATAL ERROR ở mức khoảng 12 GiB khi có hai ngữ cảnh dài chồng lấn. Hãy đặt giới hạn bộ nhớ container cao hơn heap (các bộ đệm native nằm ngoài V8):

Khối lượng công việc	Heap (`-e OMNIROUTE_MEMORY_MB`)	Container (`--memory`)
Bảng điều khiển / trò chuyện nhẹ	`1024` (mặc định của image)	≥2 g
Một tác nhân lập trình	`8192`	≥10 g
Hai `/v1/responses` dài đồng thời	`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

Bảng đầy đủ: Hướng dẫn Docker — RAM khi chạy.

Kênh Docker tiền phát hành: diegosouzapw/omniroute:next và diegosouzapw/omniroute:next-web theo dõi nhánh release/v* mặc định hiện tại. Các thẻ có thể thay đổi này chỉ dành cho việc kiểm thử các bản sửa lỗi chưa phát hành và không được hỗ trợ cho môi trường production. Xem Các kênh phát hành Docker.

🥟 Bun

bun install tiêu chuẩn và cài đặt toàn cục (bun install -g omniroute) được hỗ trợ thông qua cơ chế phát hiện runtime Bun:

bun:sqlite tích hợp sẵn: OmniRoute sử dụng driver bun:sqlite tích hợp sẵn của Bun khi chạy trên Bun và chuyển sang better-sqlite3 trên Node.js hoặc sql.js nếu cần.
Tự động chọn trình đóng gói Webpack trong môi trường phát triển: Chế độ phát triển (bun run dev) tự động phát hiện Bun và tắt Turbopack để chuyển sang Webpack, nhằm ngăn các vấn đề không tương thích với liên kết native V8. Các bản dựng production (bun run build) tuân theo OMNIROUTE_USE_TURBOPACK chính xác như trên Node: mặc định dùng Turbopack, đặt OMNIROUTE_USE_TURBOPACK=0 để dựng bằng Webpack (Dockerfile.bun cung cấp biến này dưới dạng --build-arg).
Dockerfile riêng cho Bun: Dockerfile.bun nhiều giai đoạn dành cho các bản triển khai production Bun native (docker build -f Dockerfile.bun -t omniroute:bun .).

# Cài đặt và chạy bằng Bun
bun install
bun run dev

🛠️ Từ mã nguồn

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)

# Sử dụng Nix flakes
nix develop
npm run dev

# Hoặc sử dụng devbox
devbox run npm run dev

📖 Hướng dẫn Docker — Các profile Compose, Caddy HTTPS, tunnel Cloudflare.

🦭 Podman

# 1. Chuẩn bị thư mục dữ liệu được bind mount
mkdir -p data

# 2. Chỉ dành cho Linux + Podman rootless cục bộ (không bao giờ dùng trên máy khách Podman Machine từ xa):
podman unshare chown 1000:1000 ./data

# 3. Đặt gợi ý runtime, dựng image Compose cục bộ và khởi động
echo "CONTAINER_HOST=podman" >> .env
podman compose --profile base up -d --build

Trên macOS hoặc Windows, Podman sử dụng Podman Machine từ xa: hãy bỏ qua podman unshare và làm theo hướng dẫn về thư mục dữ liệu dành riêng cho từng cấu trúc triển khai.

📖 Hướng dẫn Podman — Các bản dựng Compose, Podman Machine và thiết lập Quadlet Linux/systemd.

⚡ Cài đặt nhanh hơn / gọn nhẹ hơn (bỏ qua bước dựng native)

Công cụ SQLite native (better-sqlite3) là một dependency tùy chọn, vì vậy quá trình cài đặt toàn cục không bao giờ bị chặn do phải biên dịch từ mã nguồn: hệ thống sử dụng binary dựng sẵn khi có bản phù hợp với nền tảng/Node của bạn, nếu không sẽ tự động chuyển sang công cụ JavaScript thuần (node:sqlite trên Node 22+, nếu không thì dùng sql.js WASM đi kèm) — không yêu cầu công cụ dựng.

Để bỏ qua hoàn toàn bước khởi động native sau khi cài đặt (CI, môi trường headless hoặc máy chậm):

OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute   # CI=1 cũng bỏ qua bước này

Để cài đặt nhanh nhất, hãy ưu tiên pnpm (kho lưu trữ định địa chỉ theo nội dung + liên kết cứng — xem phần trên). Để sử dụng runtime headless không có bảng điều khiển, hãy dùng profile Docker base (ở trên) hoặc hướng dẫn Termux. CLI và bảng điều khiển web được cung cấp bởi cùng một tiến trình trên một cổng, vì vậy hiện chưa có package riêng chỉ dành cho CLI.

🎬 OmniRoute trong thực tế

📹 Hướng dẫn bằng video

_{Ảnh chụp bảng điều khiển vào 2026-08-24 · Danh mục thô: YT 809 | TT 137 | IG 124 · Độ mới (ngày): YT 1 | TT 21 | IG 22}

🎬 #1 — Instagram
_{nick_saraev — 3,042,474 lượt xem}

🎬 #2 — Instagram
_{theopenstack — 692,419 lượt xem}

🎬 #3 — TikTok
_{milesreevesai — 620,400 lượt xem}

🎬 #4 — YouTube
_{Vaibhav Sisinty — 391,109 lượt xem}

🎬 #5 — Instagram
_{buildwithai.club — 347,652 lượt xem}

Bảng xếp hạng đầy đủ (các URL chuẩn đã được loại bỏ trùng lặp, v > 0, phạm vi tiếp cận cao nhất):

#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

Số liệu chuẩn vào 2026-08-24: 1.029 video duy nhất · 11.132.922 lượt xem đã biết (v > 0) · 639 kênh/hồ sơ trên các mạng. Bảng điều khiển thô chứa 1.070 dòng; 41 mục trùng lặp trên Instagram đã được chuẩn hóa theo URL chuẩn, giữ lại số lượt xem cao nhất cho mỗi video.

🎬 Bạn đã làm video về OmniRoute? Hãy mở một vấn đề hoặc một cuộc thảo luận kèm theo liên kết — chúng tôi sẽ giới thiệu video đó tại đây.

📧 Cộng đồng & Trợ giúp

Mọi thứ ở cùng một nơi — theo dõi người bảo trì, trò chuyện với cộng đồng hoặc mở một vấn đề.

Kênh	Ở đâu / bằng cách nào
💼 LinkedIn — theo dõi người bảo trì	linkedin.com/in/diegosouzapw
🐙 GitHub — theo dõi bản phát hành và mẹo	@diegosouzapw
💬 Discord	discord.gg/U47eFqAXCn
✈️ Telegram	t.me/omnirouteOficial
🟢 WhatsApp — 🌍 Toàn cầu	tham gia nhóm
🟢 WhatsApp — 🇧🇷 Brasil	tham gia nhóm
🌍 Trang web	omniroute.online
🌍 🌍Cộng đồng StHub OmniRoute (miễn phí)	cổng thông tin StHub
📦 Mã nguồn	github.com/diegosouzapw/OmniRoute
🐛 Báo cáo lỗi	mở một issue — đính kèm kết quả của `npm run system-info`
🤝 Đóng góp	CONTRIBUTING.md · Mô hình phân nhánh và phát hành · chọn một `good first issue`
💚 Hỗ trợ dự án	Các cách hỗ trợ ↑ · Nhà tài trợ GitHub

🛠️ Ngăn xếp công nghệ

Lớp	Công nghệ
Môi trường thực thi	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
Ngôn ngữ	TypeScript 6.0 — 100% TypeScript trên toàn bộ `src/` và `open-sse/` (không có `any` trong phần lõi kể từ v2.0)
Framework	Next.js 16 + React 19 + Tailwind CSS 4
Cơ sở dữ liệu	better-sqlite3 (SQLite, ghi nhật ký WAL) + LowDB (JSON cũ) — 122 mô-đun miền nghiệp vụ, 176 bản di chuyển
Bộ nhớ	Tìm kiếm toàn văn SQLite FTS5 + vector nhúng lượng tử hóa int8, suy giảm có kiểu
Lược đồ	Zod 4 — xác thực đầu vào/đầu ra của công cụ MCP + hợp đồng API
Giao thức	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
Truyền trực tuyến	Server-Sent Events (SSE) + cầu nối WebSocket (`/v1/ws`)
Nén	Quy trình 12 công cụ — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
Xác thực & bảo mật	OAuth 2.0 (PKCE) + JWT + khóa API + xác thực theo phạm vi MCP · AES-256-GCM cho dữ liệu lưu trữ · DOMPurify
Ẩn danh	wreq-js — giả lập dấu vân tay TLS JA3 / JA4, proxy 3 cấp
Khả năng phục hồi	Bộ ngắt mạch, thời gian chờ tăng theo cấp số nhân, chống hiệu ứng đám đông truy cập đồng thời, tổ hợp tự động tự phục hồi
Ghi nhật ký	pino — nhật ký JSON có cấu trúc kèm ngữ cảnh yêu cầu
Kiểm thử	Trình chạy kiểm thử Node.js + Vitest — hơn 39.000 khai báo kiểm thử tĩnh trên hơn 5.100 tệp kiểm thử được theo dõi (đơn vị, tích hợp, E2E, bảo mật, hệ sinh thái)
Nền tảng	Máy tính để bàn (Electron) · Android (Termux) · PWA (mọi trình duyệt)
CI/CD	GitHub Actions — tự động xuất bản lên npm + Docker Hub khi phát hành
Liên kết	Trang web · npm · Docker Hub

📖 Tài liệu

📘 Bắt đầu

Tài liệu	Mô tả
Hướng dẫn sử dụng	Nhà cung cấp, combo, tích hợp CLI, triển khai
Hướng dẫn thiết lập	Đầy đủ các phương thức cài đặt, cấu hình công cụ CLI, thiết lập giao thức, tinh chỉnh thời gian chờ
Hướng dẫn công cụ CLI	Thiết lập riêng cho từng công cụ: Claude Code, Codex, Cursor, Cline, OpenClaw, Kilo, Copilot
Chế độ từ xa	Điều khiển OmniRoute từ xa (VPS) bằng CLI trên laptop thông qua token truy cập có phạm vi
Cấu hình Claude Code	Kết nối Claude Code với OmniRoute (cục bộ/từ xa) bằng `launch` + hồ sơ riêng cho từng mô hình
Bắt đầu nhanh	3 bước: cài đặt → kết nối → cấu hình

🔧 Vận hành & Triển khai

Tài liệu	Mô tả
Hướng dẫn Docker	Docker run, hồ sơ Compose, Caddy HTTPS, đường hầm, thẻ image
Hướng dẫn Podman	Tích hợp Quadlet systemd, podman-compose, SELinux
Triển khai VM	Hướng dẫn đầy đủ: thiết lập VM + nginx + Cloudflare
Triển khai Fly.io	Triển khai lên Fly.io với bộ nhớ lưu trữ bền vững
Hướng dẫn Termux	Chạy OmniRoute trên Android thông qua Termux
Hướng dẫn PWA	Cài đặt Progressive Web App, lưu vào bộ nhớ đệm, kiến trúc
Hướng dẫn gỡ cài đặt	Gỡ bỏ sạch sẽ cho tất cả phương thức cài đặt
Cấu hình môi trường	Đầy đủ các biến `.env` và tài liệu tham khảo

🧠 Tính năng & Kiến trúc

Tài liệu	Mô tả
Kiến trúc	Kiến trúc hệ thống, luồng dữ liệu và cơ chế nội bộ
Hướng dẫn nén	Quy trình 7 tùy chọn: tắt / nhẹ / tiêu chuẩn / mạnh / siêu nén / RTK / xếp chồng
Nén RTK	Nén đầu ra lệnh, bộ lọc, độ tin cậy, xác minh, khôi phục đầu ra thô
Công cụ nén	Caveman, RTK, quy trình xếp chồng, các giao diện dashboard/API/MCP
Định dạng quy tắc nén	Lược đồ gói quy tắc JSON cho bộ lọc Caveman và RTK
Gói ngôn ngữ nén	Phát hiện ngôn ngữ và biên soạn gói quy tắc Caveman
Hướng dẫn khả năng phục hồi	Bộ ngắt mạch, thời gian hồi, hàng đợi, chống hiệu ứng đám đông, giả mạo TLS
Công cụ Auto-Combo	Chấm điểm theo 16 yếu tố, gói chế độ, tự phục hồi
Hướng dẫn proxy	Hệ thống proxy 3 cấp, chợ 1proxy, CRUD registry
Các gói miễn phí	Danh mục tổng hợp: 34 nhóm định kỳ đã được lập tài liệu / 452 mục gói miễn phí đã được lập danh mục
Thư viện tính năng	Tham quan dashboard trực quan bằng ảnh chụp màn hình
Tài liệu mã nguồn	Hướng dẫn khám phá mã nguồn thân thiện với người mới bắt đầu

🤖 Giao thức & API

Tài liệu	Mô tả
Tham chiếu API	Tất cả endpoint kèm ví dụ
Đặc tả OpenAPI	Đặc tả OpenAPI 3.0
Máy chủ MCP	110 công cụ MCP, cấu hình IDE, client Python/TS/Go
Hướng dẫn máy chủ MCP	Cài đặt MCP, phương thức truyền tải và tham chiếu công cụ
Máy chủ A2A	Giao thức JSON-RPC 2.0, kỹ năng, truyền phát, quản lý tác vụ
Hướng dẫn máy chủ A2A	Thẻ tác nhân A2A, tác vụ, kỹ năng và truyền phát

📋 Dự án & Chất lượng

Tài liệu	Mô tả
Đóng góp	Thiết lập và hướng dẫn phát triển
Mô hình phân nhánh & phát hành	Đích đến của các PR (`release/*`), ý nghĩa của `main` và các thẻ
Nhật ký thay đổi	Lịch sử phát hành đầy đủ theo từng phiên bản
Chính sách bảo mật	Báo cáo lỗ hổng và các biện pháp bảo mật
Hướng dẫn i18n	Hỗ trợ 42 ngôn ngữ, quy trình dịch thuật, RTL
Danh sách kiểm tra phát hành	Các bước xác thực trước khi phát hành
Kế hoạch độ bao phủ	Chiến lược bao phủ kiểm thử cho hơn 39.000 khai báo kiểm thử tĩnh trên hơn 5.100 tệp kiểm thử được theo dõi

⭐ Những người đóng góp hàng đầu

OmniRoute được định hình bởi một cộng đồng mã nguồn mở đầy nhiệt huyết. Những cá nhân này đã có những đóng góp xuất sắc, tác động trực tiếp đến chất lượng, độ ổn định và phạm vi tiếp cận của dự án. Xin cảm ơn.

Những người đóng góp bên ngoài theo số lượng pull request đã hợp nhất

Hạng	Người đóng góp	PR đã hợp nhất	~Số dòng thay đổi
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

_{Được chốt tại đầu mút hiện hành của release/v3.8.50 là dafb4ae808, với các lần hợp nhất tính đến 2026-08-24 05:26:03 UTC. Thống kê GitHub GraphQL có phân trang chứa 5.911 PR đã hợp nhất: 2.707 PR của chủ sở hữu kho lưu trữ, 179 PR của Dependabot và 3.025 PR bên ngoài từ 535 người đóng góp riêng biệt. “Số dòng thay đổi” là tổng số dòng thêm và xóa theo GitHub, bao gồm các tệp được tạo tự động, lockfile, danh mục, bản dịch và tài liệu; đây là mức độ biến động, không phải số dòng mã do tác giả viết. Các trường hợp đồng hạng tại ngưỡng giới hạn vẫn được giữ lại.}

Các commit được GitHub ghi nhận

backryun _{🥇 220 commit được ghi nhận trên GitHub}	Paijo _{🥈 219 commit được ghi nhận trên GitHub}	Randi _{🥉 108 commit được ghi nhận trên GitHub}	Ravi Tharuma _{🏅 81 commit được ghi nhận trên GitHub}	Chris _{🏅 70 commit được ghi nhận trên GitHub}	Markus Hartung _{🏅 69 commit được ghi nhận trên GitHub · đồng hạng #6}
Dizzle _{🏅 69 commit được ghi nhận trên GitHub · đồng hạng #6}	Jan Leon _{🏅 64 commit được ghi nhận trên GitHub}	zenobit _{🏅 62 commit được ghi nhận trên GitHub}	Bob.Hou _{🏅 51 commit được ghi nhận trên GitHub · đồng hạng #10}	Xiangzhe _{🏅 51 commit được ghi nhận trên GitHub · đồng hạng #10}

_{Được kiểm tra lại vào 2026-08-24 06:14:31 UTC: số commit được ghi nhận trên GitHub do API Contributors của kho lưu trữ báo cáo cho nhánh mặc định release/v3.8.50. API trả về 525 danh tính (415 người dùng, 2 bot, 108 người ẩn danh); bảng này loại trừ người bảo trì, bot và các danh tính ẩn danh, đồng thời giữ nguyên các trường hợp đồng hạng. Bảng này khác với cả bảng xếp hạng PR đã hợp nhất ở trên và thống kê 639 người dựa trên siêu dữ liệu Git ở dưới.}

🙏 Các tính năng, bản sửa lỗi và cải tiến cơ sở hạ tầng của những người đóng góp này là một phần cốt lõi giúp OmniRoute trở nên đáng tin cậy và giàu tính năng. Mọi pull request, mọi trường hợp kiểm thử và mọi tệp bản dịch i18n đều quan trọng. Mã nguồn mở được xây dựng bởi những người như họ.

💖 Nhà tài trợ

Xin chân thành cảm ơn những người đã tự bỏ tiền túi tài trợ cho OmniRoute — mỗi đóng góp đều giúp dự án tiếp tục miễn phí, độc lập và phát triển.

Andrew
_{💛 Nhà tài trợ hằng tháng đang hoạt động}

Vlad I
_{💛 Nhà tài trợ hằng tháng đang hoạt động}

Paco Cartones
_{💛 Nhà tài trợ một lần đang hoạt động}

GS. Igor Morais
_{💛 Người ủng hộ một lần trước đây}

longtao
_{💛 Người ủng hộ một lần trước đây}

_{… và những người khác muốn giữ danh tính riêng tư 💛}

_{Các nhà tài trợ công khai trên GitHub được xác minh lại vào 2026-08-24. Trạng thái activeOnly của GitHub xác định các nhãn đang hoạt động ở trên; những người ủng hộ công khai một lần đã được công bố trước đây vẫn được ghi nhận, còn các nhà tài trợ riêng tư vẫn được giữ ẩn danh.}

💖 Trở thành nhà tài trợ → — mỗi đô la đều giúp OmniRoute tiếp tục miễn phí và độc lập.

👥 Hơn 600 người đóng góp

_{Được kiểm tra vào 2026-08-24 tại cơ sở cố định ac02c5b42f và kiểm tra lại tại đầu nhánh trực tiếp release/v3.8.50 với mã dafb4ae808: 639 danh tính Git của con người đã được chuẩn hóa — 407 xuất hiện với tư cách tác giả commit (bao gồm cả người bảo trì) và 232 chỉ xuất hiện trong các trailer Co-authored-by rõ ràng. Quá trình thống kê chuẩn hóa các handle noreply của GitHub, loại trừ 26 danh tính bot/tác nhân/dịch vụ/giữ chỗ và không hợp nhất các địa chỉ email thông thường chỉ vì tên hiển thị của chúng trùng nhau.}

Cách đóng góp

Fork kho lưu trữ
Tạo nhánh từ đầu nhánh đang hoạt động release/vX.Y.Z (không phải main) — xem Mô hình phân nhánh và phát hành
Tạo nhánh tính năng của bạn (git checkout -b feat/amazing-feature)
Commit các thay đổi của bạn (git commit -m 'feat: add amazing feature')
Push lên nhánh (git push origin feat/amazing-feature)
Mở một Pull Request với base = nhánh release/vX.Y.Z đó

Xem CONTRIBUTING.md để biết hướng dẫn chi tiết.

Phát hành phiên bản mới

# Tạo một bản phát hành — npm publish sẽ diễn ra tự động
VERSION=x.y.z
gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes

📊 Sao

🌍 StarMapper

🙏 Lời cảm ơn

OmniRoute được xây dựng dựa trên thành quả của những người tiên phong. Dự án khởi đầu như một bản phân nhánh của 9router và một bản chuyển đổi sang TypeScript từ dự án Go CLIProxyAPI — và từ đó, mỗi hệ thống con bên dưới đều được truyền cảm hứng bởi một dự án mã nguồn mở đã tiên phong trong lĩnh vực tương ứng. Mỗi dự án đều góp phần định hình một thành phần cụ thể của OmniRoute. Đây là lời cảm ơn của chúng tôi dành cho tất cả các dự án đó. 🙏

⭐ số sao được xác minh từ REST API của GitHub vào ngày 24 tháng 8 năm 2026 — hãy tặng sao cho các dự án này. Các con số là ảnh chụp nhanh chính xác tại thời điểm đó và đương nhiên sẽ thay đổi.

🧬 Nguồn gốc & cổng kết nối

Dự án	⭐	Nguồn cảm hứng cho OmniRoute
9router	26,161	Dự án gốc làm nền tảng cho bản fork này — được mở rộng tại đây với các API đa phương thức và được viết lại hoàn toàn bằng TypeScript.
CLIProxyAPI	48,497	Bản triển khai bằng Go đã truyền cảm hứng cho bản chuyển đổi sang JavaScript / TypeScript này.
LiteLLM	57,100	Cổng AI có tập dữ liệu giá công khai cung cấp dữ liệu cho quy trình đồng bộ theo dõi chi phí của chúng tôi, đồng thời mô hình chuẩn hóa nhà cung cấp của dự án này đã định hình cơ chế định tuyến của chúng tôi.
codex-chatgpt-web	1,410	Mã nguồn MIT được điều chỉnh để tích hợp vào cầu nối ChatGPT Web → Codex Responses đi kèm, bao gồm các bộ điều hợp phiên trình duyệt, đóng khung phản hồi, mức sử dụng và tìm kiếm web.
free-claude-code	48,112	Các mẫu thiết kế được chuyển sang cơ chế khôi phục luồng, bí danh không suy luận, tìm kiếm web dự phòng, giới hạn cửa sổ trượt, ẩn dữ liệu nhạy cảm trong nhật ký và các luồng trình khởi chạy được gia cố.
composer-api	322	Các mẫu chọn công cụ, ràng buộc đầu ra và xác nhận công cụ của Cursor Composer được điều chỉnh để tích hợp vào trình thực thi Cursor gốc.
codex-multi-auth	457	Các mẫu đăng nhập mới và luân phiên token làm mới được chuyển sang quy trình xác thực lại Codex OAuth.
opencode-anthropic-auth	510	Các giá trị mặc định chuyển đổi tương thích với Claude Code và hành vi tiêu đề thanh toán được tổng quát hóa thành cầu nối dựa trên cấu hình của OmniRoute.
grok2api-merged	2	Các ánh xạ mô hình Grok, trình tạo Statsig giả lập TypeError, giá trị mặc định cho yêu cầu và thiết bị, cùng bộ xử lý phản hồi NDJSON của dự án này đã được điều chỉnh đáng kể để tích hợp vào trình thực thi Grok Web của OmniRoute.
TQZHR/grok2api	705	Nguồn mã bắc cầu chính đứng sau grok2api-merged; các bản triển khai mô hình, tiêu đề, tải trọng, Statsig và bộ xử lý của dự án này được bảo tồn trong dòng phát triển Grok Web.
chenyme/grok2api	7,520	Nguồn MIT nền tảng cho các giá trị mặc định của tải trọng và thiết bị Grok, trình tạo Statsig và bộ xử lý `result.response` được kế thừa qua TQZHR và grok2api-merged.
grok2api-pro	27	Một nguồn bắc cầu được grok2api-merged ghi nhận cho lớp nhóm proxy; OmniRoute bảo tồn thông báo về nguồn gốc đó nhưng không tuyên bố đã chuyển lớp nhóm proxy sang trình thực thi Grok Web có phạm vi giới hạn của mình.
GrokProxy	50	Proxy Grok được xác thực bằng cookie và mẫu truyền phát trực tuyến `result.response.token` của dự án này đã định hình cơ chế truyền tải Grok Web của OmniRoute.
GrokBridge	5	Bản triển khai Grok Web ban đầu đã tham khảo thiết kế đầu nguồn HTTP/trình duyệt của dự án này; đường dẫn HTTP trực tiếp của nó bắt nguồn từ GrokProxy, vì vậy không tuyên bố có hoạt động chuyển mã độc lập.
grok-web-api	14	Các lược đồ `ChatOptions` và vỏ phản hồi bằng Rust của dự án này đã định hình các kiểu yêu cầu Grok và phản hồi truyền phát trực tuyến bằng TypeScript của OmniRoute.

🗜️ Nén ngữ cảnh & token — các công cụ xử lý

Dự án	⭐	Nguồn cảm hứng cho OmniRoute
Caveman	100,538	Dự án lan truyền mạnh với triết lý "tại sao dùng nhiều token khi ít token vẫn làm được việc" — triết lý nói kiểu người tiền sử của dự án này là nền tảng cho chế độ nén tiêu chuẩn và hơn 30 quy tắc loại bỏ từ thừa/cô đọng của chúng tôi.
RTK – Rust Token Killer	77,185	Nén đầu ra lệnh hiệu năng cao — truyền cảm hứng cho engine RTK, DSL bộ lọc JSON, khả năng khôi phục đầu ra thô và pipeline xếp tầng RTK → Caveman của chúng tôi.
headroom	67,310	Nén ngữ cảnh có thể đảo ngược (SmartCrusher) — truyền cảm hứng cho engine `headroom` và mẫu dấu truy xuất `ccr` của chúng tôi.
LLMLingua	6,598	Nghiên cứu nén prompt (LLMLingua / LLMLingua-2) — truyền cảm hứng cho engine `llmlingua` bất đồng bộ, an toàn với mã và tiếp tục hoạt động khi có lỗi của chúng tôi.
llmlingua-2-js	31	Bản chuyển sang JS/ONNX (MobileBERT / XLM-RoBERTa) được dùng làm backend luồng worker cho engine LLMLingua của chúng tôi.
Troglodita	40	Nén token PT-BR — là nền tảng cho gói ngôn ngữ pt-BR của chúng tôi: giảm lối diễn đạt trùng ý và loại bỏ từ thừa, được tinh chỉnh cho ngữ pháp tiếng Bồ Đào Nha Brazil.
ponytail	108,957	Kỹ năng lập trình YAGNI kiểu "lập trình viên cấp cao lười biếng" từng lan truyền mạnh — truyền cảm hứng cho Kiểu đầu ra less-code của chúng tôi: định hướng theo thay đổi nhỏ nhất vẫn hoạt động, giúp giảm lượng mã _được sinh ra_ (đối tác trên trục đầu ra của văn phong súc tích từ Caveman).
i-have-adhd	23,526	Phong cách phản hồi ưu tiên hành động, thân thiện với người mắc ADHD của dự án đã được điều chỉnh thành phong cách đầu ra súc tích của OmniRoute trên năm ngôn ngữ.

🧩 Định dạng nhỏ gọn, nghiên cứu token & công cụ nhận biết mã

Dự án	⭐	Nguồn cảm hứng cho OmniRoute
TOON	25,233	Ký pháp đối tượng hướng token — mô hình dạng cột với phần đầu và các hàng của dự án đã định hình giai đoạn nén dạng bảng của chúng tôi.
GCF – Graph Compact Format	41	Định dạng đồ thị nhỏ gọn và thiết kế hồ sơ tổng quát của dự án đã định hướng cho cơ chế nén dạng bảng và định dạng codec Headroom của OmniRoute.
gcf-typescript	4	Phần triển khai TypeScript theo giấy phép MIT được tích hợp trực tiếp và mở rộng thành codec hồ sơ tổng quát Headroom.
token-optimizer-mcp	494	Bộ nhớ đệm Brotli/SQLite + phần chênh lệch ngữ cảnh theo phiên — truyền cảm hứng cho engine `session-dedup` của chúng tôi.
token-savior	1,122	Nén đầu ra Bash + hồ sơ MCP — truyền cảm hứng cho nguyên tắc dừng nén đúng lúc và việc rút gọn bản kê công cụ MCP của chúng tôi.
token-saver	138	Nén đầu ra theo từng loại tệp, có nhận biết nội dung và dừng đúng lúc khi có lỗi — xác nhận tính đúng đắn của cơ chế phân luồng theo loại và bỏ qua khi mức cải thiện chưa đạt ngưỡng tối thiểu của chúng tôi.
token-optimizer	1,951	"Tìm những token ma" — mẫu giảm tải + tay cầm có thể khôi phục của dự án đã định hướng tư duy giảm tải CCR của chúng tôi.
TokenMizer	28	Một bản thiết kế đồ thị phiên + loại bỏ dòng trùng lặp giữa các lượt, giúp định hướng thiết kế session-dedup của chúng tôi.
OmniCompress	3	JSON dạng cột bằng Rust + truy xuất theo địa chỉ nội dung + loại bỏ trùng lặp giữa các thông điệp — xác nhận tính đúng đắn của thiết kế engine `headroom`/`ccr`/`session-dedup` và bất biến thân thiện với bộ nhớ đệm "dạng nén không phụ thuộc vào vị trí" của chúng tôi.
mcp-compressor	113	Nén schema/mô tả công cụ MCP — định hướng cho việc giảm số lượng mục trong bản kê công cụ MCP của chúng tôi.
RepoMapper	197	Xếp hạng bản đồ kho mã theo phong cách Aider — định hướng cho quá trình khám phá bản đồ kho mã / xếp hạng truy xuất của chúng tôi.
quiet-shell-mcp	4	Rút gọn đầu ra shell theo kiểu khai báo qua MCP — xác nhận tính đúng đắn của cơ chế nén đầu ra bash theo kiểu khai báo của chúng tôi.
ts-morph	6,162	Bộ công cụ TypeScript Compiler API — truyền cảm hứng cho cơ chế xóa chú thích dựa trên trình phân tích cú pháp, đồng thời bảo toàn các literal chuỗi, template và biểu thức chính quy.

🧠 Bộ nhớ & RAG

Dự án	⭐	Nguồn cảm hứng cho OmniRoute
Mem0	63,902	Lớp bộ nhớ phổ quát — mô hình proxy đóng vai trò ranh giới ghi/đọc của dự án này đã định hình kiến trúc bộ nhớ của chúng tôi.
Letta (MemGPT)	24,382	Các tác tử có trạng thái với bộ nhớ phân tầng — truyền cảm hứng cho mô hình Kiểm soát & Khôi phục Ngữ cảnh (CCR) phân tầng của chúng tôi.
WFGY	1,781	Hệ thống phân loại ProblemMap gồm 16 chế độ lỗi RAG/LLM thường gặp — bộ thuật ngữ chung trong hướng dẫn khắc phục sự cố của chúng tôi.

🛰️ Kiểm tra lưu lượng, MITM & proxy trong suốt

Dự án	⭐	Nguồn cảm hứng cho OmniRoute
llm-interceptor	66	Việc chặn/phân tích MITM đối với lưu lượng giữa trợ lý lập trình ↔ LLM đã góp phần định hình các yêu cầu ban đầu của Trình kiểm tra Lưu lượng. Bốn mô-đun được phái sinh trước đây — hợp nhất SSE, chuẩn hóa hội thoại, che giấu bí mật và làm sạch tiêu đề — đã được thay thế bằng các bản triển khai phòng sạch độc lập dựa trên các tiêu chuẩn giao thức công khai. Hai bề mặt chuyển tiếp máy chủ (`passthrough.ts` và `_internal/bypass.cjs`) vẫn là các bản triển khai nội bộ của OmniRoute được phân loại độc lập; chúng không được viết lại trong quá trình thay thế đó.
ProxyBridge	5,995	Định tuyến proxy trong suốt theo từng tiến trình — truyền cảm hứng cho cơ chế gỡ bỏ MITM an toàn khi gặp sự cố, thời gian chờ khi socket không hoạt động, truy nguồn tiến trình qua `/proc` và bắt lưu lượng bằng TPROXY của chúng tôi.

📚 Dữ liệu mô hình, khả năng quan sát & giao diện người dùng

Dự án	⭐	Nguồn cảm hứng cho OmniRoute
models.dev	6,555	Cơ sở dữ liệu mở về thông số kỹ thuật, giá cả và khả năng của các mô hình AI — được đồng bộ nguyên bản vào danh mục mô hình của chúng tôi.
React Flow / xyflow	38,108	Thư viện đồ thị dựa trên nút hỗ trợ Compression Studio và Combo/Routing Studio theo thời gian thực của chúng tôi.
LangGraph	40,314	Khả năng trực quan hóa đồ thị quy trình làm việc trực tiếp của LangGraph Studio đã truyền cảm hứng cho chế độ xem chuỗi tầng theo thời gian thực trong các Studio của chúng tôi.
Langfuse	33,592	Mô hình khả năng quan sát dấu vết → khoảng đo → lần sinh của dự án này đã định hình biểu đồ thác nước trong Compression Studio của chúng tôi.
Kiali	3,631	Khả năng quan sát lưới dịch vụ Istio — truyền cảm hứng cho các huy hiệu bộ ngắt mạch và hình ảnh cạnh lỗi trong Routing/Combo Studio của chúng tôi.
lobe-icons	2,428	Các logo thương hiệu AI/LLM dùng để hiển thị biểu tượng nhà cung cấp trên toàn bộ bảng điều khiển của chúng tôi.
flag-icons	12,354	Cung cấp các lá cờ SVG được cấp phép theo MIT, dùng trong bộ chọn ngôn ngữ của README.

🛡️ Bảo mật

Dự án	⭐	Nguồn cảm hứng cho OmniRoute
awesome-secure-defaults	721	Danh sách tuyển chọn các thư viện bảo mật theo mặc định, định hướng cho những lựa chọn bảo mật của chúng tôi (Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink).

🧭 Công cụ bổ trợ

Dự án	⭐	Nguồn cảm hứng cho OmniRoute
ClawRouter	6,564	Truyền cảm hứng cho việc loại bỏ yêu cầu trùng lặp, phương án dự phòng khẩn cấp không tốn chi phí, các chiến lược Auto-Combo có thể cắm ghép và phân loại ý định đa ngôn ngữ.
Antigravity-Manager	30,652	Cơ chế ánh xạ lại mô hình có xét đến tài khoản, xác thực đường dẫn tệp thực thi và hành vi nhãn gói của dự án này đã góp phần định hình môi trường chạy Antigravity của OmniRoute.
vscode-antigravity-cockpit	4,817	Định dạng đếm ngược đặt lại hạn ngạch nhỏ gọn của dự án này đã truyền cảm hứng cho phần hiển thị giới hạn nhà cung cấp tương ứng trong OmniRoute.
AionUi	32,230	Các tích hợp ACP của dự án này đã truyền cảm hứng cho khả năng tự động phát hiện các tác tử CLI đã cài đặt của OmniRoute.
CodexBar	20,507	Đã xác định bề mặt hạn ngạch Grok Build; sau đó OmniRoute tự xác minh và sửa định dạng truyền dẫn trực tiếp một cách độc lập.

📄 Giấy phép

Giấy phép MIT - xem LICENSE để biết chi tiết.

⬆ Quay lại đầu trang · Được xây dựng với ❤️ dành cho cộng đồng AI mã nguồn mở.

_{OmniRoute v3.8.51 · Node ≥22.22.2 · Giấy phép MIT · omniroute.online}

README.md Unescape Escape

README (Tiếng Việt)

🚀 OmniRoute — Cổng AI Miễn Phí

💰 ~1.47B Token Miễn phí / Tháng

⭐ Hãy gắn sao cho kho mã nếu OMNIROUTE đã giúp bạn tiết kiệm tiền và làm việc dễ dàng hơn.

💬 Tham gia cộng đồng

📈 Gateway Không Ngừng Phát Triển

🧩 Khả dụng

🆓 Hoạt động ngay sau khi cài đặt — không cần khóa, không cần cấu hình

💥 Cam kết

🤔 Tại sao chọn OmniRoute?

🤝 Được hỗ trợ bởi những Người bạn Mã nguồn Mở của chúng tôi

🎯 Combo — Tính năng chủ lực

⚡ Không cần cấu hình — chỉ cần dùng auto

🔀 Hoặc tự xây dựng — 19 chiến lược định tuyến

🧱 Khả năng phục hồi được tích hợp sẵn (3 lớp độc lập)

🏆 Điều gì khiến OmniRoute khác biệt

💚 Hỗ trợ OmniRoute

📡 OmniRoute Radar

✨ Có gì mới

🤖 Các CLI & tác nhân lập trình tương thích

🌐 352 Nhà cung cấp AI — 152 nhà cung cấp được đánh dấu miễn phí trong danh mục

🏢 Mọi phòng thí nghiệm lớn — thông qua một endpoint duy nhất

🆓 Miễn phí vĩnh viễn — $0, không cần thẻ

🖥️ OmniRoute Chạy Ở Đâu — Mọi Nơi

🧩 Mới: OmniRoute bên trong Copilot Chat nguyên bản của VS Code

🎩 Mới: OmniRouteTray — cổng kết nối của bạn, nằm ngay trên thanh menu

🔒 Riêng tư & Ưu tiên cục bộ

🔌 CLI đầy đủ + A2A & MCP

⌨️ Một CLI thực thụ (không chỉ có start)

🛰️ Chế độ từ xa — chạy CLI tại đây, OmniRoute trên VPS

🤝 Kết nối một tác nhân — và tác nhân đó tự điều khiển OmniRoute

🗜️ Tiết kiệm 15–95% token — Tự động

📖 Cách hoạt động — quy trình, kiến trúc & phép tính mức tiết kiệm

🧱 Ngăn xếp 12 công cụ

🎚️ Không chỉ các engine — kiểu đầu ra, nút điều chỉnh thích ứng & khả năng kiểm soát theo từng yêu cầu

⚡ Bắt đầu nhanh

📦 Các phương thức cài đặt khác — Docker, mã nguồn, pnpm, Arch

🎬 OmniRoute trong thực tế

📹 Hướng dẫn bằng video

📧 Cộng đồng & Trợ giúp

🛠️ Ngăn xếp công nghệ

📖 Tài liệu

📘 Bắt đầu

🔧 Vận hành & Triển khai

🧠 Tính năng & Kiến trúc

🤖 Giao thức & API

📋 Dự án & Chất lượng

⭐ Những người đóng góp hàng đầu

Những người đóng góp bên ngoài theo số lượng pull request đã hợp nhất

Các commit được GitHub ghi nhận

💖 Nhà tài trợ

👥 Hơn 600 người đóng góp

Cách đóng góp

Phát hành phiên bản mới

📊 Sao

🌍 StarMapper

🙏 Lời cảm ơn

🧬 Nguồn gốc & cổng kết nối

🗜️ Nén ngữ cảnh & token — các công cụ xử lý

🧩 Định dạng nhỏ gọn, nghiên cứu token & công cụ nhận biết mã

🧠 Bộ nhớ & RAG

🛰️ Kiểm tra lưu lượng, MITM & proxy trong suốt

📚 Dữ liệu mô hình, khả năng quan sát & giao diện người dùng

🛡️ Bảo mật

🧭 Công cụ bổ trợ

📄 Giấy phép

README.md

⚡ Không cần cấu hình — chỉ cần dùng `auto`

⌨️ Một CLI thực thụ (không chỉ có `start`)