oh-my-cpa
Modern web console for CLIProxyAPI v8+ with provider and OAuth management, live routing, request analytics, pricing, and MCP.
What is oh-my-cpa?
Modern web console for CLIProxyAPI v8+ with provider and OAuth management, live routing, request analytics, pricing, and MCP.
Overview of oh-my-cpa
What it is
CLIProxyAPI (CPA) is an API gateway that adapts protocols, holds credentials and proxies requests. Oh My CPA (OMC) is a web console for CPA. OMC manages the gateway's providers, credentials and configuration, and records the usage and cost of every request. It is a single Go binary with the React console embedded and a local SQLite database, runs offline, and signs in with CPA's management key.
Key features
- AI providers and OAuth management: manage multiple AI providers (Codex, Claude, Gemini, etc.) with credentials, advanced model options, retry/error policies, priority, weight, proxy, and an enable switch. OAuth sign-in from the console for several services, with quota monitoring, token refresh, and credential-specific settings.
- Client keys: create, name, and revoke gateway API keys. Names appear in request records and filters.
- Model catalog and Playground: pull model lists straight from upstream providers. Test any routed model with text and images, streamed multi-turn answers and request diagnostics.
- Insights and Dashboard: per-key, per-model, per-provider and per-credential comparison over various time ranges. Request volume, token throughput, cache hit rate and cost over presets from 15 minutes to 90 days, an all-time window, or any custom range. Statistics are kept permanently.
- Live routing: a rolling minute of which models were called and which credentials and providers CPA sent them to. Each new request travels the map out to its credential and back, rerouted attempts and cooldowns included.
Use cases
- Self-hosted management of AI provider credentials and configuration for CPA.
- Monitoring usage and cost of AI API requests across multiple providers and client keys.
- Auditing and analyzing request patterns, model mix, and cost trends.
- Managing OAuth tokens and quotas for services like Codex, Claude, and others.
Getting started
See the repository README for detailed installation instructions. For a new install with Docker Compose, save the provided compose.yml in a new directory, then run: bash curl -fsSL https://github.com/WizisCool/oh-my-cpa/releases/latest/download/cpa.config.example.yaml -o config.yaml printf 'CPA_MANAGEMENT_KEY=%s%cOMCPA_MASTER_KEY=%s%c' $(openssl rand -hex 24) $(openssl rand -hex 32) > .env chmod 600 .env docker compose up -d Open http://127.0.0.1:8080/omc/ and sign in with the CPA_MANAGEMENT_KEY value from .env.
License and pricing
License: MIT. Open source.
Based on the project's public README and repository metadata.