Plug FreeTheAi into your favorite client.
One key, one base URL, every model. Pick your client below and
follow the exact steps. All guides use https://api.freetheai.xyz/v1.
Start from what you are trying to connect.
These pages group the setup guides by client type, so you can jump straight to the right base URL, route, and model setup.
6 guides
VSCode and JetBrains extensions, native editors, and pair-programming agents that talk to FreeTheAi over the OpenAI-compatible API.
OpenCode
Pair-programming agent with a config-driven provider list.
OpenCode reads its providers from a JSON config file. Add FreeTheAi as a custom provider with the OpenAI-compatible adapter and you can pick any FreeTheAi alias as the active model.
Kilo Code
VSCode coding agent with one-click custom providers.
Kilo Code is a VSCode extension that lets you connect a custom OpenAI-compatible provider directly in its sidebar. FreeTheAi works without leaving the editor.
Zed IDE
Native editor with first-class agent support.
Zed has a built-in agent panel. Add FreeTheAi as a custom OpenAI-compatible provider and Zed handles the rest.
Cline
VSCode autonomous coding agent.
Cline runs a full agent loop inside VSCode. Add FreeTheAi as an OpenAI Compatible provider and it can read, edit, and run code with any FreeTheAi alias.
Roo Code
Multi-agent VSCode dev team forked from Cline.
Roo Code splits the agent into a planning/code/QA team. Add FreeTheAi as the OpenAI Compatible provider and Roo's roles share the same base URL.
Continue.dev
Open-source assistant for VSCode and JetBrains.
Continue uses a yaml config you can version-control. Drop a FreeTheAi model entry and Continue hot-reloads it.
4 guides
Roleplay and chat frontends that point to FreeTheAi as a reverse proxy.
SillyTavern
Power-user roleplay frontend with deep prompt control.
SillyTavern uses its own Connection Profile system. Switch the API to Chat Completion with `Custom (OpenAI-compatible)` and SillyTavern will handle streaming and presets.
Janitor AI
Roleplay site that connects through a reverse proxy.
Janitor AI uses a proxy slot for any OpenAI-compatible endpoint. Drop FreeTheAi in as a proxy and pick the model you want.
Chub AI
Open roleplay platform with Secrets-based proxy slots.
Chub AI lets you reverse-proxy any OpenAI-compatible endpoint through its `Secrets` panel. Pair it with the OpenAI / Proxy preset and pick a FreeTheAi model.
RisuAI
Local-first roleplay client with deep prompt control.
RisuAI keeps your character data local and lets you point at any OpenAI-compatible chat completions URL. Use the full FreeTheAi /chat/completions URL and any alias.
10 guides
General-purpose chat clients and self-hosted ChatGPT-style web UIs.
LibreChat
Self-hosted multi-model chat UI.
LibreChat exposes any OpenAI-compatible host through `endpoints.custom`. Add a FreeTheAi block, set the env var, and the model picker auto-fills from /v1/models.
Open WebUI
Self-hosted ChatGPT-style UI with native OpenAI connections.
Open WebUI lets admins add multiple OpenAI-compatible connections. Add FreeTheAi and the model picker auto-fills from /v1/models.
LobeChat
Modern open-source web chat UI.
LobeChat supports any OpenAI-compatible host through env vars or its `Add Custom Provider` UI. Pair it with FreeTheAi for a slick local web client.
AnythingLLM
Self-hosted RAG and chat workspace.
AnythingLLM treats FreeTheAi as a `Generic OpenAI` provider. Type the alias, set the context window, save.
Cherry Studio
Cross-platform desktop chat client.
Cherry Studio supports many providers through one UI. Add FreeTheAi as an OpenAI provider and load the aliases you want as separate models.
TypingMind
Polished BYOK web frontend.
TypingMind lets you paste any OpenAI-compatible endpoint as a custom model. Add FreeTheAi and use any alias.
BoltAI
Native macOS AI assistant in any app.
BoltAI floats AI in any macOS app. Add FreeTheAi as a custom OpenAI-compatible server.
Page Assist
Browser extension for AI while you browse.
Page Assist runs in the browser side panel. Add FreeTheAi as a custom OpenAI-compatible API and pick the alias you want.
Chatbox
Cross-platform desktop and mobile chat client.
Chatbox supports any OpenAI-compatible base. Use the OpenAI API Compatible mode and split the URL into Host and Path.
Big-AGI
Open-source web AI workbench for power users.
Big-AGI's OpenAI vendor accepts a custom API endpoint. Drop FreeTheAi in and Big-AGI auto-fetches /v1/models.
2 guides
Command-line tools and scripts that use the OpenAI SDK or curl directly.
Aider
AI pair-programming CLI driven by LiteLLM.
Aider is LiteLLM-backed, so any OpenAI-compatible base URL works. Set two env vars and pass `openai/<freetheai-alias>` as the model.
Claude Code
Anthropic's terminal coding agent via Messages route.
Claude Code talks to FreeTheAi through the Anthropic Messages format. Set the gateway env vars, run `claude`, and pick a Claude alias.
Most OpenAI-compatible clients work out of the box.
FreeTheAi follows the OpenAI Chat Completions, Anthropic Messages,
and OpenAI Responses formats. Anything that lets you set a custom
base URL and API key works. Use https://api.freetheai.xyz/v1 as the base URL and pick
any alias from the model catalog.