Willxup/cpa-usage-keeper

Standalone CliProxyAPI usage tracker with SQLite persistence and built-in dashboard.

What it solves

CPA Usage Keeper provides a centralized persistence and analytics dashboard for users of CLIProxyAPI (CPA). It solves the problem of tracking AI model usage, costs, and request health across multiple providers and API keys, which are otherwise transient or difficult to monitor in real-time.

How it works

The tool acts as a standalone server that synchronizes data from a running CPA instance. It pulls configuration, credential data, and usage statistics, storing them in a local SQLite database. It then provides a web-based dashboard (built with React and TypeScript) to visualize this data, including request-level events, cost composition, and latency diagnostics.

Who it’s for

It is designed for developers and administrators who use CLIProxyAPI to manage their AI model access and need a professional way to monitor spending, track quotas, and analyze the performance of their AI providers.

Highlights

  • Comprehensive Analytics: Tracks tokens, cost, cache usage, success rates, RPM/TPM, and latency.
  • Provider Monitoring: Inspects Auth Files and AI Providers with health checks and quota refresh capabilities.
  • Automated Sync: Automatically synchronizes API keys and AI providers while maintaining model pricing for cost estimates.
  • Flexible Deployment: Supports Docker, Docker Compose, Homebrew, and native binaries for Linux, macOS, and Windows.
  • Access Control: Includes built-in password protection and read-only views scoped to specific API keys.
  • Community Rankings: Optional opt-in for rankings based on tokens, requests, and performance metrics.

Related

  • Project
  • Project
  • Project
  • Project
  • Project