daokimluc/X-Router
TypeScript0 / 0
여러 AI provider와 코딩 도구를 단일 호환 gateway로 묶고 풀링·fallback·비용 한도를 제공하는 TypeScript CLI tool입니다.
TL;DR
X-Router는 여러 AI provider와 AI 코딩 도구를 OpenAI·Anthropic 호환 단일 엔드포인트로 연결하는 독립형 self-hosted gateway이자 CLI tool입니다. 요청마다 API key 인증, spend cap 검사, response cache 조회, 모델·채널 해석, 계정 풀링을 거쳐 provider로 전달하며 장애나 rate limit 시 다음 채널로 자동 전환합니다. 웹 대시보드는 provider, 계정, route, key, team, quota, 비용, latency와 usage를 관리하고 Token Saver와 Prometheus metrics도 제공합니다. 별도 DB 없이 JSON 파일을 사용해 설치는 간단하지만 Foza marketplace는 public beta 단계이므로 완성된 상용 결제·정산 플랫폼보다는 gateway 중심의 개발·운영 도구로 판단하는 편이 적절합니다.
핵심 포인트
- 독립형 self-hosted AI gateway이자 CLI tool로 분류됩니다. Node.js 22+와 Fastify 기반으로 실행되며 OpenAI·Anthropic 호환 프로토콜을 한 포트에서 제공합니다. Cursor, Claude Code, Cline, Codex 등 여러 AI 코딩 도구를 단일 로컬 URL에 연결하려는 환경에 맞습니다.
- 요청은 API key 인증과 사전 지출 한도 확인을 거친 뒤 캐시 조회, 모델·채널 선택, 계정 풀링 순서로 처리됩니다. 채널 장애나 rate limit이 발생하면 같은 모델의 다음 후보로 자동 전환하고 계정별 round-robin·least-busy·weighted·priority 전략을 적용합니다. 여러 provider와 계정을 묶어 가용성과 처리량을 관리하려는 운영에 유용합니다.
- 대시보드에서 provider, account, channel, model, route, team, pricing, client key를 관리합니다. API key별 모델 허용 목록, IP allowlist, 만료일, 요청·토큰 quota, 일·월별 USD spend cap을 설정하고 Prometheus /metrics와 p50·p95·p99 latency를 확인할 수 있습니다. 별도 데이터베이스 없이 JSON state file에 운영 상태를 저장하므로 소규모 self-hosting은 단순하지만 상태 관리 요구가 커지면 검토가 필요합니다.
- Foza는 X-Router core 위에 marketplace와 control plane을 추가하는 별도 Next.js 애플리케이션입니다. 구매자·provider·관리자용 identity, wallet, prepaid token pack, webhook, settlement 흐름을 제공하지만 public beta이며 검색·필터, provider 수익 화면, seller 승인 동기화, 일부 결제 복구가 미완성입니다. 단순 gateway만 필요하면 core를 사용하고 marketplace까지 필요할 때 Foza의 개발 상태와 보안 운영 범위를 함께 확인해야 합니다.
이미지 분석

83
Stars
82
Forks
+207
Trending
0
조회수
83 watchers0 open issues
관련 토론
아직 관련 토론이 없습니다.
댓글
댓글을 작성하려면 로그인이 필요합니다.