CPA Manager Plus offers an advanced management panel and persistent analytics server for the CLI Proxy API (CPA). It addresses the need for robust monitoring, usage tracking, model pricing, and administrative insights beyond CPA's core capabilities. Designed for users managing CPA deployments, it provides a centralized, feature-rich interface to streamline operations and gain deeper visibility into API interactions.

How It Works

Two modes are offered: "Full Docker mode" features a Dockerized Go Manager Server hosting a React frontend, persisting usage analytics to SQLite, and integrating advanced features like runtime monitoring, model pricing, and API key aliases. This server consumes CPA's usage queue via HTTP or RESP Pub/Sub. "CPA panel mode" uses CPA's native panel, offering basic CPA controls and local Codex inspection, isolated from the Manager Server's advanced analytics. The Full Docker mode's advantage lies in its unified, persistent data store and comprehensive feature set.

Quick Start & Requirements

• Docker: docker run -d --name cpa-manager-plus --restart unless-stopped -p 18317:18317 -v cpa-manager-plus-data:/data seakee/cpa-manager-plus:latest
• Native Packages: Download and extract provided archives for Linux, macOS, or Windows.
• Prerequisites: CPA version >= v7.1.39 recommended; >= v6.10.8 required for HTTP usage queue. CPA must have usage statistics enabled.
• Setup: Requires an admin key (generated on first startup or via env var) and CPA connection details (URL, Management Key).
• Related Project: CLIProxyAPI: CLIProxyAPI

Highlighted Details

• Comprehensive analytics: request monitoring, dashboard usage statistics, model pricing, API key aliases, usage import/export.
• Server-backed Codex account inspection and persisted inspection history.
• Encrypted CPA Management Key storage and admin-key protected panel access.
• Dual deployment modes: Full Docker (feature-rich) and CPA panel (basic CPA management).
• Native packages and Docker images available for multiple architectures (amd64, arm64).

Maintenance & Community

No specific details on maintainers, community channels, or roadmap were found in the provided text.

Licensing & Compatibility

• License: MIT.
• Compatibility: Compatible with CPA versions >= v6.10.8. The MIT license generally permits commercial use.

Limitations & Caveats

Manager Server requires continuous operation; downtime exceeding CPA's queue retention window leads to data loss. Only one Manager Server instance should consume a given CPA usage queue. Data persistence relies on correctly mounting the /data volume or managing the data directory; rebuilds without persistent storage will erase data. CPA panel mode omits advanced Manager Server features. Importing legacy JSON usage data may reduce accuracy for detailed breakdowns.