gitwtfhub

wtf is freeproxy?

wyverncw/freeproxy — explained in plain English

Analysis updated 2026-05-18

2HTMLAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A self-hosted proxy that connects JanitorAI and other AI chat apps to OpenCode's free AI models, with automatic API key failover and no logging.

Mindmap

mindmap
  root((FreeProxy))
    What it does
      Proxies AI chat requests
      OpenAI format compatible
      Forwards to OpenCode
    Features
      Multi-key failover
      Real-time streaming
      Rate limiting
      Zero logging
    Supported models
      mimo-v2.5-free
      deepseek-v4-flash-free
      nemotron-3-ultra-free
      north-mini-code-free
    Setup
      Deploy to Vercel
      Add API key env vars
      Configure JanitorAI

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

Connect JanitorAI to OpenCode's free AI models by hosting your own proxy on Vercel.

REASON 2

Use multiple OpenCode API keys with automatic failover to avoid rate-limit interruptions during chat sessions.

REASON 3

Access OpenCode free AI models from any app that supports the OpenAI-compatible API format.

What's in the stack?

JavaScriptNode.jsVercel

How it stacks up

wyverncw/freeproxyd4l3k/upassfranklinandina141-design/intuitive-tarot-production
Stars222
LanguageHTMLHTMLHTML
Last pushed2016-09-30
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/53/52/5
Audiencegeneraldevelopervibe coder

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a free Vercel account and at least one OpenCode API key from opencode.ai.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

FreeProxy (called OpenCode Proxy in the README) is a small server you host yourself that acts as a bridge between AI chat apps like JanitorAI and the OpenCode AI service. JanitorAI is a roleplay chat app that lets users bring their own AI backend, and this proxy makes it possible to use OpenCode's free AI models with that app without paying for a commercial API tier. The proxy works by accepting requests in the standard OpenAI-compatible format, the same format used by ChatGPT's API. When JanitorAI or another client sends a chat message to the proxy, the proxy forwards it to OpenCode and returns the response. This means any chat app that supports the OpenAI API format can use this proxy to access the free OpenCode models. One practical feature is multi-key failover. You can provide up to three OpenCode API keys, and if one hits a rate limit, the proxy automatically switches to the next one. Responses stream in real time using a technique called Server-Sent Events, so text appears progressively rather than arriving all at once after a delay. The proxy includes several security measures by default. It limits each IP address to 100 requests per minute, validates the size and structure of incoming requests, and sets standard security headers on all responses. It stores no logs of any kind, so neither request content nor user metadata is retained anywhere. Deployment is designed around Vercel, a hosting platform where you can run small servers for free. You clone the repo, install dependencies, and run a single deploy command. Then you add your OpenCode API keys as environment variables in the Vercel dashboard and point JanitorAI's settings at your proxy URL. Four free AI models are supported: mimo-v2.5-free, deepseek-v4-flash-free, nemotron-3-ultra-free, and north-mini-code-free. The project is MIT-licensed.

Yoink these prompts

Prompt 1
Deploy FreeProxy to Vercel and configure JanitorAI to use mimo-v2.5-free through my custom proxy URL.
Prompt 2
Set up three OpenCode API keys as Vercel environment variables in FreeProxy so I have automatic failover between them.
Prompt 3
Walk me through pointing JanitorAI's custom proxy settings to my deployed FreeProxy instance step by step.
Prompt 4
I want to use deepseek-v4-flash-free through FreeProxy. What model name do I enter in JanitorAI and what proxy URL format do I use?
Prompt 5
How do I run FreeProxy locally with vercel dev to test it before deploying to production?

Frequently asked questions

wtf is freeproxy?

A self-hosted proxy that connects JanitorAI and other AI chat apps to OpenCode's free AI models, with automatic API key failover and no logging.

What language is freeproxy written in?

Mainly HTML. The stack also includes JavaScript, Node.js, Vercel.

What license does freeproxy use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is freeproxy to set up?

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

Who is freeproxy for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

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