Willxup/cpa-usage-keeper

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.

CPA Usage Keeper は、CLIProxyAPI (CPA) のユーザー向けに、集約された永続化および分析ダッシュボードを提供します。複数のプロバイダーや API キーにわたる AI モデルの使用量、コスト、およびリクエストの健全性を追跡するという、通常は一時的であったりリアルタイムでの監視が困難であったりする問題を解決します。

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.

このツールは、実行中の CPA インスタンスからデータを同期するスタンドアロンサーバーとして機能します。設定、認証情報、および使用統計情報を取得し、ローカルの SQLite データベースに保存します。その後、React と TypeScript で構築された Web ベースのダッシュボードを提供し、リクエストレベルのイベント、コスト構成、およびレイテンシ診断などのデータを可視化します。

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.

CLIProxyAPI を使用して AI モデルへのアクセスを管理している開発者や管理者が対象です。支出の監視、クォータの追跡、および AI プロバイダーのパフォーマンス分析を行うためのプロフェッショナルな方法を必要とする方に適しています。

Highlights

• Comprehensive Analytics: Tracks tokens, cost, cache usage, success rates, RPM/TPM, and latency.
• Comprehensive Analytics: トークン、コスト、キャッシュ使用量、成功率、RPM/TPM、およびレイテンシを追跡します。
• Provider Monitoring: Inspects Auth Files and AI Providers with health checks and quota refresh capabilities.
• Provider Monitoring: ヘルスチェックおよびクォータ更新機能を使用して、Auth Files と AI Providers を検査します。
• Automated Sync: Automatically synchronizes API keys and AI providers while maintaining model pricing for cost estimates.
• Automated Sync: API キーと AI プロバイダーを自動的に同期し、コスト見積もりのためにモデルの価格設定を維持します。
• Flexible Deployment: Supports Docker, Docker Compose, Homebrew, and native binaries for Linux, macOS, and Windows.
• Flexible Deployment: Docker、Docker Compose、Homebrew、および Linux、macOS、Windows 用のネイティブバイナリをサポートしています。
• Access Control: Includes built-in password protection and read-only views scoped to specific API keys.
• Access Control: 内蔵のパスワード保護と、特定の API キーに限定された読み取り専用ビューを含みます。
• Community Rankings: Optional opt-in for rankings based on tokens, requests, and performance metrics.
• Community Rankings: トークン、リクエスト、およびパフォーマンス指標に基づいたランキングへのオプション参加が可能です。