gitwtfhub

wtf is cf-proxy?

waguriagentic/cf-proxy — explained in plain English

Analysis updated 2026-05-18

29JavaScriptAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A proxy server that makes Cloudflare's Workers AI look like the OpenAI API, rotating across multiple accounts to stretch daily free usage limits.

Mindmap

mindmap
  root((cf-proxy))
    What it does
      OpenAI compatible API
      Rotates CF accounts
      Tracks neuron usage
    Tech stack
      Node.js
      Express
      React dashboard
    Use cases
      Avoid daily limits
      Chat and embeddings
      Monitor account pool
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Point an OpenAI compatible app at Cloudflare Workers AI without changing its request format.

REASON 2

Rotate across multiple Cloudflare accounts so daily free neuron limits are less likely to block requests.

REASON 3

Watch a dashboard of account status, neuron usage, and recent request logs while developing.

What's in the stack?

Node.jsExpressReactViteSQLite

How it stacks up

waguriagentic/cf-proxyable-rip/cc-visionrouteraisatan/poe2dire
Stars292929
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasyeasy
Complexity3/52/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs one or more Cloudflare Workers AI accounts to populate the rotation pool.

Wtf does this do

This project is a small server that sits between your application and Cloudflare's AI service, called Workers AI, and makes it look like the widely used OpenAI API. That matters because many tools and apps already know how to talk to OpenAI's API format, so pointing them at this proxy instead lets them use Cloudflare's AI models with no changes to how they send requests. Cloudflare gives each account a free daily allowance of AI usage, measured in units called neurons, and once an account runs out for the day it starts failing. This proxy is built to work around that limit by holding a pool of several Cloudflare accounts and rotating between them. It automatically skips an account that Cloudflare has rate limited, and it also tries to estimate how many neurons each account has used so far today, skipping accounts that are close to running out before they actually fail. Because Cloudflare does not expose exact neuron counts to this kind of account token, the estimate is calculated from the number of words processed in each request and response, using Cloudflare's published pricing rates, so the number is an approximation rather than an exact bill. The proxy exposes the same style of endpoints developers expect from OpenAI, for chat, embeddings, and a general passthrough that can reach any Cloudflare AI capability, including image generation, text to speech, speech recognition, and translation. It also ships with a web dashboard, built with React, that shows the status of each account, how many neurons it has used, a live list of available Cloudflare models, and a log of recent requests that can be expanded to see exactly what was sent and received. It is built to be simple to run locally: install dependencies, build the dashboard, copy an example settings file, and start the server with a single command. Accounts can be imported automatically from another local project called 9router, and optional settings let you set an access key, change the listening port, and adjust cooldown timers.

Yoink these prompts

Prompt 1
Walk me through installing and running cf-proxy locally with npm.
Prompt 2
Explain how cf-proxy estimates neuron usage when Cloudflare doesn't expose exact counts.
Prompt 3
Show me how to call a Cloudflare model through cf-proxy using OpenAI's chat completions format.
Prompt 4
List the environment variables I can set to change cf-proxy's port and cooldown behavior.

Frequently asked questions

wtf is cf-proxy?

A proxy server that makes Cloudflare's Workers AI look like the OpenAI API, rotating across multiple accounts to stretch daily free usage limits.

What language is cf-proxy written in?

Mainly JavaScript. The stack also includes Node.js, Express, React.

How hard is cf-proxy to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is cf-proxy for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.