Freebuff2API: un proxy compatible con clientes OpenAI

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

• Dificultad: avanzado
• Proyecto: https://github.com/Quorinex/Freebuff2API (licencia MIT)
• Guía completa: https://lab.wisd.ai/hub/freebuff-openai-compatible-proxy

Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Comprueba que Git y Go ≥1.23 están disponibles. El README documenta la compilación:

git clone https://github.com/Quorinex/Freebuff2API.git
cd Freebuff2API
go build -o Freebuff2API .

Copia config.example.json a config.json desde esa raíz. Configura AUTH_TOKENS con el authToken de tu sesión válida, siguiendo Authentication del README; usa UPSTREAM_BASE_URL igual a https://codebuff.com. Configura LISTEN_ADDR como 127.0.0.1:8080 y una lista API_KEYS no vacía con claves propias del cliente. Las variables de entorno prevalecen sobre el JSON. Inicia:

./Freebuff2API -config config.json

En otra terminal, con curl disponible, configura PROXY_API_KEY con una de las claves locales de API_KEYS. Consulta la ruta implementada en server.go:

curl -i http://127.0.0.1:8080/v1/models
curl -s http://127.0.0.1:8080/v1/models -H "Authorization: Bearer $PROXY_API_KEY"

La primera petición debe devolver 401 y la segunda el catálogo. En tu cliente compatible configura la base http://127.0.0.1:8080/v1, esa misma clave y un ID de modelo del catálogo. Envía una consulta breve y contrasta el campo model de la respuesta. Las rutas de comprobación se toman del código del servidor.

Comprobación

Comprueba una petición corta y revisa qué modelo devuelve realmente el servicio. Verifica que el proxy rechaza clientes sin la autenticación configurada.

Si algo falla

Si el backend rechaza la petición, comprueba acceso y cambios del servicio. No asumas que la compatibilidad del formato garantiza la disponibilidad del modelo.

Consulta el README oficial para requisitos y variantes de instalación.