Agent skill · software engineering · aradotso
freebuff2api-openai-proxy
OpenAI-compatible proxy server for Freebuff that translates standard OpenAI API requests into Freebuff's backend format with multi-token rotation and Docker deployment.
Why this skill is useful
Adds executable Docker deployment scripts and configuration patterns for integrating Freebuff with OpenAI API requests.
What it needs
Requires docker installed locally. Requires freebuff account access. About 5k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
Freebuff2API OpenAI Proxy Skill by ara.so — Daily 2026 Skills collection. Freebuff2API is an OpenAI-compatible proxy server written in Go that translates standard OpenAI API requests into Freebuff's backend format. It enables any OpenAI-compatible client, SDK, or CLI tool to use Freebuff's free models without modification. What It Does Exposes standard OpenAI endpoints (/v1/chat/completions, etc.) Dynamically randomizes client fingerprints to mimic official Freebuff SDK behavior Rotates multiple auth tokens on a configurable interval Routes outbound traffic through an optional HTTP proxy Ships as a multi-arch Docker image for easy deployment Getting Auth Tokens Before deploying, obtain one or more Freebuff auth tokens: Method 1 — Web (easiest): Visit https://freebuff.llm.pm, log in with your Freebuff account, and copy the displayed token. Method 2 — Freebuff CLI: Token is stored at: Linux/macOS: ~/.config/manicode/credentials.json Windows: C:\Users\<username>\.config\manicode\credentials.json Copy the authToken value — this is your AUTHTOKENS value. Installation & Deployment Docker (Recommended) Docker Compose Build from Source Requirements: Go 1.23+ Configuration config.json Configuration Reference Key / Env Var Default Description --- --- --- LISTENADDR :8080 Proxy listen address UPSTREAMBASEURL https://codebuff.com Freebuff backend URL AUTHTOKENS — Freebuff auth tokens (JSON array or comma-separated) ROTATIONINTERVAL 6h How often to rotate tokens REQUESTTIMEOUT 15m Upstream request timeout APIKEYS [] Client API keys for proxy auth (empty = open access) HTTPPROXY "" HTTP proxy for outbound requests Note: Environment variables override JSON file values when both are set. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/freebuff2api-openai-proxy