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

# 🚀 OmniRoute — 무료 AI 게이트웨이 **[Diego Souza](https://github.com/diegosouzapw)가 제작** OmniRoute — 코딩을 절대 멈추지 마세요. 모든 AI 도구 → 하나의 엔드포인트를 통해 388개 제공업체 — 150개 이상 무료 — Claude Code, Codex, Cursor, Cline, Copilot 및 Antigravity를 무료 Claude / GPT / Gemini로 자동 대체 기능과 함께 연결합니다. RTK + Caveman 스택 압축으로 토큰을 15–95% 절약(평균 약 89%)하여 한도에 도달하지 않습니다. AI 제공업체 388개 · 무료 티어 150개 이상 · 월 약 16.2억 개의 무료 토큰 · 라우팅 전략 20개 · $0로 시작.

OmniRoute — 코딩을 절대 멈추지 마세요. 모든 AI 도구 → 하나의 엔드포인트를 통해 388개 제공업체 — 150개 이상 무료 — Claude Code, Codex, Cursor, Cline, Copilot 및 Antigravity를 무료 Claude / GPT / Gemini로 자동 대체 기능과 함께 연결합니다. RTK + Caveman 스택 압축으로 토큰을 15–95% 절약(평균 약 89%)하여 한도에 도달하지 않습니다. AI 제공업체 388개 · 무료 티어 150개 이상 · 월 약 16.2억 개의 무료 토큰 · 라우팅 전략 20개 · $0로 시작.

## 💰 타사 무료 요금제 전체에서 월 ~1.62B 토큰

> **사용자 본인의 프로바이더 계정을 사용하세요.** 이는 각각 별도로 이용 자격이 있는 타사 무료 요금제를 합산한 추정치이며, OmniRoute가 제공하는 토큰 지급량이 아닙니다. 가입하고, 필요한 경우 인증 정보를 발급받은 다음, 사용할 수 있는 프로바이더를 연결하세요. 각 프로바이더가 자체 한도, 이용 가능 여부 및 약관을 관리합니다. > > 무료 요금제를 직접 조합하는 일은 번거롭습니다 — 수십 개의 SDK, 수십 개의 요청 제한, 그리고 실제로 얼마나 사용할 수 있는지 알 수 없습니다. OmniRoute는 **34개의 반복 풀 키에 걸쳐 465개의 무료 요금제 항목을 목록화**하고, 공유 풀을 중복 제거한 뒤 **공개된 양수 월간 예산이 있는 17개 풀과 모델별 Groq 한도 5개**를 기준으로 토큰 총량을 계산합니다. 지역 신원 확인 후에만 활성화되는 할당량(현재: ModelScope)은 별도로 표시되며, 지역 신원 확인 후 추가되는 약 +6M은 헤드라인에 합산되지 않습니다. 결과는 대시보드(`/dashboard/free-tiers`)에서 계속 확인할 수 있습니다.

OmniRoute 무료 요금제 예산 카드: 월간 무료 토큰은 안정적으로 ~1.62B, 가입 크레딧을 포함하면 첫 달에는 최대 ~2.22B이며, 하나의 엔드포인트 뒤에 34개의 문서화된 반복 풀 키와 465개의 목록화된 무료 요금제 항목이 포함됩니다. 정직한 풀 중복 제거 방식으로 계산하며 — 공유 풀은 각각 한 번만 계산하고, 공개된 양수 월간 토큰 예산이 있는 17개의 반복 풀과 모델별 Groq 한도 5개를 포함합니다. 약관 위험 카탈로그에서는 12개 프로바이더가 사용 자제로 표시되어 있으므로 사용 여부를 직접 결정할 수 있습니다. 예산 막대에는 Mistral 1B, Nara 210M, LLM7 150M, xKiro 150M, Groq 30M(모델별 한도 5개) 및 더 작은 풀과 첫 달 가입 크레딧이 포함되며, 영구 무료이면서 토큰 한도가 없는 프로바이더는 별도로 표시되어 헤드라인을 부풀리지 않습니다. /dashboard/free-tiers에서 실시간 사용량 및 잔여량을 확인할 수 있습니다.

> 실시간 `/dashboard/free-tiers` 페이지의 애니메이션 요약입니다. 전체 방법론(풀 중복 제거, 크레딧 등급, 프로바이더 약관): **[docs/reference/FREE_TIERS.md](docs/reference/FREE_TIERS.md)**. > > _{이 수치는 2주마다 실시간 카탈로그를 기준으로 다시 감사되며 **양방향으로 변동합니다** — 프로바이더가 무료 요금제를 종료하면 숫자가 감소하고, 새로운 프로바이더가 추가되면 증가합니다. 카탈로그가 실제로 계산한 값을 게시하며, 반올림해 올린 최상의 경우를 게시하지 않습니다.}

OMNIROUTE가 비용을 절약하고 작업을 더 쉽게 만드는 데 도움이 되었다면 저장소에 ⭐를 눌러 주세요.

