Sobre o projeto

CPA Manager Plus (CPAMP) é um painel de gerenciamento e observabilidade self-hosted para gateways CPA/CLIProxyAPI. Não é um proxy substituto: gerencia e observa o tráfego que flui pelo CPA, sem encaminhar tráfego de modelo por conta própria. Capacidades principais Gerenciamento de gateway: configura provedores CPA, incluindo endpoints compatíveis com Gemini, Codex, Claude, Vertex, xAI, Devin, Muse/Meta e OpenAI; mantém arquivos de autenticação, logins OAuth, chaves de API, aliases de modelo, prioridades, plugins, logs e configurações do sistema. Pode importar exportações oficiais do Sub2API OpenAI OAuth e dividir várias contas em arquivos de autenticação CPA Codex separados. Monitoramento de requisições e diagnóstico de falhas: requisições da fila de uso do CPA são persistidas em SQLite local e podem ser pesquisadas por conta, chave de API do cliente ou visualizações em tempo real. Status, latência, tokens, cache, rastreamento e evidências de falha redigidas são inspecionáveis; o histórico pode ser exportado ou importado como JSONL. Análises de custo e uso: chamadas, tokens, custo, latência e falhas podem ser detalhados por modelo, provedor, conta, credencial, chave de API, projeto, canal e intervalo de tempo, incluindo semânticas de preço de entrada, saída, raciocínio, cache, nível de serviço e contexto longo. Os preços de modelo são sincronizados do models.dev com fallbacks LiteLLM e OpenRouter e sobrescrições locais. Saúde de conta, cota e automação: contas Codex e xAI podem ser inspecionadas localmente ou em um agendamento do Servidor de Gerenciamento, lendo janelas de cota, evidências de redefinição, estado de credenciais e espaço de trabalho. Resfriamentos de cota controlados e uma fila de ações de conta suportam revisão e recuperação. Implantação e operações O Modo Completo roda como um único contêiner Docker ou um pacote nativo Linux, macOS ou Windows para amd64/arm64, e pode rodar junto com o CPA. Um modo de painel leve substitui a interface oficial do CPA na porta 8317 sem adicionar outro serviço. A pilha completa expõe o painel na porta 18317. Um script de instalação suporta implantação guiada, pré-visualização de simulação, atualização, reparo e recuperação de chave de administrador. Histórico de requisições, configuração, estado de automação e preços de modelo permanecem em arquivos locais; arquivos SQLite devem ser copiados junto com data.key para preservar Chaves de Gerenciamento CPA criptografadas. Sistemas de arquivos raiz somente leitura ou configurações sem root precisam de um diretório temporário gravável e arquivo de banco de dados. Privacidade e segurança O projeto declara que não envia dados para casa, não inclui SDKs de análise nem exige registro de conta. Chamadas externas são limitadas ao gateway CPA e integrações que o usuário configura ou aciona, como OAuth, verificações de provedor, lançamentos de plugins e sincronização de preços de modelo. Chaves de gerenciamento são criptografadas antes da persistência em SQLite, e APIs normais e exportações JSONL expõem resumos de falha redigidos em vez de corpos de falha brutos. Destina-se a tráfego e credenciais que o operador está autorizado a gerenciar. Desenvolvimento e lançamento O aplicativo web é construído com scripts npm para desenvolvimento, verificação de tipos, lint, teste, build e documentação; o Servidor de Gerenciamento é baseado em Go com go test, testes de corrida e vet. Os lançamentos produzem um único management.html, pacotes nativos e imagens Docker para linux/amd64 e linux/arm64, com um processo de lançamento validado e serializado. Licenciado sob MIT.