9router

library0.4.6jsnpmunverified

9Router CLI (v0.4.6) is a command-line tool for running a local AI endpoint proxy server with a web dashboard. It consolidates access to 15+ AI providers (Claude, OpenAI, Gemini, GitHub Copilot, Qwen, iFlow, DeepSeek, etc.) behind a single OpenAI-compatible endpoint. It supports OAuth2 and API key authentication, automatic format translation between provider-specific schemas (OpenAI, Claude, Gemini, Codex), a combo system for model fallback, and intelligent account rotation on rate limits or errors. The CLI installs globally or runs via npx. It is designed for tools like Claude Code, Cline, RooCode, AmpCode, and Cursor IDE. The project is actively maintained with a focus on simplicity and multi-provider unification, differentiating from single-provider or heavier proxy solutions.

llm-agents http-networking auth-security observability

npm install 9router

package ↗homepage ↗

INSTALL

IMPORT

SIG · 9ROUTER

9router

llm-agentsjavascriptv0.4.6

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ npx 9router

✗ npm start 9router

This is a CLI tool, not a library. Use npx or global install to run the server.

require('9router')

✓ import is not supported; use CLI directly

✗ const router = require('9router')

9router is a CLI only, not a programmatic API. Do not attempt to import or require it in code.

global install

✓ npm install -g 9router

✗ npm install 9router (local install)

Local install works but CLI won't be on PATH. Use -g or npx for direct CLI access.

Installs and runs the 9Router proxy server with optional port and browser flags.

# Install globally npm install -g 9router # Start server with default settings 9router # Or run directly with npx npx 9router --port 8080 --no-browser

9router --version

Debug

Known issues

breakingRequires Node.js >=18.0.0

fix

Upgrade Node.js to version 18 or higher.

affects: >=0.1.0

gotchaDefault port 20128 may conflict with other services

fix

Use --port flag to specify a different port, e.g., 9router --port 3000.

affects: >=0.1.0

gotchaDashboard only accessible when server is running and browser is opened

fix

Ensure server is started with default settings or explicitly open http://localhost:20128/dashboard.

affects: >=0.1.0

deprecatedAuto-update check may be skipped with --skip-update; future versions may remove auto-update

fix

Use --skip-update to suppress or update manually via npm.

affects: >=0.4.0

Errors

Common errors & fixes

Error: Cannot find module '9router'

Local install without -g and not using npx

fix

Install globally with 'npm install -g 9router' or use 'npx 9router'.

EACCES: permission denied, open '/usr/local/lib/node_modules/9router'

Global install fails due to insufficient permissions

fix

Use npx instead: 'npx 9router', or fix npm permissions: 'sudo npm install -g 9router'.

9router: command not found

Global install not on PATH (common on Windows or misconfigured npm)

fix

Use npx: 'npx 9router', or ensure npm global bin directory is in PATH.

Error: listen EADDRINUSE: address already in use :::20128

Port 20128 already occupied by another process

fix

Kill the process using port 20128, or specify a different port: '9router --port 3000'.

Upgrade

Version history

0.4.6latest on npm

Audit

Dependencies

noderequiredRequires Node.js >=18.0.0 for runtime

Agent activity

112 hits · last 30 days

node

103

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/9router ↗

homepagehttps://9router.com ↗