explaingit

wyverncw/freeproxy

Analysis updated 2026-05-18

2HTMLAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

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
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

What is it built with?

JavaScriptNode.jsVercel

How does it compare?

wyverncw/freeproxyd4l3k/upasstakcastel/css-calculator
Stars222
LanguageHTMLHTMLHTML
Last pushed2016-09-30
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/53/54/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

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.

In plain English

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.

Copy-paste 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

What 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.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub wyverncw on gitmyhub

Verify against the repo before relying on details.