walkingddd/CPA-Helper

CPA-Helper is a local, self-hosted multi-user management panel designed for CLIProxyAPI users. It features independent API keys per user, isolated usage statistics, detailed request tracking, model pricing maintenance, available model querying, administrator account management, and Codex account inspection.

What it solves

CPA-Helper is a self-hosted administration panel designed for users of CLIProxyAPI (CPA). It solves the problem of managing multiple users, tracking API usage and costs, and maintaining API keys across a local environment without having to rely on the core proxy service for administrative tasks.

How it works

The tool acts as a management layer that interacts with CLIProxyAPI's management interfaces. It does not proxy the actual AI model requests; instead, it polls usage queues and manages credentials. It uses a Go backend with a SQLite database to store runtime data and a Vue 3 frontend for the user interface.

Who it’s for

It is intended for administrators of CLIProxyAPI instances who need to monitor global usage, manage user balances and permissions, and provide a multi-user environment where individual users can manage their own API keys and track their own costs.

Highlights

  • Usage Analytics: Detailed tracking of requests, tokens, and estimated costs with global and per-user views.
  • User & Balance Management: Ability to set monthly and lifetime balances in USD, with automatic API key pausing when limits are reached.
  • API Key Lifecycle: Independent API key creation, editing, and synchronization with CPA.
  • Model Pricing Maintenance: Local price catalog for token-based and image-based models, with LiteLLM synchronization support.
  • Account Inspection: Scheduled health and quota checks for Codex auth files via Cron.
  • Local-first Storage: Uses SQLite for data persistence, ensuring data remains on the host machine.

Related

  • Project
  • Project
  • Project
  • Project
  • Project