nightwalker8x/n9router repository overview

⁠n9router Docker Image

n9router is a self-hosted AI routing gateway and OpenAI-compatible Docker proxy for Claude Code, Cursor, Antigravity, Copilot, Codex, Gemini CLI, OpenCode, Cline, OpenClaw, and 40+ AI providers.

Run n9router locally or on a VPS with Docker to get model fallback, quota tracking, token savings, format translation, and multi-account routing.

⁠Quick Start

docker run -d \
  --name n9router \
  -p 20128:20128 \
  -e JWT_SECRET="change-this-secret" \
  -e INITIAL_PASSWORD="change-this-password" \
  -e NEXT_PUBLIC_BASE_URL="http://localhost:20128" \
  -v n9router-data:/app/data \
  nightwalker8x/n9router:latest

Dashboard: http://localhost:20128/dashboard⁠

OpenAI-compatible API endpoint: http://localhost:20128/v1⁠

⁠Versioned Tag

docker run -d \
  --name n9router \
  -p 20128:20128 \
  -e JWT_SECRET="change-this-secret" \
  -e INITIAL_PASSWORD="change-this-password" \
  -e NEXT_PUBLIC_BASE_URL="http://localhost:20128" \
  -v n9router-data:/app/data \
  nightwalker8x/n9router:v0.4.25

⁠Persistent Local Data

mkdir -p ./data/n9router

docker run -d \
  --name n9router \
  -p 20128:20128 \
  -e JWT_SECRET="change-this-secret" \
  -e INITIAL_PASSWORD="change-this-password" \
  -e NEXT_PUBLIC_BASE_URL="http://localhost:20128" \
  -v "$PWD/data/n9router:/app/data" \
  nightwalker8x/n9router:latest

⁠Features

• OpenAI-compatible gateway at /v1/*
• Works with Claude Code, Cursor, Codex, Gemini CLI, Antigravity, OpenCode, Cline, OpenClaw, and more
• Routes to 40+ AI providers and 100+ models
• Format translation between OpenAI, Claude, Gemini, Codex, Cursor, Antigravity, Kiro, Ollama, and provider-native formats
• Automatic fallback across subscription, cheap, and free providers
• Multi-account routing and quota tracking
• RTK token saver for coding-agent tool output
• Dashboard for providers, API keys, usage, combos, pricing, and MITM setup

⁠Tags

• nightwalker8x/n9router:latest
• nightwalker8x/n9router:v0.4.25

Current public image is published for linux/arm64. For linux/amd64, build locally from source or use a future multi-arch tag.

⁠Links

• GitHub: https://github.com/nightwalker89/n9router⁠
• npm: https://www.npmjs.com/package/n9router⁠