9Router v2

A self-hosted AI gateway — one endpoint, many providers, auto-fallback.

9Router v2 is a decoupled rewrite of 9Router with a clean separation between a dedicated Express backend and a Vite + React frontend. It exposes an OpenAI-compatible REST API that proxies requests across dozens of AI providers with automatic load balancing, fallback, and key rotation.

---

Screenshots

---

Features

• OpenAI-compatible API — works with any client that supports /v1/chat/completions, /v1/images/generations, /v1/audio/speech, /v1/embeddings, etc.
• Multi-provider routing — Cloudflare Workers AI, OpenAI, Anthropic, Gemini, Groq, and many more
• Cloudflare Workers AI Automation — automates account registration and API key extraction with Playwright + 2Captcha + Ammail temp mail
• Dashboard UI — manage providers, connections, proxy pools, CLI tools, and automation from a modern dark-mode interface
• OIDC / Password authentication — single sign-on or local credentials
• Agent Skills — ready-to-use SKILL.md files for Claude, Gemini, Codex, and other AI coding agents
• SQLite backend — zero-dependency local database, no external services required

---

Architecture

9router-v2/
├── backend/          # Express server (port 3001)
│   └── src/
│       ├── routes/   # Auto-routed endpoints (/v1, /api, /auth, ...)
│       ├── db/       # SQLite via better-sqlite3
│       └── automation/ # Playwright automation scripts
├── frontend/         # Vite + React SPA (port 5177)
│   └── src/
│       ├── pages/    # Dashboard pages
│       └── shared/   # Components, hooks, constants
└── skills/           # Agent SKILL.md files

---

Quick Start

Requirements

• Node.js 20+
• Python 3.10+ (for automation features)
• Chromium (for Playwright automation)

Install

git clone https://github.com/ahwanulm/9router-v2.git
cd 9router-v2
npm install

Development

npm run dev          # Start both backend + frontend concurrently
npm run backend      # Backend only (port 3001)
npm run frontend     # Frontend only (port 5177)

Environment Variables

Copy and configure the backend environment:

cp backend/.env.template backend/.env

Key variables:

---

Production Deployment

1. Build Frontend

cd frontend && npm run build

2. Start Backend

cd backend && npm start

3. Nginx Reverse Proxy