[![별](https://img.shields.io/github/stars/diegosouzapw/OmniRoute?style=social)](https://github.com/diegosouzapw/OmniRoute)

[![별 기록 순위](https://api.star-history.com/badge?repo=diegosouzapw/OmniRoute&theme=dark)](https://www.star-history.com/diegosouzapw/omniroute) [![olud.ai](https://olud.ai/badge.php?tool=diegosouzapw-omniroute)](https://olud.ai/project/diegosouzapw-omniroute.html) ### 💬 커뮤니티에 참여하세요 **👋 메인테이너를 팔로우하세요 — 새로운 프로바이더, 릴리스 및 팁을 가장 먼저 받아보세요:** [![LinkedIn에서 Diego 팔로우](https://img.shields.io/badge/Follow_Diego_on-LinkedIn-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/diegosouzapw/) [![GitHub에서 @diegosouzapw 팔로우](https://img.shields.io/github/followers/diegosouzapw?style=for-the-badge&logo=github&logoColor=white&label=Follow%20on%20GitHub&color=181717)](https://github.com/diegosouzapw) [![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/U47eFqAXCn) [![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/omnirouteOficial) [![WhatsApp 글로벌](https://img.shields.io/badge/WhatsApp_Global-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) [![WhatsApp 브라질](https://img.shields.io/badge/WhatsApp_Brasil-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) [![웹사이트](https://img.shields.io/badge/Website-omniroute.online-blue?logo=google-chrome&logoColor=white)](https://omniroute.online) **질문, 프로바이더 팁, 로드맵 및 지원 → [Discord](https://discord.gg/U47eFqAXCn) · [Telegram](https://t.me/omnirouteOficial) · WhatsApp [🌍 글로벌](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) / [🇧🇷 브라질](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) / [포털](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK)**
## 📈 게이트웨이는 계속 성장하고 있습니다

| | v3.8.50 | **v3.8.51** | `v3.8.54+` | | ----------------------- | :-----------------------: | :---------: | :-------------------: | | 🌐 제공업체 | 352 | **358** | 388 | | 🧠 고유 채팅 모델 ID | 1320 | **1374** | 1491 | | 🖼️ 모달리티 브리지 | 🆕 비전 + 오디오 + 비디오 | ✓ | ✓ | | 📡 Radar 무료 카탈로그 | 🆕 옵트인 | ✓ | ✓ | | ⚖️ 할당량 인식 스케줄링 | 🆕 Quota-Share | ✓ | ✓ | | 📊 할당량 원격 측정 | 🆕 실시간 | ✓ | ✓ | | 🧰 헤드리스 모드 | — | — | 🆕 `serve --headless` | | 🛤️ LTS 레일 인프라 | — | — | 🆕 릴리스 채널 | | 🔎 모델 검색 API | — | — | 🆕 `/v1/models/query` | **→ [로드맵](ROADMAP.md) — `v3.9.0 LTS`를 향해 레일을 달립니다**

## 🧩 사용 가능 [![npm 버전](https://img.shields.io/npm/v/omniroute?color=cb3837&logo=npm)](https://www.npmjs.com/package/omniroute) ![NPM 월간 다운로드](https://img.shields.io/npm/dm/omniroute?label=npm/month&color=cb3837&logo=npm) [![Docker Hub](https://img.shields.io/docker/v/diegosouzapw/omniroute?label=Docker%20Hub&logo=docker&color=2496ED)](https://hub.docker.com/r/diegosouzapw/omniroute) ![라이선스: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) ![Docker 다운로드](https://img.shields.io/docker/pulls/diegosouzapw/omniroute?label=docker%20pulls&logo=docker&color=2496ED) ![Electron 다운로드](https://img.shields.io/github/downloads/diegosouzapw/omniroute/total?style=flat&label=electron%20downloads&logo=electron&color=47848F)

🚀 시작	🚀 빠른 시작	📦 설치	🆓 제공업체 연결
💡 알아보기	💥 약속	🤔 OmniRoute를 사용해야 하는 이유	🏆 차별화된 점
⚙️ 기능	🎯 콤보	🌐 제공업체	🔌 CLI 및 MCP
	🗜️ 자동으로 15.95% 토큰 절약	🖥️ 실행 환경	🔒 비공개
👀 살펴보기	🎬 실제 사용 모습	✨ 새로운 소식	🤖 호환 CLI
💚 지원	💚 지원 / 기부	💬 커뮤니티	💖 후원자
📦 프로젝트	🛠️ 기술 스택	📖 문서	👥 기여자

🌐 67개 언어로 제공

## 🆓 설치하고, 공급자를 연결한 다음, 하나의 엔드포인트를 통해 라우팅하세요

세 단계: OmniRoute를 설치하고 시작한 다음, 자신의 계정 또는 API 키로 적격 공급자를 연결하고, OmniRoute API 키와 모델 auto를 사용해 도구가 localhost:20128/v1을 가리키도록 합니다. 라우팅은 사용 가능한 적격 연결과 공급자 제한에 따라 달라집니다.

```bash # 공급자를 연결한 후 대시보드 → 엔드포인트에서 OmniRoute 키를 복사합니다: curl http://localhost:20128/v1/chat/completions \ -H "Authorization: Bearer YOUR_OMNIROUTE_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"auto","messages":[{"role":"user","content":"Hello!"}]}' ``` _{`auto`에는 적격 라우트가 필요합니다. 새로 설치하면 적격한 키 없는 대상이 없을 수 있으며, 키 없는 공급자는 타사 클라이언트를 거부할 수 있습니다. Kiro를 포함하여 `tos: avoid`로 표시된 공급자는 기본적으로 자동 라우팅에서 제외됩니다. 계정을 연결해도 이 설정은 재정의되지 않습니다. 공급자를 선택하기 전에 [무료 티어 가이드](docs/getting-started/FREE-TIERS-GUIDE.md)를 참조하세요.} _{📦 **Python, Node.js, PHP 및 cURL**용 복사-붙여넣기 빠른 시작 스크립트 → [`examples/quickstart/`](examples/quickstart/)}

# 💥 약속

# 🤔 OmniRoute를 사용하는 이유

OmniRoute 요청 흐름: IDE 또는 CLI(Claude Code, Cursor, Cline…)가 하나의 로컬 엔드포인트(http://localhost:20128/v1)를 호출합니다. OmniRoute 스마트 라우터(RTK + Caveman 압축, 20가지 라우팅 전략, 회로 차단기, TLS 스텔스, MCP, A2A, 가드레일)는 적격하고 정상인 대상이 남아 있는 동안 4개 공급자 티어에 걸쳐 폴백할 수 있습니다 — 티어 1 구독, 티어 2 API 키, 티어 3 저렴한 요금, 티어 4 무료.

## 🤝 오픈 소스 친구들의 지원

> **오픈 소스 친구로 참여하고 싶으신가요?** 이들은 오픈 소스를 지지하고 OmniRoute가 계속 움직일 수 있도록 돕는 회사들입니다. 저희는 그들이 제공하는 모든 토큰이 어디에 사용되는지 공개적으로 밝힙니다. 연락처: [diegosouza.pw@outlook.com](mailto:diegosouza.pw@outlook.com)

Kimi
_{Moonshot AI} 이 프로젝트를 지원해 주신 창립 오픈 소스 친구인 Kimi (Moonshot AI)에게 감사드립니다! Kimi는 오픈 가중치 K2 및 K3 모델 제품군을 개발한 AI 연구소입니다. Kimi K3는 1M 토큰 컨텍스트 창, 네이티브 비전, 최첨단 코딩 기능을 폐쇄형 모델 가격의 일부로 제공하며, Claude Code, Codex 및 OmniRoute가 제공하는 모든 코딩 도구와 즉시 작동합니다.

Kimi의 지원이 제공하는 것: Kimi의 API 크레딧은 OmniRoute의 AI 검증 릴리스 파이프라인(모든 풀 리퀘스트가 배포되기 전에 검토하는 Kimi K3 기반 병합 검증 단계)과 일상적인 기능 개발을 지원합니다. 최고 수준의 Kimi 지원은 두 가지 방식으로 제공됩니다: 직접적인 Kimi API (kimi-k3)와 Kimi Code 코딩 플랜 (OAuth 및 API 키). OmniRoute는 또한 Kimi의 지원 프로그램에 참여하는 최초의 브라질 오픈 소스 프로젝트입니다. 15% 추가 크레딧이 포함된 Kimi API 키 받기 →

Cheaper Inference
_{cheaperinference.com} 이 프로젝트를 지원해 주신 OmniRoute 오픈 소스 친구인 Cheaper Inference에게 감사드립니다! Cheaper Inference는 비용 순위가 매겨진 게이트웨이로, Claude, GPT-5.x, Gemini, Kimi K3, GLM, DeepSeek, Grok 및 MiniMax 등 42개의 최첨단 모델을 하나의 OpenAI 호환 엔드포인트 뒤에서 재판매하며, 모델 제작사의 정가 이상으로 청구하지 않고 각 요청을 가장 저렴한 적격 공급자에게 라우팅합니다.

OmniRoute의 최고 수준 지원: Chat Completions, 네이티브 /v1/responses 엔드포인트, 비전, 도구 호출 및 3개의 이미지 모델 (grok-imagine, nano-banana-pro, nano-banana-2, cheaperinference/<model>로 접근 가능). API 키 받기 →

_{aff=omniroute 태그가 붙은 링크는 파트너 링크입니다. 이 링크들은 사용자에게 추가 비용 없이 프로젝트에 자금을 지원합니다.}

_{🎟️ 제휴 프로모션 — 저희가 후원하지 않는 공급업체의 무료 가입 쿠폰 (클릭하여 확장)}

_{이 섹션은 추천/쿠폰 코드 전용입니다. 후원 파트너십은 위에 있는 🤝 오픈 소스 친구들의 지원 섹션에 있습니다. OmniRoute는 여기에 나열된 공급업체와 후원 또는 파트너십 관계가 없으며, 이들은 누구나 사용할 수 있는 공개 쿠폰입니다.}

_AgentRouter
_{agentrouter.org} _{AgentRouter — 제휴 가입 · 가입 시 $100 무료 크레딧 (무료 서버, 더 높은 지연 시간 예상 — 테스트용으로 최적, 프로덕션용 아님). v3.8.50부터 OmniRoute에서 최고 수준 지원: Chat Completions, Anthropic 호환 와이어 형식 및 OpenAI 호환 경로. 사용 가능한 모델에는 claude-opus-4-8, claude-opus-5, gpt-5.6-sol 등이 포함됩니다. $100 받기 →}

_{⚠️ 제휴 링크 — OmniRoute는 이 공급업체와 후원 또는 파트너십 관계가 없습니다.}

_{OmniRoute 사용자에게 도움이 되는 관대한 무료 가입 쿠폰을 제공하는 다른 공급업체를 알고 계신가요? 이슈를 열어주시면 여기에 추가하겠습니다.}

## 🎯 콤보 — 핵심 기능

20가지 콤보 라우팅 전략 중 18가지의 애니메이션 예시 — 전략별 타일: priority, fill-first, weighted, round-robin, p2c, least-used, random, strict-random, cost-optimized, headroom, reset-window, reset-aware, context-relay, context-optimized, lkgp, auto, fusion, pipeline. cache-optimized와 quota-weighted는 애니메이션으로 제공되지 않으며, 아래 표에서 20가지 전략을 모두 설명합니다.

> **콤보**는 OmniRoute가 **자동으로** 라우팅하는 모델 체인입니다. 할당량이 소진되거나, 공급자에 장애가 발생하거나, 비용이 급증하면 콤보는 조건을 충족하는 다음 정상 모델로 전환할 수 있습니다. 🛡️ ### ⚡ 설정 불필요 — `auto`만 사용하세요 콤보를 생성할 필요가 없습니다. 모델을 `auto`(또는 변형 모델)로 설정하면 OmniRoute가 연결된 공급자를 바탕으로 가상 콤보를 구성하고 실시간으로 점수를 산정합니다.

모델 ID	최적화 대상
`auto`	🎯 균형 잡힌 기본값(LKGP — 마지막으로 정상 작동한 공급자를 계속 사용)
`auto/coding`	🧑💻 코드 생성 품질을 우선하는 가중치
`auto/fast`	⚡ 지연 시간이 가장 짧은 대상을 우선
`auto/cheap`	💰 토큰당 비용이 가장 저렴한 대상을 우선
`auto/subscription`	🎟️ 이미 비용을 지불 중인 구독 할당량만 사용 — 사용 불가 시 즉시 실패하며, 유료 대체 경로는 사용하지 않음(가이드)
`auto/thrifty`	🪜 요금제 할당량을 먼저 사용한 다음, 가장 저렴한 유료 옵션으로 한 단계씩 이동 — 요금제 할당량이 초기화되면 다시 사용(가이드)
`auto/offline`	🔋 할당량/요청 한도 여유가 가장 큰 대상을 우선
`auto/smart`	🔭 품질 우선 + 더 나은 모델을 찾기 위한 10% 탐색
`auto/lkgp`	📌 마지막으로 정상 작동한 공급자를 명시적으로 고정
`auto/chaos`	🧪 모델 패널로 병렬 분산(공급자당 하나, 기본값 5개)하여 하나의 답변을 반환합니다. 패널 모델마다 업스트림 호출이 한 번씩 발생하며, 장애 주입 기능은 아닙니다.

## ### 🔀 또는 직접 구성 — 20가지 라우팅 전략 **20가지** 전략 모두 콤보 단계별로 자유롭게 조합할 수 있습니다.

#	전략	기능
1	`priority`	첫 번째 대상을 우선하는 순서 지정 목록 — 각 대상을 소진한 후 다음 대상으로 이동 🥇
2	`fill-first`	각 대상의 할당량을 완전히 소진한 후 다음 대상으로 이동
3	`weighted`	대상별 가중치에 따른 가중 무작위 선택
4	`round-robin`	대상을 순서대로 순환
5	`p2c`	두 개 선택 방식의 무작위 부하 분산
6	`least-used`	현재 부하가 가장 낮은 대상을 선택
7	`random`	균등 무작위 선택(중복 제거)
8	`strict-random`	반복 항목을 중복 제거하지 않고 무작위 선택 🎲
9	`cost-optimized`	실시간 카탈로그 가격을 기준으로 요청당 비용을 최소화 💸
10	`headroom`	남은 할당량이 가장 많은 대상을 선택
11	`quota-weighted`	할당량이 소진된 계정은 건너뛴 후, 남은 할당량 ÷ 처리 중인 부하에 비례하여 선택 — 기존 대화는 고정 상태 유지 ⚖️
12	`reset-window`	할당량 기간이 가장 빨리 초기화되는 대상을 우선
13	`reset-aware`	할당량 초기화 시간을 기준으로 순위 지정 — 짧은 기간 우선 📊
14	`context-relay`	긴 대화를 위해 대상 간에 컨텍스트를 전달 🧠
15	`context-optimized`	현재 컨텍스트 크기에 가장 적합한 대상을 선택
16	`cache-optimized`	재사용 가능한 각 프롬프트 접두사를 동일한 계정에 고정 — 프롬프트 캐시 적중률 극대화 🎯
17	`lkgp`	마지막 정상 경로(Last-Known-Good Path) — 마지막으로 성공한 공급자에 고정한 후 규칙에 따라 대체 경로 사용
18	`auto`	모든 연결을 대상으로 16가지 요소를 실시간으로 평가 🤖
19	`fusion`	모델 패널로 분산 호출하고 판정 모델이 하나의 답변으로 종합 🧬
20	`pipeline`	단계를 연결 — 각 대상의 출력이 다음 대상의 입력으로 전달됨 🔗

_{Auto-Combo 엔진은 모든 후보를 **16가지 요소**(상태, 할당량, 비용, 지연 시간, 작업 적합성, 품질, 세션 가용성 등)로 평가합니다 — [`docs/routing/AUTO-COMBO.md`](docs/routing/AUTO-COMBO.md)를 참조하세요.} ## ### 🧱 복원력이 기본으로 내장되어 있습니다(독립적인 3개 계층)

OmniRoute 복원력 — 각 장애에 적합한 독립적인 3개의 자가 복구 계층. 계층 1 제공자 회로 차단기(전체 제공자): 408/5xx에서만 작동하며, 임계값은 OAuth 8회/API 키 12회/로컬 2회이고, 60초/30초/15초 후 HALF-OPEN 탐색 상태로 재설정되며 지연 복구를 사용합니다. OPEN 상태에서는 콤보가 다음 제공자로 경로를 변경합니다. 계층 2 연결 쿨다운(키/계정 하나): 기본값은 OAuth 5초/API 키 3초이며, 동시 재시도 폭주 방지 기능을 갖춘 지수형 ×2 백오프를 사용하고, 429에서는 Retry-After를 준수하며, 성공하면 모든 오류 상태를 초기화합니다. 쿨다운 중인 키 하나는 건너뛰지만 다른 키들은 계속 요청을 처리합니다. 계층 3 모델 잠금(모델 하나): 모델별 429, 로컬 404 또는 모드 거부는 해당 모델만 잠급니다 — 전체 연결은 절대 잠그지 않습니다. 최종 상태(차단됨, 만료됨, 크레딧 소진)는 쿨다운 대상이 아니라 운영자가 처리해야 합니다.

_{📖 [Auto-Combo 엔진](docs/routing/AUTO-COMBO.md) · [복원력 가이드](docs/architecture/RESILIENCE_GUIDE.md)}

## 🏆 OmniRoute의 차별점

_{📊 9router, OpenRouter, CLIProxyAPI 및 LiteLLM과의 전체 방법론 및 기능별 세부 정보 → [`docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md`](docs/comparison/OMNIROUTE_VS_ALTERNATIVES.md)}
## 💚 OmniRoute 후원하기 OmniRoute는 MIT 라이선스로 공개적으로 유지·관리됩니다. 시간이나 비용을 절약하는 데 도움이 되었다면, 독립성을 유지할 수 있도록 자신에게 맞는 방법으로 후원해 주세요. 후원은 라우팅 우선순위에 절대 영향을 주지 않습니다. 후원으로 얻는 것은 노출이지 순위가 아닙니다.

⭐ 저장소에 별표 표시	무료 — 인지도를 높이는 데 실질적으로 도움이 됩니다	OmniRoute에 별표 표시
🐙 GitHub Sponsors	일회성 또는 월간 후원 · 플랫폼 수수료 없음	github.com/sponsors/diegosouzapw
☕ Ko-fi	빠른 일회성 후원, 후원자는 가입 불필요	ko-fi.com/diegosouzapw
🧋 Buy Me a Coffee	소소하고 편안한 방식의 후원	buymeacoffee.com/diegosouzapw
🖐 Liberapay	정기 후원 · 비영리 · 오픈 소스	liberapay.com/diegosouzapw
🇧🇷 PIX (브라질)	즉시 송금, 수수료 없음	키 및 QR은 아래 참조
₿ 암호화폐	BTC · ETH · USDT-TRC20 · USDC-Solana	주소는 아래 참조

**🇧🇷 PIX** — 즉시 송금, 수수료 없음 (브라질) OmniRoute PIX QR 코드

키 (무작위): `5d865059-bc44-483a-962d-43ceb80126eb` Pix 복사 및 붙여넣기: ``` 00020101021126580014br.gov.bcb.pix01365d865059-bc44-483a-962d-43ceb80126eb5204000053039865802BR5922OMNIROUTE CONTRIBUICAO6006BRASIL62070503***630475DD ```

₿ 암호화폐 — BTC · ETH · USDT-TRC20 · USDC-Solana (클릭하여 펼치기)

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

_{⚠️ 각 코인은 표시된 네트워크에서만 전송하세요. 잘못된 네트워크로 전송하면 자금을 잃을 수 있습니다.}

🐛 버그를 발견했거나 의견이 있으신가요? [토론](https://github.com/diegosouzapw/OmniRoute/discussions)을 시작해 주세요.

개발자 참고 사항: 이 프로젝트는 개발 편의를 위해 npm 설치 또는 설치 후 과정에서 로컬 .env 파일을 생성할 수 있습니다. 이 파일은 의도적으로 .gitignore를 통해 무시되며(.gitignore 참조), 절대로 커밋해서는 안 됩니다. 실수로 커밋한 경우 노출된 모든 비밀 정보를 교체하고 기록에서 해당 파일을 제거하세요. 로컬 환경 파일 및 비밀 정보 관리 지침은 docs/DEVELOPER-ENVIRONMENT.md를 참조하세요.

## 📡 OmniRoute Radar 문서에 명시된 위의 풀 중복 제거 카탈로그를 기준으로, 무료 티어의 주요 수치는 여전히 **월 ~1.62B 토큰**입니다. 임시 제공업체 가입 크레딧을 활용하면 첫 달에는 별도로 **~2.22B**까지 늘어날 수 있습니다. Radar는 OmniRoute 릴리스 사이에도 최신 무료 모델 가용성 정보를 원하는 사용자를 위한 선택적 서명 카탈로그 오버레이입니다. 커뮤니티 카탈로그와 기존의 모든 무료 기능은 계속 무료로 제공됩니다. 후원자는 실시간 카탈로그와 추가 제공업체 이용 기회를 받을 수 있습니다. 별도로 운영되며 변경 가능한 최대 한도는 제공업체의 가용성에 따라 **월 최대 약 3B 토큰**입니다. 이 최대 한도는 보장되지 않습니다. 제공업체는 언제든 할당량, 자격 요건, 모델 또는 지역을 변경할 수 있습니다. Radar는 선택적으로 사용할 수 있으며 GET 전용입니다. OmniRoute 클라이언트는 프롬프트, 트래픽, 제공업체 구성, 사용량 텔레메트리 또는 로컬 공지 숨김 상태를 업로드하지 않습니다. 자격 요건과 현재 카탈로그에 대한 자세한 내용은 **[radar.omniroute.online/planos](https://radar.omniroute.online/planos)**에서 확인하세요.

## ✨ 새로운 기능

> **v3.8.20 → v3.8.54**의 주요 변경 사항입니다. 전체 변경 이력은 [`CHANGELOG.md`](CHANGELOG.md)에서 확인할 수 있습니다. - **⚖️ `quota-weighted` 라우팅** — 20번째 콤보 전략은 소진된 계정을 건너뛴 다음, 남은 할당량 ÷ 처리 중인 부하에 비례하여 나머지 계정 중에서 선택하므로 기존 대화는 계속 동일한 계정에 고정됩니다. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🧰 헤드리스 모드** — `omniroute serve --headless` (또는 `OMNIROUTE_HEADLESS=1`)는 대시보드와 대시보드 전용 하위 시스템을 끄고 `/v1/*` 프록시 엔진만 실행합니다. → [헤드리스 모드](docs/guides/HEADLESS.md) - **🔎 모델 검색** — `/v1/models`는 기능, 컨텍스트, 종류 및 텍스트로 필터링하며, `POST /v1/models/query`는 동일한 키별 표시 권한을 적용한 짧고 결정적인 후보 목록을 반환합니다. → [API 레퍼런스](docs/reference/API_REFERENCE.md) - **🔑 키별 라우팅 제어** — `forcedModel`을 사용하여 API 키를 하나의 모델 또는 콤보에 고정하고, 키의 모델과 콤보를 원자적으로 추가하거나 제거할 수 있습니다(`/api/keys/{id}/access`). → [API 레퍼런스](docs/reference/API_REFERENCE.md) · [OpenAPI](docs/openapi.yaml) - **🛡️ 세분화된 PII 제어** — 유형별 선택, 최대 20개의 검증된 사용자 지정 마스킹 패턴 및 유형별 감지 카운터를 지원하며, 마스킹 자체는 계속 선택 사항입니다. → [가드레일](docs/security/GUARDRAILS.md) - **🌍 67개 언어** — 대시보드, 문서 미러 및 CLI를 지원하며, `npm run i18n:add-locale` 한 번으로 모든 영역에 언어를 추가할 수 있습니다. → [i18n 가이드](docs/guides/I18N.md) - **🎛️ OmniConductor** — 에이전트 fleet으로의 인바운드 A2A 위임, Agent Card의 Conductor 스킬, Faro 푸시 투 토크 음성 채팅이 포함된 대시보드 패널을 제공합니다. → [A2A 서버](docs/frameworks/A2A-SERVER.md) - **🛂 적응형 요청 허용 및 과부하 보호** — 대규모 채팅 요청은 503을 반환하는 대신 대기열에 들어가며, 연결별 RPM 롤링 lease를 원자적으로 처리합니다. → [복원력 가이드](docs/architecture/RESILIENCE_GUIDE.md) - **🗂️ 정식 `/v1/models` 정렬** — 각 제공자마다 하나의 연속된 제공자 그룹 블록을 사용하며(콤보가 먼저 고정됨), 모든 카탈로그 소스에서 안정적으로 동일한 순서를 유지합니다. → [API 레퍼런스](docs/reference/API_REFERENCE.md) - **🗜️ 압축 강화** — 기본 활성화된 팽창 방지, DE / FR / JA 및 중국어(wényán)를 위한 Caveman 팩, Gradle 및 .NET용 RTK 필터를 제공합니다. → [압축](docs/compression/COMPRESSION_ENGINES.md) - **💸 정직한 정액 요금 비용** — 구독 / 코딩 플랜 제공자는 비용 분석에서 **$0**으로 표시되며, 예산, 할당량 및 라우팅은 계속 추정치를 계산합니다. → [API 레퍼런스](docs/reference/API_REFERENCE.md) - **⚖️ Quota-Share 라우팅** — 공유 계정의 할당량을 풀링된 키에 공정하게 분배하며, 유휴 슬라이스를 대여하여 작업을 계속 처리할 수 있도록 합니다. → [복원력 가이드](docs/architecture/RESILIENCE_GUIDE.md) - **🤖 한 번의 명령으로 CLI/에이전트 설정** — 15개의 등록된 `setup-*` 명령을 제공합니다. `omniroute run`은 7개의 CLI(Claude Code, Codex, Aider, Goose, OpenCode, Qwen Code, Gemini CLI)를 실행하며, `omniroute configure`는 대화형 제공자+모델 선택기와 컨텍스트별 즐겨찾기를 통해 11개의 대상을 지원합니다. → [CLI 통합](docs/guides/CLI-INTEGRATIONS.md) - **🛰️ 원격 모드** — 범위가 지정된 토큰(`connect` / `contexts` / `tokens`)으로 원격 OmniRoute를 제어하고, VPS 설치를 위한 `antigravity` OAuth 도우미를 제공합니다. → [원격 모드](docs/guides/REMOTE-MODE.md) - **🧭 더 스마트한 자동 라우팅** — `auto/:` 콤보, **Fusion**(모델 패널 + judge), 작업 인식 라우팅, 요청별 모델 / 모드 / USD 예산 재정의를 지원합니다. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **🗜️ 플러그형 압축** — 12개의 조합 가능한 엔진과 Compression Studios를 제공합니다: LLMLingua-2, 2단계 Ultra, omniglyph, 단계별 충실도 게이트, GCF v3.2, 드래그 앤 드롭 순서 변경 편집기. → [압축](docs/compression/COMPRESSION_ENGINES.md) - **🕵️ 투명한 MITM 복호화(TPROXY)** — 프록시 환경 변수를 무시하는 CLI를 캡처하고, SNI별 CA 및 trust-store 설치 프로그램을 제공합니다. → [MITM/TPROXY](docs/security/MITM-TPROXY-DECRYPT.md) - **💸 모든 곳에서 비용 텔레메트리 제공** — 모든 엔드포인트에 `X-OmniRoute-*` 비용/사용량 헤더를 제공하고, 캐시 적중 절감액 헤더 및 키별 USD 지출 할당량을 지원합니다. → [API 레퍼런스](docs/reference/API_REFERENCE.md) - **🧠 직접 제어하는 메모리** — 기본적으로 비활성화되어 있으며, 선택적 int8 벡터 양자화와 유형별 감쇠, 요청별 `x-omniroute-no-memory`를 지원합니다. → [메모리](docs/frameworks/MEMORY.md) - **🛡️ 보안** — 모든 LLM 라우트에 프롬프트 인젝션 방어 기능(레드팀 테스트 모음)을 적용하고, 선택적 자격 증명 마스킹 가드레일(양방향으로 유출된 API 키/시크릿을 삭제), 무료 DuckDuckGo 최후 수단 웹 검색, 대시보드용 선택적 OIDC 로그인 게이트를 제공합니다(비밀번호 로그인은 항상 사용 가능). → [가드레일](docs/security/GUARDRAILS.md) - **🖼️ 새로운 엔드포인트** — `/v1/ocr`(Mistral OCR) 및 `/v1/audio/translations`(Whisper 스타일)가 미디어 기능을 확장합니다. → [API 레퍼런스](docs/reference/API_REFERENCE.md) - **🎨 이미지 / 동영상 / 오디오 생성** — 미디어를 위한 단일 API를 제공하며, xAI Grok Imagine 및 Novita AI 동영상, ComfyUI, Magnific, Adobe Firefly, Segmind, ElevenLabs와 같은 음성 제공자를 지원합니다. → [API 레퍼런스](docs/reference/API_REFERENCE.md) - **🌍 배포 및 운영** — 리버스 프록시 `basePath`, 브라우저 언어 자동 감지, 키별 장치 추적, 루트 권한 없는 MITM trust, zh-TW 현지화를 지원합니다. → [환경](docs/reference/ENVIRONMENT.md) - **🤝 더 많은 제공자 및 에이전트** — 클라우드 에이전트(Codex Cloud, Cursor, Devin, Jules), 브라우저 + OAuth 로그인을 지원하는 Grok Build(xAI), Ollama 퍼스트 클래스 카드, Claude Opus 5 및 Sonnet 5, Kimi 공식 파트너십(Code/Web/Moonshot), Zed, Requesty, SenseNova, Yuanbao, Agnes AI… 그리고 새롭게 정비된 **388개 제공자 카탈로그**를 제공합니다. → [제공자](docs/reference/PROVIDER_REFERENCE.md) - **📡 라우팅 투명성** — 모든 응답에 해당 응답을 처리한 전략/제공자/지연 시간을 명시하는 `X-OmniRoute-Decision` 헤더가 포함됩니다. 새로운 `cache-optimized` 콤보 전략과 Auto-Combo `cacheAffinity` 요소는 반복 요청을 캐시된 접두사를 보유한 연결로 다시 라우팅하며, 읽기 전용 `/v1/auto-combo/{channel}/candidates` 엔드포인트는 `auto/*` 채널의 실시간 후보 풀을 노출합니다. → [Auto-Combo](docs/routing/AUTO-COMBO.md) - **⚡ 로컬 성능 및 인프라** — 원클릭 로컬 Redis, Cloudflare Workers / Deno Deploy 릴레이 배포 도구, 감독형 임베디드 서비스로 제공되는 Bifrost 및 Mux. → [임베디드 서비스](docs/frameworks/EMBEDDED-SERVICES.md) - **🧩 기본 포함 기능** — 플러그인 프레임워크 및 마켓플레이스, Omni/Agent/GitHub 스킬 프레임워크, Obsidian 볼트 통합(22개의 MCP 도구), OpenAI 호환 Batch 및 Files API, 시맨틱 응답 캐시, 리더보드가 포함된 게이미피케이션, ACP 에이전트 검색(기본 제공 에이전트 15개), BigQuery로의 예약된 로그 내보내기, `auto/chaos` 병렬 다중 모델 팬아웃, Telegram 봇 브리지, 앱 내 버전 관리자, LMArena-ELO 무료 제공자 순위. → [문서](docs/README.md)

## 🤖 호환되는 CLI 및 코딩 에이전트 > 하나의 설정 — `http://localhost:20128/v1` — 만으로 **모든** AI IDE 또는 CLI가 무료 및 저렴한 모델에서 실행됩니다.

_{Claude Code}	_{Codex CLI}	_Cline	_{Kilo Code}	_{Zoo Code}	_Continue
_Aider	_ForgeCode	_jcode	_{DeepSeek TUI}	_CodeWhale	_OpenCode
_{Factory Droid}	_{Copilot CLI}	_{Cursor CLI}	_Smelt	_Pi	_{Grok Build}
_{Hermes Agent}	_OpenClaw	_Goose	_{Open Interpreter}	_{Warp AI}	_deyin.ai

＋ 또한 다음과 함께 작동합니다 · Agent Deck · Kiro · Command Code · Antigravity · Windsurf · AMP · 모든 OpenAI 호환 도구

_{📖 모든 39개 도구(28개 CLI Code + 11개 CLI Agents)에 대한 도구별 설정 → [`docs/reference/CLI-TOOLS.md`](docs/reference/CLI-TOOLS.md) · 🧩 OpenCode 플러그인 → [`@omniroute/opencode-provider`](https://www.npmjs.com/package/@omniroute/opencode-provider)}

**OmniRoute를 통해 지원되는 모든 CLI를 한 번의 명령으로 실행하세요** — 별도의 설정 파일 없이, 각 프로세스마다 자격 증명이 주입되며, Qwen/Gemini는 임시로 격리된 홈 디렉터리를 사용합니다: ```bash omniroute run claude --model openai/gpt-5.4 # Claude Code omniroute run codex --model glm/glm-5.2 # OpenAI Codex CLI omniroute run aider --model glm/glm-5.2 -- --message "reply OK" omniroute run goose --model glm/glm-5.2 omniroute run opencode --model glm/glm-5.2 -- run "reply OK" omniroute run qwen --model glm/glm-5.2 -- -p "reply OK" omniroute run gemini --model glm/glm-5.2 -- --skip-trust -p "reply OK" # 또는 제공자+모델을 대화식으로 선택하고 도구의 자체 설정을 작성할 수 있습니다: omniroute configure codex # 또한: claude opencode qwen aider goose gemini cline continue kilo 5dive ``` 모든 명령은 활성 원격 컨텍스트(`omniroute connect `)를 따르며, `--dry-run`은 실행 없이 정확한 환경/인자를 미리 보여주고, `--api-key-env NAME`는 쉘 히스토리에 비밀이 남지 않도록 합니다. → [CLI 통합](docs/guides/CLI-INTEGRATIONS.md)

## 🌐 388개 AI 제공업체 — 카탈로그에 표시된 무료 제공업체 153개

> **등록된 제공업체 388개**가 표준 채팅, 미디어, 검색, 로컬, 클라우드 에이전트 및 시스템 컬렉션에 걸쳐 포함되어 있으며, 이 중 **153개는 `hasFree: true` 검색 메타데이터를 보유**합니다. 채팅 모델 레지스트리에는 **제공업체 239개 / 서로 다른 제공업체-모델 쌍 3,059개 / 원시 모델 ID 1,475개**가 포함되어 있으며, 별도의 무료 예산 카탈로그에는 **모델별 행 471개**, **반복 풀 34개**, **반복/키리스 영구 무료 제공업체 52개**가 있습니다. 이는 설계상 서로 다른 분모입니다. 정의와 풀 중복 제거 계산은 [제공업체 참조](docs/reference/PROVIDER_REFERENCE.md) 및 [무료 요금제](docs/reference/FREE_TIERS.md)에 정리되어 있습니다.

### 🏢 하나의 엔드포인트로 이용하는 모든 주요 연구소

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

_{…그리고 350개 이상 — 모든 아이콘은 대시보드의 제공업체 카탈로그에서 실시간으로 확인할 수 있습니다. 📖 [제공업체 참조](docs/reference/PROVIDER_REFERENCE.md)}
### 🆓 영구 무료 — $0, 카드 불필요

OpenCode Zen _{DeepSeek V4, Nemotron 3 토큰 제한 없음}	Kilo Code _{자동 라우터, 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회 무료}	Cerebras _{GLM 4.7, GPT-OSS 일회성 $5 크레딧; 카드 필요}	OpenRouter _{:free 모델 +$10 → 더 높은 RPM}

📖 전체 머신 판독 가능 카탈로그 → [`docs/reference/PROVIDER_REFERENCE.md`](docs/reference/PROVIDER_REFERENCE.md)

## 🖥️ OmniRoute 실행되는 곳 — 어디에서나

> 동일한 앱, 귀하의 컴퓨터, 귀하의 규칙. 글로벌 npm 설치에서** 당신의 전화** Termux를 통해. 에 기여하세요

플랫폼		설치
📦 npm (글로벌)	`npm install -g omniroute`	하나의 명령, 모든 OS
⚡ Bun (글로벌)	`bun add -g omniroute`	동일한 레지스트리 tarball, 더 빠른 설치
🐳 Docker	`docker run ... diegosouzapw/omniroute`	멀티 아키텍처 AMD64 + ARM64
🖥️ 데스크탑 (Electron)	`npm run electronic: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, 루트 없음
📲 PWA	"홈 화면에 추가"	전체 화면, 오프라인, 브라우저에서 설치 가능
🧩 OpenCode 플러그인	`@omniroute/opencode-provider`	OpenCode
🤖 VS 코드 Copilot 채팅	설치 OmniCopilot 확장	기본 Copilot 채팅 선택기의 모든 OmniRoute 모델 — 안정 & 내부자
🛠️ 소스에서	`npm install && npm run dev`	해킹하고

_{📖 [Docker 가이드](docs/guides/DOCKER_GUIDE.md) · [데스크탑](electron/README.md) · [메뉴바 트레이](https://github.com/zoispag/omniroute-tray) · [Termux](docs/guides/TERMUX_GUIDE.md) · [PWA](docs/guides/PWA_GUIDE.md) · [OpenCode](docs/frameworks/OPENCODE.md)}

### 🧩 새로운 기능: VS Code의 기본 Copilot Chat 내부의 OmniRoute

> 새로운 사이드바도 없고, 새로운 채팅도 없습니다. UI — OmniRoute 제공하는 모든 모델은** 이미 사용하고 있는 Copilot Chat 모델 선택기** . VS Code 1.122부터 공급자 모델은 GitHub 로그인이나 Copilot 구독 없이도 에이전트 모드, 도구 호출 및 비전이 무료로 작동합니다. 설치하다** [OmniCopilot](https://github.com/diegosouzapw/OmniCopilot)** 확장명을 OmniRoute 서버(기본값은 `localhost:20128`)로 지정한 다음 Copilot Chat → 모델 선택기 → 엽니다.** 모델 관리…** →**OmniRoute** . < td align ="left">VS 코드 — stable & < td align ="left">Cursor, Windsurf, VSCodium, Theia, 코드 서버, Gitpod, Antigravity, Kiro…

	링크
와 함께 작동
🧩 VS 코드 마켓플레이스	설치 →
🔓 VSX 레지스트리 열기	설치 →

편집기 내부에서:** 확장** 보기, 검색** "OmniRoute"** , 클릭** 설치하다** — 두 매장 모두에서 동일한 방식으로 작동합니다. 소스, 이슈 및 게시 런북은 [diegosouzapw/OmniCopilot](https://github.com/diegosouzapw/OmniCopilot) 에 게시되어 있습니다. _{📖 [VS 코드 Copilot 채팅 가이드](docs/guides/VSCODE-COPILOT.md) — 설정, 선택기에 표시되는 내용, 탭 내 대시보드,} 문제 해결

### 🎩 새로운 기능: OmniRouteTray — 메뉴 표시줄에 있는 게이트웨이

> `omniroute serve` 항상 켜져 있을 때 가장 행복합니다.** [OmniRouteTray](https://github.com/zoispag/omniroute-tray)** 이를 macOS 용 설정 후 잊어버릴 수 있는 메뉴 표시줄 앱으로 바꿉니다. 서버를 시작하고, 재부팅 후에도 활성 상태를 유지하고, 제자리에 업데이트하고, 클릭 한 번으로 라이브 토큰 예산을 투입합니다 —** 터미널 창이 열려 있지 않고, 베이비시터를 위한 `npm install -g omniroute` 도 없습니다.** [Tauri v2](https://v2.tauri.app/) (반올림 오류 크기의 Rust 코어)로 구축되어 자체 서명된 Node 24 런타임을 제공하고 앱 소유 OmniRoute 설치를 관리하므로 전역 `node`/`bun` 와 싸우지 않습니다. 그것** 기존 `~/.omniroute/` 구성 및 데이터베이스를 공유합니다.** — 모자만 쓰고 이미 실행 중인 것과 동일한 OmniRoute 입니다. 🎩

하는
🟢 서버 감독	생성 `옴니루트 서브` 복제 대신 이미 실행 중인 인스턴스 채택
📊 실시간 사용량 개요	공급자 할당량 막대, 재설정 카운트다운을 통한 Claude session/weekly 제한, 30일 비용 분석
🔄 자동 업데이트	단계적 설치, 원자 스왑, 실패 시 롤백 - 항상 최신 릴리스에서 실행
🚀 로그인 시 시작	로그인 시 선택적으로 시작; 트레이 전용, 도킹 아이콘 없음
🩺 Doctor & 로그	원클릭 진단 및 서버 로그 액세스

```sh brew install --cask zoispag/tap/omniroute-tray ``` _{다운로드를 원하시나요? 다음에서 최신 .dmg 다운로드하세요.
출시합니다. 소스, 이슈 및 빌드
문서는 zoispag/omniroute-tray 에 있습니다.

💛 @zoispag 의 커뮤니티 프로젝트 — 공식 OmniRoute 릴리스는 아닙니다.}

## 🔒 비공개 및 로컬 우선

_{📖 [권한 부여](docs/architecture/AUTHZ_GUIDE.md) · [가드레일](docs/security/GUARDRAILS.md) · [컴플라이언스](docs/security/COMPLIANCE.md)}

## 🔌 완전한 CLI + A2A 및 MCP

> 서버를 넘어, OmniRoute는 **80개 이상의 명령어**를 갖춘 **완전한 명령줄 조종석**이며, AI 에이전트가 **스스로** 조작할 수 있도록 개방형 에이전트 프로토콜도 제공합니다. ### ⌨️ 진정한 CLI (`start`만 있는 것이 아닙니다) ```bash omniroute # 게이트웨이 + 대시보드 실행(포트 20128) omniroute chat # 대화형 TUI 채팅 클라이언트(슬래시 명령어: /model /combo /skill /memory) omniroute setup # 안내형 최초 실행 마법사 omniroute doctor # 제공자, 포트, 네이티브 종속성 진단 ``` ### 🛰️ 원격 모드 — CLI는 여기서, OmniRoute는 VPS에서 실행 서버에서 OmniRoute를 실행하시나요? 노트북에서 **동일한 CLI**로 제어하세요. 범위가 지정된 액세스 토큰으로 한 번 로그인하면 이후 모든 명령이 원격 서버를 대상으로 실행됩니다. ```bash omniroute connect 192.168.0.15 # 비밀번호 → 범위 지정 토큰, 컨텍스트로 저장 omniroute models # ← 원격 서버를 대상으로 실행 omniroute configure codex # ← 원격 모델을 선택하고 로컬 Codex 프로필 작성 omniroute tokens create --name ci --scope read # 다른 머신용으로 범위가 더 제한된 토큰 발급 omniroute contexts use default # ← 로컬 서버로 다시 전환 ``` 토큰 범위는 `read` / `write` / `admin`이며, 프로세스를 생성하는 경로는 루프백 전용으로 유지됩니다. _{📖 [원격 모드](docs/guides/REMOTE-MODE.md)}

OmniRoute CLI를 시연하는 애니메이션 터미널 — omniroute providers list, omniroute combo list 및 omniroute health — 89개 명령어로 구성된 최상위 인터페이스를 순환 표시: providers · oauth · keys · combo · nodes · models · cache · compression · cost · usage · quota · health · resilience · telemetry · logs · audit · mcp · a2a · cloud · memory · skills · eval · tunnel · backup · sync · webhooks · policy · pricing · translator · simulate …

### 🤝 에이전트를 연결하면 OmniRoute 자체를 제어합니다 OmniRoute를 **MCP**, **A2A**, **REST API**, **웹훅** 또는 **원격 CLI**를 통해 노출하세요. 기능을 갖춘 모든 에이전트(또는 자체 코드)가 라우팅, 제공자, 조합, 캐시, 압축, 메모리를 포함한 전체 게이트웨이를 자율적으로 제어할 수 있습니다. 아래 HTTP 엔드포인트는 `http://localhost:20128`에서 제공됩니다.

인터페이스	엔드포인트 / 명령어	용도
🧰 MCP (stdio)	`omniroute --mcp`	Claude Desktop, Cursor 또는 모든 MCP 클라이언트에 연결
🌊 MCP (HTTP)	`/api/mcp/stream`	원격 MCP — 110개 도구, 33개 범위(선택적 적용), 완전한 감사 추적
📡 MCP (SSE)	`/api/mcp/sse`	스트리밍 MCP 전송
🤝 A2A	`/.well-known/agent.json`	에이전트 간 통신, JSON-RPC 2.0 + SSE, 6개 스킬
🌐 REST API	`/v1/*`	OpenAI 호환 — 채팅, 임베딩, 이미지, 오디오, OCR
🔔 웹훅	`/api/webhooks`	요청 / 할당량 이벤트를 Slack, Discord, Telegram 또는 모든 URL로 푸시
🛰️ 원격 CLI	`omniroute connect`	범위가 지정된 액세스 토큰으로 원격 인스턴스 제어

```bash # MCP를 통해 Claude Code에 전체 OmniRoute 도구 세트 제공: claude mcp add-server omniroute --type http --url http://localhost:20128/api/mcp/stream ``` _{📖 [MCP 서버](docs/frameworks/MCP-SERVER.md) · [A2A 서버](docs/frameworks/A2A-SERVER.md) · [에이전트 프로토콜](docs/frameworks/AGENT_PROTOCOLS_GUIDE.md)}

## 🗜️ 토큰 15–95% 절감 — 자동으로

### 📖 작동 방식 — 파이프라인, 아키텍처 및 절감률 계산 OmniRoute 압축 파이프라인: 10,000토큰의 클라이언트 요청이 12개의 조합 가능한 엔진 — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra 및 OmniGlyph — 을 거쳐 문서화된 스택 예시에서 약 1,080토큰으로 프로바이더에 도달할 수 있습니다. 구조화된 콘텐츠는 보존 가드와 단계별 충실도 게이트로 보호되며, 명시적인 손실 또는 실험적 모드는 적격 콘텐츠를 변환할 수 있습니다.

OmniRoute 압축 파이프라인: 10,000토큰의 클라이언트 요청이 12개의 조합 가능한 엔진 — Session-Dedup, CCR, Lite, RTK, Responses Tool Output, Headroom, Relevance, Caveman, Aggressive, LLMLingua-2, Ultra 및 OmniGlyph — 을 거쳐 문서화된 스택 예시에서 약 1,080토큰으로 프로바이더에 도달할 수 있습니다. 구조화된 콘텐츠는 보존 가드와 단계별 충실도 게이트로 보호되며, 명시적인 손실 또는 실험적 모드는 적격 콘텐츠를 변환할 수 있습니다.

기본 스택 조합은 `RTK → Caveman`을 실행합니다. 두 엔진이 동일한 도구/컨텍스트 페이로드에 작동하면 절감 효과가 누적됩니다. ```txt combined = 1 − (1 − RTK) × (1 − Caveman_input) average = 1 − (1 − 0.80) × (1 − 0.46) = 89.2% range = 78.4 – 94.6% ``` 코드 블록, URL, JSON 및 구조화된 데이터는 **항상** 보존 엔진으로 보호됩니다. > **적은 토큰으로 해결할 수 있는데 왜 많은 토큰을 사용하나요?** 모든 요청은 **투명하게** OmniRoute의 압축 파이프라인을 통과합니다 — 클라이언트를 변경할 필요가 없습니다. 이제 순서대로 실행되고 라우팅 조합별로 자유롭게 조합되는 **12개의 조합 가능한 엔진 스택**이며, [RTK](https://github.com/rtk-ai/rtk), [Caveman](https://github.com/JuliusBrussee/caveman) (⭐ 90K+), [LLMLingua-2](https://github.com/microsoft/LLMLingua) 및 [Troglodita](https://github.com/leninejunior/troglodita) (PT-BR)의 아이디어를 기반으로 합니다. ### 🧱 12개 엔진 스택 엔진은 파이프라인 순서대로 실행되며, 각 엔진은 조합별로 독립적으로 활성화/비활성화하고 구성할 수 있습니다.

#	엔진	기능
1	Session-Dedup	턴 간에 반복되는 콘텐츠 삭제 (콘텐츠 주소 기반, 턴 간 중복 제거)
2	CCR	대규모 블록을 검색 마커 뒤에 보관하고 필요할 때 가져옴
3	Lite	공백 + 이미지 URL 정리 (지연 시간이 낮은 기준선)
4	RTK	스마트 도구 결과 필터링, 중복 제거 및 잘라내기 (명령 인식)
5	Responses Tool Output	셸/패치/검색/빌드 출력에 대한 무손실 우선 JSON + 제한된 진단 압축 (Responses API)
6	Headroom	벤더링된 GCF 코덱을 통한 JSON 배열의 무손실 표 형식 압축 (~30%)
7	Relevance	마지막 사용자 쿼리를 기준으로 문장 추출 점수 계산
8	Caveman	규칙 기반 산문 압축 (출력에서 ~65–75%)
9	Aggressive	이전 턴의 요약 + 점진적 노후화
10	LLMLingua-2	MobileBERT ONNX를 통한 ML 의미 가지치기 — 코드 안전, 비동기
11	Ultra	선택적 소형 모델 (SLM) 계층을 사용하는 휴리스틱 토큰 가지치기
12	OmniGlyph	직접 Anthropic 와이어에서 측정된 Claude Fable 5용 실험적 컨텍스트-이미지 인코딩. GPT 5.6 트랜스포머는 프로바이더 영수증이 제공될 때까지 fail-closed 상태로 유지됩니다. 네 가지 압축 프로필 (aggressive 기본값, balanced, coding-safe, passthrough) (가장 공격적; 옵트인)

코드 블록, URL 및 구조화된 데이터는 **항상** 바이트 단위로 완벽하게 보존됩니다. **원클릭 프리셋**은 엔진을 조합합니다.

모드	절감률	적합한 용도
🪶 Lite	~15%	항상 활성화하는 안전한 기본값
🪨 Standard (Caveman)	~30%	일상적인 코딩
⚡ Aggressive	~50%	도구 사용이 많은 긴 세션
🔥 Ultra	~75%	최대 절감
🧰 RTK	60–90%	셸/테스트/빌드/git 출력
🔗 Stacked (RTK → Caveman)	78–95%	혼합 프롬프트 + 도구 로그

**실제 예시 — Standard 모드:** > **이전 (69토큰):** _"React 컴포넌트가 다시 렌더링되는 이유는 각 렌더링 주기마다 새 객체 참조를 생성하기 때문일 가능성이 높습니다. 인라인 객체를 prop으로 전달하면 React의 얕은 비교에서 매번 다른 객체로 인식하므로 다시 렌더링됩니다. 객체를 메모이제이션하려면 useMemo를 사용하는 것이 좋습니다."_ > > **이후 (19토큰):** _"렌더링할 때마다 새 객체 참조. 인라인 객체 prop = 새 참조 = 다시 렌더링. useMemo로 감싸세요."_ > > **같은 답변. 토큰 72% 감소. 정확도 손실 없음.** ✅ **PT-BR 예시 — [Troglodita](https://github.com/leninejunior/troglodita) 모드:** > **이전 (42 토큰):** _"문제는 각 렌더링 주기마다 새로운 객체 참조가 생성되어 컴포넌트가 다시 렌더링된다는 것입니다. `useMemo`를 사용하는 것을 권장합니다."_ > > **이후 (12 토큰):** _"재렌더링: 매 주기마다 새 참조(인라인 객체가 재생성됨). `useMemo` 사용."_ > > **같은 답변. 약 70% 적은 토큰. 기술적 정확성은 그대로입니다.** ✅
### 🎚️ 엔진을 넘어서 — 출력 스타일, 적응형 다이얼 및 요청별 제어 위의 12개 엔진은 **입력되는** 내용을 줄입니다. 세 가지 추가 계층이 **방식**, **시점**, 그리고 **출력되는** 내용을 결정합니다. - **🪄 출력 스타일** _(출력 축 조정)_ — 결정적이며 캐시 안전한 응답 형성 지침을 주입합니다. 서로 조합할 수 있으며, 각 스타일에 `lite` / `full` / `ultra` 강도를 적용할 수 있습니다. 스타일 추가는 한 줄짜리 레지스트리 항목이면 됩니다. - **간결한 문장** — 불필요한 표현 / 관사 / 완곡한 표현을 제거하고 기술적 내용은 정확하게 유지합니다. - **코드 줄이기** — "게으른 시니어 개발자"의 YAGNI: 작동하는 가장 작은 변경만 적용하고, 요청하지 않은 스캐폴딩은 추가하지 않습니다. - **포니테일 (게으른 시니어 개발자)** — YAGNI 사다리를 올라 근본 원인을 해결하고, 작동하는 가장 작은 diff를 적용합니다. - **나는 ADHD가 있습니다 (행동 우선)** — 다음 행동을 먼저 제시하고, 단계를 번호로 매기며, 구체적인 다음 단계 하나만 제시하고, 서론은 생략합니다. - **간결한 CJK (文言)** — 고전 중국어 초간결 스타일입니다 (`zh` 로케일에서만 사용). - **🎯 적응형 컨텍스트 예산** _(다이얼)_ — 하나의 on/off 토큰 임계값을 사용하는 대신, **모델의 컨텍스트 창에 맞추는 데** 필요한 만큼만 가장 저렴하고 정보 손실이 적은 엔진을 단계적으로 적용합니다. 정책: `reserve-output` (기본값, 모델 인식) · `percentage` · `absolute`. 모드: `floor` (적합성을 보장) · `replace-autotrigger` (명시적 선택을 우선) · `off` (기존 임계값). - **🎛️ 압축 결정 위치** _(우선순위, 높음 → 낮음)_ — 요청별 `x-omniroute-compression` 헤더 › 라우팅 조합 재정의 › 활성 명명 프로필 › 적응형 / 자동 트리거 › 패널 기본값 › off. 적용된 계획은 `X-OmniRoute-Compression: ; source=` 응답 헤더로 반환됩니다. 토큰 임계값으로 자동 트리거하거나, 적응형 다이얼을 켜거나, 명명 프로필을 고정하거나, 요청별 일회성 설정을 적용하거나, 라우팅 조합별로 파이프라인을 지정할 수 있습니다. 워크로드에 맞는 방식을 선택하면 됩니다. 선택적으로 사용할 수 있는 오프라인 **평가 하니스**(`npm run eval:compression`)는 변경 사항을 적용하기 전에 고정된 코퍼스에서 충실도와 절감량을 비교 평가합니다. 📖 [`COMPRESSION_GUIDE.md`](docs/compression/COMPRESSION_GUIDE.md) · [`RTK_COMPRESSION.md`](docs/compression/RTK_COMPRESSION.md) · [`COMPRESSION_ENGINES.md`](docs/compression/COMPRESSION_ENGINES.md)

# ⚡ 빠른 시작

**1) 설치 및 실행** ```bash npm install -g omniroute omniroute ``` > 💡 `npm warn ERESOLVE` 또는 peer-dep 경고가 표시되나요? [무해한 경고입니다](docs/guides/TROUBLESHOOTING.md#npm-install-warnings-eresolve--peer--deprecated). > **npm 11 이상을 사용하시나요?** npm은 허용되지 않은 패키지 라이프사이클 스크립트를 차단할 수 있습니다. OmniRoute의 `postinstall` (`node scripts/build/postinstall.mjs`)은 네이티브 런타임 파일을 준비하는 데 필요합니다. 전역 설치 시 npm 경고에 표시된 패키지 이름을 허용하세요. OmniRoute 3.8.54에서 보고된 패키지 집합은 다음과 같습니다. > > ```bash > npm install -g --allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild omniroute > ``` > > 이후 전역 설치에서 이 허용 목록을 재사용하려면 한 번만 구성한 다음 평소처럼 설치하세요. > > ```bash > npm config set allow-scripts=omniroute,keytar,onnxruntime-node,@parcel/watcher,@swc/core,protobufjs,esbuild --location=user > npm install -g omniroute > ``` > > 의존성 목록은 릴리스마다 변경될 수 있습니다. npm에서 다른 목록을 보고하면 해당 경고에 표시된 패키지 이름을 사용하세요. 패키지를 허용하면 해당 패키지의 설치 스크립트가 실행됩니다. > **Gemini Web 또는 다른 웹 쿠키 제공자를 사용하시나요?** npm 패키지에는 > Playwright가 포함되어 있지만 Chromium 바이너리는 포함되어 있지 않습니다. 첫 웹 제공자 요청을 보내기 전에 > [Playwright Chromium 설정](docs/guides/TROUBLESHOOTING.md#gemini-web-and-playwright-chromium) > 참고 사항을 확인하세요. 대시보드: `http://localhost:20128` · API: `http://localhost:20128/v1`. **2) 자신의 계정으로 사용 가능한 제공자 연결** 대시보드 → **Providers** → 현재 약관과 할당량이 사용 사례에 적합한 제공자 선택 → API 키를 추가하거나 계정 절차 완료. 무료 요금제는 가입, 승인 또는 결제 수단을 요구할 수 있습니다. [무료 요금제 가이드](docs/getting-started/FREE-TIERS-GUIDE.md)를 확인하세요. 키 없이 사용할 수 있다는 보장은 없으며, `tos: avoid`로 표시된 제공자는 기본적으로 `auto`에서 제외됩니다. **3) 코딩 도구 지정** ```txt Base URL: http://localhost:20128/v1 API Key: [copy from Dashboard → Endpoints] Model: auto (routes among eligible connections — or choose provider/model) ``` **4) 작동 여부 확인** ```bash curl http://localhost:20128/v1/models -H "Authorization: Bearer YOUR_KEY" ``` 연결된 모델 목록이 표시되어야 합니다. 🎉 이제 끝입니다 — 코딩을 시작하면 OmniRoute가 자동으로 라우팅하고 폴백을 처리합니다. 클라이언트가 사용자 지정 헤더를 전송할 수 없는 경우, OmniRoute는 토큰화된 호환성 별칭도 제공합니다. ```txt OpenAI catalog: http://localhost:20128/vscode/YOUR_KEY/ OpenAI models: http://localhost:20128/vscode/YOUR_KEY/models OpenAI chat: http://localhost:20128/vscode/YOUR_KEY/chat/completions OpenAI responses: http://localhost:20128/vscode/YOUR_KEY/responses Ollama chat: http://localhost:20128/vscode/YOUR_KEY/api/chat Ollama tags: http://localhost:20128/vscode/YOUR_KEY/api/tags ``` `Authorization: Bearer ...`를 첨부할 수 없는 클라이언트에서만 사용하세요. 헤더 인증이 여전히 권장되는 방식입니다.
## 📦 더 많은 설치 방법 — Docker, 소스, pnpm, Arch **🐳 Docker** ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` `:latest`는 **게시된** 안정 SemVer 중 가장 높은 버전을 따릅니다. git `main`을 추적하지 않습니다. GitOps에서는 `:X.Y.Z`로 버전을 고정하세요. [Docker 릴리스 채널](docs/guides/DOCKER_GUIDE.md#release-channels)을 참조하세요. 이미지에는 **`OMNIROUTE_MEMORY_MB=1024`**가 고정 설정되어 있습니다. 대시보드와 가벼운 채팅에는 충분합니다. **코딩 에이전트**(Claude Code, Codex, Grok 등에서 보내는 `POST /v1/responses`)에는 훨씬 더 큰 V8 힙이 필요하며, 긴 컨텍스트 두 개가 겹치면 약 12 GiB에서 프로세스에 `FATAL ERROR`가 발생합니다. 네이티브 버퍼는 V8 외부에 있으므로 컨테이너 크기를 힙보다 크게 설정하세요. | 워크로드 | 힙 (`-e OMNIROUTE_MEMORY_MB`) | 컨테이너 (`--memory`) | | -------------------------------------- | ----------------------------- | --------------------- | | 대시보드 / 가벼운 채팅 | `1024` (이미지 기본값) | ≥2 g | | 코딩 에이전트 하나 | `8192` | ≥10 g | | 동시 실행되는 긴 `/v1/responses` 두 개 | `10240`–`12288` | ≥12–16 g | ```bash docker run -d --name omniroute --restart unless-stopped --stop-timeout 40 \ -e OMNIROUTE_MEMORY_MB=8192 --memory=10g \ -p 127.0.0.1:20128:20128 -v omniroute-data:/app/data diegosouzapw/omniroute:latest ``` 전체 표: [Docker 가이드 — 런타임 RAM](docs/guides/DOCKER_GUIDE.md#runtime-ram-for-coding-agents). > **사전 릴리스 Docker 채널:** `diegosouzapw/omniroute:next` 및 > `diegosouzapw/omniroute:next-web`은 현재 기본 `release/v*` > 브랜치를 따릅니다. 이러한 가변 태그는 릴리스되지 않은 수정 사항을 테스트하는 용도로만 제공되며 > **프로덕션 환경에서는 지원되지 않습니다**. 자세한 내용은 > [Docker 릴리스 채널](docs/guides/DOCKER_GUIDE.md#release-channels)을 참조하세요. **🥟 Bun** Bun 런타임 감지를 통해 표준 `bun install` 및 전역 설치(`bun install -g omniroute`)를 지원합니다. - **내장 `bun:sqlite`**: OmniRoute는 Bun에서 실행될 때 Bun의 내장 `bun:sqlite` 드라이버를 사용하며, Node.js에서는 `better-sqlite3` 또는 `sql.js`로 대체됩니다. - **개발 환경에서 자동 Webpack 번들러 선택**: 개발(`bun run dev`) 시 Bun을 자동으로 감지하고 네이티브 V8 바인딩 비호환성을 방지하기 위해 Turbopack을 비활성화하고 Webpack을 사용합니다. 프로덕션 빌드(`bun run build`)는 Node와 마찬가지로 `OMNIROUTE_USE_TURBOPACK`을 정확히 따릅니다. 기본값은 Turbopack이며, Webpack으로 빌드하려면 `OMNIROUTE_USE_TURBOPACK=0`을 사용합니다(`Dockerfile.bun`에서는 이를 `--build-arg`로 노출합니다). - **전용 Bun Dockerfile**: 네이티브 Bun 프로덕션 배포를 위한 다단계 `Dockerfile.bun`입니다(`docker build -f Dockerfile.bun -t omniroute:bun .`). ```bash # Bun으로 설치 및 실행 bun install bun run dev ``` **🛠️ 소스에서 설치** ```bash cp .env.example .env && npm install PORT=20128 npm run dev ``` **📦 pnpm** ```bash pnpm add -g omniroute@latest --allow-build=better-sqlite3 --allow-build=@swc/core && omniroute ``` **🐧 Arch Linux (AUR)** ```bash yay -S omniroute-bin && systemctl --user enable --now omniroute.service ``` **🔧 Nix (Flake)** ```bash # Nix flakes 사용 nix develop npm run dev # 또는 devbox 사용 devbox run npm run dev ``` 📖 [Docker 가이드](docs/guides/DOCKER_GUIDE.md) — Compose 프로필, Caddy HTTPS, Cloudflare 터널. **🦭 Podman** ```bash # 1. 바인드 마운트할 데이터 디렉터리 준비 mkdir -p data # 2. Linux + 로컬 루트리스 Podman에서만 실행(원격 Podman Machine 클라이언트에서는 절대 실행하지 마세요): podman unshare chown 1000:1000 ./data # 3. 런타임 힌트를 설정하고 로컬 Compose 이미지를 빌드한 후 시작 echo "CONTAINER_HOST=podman" >> .env podman compose --profile base up -d --build ``` macOS 또는 Windows에서 Podman은 원격 Podman Machine을 사용합니다. `podman unshare`를 건너뛰고 [토폴로지별 데이터 디렉터리 지침](contrib/podman/README.md#data-directory-permissions-by-topology)을 따르세요. 📖 [Podman 가이드](contrib/podman/README.md) — Compose 빌드, Podman Machine 및 Linux/systemd Quadlet 설정. **⚡ 더 빠르고 가벼운 설치(네이티브 빌드 건너뛰기)** 네이티브 SQLite 엔진(`better-sqlite3`)은 **선택적** 의존성이므로 전역 설치가 소스 컴파일로 인해 중단되는 일은 없습니다. 플랫폼/Node에 맞는 사전 빌드 바이너리가 있으면 이를 사용하고, 그렇지 않으면 순수 JS 엔진(Node 22 이상에서는 `node:sqlite`, 그 외에는 번들된 `sql.js` WASM)으로 투명하게 대체되므로 빌드 도구가 필요하지 않습니다. 설치 후 네이티브 워밍업을 완전히 건너뛰려면(CI, 헤드리스 또는 느린 머신): ```bash OMNIROUTE_SKIP_POSTINSTALL=1 npm install -g omniroute # CI=1도 이를 건너뜁니다 ``` 가장 빠른 설치를 위해서는 **pnpm**을 권장합니다(콘텐츠 주소 지정 저장소 + 하드 링크 — 위 내용 참조). 대시보드가 없는 헤드리스 런타임에는 위의 Docker `base` 프로필이나 [Termux 가이드](docs/guides/TERMUX_GUIDE.md)를 사용하세요. CLI와 웹 대시보드는 동일한 프로세스가 하나의 포트에서 제공하므로 현재 별도의 CLI 전용 패키지는 없습니다.

# 🎬 OmniRoute 실행 모습

## 📹 동영상 가이드

_{2026-10-18 기준 대시보드 스냅샷 · 원시 카탈로그: YT 1.352 | TT 334 | IG 290 · 최신성(일): YT 5 | TT 48 | IG 49}

🎬 #1 — Instagram
_{nick_saraev — 조회수 3,042,474회}

🎬 #2 — Instagram
_{nnapier7 — 조회수 1,454,535회}

🎬 #3 — YouTube
_{Amidia AI & Tech — 조회수 794,974회}

🎬 #4 — Instagram
_{theopenstack — 조회수 692,419회}

🎬 #5 — TikTok
_{migue.baena — 조회수 685,788회}

**전체 순위(중복 제거된 정규 URL, `v > 0`, 도달 범위순):** | #1 | #2 | #3 | #4 | #5 | | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [nick_saraev — Instagram](https://www.instagram.com/reel/Da8ZthUPK98/) — **3,042,474** | [nnapier7 — Instagram](https://www.instagram.com/reel/Dbp7wv_CIO0/) — **1,454,535** | [Amidia AI & Tech — YouTube](https://www.youtube.com/watch?v=NJ0TQ-pyMDY) — **794,974** | [theopenstack — Instagram](https://www.instagram.com/reel/DaSs65mMrHk/) — **692,419** | [migue.baena — TikTok](https://www.tiktok.com/@migue.baena/video/7670919268216622358) — **685,788** | | #6 | #7 | #8 | #9 | #10 | | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | [milesreevesai — TikTok](https://www.tiktok.com/@milesreevesai/video/7667980059189366019) — **620,400** | [nikothetech — TikTok](https://www.tiktok.com/@nikothetech/video/7671890769665477918) — **610,803** | [Vaibhav Sisinty — YouTube](https://www.youtube.com/watch?v=QucgvbO5gsM) — **509,281** | [buildwithai.club — Instagram](https://www.instagram.com/reel/DbIt9AjK7-U/) — **347,652** | [nivedan.ai — Instagram](https://www.instagram.com/reel/DbIrCksJiqq/) — **331,973** | 2026-10-18 기준 정규 지표: **고유 동영상 1.976개** · **확인된 조회수 20.220.289회** (`v > 0`) · **네트워크별 채널/프로필 1.210개**. 원시 대시보드에는 1.976개 행(YouTube 1.352개 = 긴 형식 740개 + Shorts 612개 · TikTok 334개 · Instagram 290개)이 포함되어 있습니다. 동영상별로 가장 높은 조회수를 유지하는 정규 URL 기반 정규화 이후 중복 항목은 남아 있지 않습니다. YouTube 데이터 수집은 2026-10-13에 중단되었으며(14일부터 18/10까지 API 할당량 소진), TikTok/Instagram 데이터 수집은 2026-09-02부터 중단되었습니다(수집 크레딧 없음). 아직 조회수가 집계되지 않은 동영상은 76개입니다. > 🎬 **OmniRoute에 관한 동영상을 만드셨나요?** 링크와 함께 [이슈](https://github.com/diegosouzapw/OmniRoute/issues/new) 또는 [토론](https://github.com/diegosouzapw/OmniRoute/discussions)을 등록해 주세요. 여기에 소개해 드리겠습니다.

# 📧 커뮤니티 및 도움말 > 모든 것을 한곳에서 이용하세요. 유지관리자를 팔로우하고, 커뮤니티와 대화하거나, 이슈를 등록하세요. | 채널 | 위치 / 방법 | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | | 💼 **LinkedIn** — 메인테이너 팔로우 | [linkedin.com/in/diegosouzapw](https://www.linkedin.com/in/diegosouzapw/) | | 🐙 **GitHub** — 릴리스 및 팁을 받으려면 팔로우 | [@diegosouzapw](https://github.com/diegosouzapw) | | 💬 **Discord** | [discord.gg/U47eFqAXCn](https://discord.gg/U47eFqAXCn) | | ✈️ **Telegram** | [t.me/omnirouteOficial](https://t.me/omnirouteOficial) | | 🟢 **WhatsApp — 🌍 글로벌** | [그룹 참여](https://chat.whatsapp.com/FvuCbrpZmQ6I85n2vW5QIC?s=cl&p=a&mlu=4) | | 🟢 **WhatsApp — 🇧🇷 브라질** | [그룹 참여](https://chat.whatsapp.com/KWgatljAjmbELQory59Oti?s=cl&p=a&mlu=4) | | 🌍 **웹사이트** | [omniroute.online](https://omniroute.online) | | 🌍 **🌍StHub OmniRoute 커뮤니티(무료)** | [StHub 포털](https://portal.sthub.com.br/communities/groups/st-hub/channels/Omniroute-World-8kRjmK) | | 📦 **소스 코드** | [github.com/diegosouzapw/OmniRoute](https://github.com/diegosouzapw/OmniRoute) | | 🐛 **버그 신고** | [이슈 등록](https://github.com/diegosouzapw/OmniRoute/issues) — `npm run system-info` 출력 첨부 | | 🤝 **기여** | [CONTRIBUTING.md](CONTRIBUTING.md) · [브랜치 및 릴리스 모델](docs/ops/BRANCHING_MODEL.md) · `good first issue` 선택 | | 💚 **프로젝트 후원** | [후원 방법 ↑](#-support-omniroute) · [GitHub Sponsors](https://github.com/sponsors/diegosouzapw) |

---

## 🛠️ 기술 스택

계층	기술
런타임	Node.js 22.x / 24.x LTS — `>=22.22.2 <23 \|\| >=24.0.0 <27`
언어	TypeScript 6.0 — `src/` 및 `open-sse/` 전체에서 100% TypeScript 사용 (v2.0 이후 코어에 `any` 없음)
프레임워크	Next.js 16 + React 19 + Tailwind CSS 4
데이터베이스	better-sqlite3 (SQLite, WAL 저널링) + LowDB (JSON 레거시) — 도메인 모듈 147개, 마이그레이션 233개
메모리	SQLite FTS5 전문 검색 + int8 양자화 벡터 임베딩, 타입 지정 감쇠
스키마	Zod 4 — MCP 도구 I/O 검증 + API 계약
프로토콜	MCP (stdio / HTTP / SSE) + A2A v0.3 (JSON-RPC 2.0 + SSE)
스트리밍	Server-Sent Events (SSE) + WebSocket 브리지 (`/v1/ws`)
압축	12개 엔진 파이프라인 — RTK, Caveman, LLMLingua-2 (MobileBERT ONNX), GCF, OmniGlyph
인증 및 보안	OAuth 2.0 (PKCE) + JWT + API Keys + MCP 범위 지정 인증 · 저장 데이터 AES-256-GCM 암호화 · DOMPurify
스텔스	wreq-js — JA3 / JA4 TLS 지문 위장, 3단계 프록시
복원력	서킷 브레이커, 지수 백오프, 동시 폭주 방지, 자동 조합 자가 복구
로깅	pino — 요청 컨텍스트를 포함한 구조화된 JSON 로그
테스트	Node.js 테스트 러너 + Vitest — 8,400개 이상의 추적 테스트 파일(단위, 통합, E2E, 보안, 생태계)에 걸쳐 정적 테스트 선언 60,000개 이상
플랫폼	데스크톱 (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의 도구별 설정
원격 모드	범위가 지정된 액세스 토큰을 사용하여 노트북 CLI에서 원격 OmniRoute(VPS) 제어
Claude Code 구성	`launch` 및 모델별 프로필을 사용하여 Claude Code를 OmniRoute(로컬/원격)에 연결
빠른 시작	3단계 설치 → 연결 → 구성

### 🔧 운영 및 배포

문서	설명
Docker 가이드	Docker 실행, Compose 프로필, Caddy HTTPS, 터널, 이미지 태그
Podman 가이드	Quadlet systemd 통합, podman-compose, SELinux
VM 배포	전체 가이드: VM + nginx + Cloudflare 설정
Fly.io 배포	영구 스토리지를 사용하여 Fly.io에 배포
Termux 가이드	Termux를 통해 Android에서 OmniRoute 실행
PWA 가이드	프로그레시브 웹 앱 설치, 캐싱, 아키텍처
제거 가이드	모든 설치 방법에 대한 완전한 제거
환경 구성	전체 `.env` 변수 및 참조

### 🧠 기능 및 아키텍처

문서	설명
아키텍처	시스템 아키텍처, 데이터 흐름 및 내부 구조
압축 가이드	7가지 옵션 파이프라인: off / lite / standard / aggressive / ultra / RTK / stacked
RTK 압축	명령 출력 압축, 필터, 신뢰, 검증, 원시 출력 복구
압축 엔진	Caveman, RTK, 스택형 파이프라인, 대시보드/API/MCP 인터페이스
압축 규칙 형식	Caveman 및 RTK 필터용 JSON 규칙 팩 스키마
압축 언어 팩	언어 감지 및 Caveman 규칙 팩 작성
복원력 가이드	회로 차단기, 쿨다운, 큐, 동시 폭주 방지, TLS 스푸핑
자동 콤보 엔진	16개 요소 점수화, 모드 팩, 자가 복구
프록시 가이드	3단계 프록시 시스템, 1proxy 마켓플레이스, 레지스트리 CRUD
무료 티어	통합 디렉터리: 문서화된 반복 풀 34개 / 목록화된 무료 티어 항목 465개
기능 갤러리	스크린샷을 포함한 시각적 대시보드 둘러보기
코드베이스 문서	초보자 친화적인 코드베이스 둘러보기

### 🤖 프로토콜 및 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 가이드	67개 언어 지원, 번역 워크플로, RTL
릴리스 체크리스트	릴리스 전 검증 단계
커버리지 계획	8,400개 이상의 추적된 테스트 파일에 걸친 60,000개 이상의 정적 테스트 선언을 위한 테스트 커버리지 전략

# ⭐ 주요 기여자 > OmniRoute는 열정적인 오픈 소스 커뮤니티가 함께 만들어 갑니다. 이들은 프로젝트의 품질, 안정성 및 도달 범위에 직접적인 영향을 미치는 뛰어난 기여를 해왔습니다. **감사합니다.** ### 병합된 pull request 기준 외부 기여자

순위	기여자	병합된 PR	~변경된 줄
1	maxmad64bis	418	25,367,739
2	HouMinXi	295	13,557,796
3	pacocartones	222	81,551
4	backryun	210	270,562
5	JxnLexn	198	3,570,623
6	oyi77	190	411,243
7	KooshaPari	151	5,972,314
8	rdself	145	80,663
9	RaviTharuma	123	500,065
10	herjarsa	88	230,872
11	hartmark	85	2,849,623
12	jonlwheat2-gif	68	69,097
13	artickc	62	43,502
14	xiaoyaner0201	59	126,220
15	chirag127	52	6,661
16	xz-dev	50	245,976
17	woodsonl	48	811,771
18	rqzbeh	46	151,229
19	MumuTW	43	28,166
19	QuangBlue	43	13,112

_{2026-11-03 03:01:19 UTC에 현재 release/v3.8.53 팁 05bc048d6c을 기준으로 집계되었습니다. 페이지가 매겨진 GitHub GraphQL 집계에는 병합된 PR 9,947건이 포함되어 있습니다. 이 중 저장소 소유자가 4,130건, Dependabot이 240건, 기타 봇/앱이 6건을 작성했으며, 883명의 고유 기여자가 5,571건의 외부 PR을 작성했습니다. “변경된 줄”은 GitHub의 추가 및 삭제를 의미하며 생성된 파일, lockfile, 카탈로그, 번역 및 문서를 포함합니다. 이는 작성자가 직접 작성한 LOC가 아니라 변경량입니다. 53개의 PR은 500,000줄을 초과하는 GitHub diff를 보고합니다(예: 단일 provider 추가인 #13399는 변경된 파일을 2,347개 나열함). 이로 인해 위의 몇몇 합계가 부풀려졌습니다. 동률은 같은 순위로 표시됩니다.} ### GitHub 귀속 커밋

Dizzle _{🥇 GitHub 기여로 집계된 커밋 418개}	Bob.Hou _{🥈 GitHub 기여로 집계된 커밋 294개}	Paijo _{🥉 GitHub 기여로 집계된 커밋 229개}	Paco Cartones _{🏅 GitHub 기여로 집계된 커밋 222개}	backryun _{🏅 GitHub 기여로 집계된 커밋 202개}	Jan Leon _{🏅 GitHub 기여로 집계된 커밋 134개}
Ravi Tharuma _{🏅 GitHub 기여로 집계된 커밋 126개}	Markus Hartung _{🏅 GitHub 기여로 집계된 커밋 115개}	Randi _{🏅 GitHub 기여로 집계된 커밋 108개}	Chris _{🏅 GitHub 기여로 집계된 커밋 70개}	WebPerson _{🏅 GitHub 기여로 집계된 커밋 68개}	Koosha Paridehpour _{🏅 GitHub 기여로 집계된 커밋 68개}

_{2026-11-03 02:09:16 UTC에 재확인: release/v3.8.53 기본 브랜치에 대해 저장소 Contributors API가 보고한 GitHub 기여 커밋입니다. API는 903개의 ID(사용자 429명, 봇 2개, 익명 472개)를 반환했으며, 이 표에서는 유지 관리자, 봇 및 익명 ID를 제외하고 공동 순위를 유지합니다. 이 목록은 위의 병합된 PR 순위 및 아래의 Git 메타데이터 조사 결과와는 별개입니다.} > 🙏 이러한 기여자들이 제공한 기능, 버그 수정 및 인프라 개선은 OmniRoute를 안정적이고 풍부한 기능을 갖춘 제품으로 만드는 **핵심 요소**입니다. 모든 풀 리퀘스트, 모든 테스트 케이스, 모든 i18n 번역 파일이 중요합니다. 오픈 소스는 이와 같은 사람들에 의해 만들어집니다.

---
## 💖 스폰서

자비로 OmniRoute를 후원해 주시는 모든 분께 진심으로 감사드립니다. 여러분의 모든 후원은 프로젝트가 무료로 독립성을 유지하며 계속 발전하는 데 큰 힘이 됩니다.

Andrew _{💛 현재 월간 스폰서}	Vlad I _{💛 현재 월간 스폰서}	小妍儿 _{💛 현재 월간 스폰서}	Guilherme Costa _{💛 현재 일회성 스폰서}	Henrique Iurkiv _{💛 현재 일회성 스폰서}	Somesh Ghaturle _{💛 현재 일회성 스폰서}
Kolonie AI _{💛 과거 일회성 후원자}	Prof. Igor Morais _{💛 과거 일회성 후원자}	Pixma _{💛 과거 일회성 후원자}	Paco Cartones _{💛 과거 일회성 후원자}	longtao _{💛 과거 일회성 후원자}

_{… 그리고 익명으로 남기를 원하시는 다른 분들께도 감사드립니다 💛} _{공개 GitHub Sponsors 정보는 2026-10-18에 GitHub Sponsors GraphQL API를 통해 재검증되었습니다. 총 14건 중 공개 후원은 11건(현재 6건, 과거 5건)입니다. 위의 현재 후원자 표시는 GitHub의 isActive 상태에 따라 결정됩니다. 과거의 공개 일회성 후원자에게도 계속 감사를 표하며, 비공개 스폰서는 익명으로 유지됩니다. Ko-fi, Buy Me a Coffee, Liberapay, PIX 및 암호화폐 후원은 공개 스폰서 기록이 없으므로 표시되지 않습니다.} 💖 스폰서가 되어 주세요 → — 모든 후원금은 OmniRoute가 무료로 독립성을 유지하는 데 도움이 됩니다.

## 👥 1,000명 이상의 기여자

[![Contributors](https://contrib.rocks/image?repo=diegosouzapw/OmniRoute&max=1074&columns=20&anon=1)](https://github.com/diegosouzapw/OmniRoute/graphs/contributors) _{2026-11-02에 라이브 release/v3.8.53 팁 1c7135e0fb(7,972개 커밋)을 기준으로 감사되었습니다: 정규화된 인간 Git ID 1,074개 — 759개는 커밋 작성자로 표시되고(메인테이너 포함), 315개는 명시적인 Co-authored-by 트레일러에만 표시됩니다. 이 집계에는 .mailmap이 적용되며, 이메일 주소는 대소문자를 구분하지 않고 비교합니다. 숫자 형식과 일반 GitHub noreply 주소는 동일한 핸들을 인코딩하는 경우에만 통합하고, 봇/에이전트/서비스/자리 표시자 ID 29개는 제외하며, 표시 이름이 일치한다는 이유만으로 일반 이메일 주소를 통합하지 않습니다. 2026-08-24 감사에서는 639명이 게시되었으며, 해당 감사의 기준 ac02c5b42f에 이 방법을 다시 실행하면 619명이므로, 증가는 느슨해진 방법이 아니라 새로운 기여자들에 의한 것입니다.} ### 기여 방법 1. 저장소를 포크합니다 2. **활성** `release/vX.Y.Z` 팁에서 브랜치를 생성합니다(`main`이 아님) — [브랜치 및 릴리스 모델](docs/ops/BRANCHING_MODEL.md) 참조 3. 기능 브랜치를 생성합니다(`git checkout -b feat/amazing-feature`) 4. 변경 사항을 커밋합니다(`git commit -m 'feat: add amazing feature'`) 5. 브랜치에 푸시합니다(`git push origin feat/amazing-feature`) 6. **base = 해당 `release/vX.Y.Z` 브랜치**로 Pull Request를 엽니다 자세한 지침은 [CONTRIBUTING.md](CONTRIBUTING.md)를 참조하세요. ### 새 버전 릴리스 ```bash # 릴리스를 생성합니다 — npm publish가 자동으로 실행됩니다 VERSION=x.y.z gh release create "v${VERSION}" --title "v${VERSION}" --generate-notes ```

## 📊 스타

## 🌍 StarMapper

## 🙏 감사의 말

OmniRoute는 거인들의 어깨 위에 서 있습니다. **[9router](https://github.com/decolua/9router)**의 포크이자 Go 프로젝트 **[CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI)**의 TypeScript 포트로 시작했으며, 이후 아래의 모든 하위 시스템은 먼저 이 길을 개척한 오픈 소스 프로젝트에서 영감을 받았습니다. 각각의 프로젝트는 OmniRoute의 구체적인 한 부분을 형성했습니다. 이 모든 프로젝트에 감사의 마음을 전합니다. 🙏 > ⭐ 별 개수는 2026년 11월 3일 GitHub REST API에서 확인했습니다 — 이 프로젝트들에 별을 눌러 주세요. 별 개수는 해당 날짜의 정확한 스냅샷이며 자연스럽게 변동됩니다. ### 🧬 계보 및 게이트웨이

프로젝트	⭐	OmniRoute에 영감을 준 방식
9router	31,861	이 포크가 기반으로 삼은 원본 프로젝트로, 여기서 멀티모달 API와 완전한 TypeScript 재작성을 추가했습니다.
CLIProxyAPI	57,329	이 JavaScript / TypeScript 포트에 영감을 준 Go 구현입니다.
LiteLLM	62,580	공개 가격 데이터셋이 비용 추적 동기화에 사용되고, 프로바이더 정규화 모델이 라우팅 설계에 반영된 AI 게이트웨이입니다.
codex-chatgpt-web	15,435	브라우저 세션, 응답 프레이밍, 사용량 및 웹 검색 어댑터를 포함하여, 벤더링된 ChatGPT Web → Codex Responses 브리지에 MIT 소스를 적용했습니다.
free-claude-code	65,966	스트림 복구, no-thinking 별칭, 폴백 웹 검색, 슬라이딩 윈도우 제한, 로그 비식별화 및 강화된 런처 흐름에 패턴을 포팅했습니다.
composer-api	347	Cursor Composer의 도구 선택, 출력 제약 및 도구 커밋 패턴을 네이티브 Cursor 실행기에 적용했습니다.
codex-multi-auth	561	Codex OAuth 재인증에 신규 로그인 및 리프레시 토큰 순환 패턴을 포팅했습니다.
opencode-anthropic-auth	562	Claude Code 호환 변환 기본값과 결제 헤더 동작을 OmniRoute의 구성 기반 브리지에 일반화했습니다.
grok2api-merged	2	Grok 모델 매핑, 가짜 TypeError Statsig 생성기, 요청 및 디바이스 기본값, NDJSON 응답 프로세서가 OmniRoute의 Grok Web 실행기에 실질적으로 적용되었습니다.
TQZHR/grok2api	707	grok2api-merged의 주요 전이 코드 소스이며, 모델, 헤더, 페이로드, Statsig 및 프로세서 구현이 Grok Web 계보에 보존되어 있습니다.
chenyme/grok2api	7,874	Grok 페이로드 및 디바이스 기본값, Statsig 생성기, 그리고 TQZHR과 grok2api-merged를 거쳐 전해진 `result.response` 프로세서의 기반 MIT 소스입니다.
grok2api-pro	27	프록시 풀 계층에 대해 grok2api-merged가 출처로 명시한 전이 소스입니다. OmniRoute는 해당 계보 고지를 보존하지만, 제한된 Grok Web 실행기에 프록시 풀을 포팅했다고 주장하지는 않습니다.
GrokProxy	52	쿠키 인증 방식의 Grok 프록시와 `result.response.token` 스트리밍 패턴이 OmniRoute의 Grok Web 전송 계층에 영감을 주었습니다.
GrokBridge	5	원본 Grok Web 구현을 HTTP/브라우저 업스트림 설계에 참고했습니다. 직접적인 HTTP 경로는 GrokProxy에서 파생되었으므로 독립적인 코드 포트는 주장하지 않습니다.

### 🗜️ 컨텍스트 및 토큰 압축 — 엔진

프로젝트	⭐	OmniRoute에 영감을 준 방식
Caveman	116,957	바이럴 문구인 "왜 많은 토큰을 쓰지? 적은 토큰으로도 되는데" 프로젝트 — 동굴인 말투 철학이 표준 압축 모드와 30개 이상의 불필요한 표현 제거/응축 규칙의 기반이 되었습니다.
RTK – Rust Token Killer	85,350	고성능 명령 출력 압축 — RTK 엔진, JSON 필터 DSL, 원시 출력 복구, 그리고 RTK → Caveman 스택 파이프라인에 영감을 주었습니다.
headroom	78,672	되돌릴 수 있는 컨텍스트 압축(SmartCrusher) — `headroom` 엔진과 `ccr` 검색 마커 패턴에 영감을 주었습니다.
LLMLingua	6,797	프롬프트 압축 연구(LLMLingua / LLMLingua-2) — 비동기, 코드 안전, 실패 시 원본 개방 방식의 `llmlingua` 엔진에 영감을 주었습니다.
llmlingua-2-js	33	LLMLingua 엔진의 워커 스레드 백엔드로 사용되는 JS/ONNX 포트(MobileBERT / XLM-RoBERTa)입니다.
Troglodita	50	PT-BR 토큰 압축 — 브라질 포르투갈어 문법에 맞춘 군더더기 표현 축소 및 불필요한 표현 제거 기능으로 pt-BR 언어 팩을 지원합니다.
ponytail	182,929	바이럴 "게으른 시니어 개발자" YAGNI 코더 스킬 — less-code 출력 스타일에 영감을 주었습니다. 이는 Caveman의 간결한 문체와 같은 출력 축에서, 가장 작은 작업 가능한 변경을 유도해 _생성된_ 코드를 줄입니다.
i-have-adhd	59,838	행동 우선의 ADHD 친화적 응답 스타일을 다섯 개 언어에 걸친 OmniRoute의 간결한 출력 스타일에 적용했습니다.

### 🧩 컴팩트 형식, 토큰 연구 및 코드 인식 도구

프로젝트	⭐	OmniRoute에 영감을 준 방식
TOON	25,602	토큰 지향 객체 표기법(Token-Oriented Object Notation) — 열 기반의 헤더+행 모델이 표 형식 압축 단계를 구성하는 데 영향을 주었습니다.
GCF – Graph Compact Format	61	컴팩트한 그래프 형식과 범용 프로필 설계가 OmniRoute의 표 형식 압축 및 Headroom 코덱 형식에 반영되었습니다.
gcf-typescript	4	MIT TypeScript 구현을 Headroom 범용 프로필 코덱으로 직접 벤더링하고 확장했습니다.
token-optimizer-mcp	566	Brotli/SQLite 캐시 + 세션별 컨텍스트 델타 — `session-dedup` 엔진에 영감을 주었습니다.
token-savior	1,203	Bash 출력 압축 + MCP 프로필 — 압축 중단 규율과 MCP 도구 매니페스트 축소에 영감을 주었습니다.
token-saver	162	콘텐츠 인식 방식의 파일 형식별 출력 압축과 실패 인지형 중단 — 형식별 디스패치와 최소 이득 미달 시 건너뛰기를 검증했습니다.
token-optimizer	2,853	"유령 토큰 찾기" — 오프로드 + 복구 가능한 핸들 패턴이 CCR 오프로드 구상에 영향을 주었습니다.
TokenMizer	34	세션 그래프 + 턴 간 줄 중복 제거 청사진이 session-dedup 설계에 영향을 주었습니다.
OmniCompress	3	Rust 열 기반 JSON + 콘텐츠 주소 기반 검색 + 메시지 간 중복 제거 — `headroom`/`ccr`/`session-dedup` 엔진 설계와 캐시 안정적인 "압축 형식은 위치와 무관하다"는 불변식을 검증했습니다.
mcp-compressor	140	MCP 도구 스키마/설명 압축 — MCP 도구 매니페스트의 항목 수 축소에 영향을 주었습니다.
RepoMapper	218	Aider 스타일의 저장소 맵 순위 지정 — 저장소 맵 및 검색 순위 지정 탐색에 영향을 주었습니다.
quiet-shell-mcp	4	MCP를 통한 선언적 셸 출력 축소 — 선언적 bash 출력 압축을 검증했습니다.
ts-morph	6,222	TypeScript Compiler API 도구 키트 — 문자열, 템플릿 및 정규식 리터럴을 보존하는 파서 기반 주석 제거에 영감을 주었습니다.

### 🧠 메모리 및 RAG

프로젝트	⭐	OmniRoute에 영감을 준 방식
Mem0	68,294	범용 메모리 계층 — 프록시를 쓰기/읽기 경계로 사용하는 모델이 당사의 메모리 아키텍처에 영향을 주었습니다.
Letta (MemGPT)	25,321	계층화된 메모리를 사용하는 상태 저장 에이전트 — 당사의 Context Control & Recovery (CCR) 계층 모델에 영감을 주었습니다.
WFGY	1,804	반복적으로 발생하는 16가지 RAG/LLM 장애 모드에 대한 ProblemMap 분류 체계 — 당사의 문제 해결 가이드에서 공유하는 용어 체계입니다.

### 🛰️ 트래픽 검사, MITM 및 투명 프록시

프로젝트	⭐	OmniRoute에 영감을 준 방식
llm-interceptor	81	코딩 어시스턴트 ↔ LLM 트래픽의 MITM 가로채기/분석은 초기 Traffic Inspector 요구 사항에 영향을 주었습니다. 이전에 도출된 네 가지 모듈 — SSE 병합, 대화 정규화, 시크릿 마스킹 및 헤더 정제 — 은 공개 프로토콜 표준을 기반으로 한 독립적인 클린룸 구현으로 대체되었습니다. 두 호스트 패스스루 표면(`passthrough.ts` 및 `_internal/bypass.cjs`)은 OmniRoute 내부에서 독립적으로 분류된 구현으로 남아 있으며, 해당 대체 작업의 일부로 다시 작성되지 않았습니다.
ProxyBridge	6,978	프로세스별 투명 프록시 라우팅 — 장애 안전 MITM 종료, 소켓 유휴 시간 초과, `/proc` 프로세스 어트리뷰션 및 TPROXY 캡처에 영감을 주었습니다.

### 📚 모델 데이터, 관측 가능성 및 UI

프로젝트	⭐	OmniRoute에 영감을 준 방식
models.dev	7,486	AI 모델 사양, 가격 및 기능을 제공하는 공개 데이터베이스 — 당사의 모델 카탈로그에 기본적으로 동기화됩니다.
React Flow / xyflow	38,874	실시간 Compression Studio 및 Combo/Routing Studio를 구동하는 노드 기반 그래프 라이브러리입니다.
LangGraph	44,349	LangGraph Studio의 실시간 워크플로 그래프 시각화는 당사 Studio의 실시간 캐스케이드 보기에 영감을 주었습니다.
Langfuse	36,907	트레이스 → 스팬 → 생성으로 이어지는 관측 가능성 모델이 당사의 Compression Studio 워터폴 구성에 영향을 주었습니다.
Kiali	3,647	Istio 서비스 메시 관측 가능성 — Routing/Combo Studio의 서킷 브레이커 배지와 오류 엣지 시각화에 영감을 주었습니다.
lobe-icons	2,666	대시보드 전반에 프로바이더 아이콘으로 표시되는 AI/LLM 브랜드 로고를 제공합니다.
flag-icons	12,499	README 언어 선택기에서 사용하는 MIT 라이선스 SVG 국기를 제공합니다.

### 🛡️ 보안

프로젝트	⭐	OmniRoute에 영감을 준 방식
awesome-secure-defaults	723	보안 기본값을 제공하는 엄선된 라이브러리 목록으로, 당사의 보안 선택(Helmet.js, DOMPurify, ssrf-req-filter, safe-regex, Google Tink)을 안내합니다.

### 🧭 보완 도구

프로젝트	⭐	OmniRoute에 영감을 준 방식
ClawRouter	6,649	요청 중복 제거, 긴급 무비용 폴백, 플러그형 Auto-Combo 전략 및 다국어 의도 분류에 영감을 주었습니다.
Antigravity-Manager	32,785	계정 인식 모델 재매핑, 실행 파일 경로 검증 및 플랜 레이블 동작이 OmniRoute의 Antigravity 런타임에 영향을 주었습니다.
vscode-antigravity-cockpit	4,852	간결한 할당량 초기화 카운트다운 형식이 OmniRoute의 해당 프로바이더 제한 표시 방식에 영감을 주었습니다.
AionUi	33,996	ACP 통합 기능이 설치된 CLI 에이전트의 자동 감지에 영감을 주었습니다.
CodexBar	22,955	Grok Build 할당량 표면을 식별했으며, 이후 OmniRoute가 라이브 와이어 형식을 독립적으로 검증하고 수정했습니다.

## 📄 라이선스 MIT 라이선스 - 자세한 내용은 [LICENSE](LICENSE)를 참조하세요. ---

**[⬆ 맨 위로 돌아가기](#-omniroute)** · 오픈 소스 AI 커뮤니티를 위해 ❤️로 제작되었습니다. _{Diego Souza 제작 · OmniRoute v3.8.54 · Node ≥22.22.2 · MIT 라이선스 · omniroute.online}