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로 구축된 웹 기반 대시보드를 제공하여 요청 수준의 이벤트, 비용 구성 및 지연 시간 진단을 포함한 데이터를 시각화합니다.

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: Linux, macOS, Windows용 Docker, Docker Compose, Homebrew 및 네이티브 바이너리를 지원합니다.
• 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: 토큰, 요청 및 성능 지표를 기반으로 한 랭킹에 선택적으로 참여할 수 있습니다.