explaingit

nextbasedev/super-proxy

Analysis updated 2026-05-18

8TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A self-hosted gateway that lets your apps talk to OpenAI, Anthropic, and other AI providers through one unified API, with usage limits and a dashboard.

Mindmap

mindmap
  root((Super Proxy))
    What it does
      Unifies AI provider APIs
      Self hosted gateway
      Streams responses
    Tech stack
      TypeScript
      Node.js
      Docker
      SQLite
    Use cases
      Swap providers easily
      Control team usage
      Track cost
    Audience
      Developers
      Self hosters
      Teams using multiple AI APIs

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

Run one self-hosted endpoint that lets your app switch between AI providers without rewriting API calls.

USE CASE 2

Give team members individual gateway tokens with usage limits so no single account can exceed a shared rate limit.

USE CASE 3

Track cost and usage across multiple AI providers from a single dashboard.

USE CASE 4

Put a stable base URL in front of several upstream AI services for existing OpenAI or Anthropic SDKs.

What is it built with?

TypeScriptNode.jsDockerSQLite

How does it compare?

nextbasedev/super-proxyabdulkader-safi/obsidian-image-magick-pluginsacartag7/mcp-sso
Stars888
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires generating session and admin secret keys and configuring provider credentials before first use.

Use, modify, and redistribute freely, including commercially, as long as you keep the required copyright and license notices.

In plain English

Super Proxy is a self-hosted gateway that sits between your applications and different AI providers, like OpenAI, Anthropic, Groq, Gemini, and several others. Instead of writing separate code for each provider's API, you point your app at one endpoint, and Super Proxy translates the request to whichever provider you have configured behind the scenes. The project offers both an OpenAI-compatible interface and an Anthropic-compatible interface, so tools already built for those APIs can often switch to Super Proxy with just a change of base URL and API key. It also includes gateway tokens with per-token usage limits, so an operator running the proxy for a team can control who uses how much, track cost, and check on the health of each connected provider through a built-in dashboard. To run it, you need either Node.js 20 or newer, or Docker with Docker Compose. Setup involves cloning the repository, copying an example environment file, generating two secret keys with openssl, and starting the service either directly with npm or inside a Docker container. Once running, you open the dashboard in a browser, sign in with an admin key, create a user, and issue an API token from there. That token is what your applications use to send requests through the gateway. Super Proxy stores its data in a SQLite database and supports streaming responses, meaning replies can come back gradually instead of all at once, useful for chat-style applications. The project is still pre-1.0, so its configuration and interfaces may still change between updates, and the maintainers point to Git tags and GitHub releases as the source of truth for what has actually been published. It is licensed under Apache 2.0, a permissive license that lets you use, modify, and redistribute the code, including for commercial purposes, as long as you keep the required notices in place.

Copy-paste prompts

Prompt 1
Help me set up Super Proxy locally with Docker Compose and generate the required secret keys.
Prompt 2
Show me how to swap my existing OpenAI SDK calls to point at a self-hosted Super Proxy gateway instead.
Prompt 3
Explain how to create a gateway API token in Super Proxy's dashboard and set a usage limit on it.
Prompt 4
Walk me through configuring Super Proxy to route requests to Groq and Gemini as upstream providers.

Frequently asked questions

What is super-proxy?

A self-hosted gateway that lets your apps talk to OpenAI, Anthropic, and other AI providers through one unified API, with usage limits and a dashboard.

What language is super-proxy written in?

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

What license does super-proxy use?

Use, modify, and redistribute freely, including commercially, as long as you keep the required copyright and license notices.

How hard is super-proxy to set up?

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

Who is super-proxy for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.