CPA-Manager-Plus
A self-hosted CPA / CLIProxyAPI management panel and AI gateway observability dashboard for requests, usage, cost, quota, failures, and account health.
What is CPA-Manager-Plus?
A self-hosted CPA / CLIProxyAPI management panel and AI gateway observability dashboard for requests, usage, cost, quota, failures, and account health.
Overview of CPA-Manager-Plus
What it is
CPA Manager Plus (CPAMP) is a self-hosted management panel and observability dashboard for CPA / CLIProxyAPI. It provides persistent request history, cost analytics, account health inspection, and automation for AI gateways.
Key features
- CPA Gateway Management: Manage provider configurations (Gemini, Codex, Claude, Vertex, xAI, Devin, Muse/Meta, OpenAI-compatible), auth files, OAuth logins, API keys, model aliases, priorities, plugins, logs, and system settings.
- Request Monitoring and Failure Diagnosis: Persist requests in local SQLite, search by account/client API key, inspect status, latency, token, cache, trace, and redacted failure evidence. Export/import request history as JSONL.
- Cost and Usage Analytics: Break down calls, tokens, cost, latency, and failures by model, provider, account, credential, API key, project, channel, and time range. Sync model prices from models.dev with LiteLLM and OpenRouter fallbacks.
- Account Health, Quota, and Automation: Inspect Codex and xAI accounts, read quota windows, reset evidence, credential state, workspace state, and apply controlled quota cooldowns. Route credential failures into an account action queue.
- Production Operations: Run as one Docker container or native package (Linux, macOS, Windows) for amd64/arm64. Back up SQLite files with data.key. No account registration or telemetry SDK.
Use cases
- Diagnose why requests are failing by inspecting failure rates, status codes, affected models/accounts, and redacted evidence.
- Track where costs are going by breaking down tokens and estimated cost by model, provider, account, API key, project, channel, and time range.
- Monitor account and quota health by reviewing credential state, quota windows, reset evidence, and controlled automation for Codex and xAI accounts.
Getting started
For a guided full-stack or CPAMP-only deployment: bash curl -fsSLO https://raw.githubusercontent.com/seakee/CPA-Manager-Plus/main/bin/install-cpamp.sh bash install-cpamp.sh Preview without deploying: bash CPAMP_DRY_RUN=1 bash install-cpamp.sh To run CPA + CPAMP together with Docker Compose: ```yaml services: cli-proxy-api: image: eceasy/cli-proxy-api:latest restart: unless-stopped ports:
- '8317:8317' volumes:
- cpa-data:/app/data cpa-manager-plus: image: seakee/cpa-manager-plus:latest restart: unless-stopped ports:
- '18317:18317' volumes:
- cpa-manager-plus-data:/data volumes: cpa-data: cpa-manager-plus-data:
bash docker compose up -dOpen `http://:18317/management.html`, retrieve the CPAMP Admin Key from the Manager Server log, then enter the CPA URL and CPA Management Key during setup. For CPAMP only (if CPA is already running):bash docker run -d --name cpa-manager-plus --restart unless-stopped -p 18317:18317 -v cpa-manager-plus-data:/data seakee/cpa-manager-plus:latest ``` Recommended CPA version: v7.3.4+. The HTTP usage queue needs v6.10.8+.
License and pricing
The project is licensed under MIT and is open source.
Based on the project's public README and repository metadata.