Oh-My-CPA: управление API и отслеживание запросов через консоль

Oh-My-CPA: управление API и отслеживание запросов через консоль

Oh-My-CPA — это самохозяйственная консоль для управления и наблюдения за использованием API через CLIProxyAPI. Проект ориентирован на разработчиков, которые хотят централизовать свои API, управлять ключами и отслеживать телеметрию запросов и затраты на модели.

Подобные решения существуют, но Oh-My-CPA выделяется своей легковесностью и возможностью разворачивания в собственном окружении, что подходит для команд с требованиями к контролю данных и безопасности. Подходит для разработчиков, работающих с множеством API-провайдеров, которые хотят видеть полную картину использования своих ресурсов.

Проект написан на Go с фронтендом на React и предлагает возможность запуска как отдельного бинарника. Инструкции по установке содержатся в README, и его можно запустить через Docker. Будь внимателен, проект находится на ранней стадии, поэтому могут быть ограничения в функционале.

Проект **Oh My CPA** (OMC) — это веб-консоль для управления API-шлюзом **CLIProxyAPI** (CPA). Он предназначен для упрощения работы с API, а также для управления OAuth, визуализации запросов, затрат и их использования. OMC представляет собой единственный бинарный файл на Go с интегрированной консолью на React и локальной базой данных SQLite. Он работает в оффлайн-режиме и требует для входа ключ управления CPA.

Установка

Существует несколько способов установки OMC:

  • Установка через агента: можно вставить специальную команду в Claude Code или другой кодировщик, чтобы агент сам выбрал подходящий метод установки:
  • Install Oh My CPA for me by following
    https://raw.githubusercontent.com/WizisCool/oh-my-cpa/master/docs/install-for-agents.md
    
  • Установка с помощью Docker Compose: требуется установленный Docker Engine с плагином Compose и CLIProxyAPI версии 8.0.0 или выше. Настройки зависят от сценария, например, если CPA ещё не развернут, необходимо создать файл `compose.yml`, указав конфигурацию для OMC и CPA
  • curl -fsSL https://github.com/WizisCool/oh-my-cpa/releases/latest/download/cpa.config.example.yaml -o config.yaml
    printf 'CPA_MANAGEMENT_KEY=%s\nOMCPA_MASTER_KEY=%s\n' "$(openssl rand -hex 24)" "$(openssl rand -hex 32)" > .env
    chmod 600 .env
    docker compose up -d
    
  • Установка как нативный исполняемый файл: можно скачать исполняемые файлы для macOS, Windows, Linux и FreeBSD. Необходимо отдельно установить CPA. Подробности по установке можно найти в [руководстве](docs/install.md#native-executable).

Функционал

OMC предлагает множество возможностей:

  • Управление провайдерами и OAuth: управление ключами, их квотами, настройками и интеграция с разными AI-провайдерами.
  • Визуализация: отображение статистики запросов, затрат и использования в удобном виде с возможностью фильтрации.
  • Аудит и ведение журнала: хранение информации о каждом запросе, а также возможность наблюдения за историей запросов.
  • Настройка цен: возможность использовать фиксированные и индивидуальные тарифы за запросы.
  • Режим работы в оффлайне: все необходимые ресурсы встроены в бинарный файл, обеспечивая полную независимость от CДН.

Ограничения

Некоторые моменты, на которые стоит обратить внимание:

  • Необходимо хранить файл `.env`, так как ключ `OMCPA_MASTER_KEY` используется для шифрования базы данных, и без него данные невозможно будет расшифровать.
  • OMC может вести учет использования только одного потока запросов — использование нескольких отслеживателей может вызвать конфликты.
  • Сеть должна быть защищена HTTPS, чтобы избежать утечек ключей и секретов при подключении внешних агентов.

Более полную информацию о функционале, установке и конфигурации можно найти в [документации](docs/install.md).

Открыть на GitHub: WizisCool/oh-my-cpa →

Что нового на GitHub — короткие обзоры на русском Новые обзоры приходят в Telegram. Без спама, по делу.
Подписаться

Похожие статьи

Популярные темы на сайте