Skip to main content
skill CX Codex

freellmapi-proxy — Claude Code skill: one proxy for free LLMs

This skill sets up a self-hosted Anthropic-compatible proxy that puts free-tier keys from many providers behind one endpoint.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a claude-code
Open on GitHub

What freellmapi-proxy does

FreeLLMAPI gathers keys from roughly fourteen providers — Google, Groq, Cerebras, SambaNova, NVIDIA, Mistral, OpenRouter, GitHub Models, Hugging Face, Cohere, Cloudflare, Zhipu, Moonshot, MiniMax — behind a single /v1/chat/completions. Send model: "auto" and the router picks whichever provider is available; on 429 or 5xx it moves down the fallback chain. Provider keys sit in SQLite encrypted, and multi-turn conversations can stick to one provider.

Setup is a plain Node project: git clone, npm install, then an ENCRYPTION_KEY in .env. That key is a 64-character hex string and it protects every stored provider key, so the store is useless without it. npm run dev starts the server plus a Vite dashboard; the production build serves the API and panel on port 3001.

You add keys on the Keys page, reorder providers under Fallback Chain, and copy the unified freellmapi-… bearer token from the same page. Any OpenAI SDK client works — point base_url at http://localhost:3001/v1. Tool calling runs across all providers, and Gemini requests get translated to functionDeclarations and back on the fly.

What it helps with

  • put free-tier keys from several providers behind one endpoint
  • survive a 429 by failing over to the next provider
  • keep a multi-turn conversation pinned to one provider
  • store provider keys encrypted instead of plain in .env
  • call a named model such as gemini-2.5-flash through the shared router

Example prompts for the agent

  • Set up FreeLLMAPI and add my Groq and Cerebras keys from the dashboard
  • Reorder the fallback chain so Gemini comes first and OpenRouter last
  • Send a request through the proxy with model: "auto" and tell me which provider answered

How to install freellmapi-proxy

1Skills CLI (Vercel)

npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a claude-code

2Manually: put the files in place

~/.claude/skills/freellmapi-proxy/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/freellmapi-proxy/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about freellmapi-proxy

How do I install freellmapi-proxy in Claude Code?

Run npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a claude-code. The skill lands at ~/.claude/skills/freellmapi-proxy/SKILL.md.

What does freellmapi-proxy do?

It stands up an OpenAI-compatible proxy that combines free-tier keys from about fourteen providers and switches between them when one fails.

What do I need before running the proxy?

Node.js 20+ and npm. The .env file must carry an ENCRYPTION_KEY, which encrypts provider keys before they reach SQLite.

Similar skills

All skills for AI and ML →

From the same set139

kami-document-design A skill that locks generated resumes, slides, letters and white papers into one editorial look. Useful when you want a clean PDF without hand-building the layout. CX Codex +1 387installs permiso-accessibility-permissions A skill for coding agents that shows how to add a guided macOS accessibility permission panel to a Swift app. CX Codex +1 386installs text-to-cad-harness This skill has your coding agent write build123d Python parts from a description, export them as STEP, STL or URDF, and open the geometry in a local viewer. CX Codex +1 380installs gpt2api-openai-gateway This skill walks your agent through deploying a self-hosted Anthropic-compatible gateway over chatgpt.com and wiring up an account pool. CX Codex +1 378installs openai-privacy-filter A skill that wires a token-classification model into your project to find and blank out personal data. Useful before shipping logs or documents to an LLM. CX Codex +1 369installs masterhttprelayvpn-proxy A skill that walks your agent through running a local HTTP/SOCKS5 proxy, with traffic tunnelled through Google Apps Script and dressed up as Google requests. CX Codex +1 365installs ppt-image-first-workflow Takes a vague deck request through style previews and a locked plan to a PPTX where every slide is one full-page image made with GPT Image 2. CX Codex +1 325installs flowdriver-covert-transport Routes SOCKS5 traffic through Google Drive API calls so it survives DPI and SNI filtering. Useful on networks where a normal proxy gets blocked. CX Codex +1 310installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor