// readme


โšก Overview

X Router is an ultra-lightweight, high-performance AI routing gateway running on Node.js 26 (ESM) with an embedded Next.js 14.2 dashboard, currently in transition toward a planned Hybrid Go Core architecture (see Migration Plan).

It consolidates 40+ upstream AI providers (Claude, OpenAI, Antigravity, DeepSeek, River AI, OpenCode, Kilo, Grok, Gemini, and custom nodes) behind unified OpenAI and Anthropic-compatible wire surfaces with high-efficiency Node.js concurrency, zero-CGO SQLite WAL persistence, automated dead-account pruning, and integrated Telegram Bot Remote Control.


๐Ÿ›๏ธ Architecture

 โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
 โ”‚                           CLIENT INGRESS                               โ”‚
 โ”‚   OpenAI SDK / cURL                    Claude Code / Anthropic SDK     โ”‚
 โ”‚   POST /v1/chat/completions            POST /v1/messages               โ”‚
 โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                    โ”‚                                 โ”‚
                    โ–ผโ€ฆ