CPA Manager Plus

A self-hosted CPA / CLIProxyAPI management panel and AI gateway observability dashboard for requests, usage, cost, quota, failures, and account health.

Operate providers, credentials, OAuth, plugins, and configuration while keeping persistent request history, cost analytics, and account automation in local storage.

中文 ｜ Live Demo ｜ Documentation ｜ Install

What Can CPAMP Help You Answer?

• Why are requests failing? Inspect failure rates, status codes, affected models/accounts, and redacted evidence in persistent request history.
• Where is the cost going? Break down tokens and estimated cost by model, provider, account, API key, project, channel, and time range.
• Are accounts and quotas healthy? Review credential state, quota windows, reset evidence, and controlled automation for Codex and xAI accounts.

Screenshots

Which Panel Should You Choose?

CPA / CLIProxyAPI can serve either the official Management Center or the CPAMP Lightweight Panel directly on :8317. The lightweight panel replaces the official UI without adding another service. Deploy CPAMP Full Mode when you also need persistent observability and long-running operations.

Option	Best for	Entry
Official CLI Proxy API Management Center	Keeping the upstream UI maintained by the CPA project	CPA :8317/management.html
CPAMP Lightweight Panel	Replacing only the UI without another service or database	CPA :8317/management.html
CPAMP Full Mode	Request history, cost analytics, inspection, and automation	Manager Server :18317/management.html

See Choosing A CPA Panel for the comparison, or install the CPAMP Lightweight Panel directly in CPA.

Core Capabilities

CPA Gateway Management

• Manage CPA provider configurations, including Gemini, Codex, Claude, Vertex, xAI, Devin, Muse / Meta, and OpenAI-compatible providers.
• Maintain auth files, OAuth logins, API keys, model aliases, priorities, plugins, logs, and system settings. Muse / Meta supports Device Flow credentials separately from meta-api-key inference providers.
• Import official Sub2API OpenAI OAuth exports and split multiple accounts into separate CPA Codex auth files.

Request Monitoring And Failure Diagnosis

• Persist requests from the CPA usage queue in local SQLite and search account, client API key, and realtime request views.
• Inspect status, latency, token, cache, trace, and redacted failure evidence without exposing raw failure bodies.
• Export or import request history as JSONL.
• Open the Monitoring Demo.

Cost And Usage Analytics

• Break down calls, tokens, cost, latency, and failures by model, provider, account, credential, API key, project, channel, and time range.
• Track input, output, reasoning, cache, service tier, and long-context pricing semantics.
• Sync model prices from models.dev first, with LiteLLM and OpenRouter fallbacks plus local overrides for aliases or internal models.
• Open the Usage Analytics Demo.

Account Health, Quota, And Automation

• Inspect Codex and xAI accounts locally or on a Manager Server schedule.
• Read quota windows, reset evidence, credential state, workspace state, and provider-specific health signals when available.
• Apply controlled quota cooldowns and route credential failures into an account action queue for review and recovery.
• Open the unified Accounts Demo.

Production Operations

• Run CPAMP Full Mode as one Docker container or a native Linux, macOS, or Windows package for amd64/arm64; the full stack can run alongside CPA.
• Keep request history, Manager configuration, automation state, and model prices in local files with no account registration or telemetry SDK.
• Back up SQLite files together with data.key to preserve encrypted CPA Management Keys.
• If you harden the runtime with a read-only root filesystem or a non-root user, give SQLite a writable temporary directory and a writable database file; see Read-Only Root Filesystem.

This is the beginning of the README. Read the rest at the original. Read the full README ↗