RepoRadar freebuff-proxy: шлюз для моделей FreeBuff с REST API и панелью управления
Проект freebuff-proxy — это шлюз для моделей кодирования FreeBuff, совместимый с OpenAI. Он предлагает REST API для взаимодействия с FreeBuff и добавляет встроенную панель управления на Svelte.
freebuff-proxy позволяет маршрутизировать запросы к FreeBuff через знакомые эндпоинты OpenAI и Anthropic. Можешь запускать его в различных режимах: "пул" хранит токены, "мост" использует токены в каждом запросе, а "гибридный" комбинирует оба подхода. Это удобно, если ты хочешь интегрировать FreeBuff в существующую инфраструктуру без изменения кода приложения. Встроенная панель управления делает управление сессиями более простым.
Проект написан на Go. Для запуска достаточно скопировать файл окружения и выполнить несколько команд, как указано в README. Обрати внимание, что есть ограничения по количеству запросов и режимы работы с токенами. Это может не подойти для коммерческого использования без тщательной настройки, так как проект пока находится на ранней стадии.
Проект freebuff-proxy представляет собой шлюз, разработанный на языке Go, который служит посредником между клиентами и сервисом FreeBuff. Он поддерживает работу с API OpenAI и Anthropic, а также включает в себя встроенную панель управления на базе Svelte.
Зачем это нужно
Этот прокси переводит запросы, поступающие к OpenAI и Anthropic, в протокол FreeBuff. Он может работать в разных режимах:
- Pooled — используется набор токенов (AUTH_TOKENS), при этом мост (BRIDGE_ENABLED) отключен; работает только с пулом токенов.
- Bridge — набор токенов пуст, каждый запрос использует свой собственный токен.
- Hybrid — режим по умолчанию, использует пул для токенов API_KEYS и отправляет другие токены как токены моста.
Панель управления доступна по адресу /admin.
Метрики Freebucks следуют определенной карте цен: взимается плата один раз в начале сессии, может быть возвращена при завершении сессии раньше времени и пополняется по расписанию.
Как установить и запустить
Для быстрой настройки достаточно выполнить следующие команды:
cp .env.example .env # затем отредактируй: AUTH_TOKENS, ADMIN_TOKEN и т.д.
go build ./backend/...
go run ./backend/cmd/freebuff-proxy
Можно также запустить проект из образа, полученного из GHCR:
cp .env.example .env # затем отредактируй: AUTH_TOKENS, ADMIN_TOKEN и т.д.
VERSION=v1.7.0 docker compose pull
VERSION=v1.7.0 docker compose up -d
Обязательно проверь статус через GET /healthz, который должен вернуть 200, и учти, что /admin защищен логином.
Основные настройки, которые стоит знать: SAFE_MODE=true (защита от бана), COST_MODE=free, ограничения по запросам 30 в минуту и 1500 в день.
Ограничения и безопасность обновлений
Хранилище данных располагается в отдельном файле, и при каждом обновлении необходимо следовать указанной процедуре:
docker compose stop freebuff-proxy
scripts/backup-state.sh # создание снимка + манифест
docker compose up -d --build # пересоздание на том же объёме
ADMIN_TOKEN="$ADMIN_TOKEN" scripts/verify-state.sh # проверка состояния
Перед копированием базы данных обязательно останови контейнер или используй специальный сценарий резервного копирования.
Структура проекта
backend/— исходники шлюза.frontend/— исходники панели управления.scripts/— инструменты для синхронизации.docs/— документация по рабочим процессам агентов.
При взносе предложений соблюдай правила работы с ветками, избегай коммитов с секретами.
Радар проекта: 13 из 100 — эксперимент
- Импульс 0 ≈ 0 звёзд в месяц
- Темп разработки — GitHub ещё считает статистику
- Зрелость 0 возраст неизвестен, релизов нет
- Сообщество 0 участники неизвестны, 0 форков
- Свежесть 0 последний коммит — неизвестно когда
- Быстрый старт 50 есть: команда установки
- Готовность к продакшену 0 ни релизов, ни тестов не видно
- Безопасность и доверие 10 без лицензии
- Документация 53 README 4.1 тыс. знаков, 6 разделов
- Экосистема 0 0 подписчиков на обновления, 0 тем
Как считаем
Только открытые данные GitHub на 07.11.2026, без оценок нейросети. Каждая ось — от 0 до 100, итог — среднее.
- Импульс — звёзд в день: за время наших замеров, а пока их нет — за всю жизнь проекта; 200 в день — максимум.
- Темп разработки — коммитов за последние 12 недель; 300 — максимум. Пока GitHub не досчитал статистику, ось не учитывается.
- Зрелость — возраст проекта (3 года — максимум) и число релизов (30 — максимум), поровну.
- Сообщество — участников с коммитами (200 — максимум) и форков (5000 — максимум), поровну.
- Свежесть — дней с последнего коммита: сегодня — 100, полгода и больше или архив — 0.
- Быстрый старт — в README есть команда установки, раздел «быстрый старт» или примеры использования, в репозитории — Docker и папка примеров, у проекта есть сайт или демо.
- Готовность к продакшену — релизы, версия 1.0 и выше, автосборка (GitHub Actions), тесты, лицензия, журнал изменений.
- Безопасность и доверие — открытая лицензия (своя — половина балла), политика безопасности (SECURITY.md), проект организации, правила для участников, не в архиве.
- Документация — объём и структура README, папка docs или сайт, оценка «здоровья сообщества» GitHub.
- Экосистема — звёзды (50 тыс. — максимум), подписчики на обновления (1000 — максимум), темы репозитория.
Открыть на GitHub: trefeon/freebuff-proxy →
