gitwtfhub

wtf is jc-proxy?

iniyavanjambulingam/jc-proxy — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A lightweight gateway that lets AI apps talk to multiple providers like Groq and Gemini through one address, with automatic failover.

Mindmap

mindmap
  root((jc-proxy))
    What it does
      Routes AI requests
      Automatic failover
      Admin dashboard
    Tech stack
      TypeScript
      Node.js
      Docker
      SearXNG
    Use cases
      Free tier rate limit workaround
      Claude Code integration
      Multi-provider routing
    Audience
      Students
      AI hobbyists
      Solo 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

Automatically switch between free AI provider tiers when one hits a rate limit.

REASON 2

Connect Claude Code or n8n AI Agents to multiple AI providers through a single endpoint.

REASON 3

Run a self-hosted API gateway without needing complex enterprise infrastructure.

REASON 4

Manage provider API keys and view routing logs through a built-in admin dashboard.

What's in the stack?

TypeScriptNode.jsDockerSearXNG

How it stacks up

iniyavanjambulingam/jc-proxy0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires API keys for at least one provider and editing config.yaml before first use.

MIT license: use, copy, modify, and distribute freely, including for commercial purposes, as long as you keep the copyright notice.

Wtf does this do

This project is a small server that sits between your AI applications and various AI companies, letting you use one consistent connection point no matter which AI provider is actually answering behind the scenes. It understands the same request formats used by OpenAI and Anthropic, so tools built for either of those can talk to it without changes. The author built this after running into rate limits on free tiers of services like Google, OpenRouter, and Groq while experimenting with AI agent tools such as n8n and Hermes. Paid services work fine but cost money, which is a real barrier for students and hobbyists. Existing proxy tools were either built for large companies or too complicated to run alone. This project's main feature is automatic failover: when one free provider hits its rate limit or fails, the gateway automatically switches to a backup provider so an AI agent workflow does not break. It supports several providers including Groq, Gemini, OpenRouter, Cloudflare Workers AI, and anything else that speaks the OpenAI format, such as locally run Ollama or vLLM setups. It also includes a web based admin dashboard for managing provider settings, checking status, and reviewing routing logs, along with support for streaming responses and tool calling, which lets an AI model trigger actions during a conversation. It can be run directly with Node.js or through Docker, and the Docker setup includes an optional local web search tool called SearXNG. The project is specifically designed to work well with Claude Code and n8n AI Agents, but is also compatible with other agent frameworks like LangChain and LlamaIndex. The readme includes a clear warning that since this proxy holds your private API keys, it should never be exposed directly to the public internet without proper authentication in front of it. It is released under the MIT license.

Yoink these prompts

Prompt 1
Help me set up jc-proxy with Docker and configure Gemini and Groq as fallback providers.
Prompt 2
Explain how to point Claude Code at this proxy's Anthropic-compatible endpoint.
Prompt 3
Walk me through configuring automatic failover priorities in config.yaml.
Prompt 4
Show me how to secure the admin dashboard and API keys before exposing this proxy.

Frequently asked questions

wtf is jc-proxy?

A lightweight gateway that lets AI apps talk to multiple providers like Groq and Gemini through one address, with automatic failover.

What language is jc-proxy written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Docker.

What license does jc-proxy use?

MIT license: use, copy, modify, and distribute freely, including for commercial purposes, as long as you keep the copyright notice.

How hard is jc-proxy to set up?

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

Who is jc-proxy for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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