Set up your app
Step-by-step guides for using FreeTheAI models in roleplay sites, chat apps, and coding tools. Every guide was checked against the app itself.
What every app needs
Paste these into any app that takes an OpenAI-compatible connection.
- Base URL
- https://api.freetheai.org/v1
- Full chat URL
- https://api.freetheai.org/v1/chat/completions
- Anthropic base URL
- https://api.freetheai.org
- Model
- glm-5.3Any ID from the models page.
Check it works
One request with your key. A reply means your app will work with the same values.
curl https://api.freetheai.org/v1/chat/completions \
-H "Authorization: Bearer $FTAI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "glm-5.3",
"messages": [{ "role": "user", "content": "Hello!" }]
}'Roleplay
Character chat sites and apps that take an OpenAI-compatible proxy.
5 guides
- JanitorAIJanitorAI connects to FreeTheAI through its Proxy settings. You paste the full chat completions URL, your key, and a model ID, then refresh the page.5 stepsOpen guide
- SillyTavernSillyTavern talks to FreeTheAI through its Chat Completion API with the Custom (OpenAI-compatible) source. It lists every model your key can use.5 stepsOpen guide
- Chub AIChub AI uses FreeTheAI as an OpenAI reverse proxy. You enter the base URL and key in Secrets, check the proxy, then choose the model in Configuration.4 stepsOpen guide
- RisuAIRisuAI connects through its Custom API model (OpenAI Compatible format). On the web version, turn on Force Plain Fetch so requests go straight to FreeTheAI.4 stepsOpen guide
- TavoTavo adds FreeTheAI as a Custom (OpenAI Protocol) API connection. Use the base URL ending in /v1 and a model ID from the models page.4 stepsOpen guide
Using another app?
Any app that takes an OpenAI-compatible base URL works with the values above.
Ask for a guide on Discord
Chat apps
Chat apps for desktop, mobile, and the browser.
9 guides
- Open WebUIOpen WebUI connects to FreeTheAI as an OpenAI API connection and lists every model your key can use.3 stepsOpen guide
- LibreChatLibreChat adds FreeTheAI as a custom endpoint in librechat.yaml. With fetch on, it lists every model your key can use.3 stepsOpen guide
- LobeHub (LobeChat)LobeHub (formerly LobeChat) adds FreeTheAI as a custom provider with the OpenAI request format.3 stepsOpen guide
- ChatboxChatbox adds FreeTheAI as a custom provider in OpenAI API Compatible mode. It works on desktop, mobile, and the web app.3 stepsOpen guide
- Cherry StudioCherry Studio adds FreeTheAI as an OpenAI-type model service. Enter the root address; Cherry adds /v1 itself.3 stepsOpen guide
- NextChatNextChat uses FreeTheAI through its custom OpenAI endpoint. Add the model IDs to Custom Models so they appear in the picker.3 stepsOpen guide
- TypingMindTypingMind adds each FreeTheAI model as a custom model with the full chat completions endpoint and your key in an Authorization header.4 stepsOpen guide
- AnythingLLMAnythingLLM uses FreeTheAI through its Generic OpenAI provider.3 stepsOpen guide
- Page AssistPage Assist adds FreeTheAI as an OpenAI compatible provider, so you can chat with web pages using FreeTheAI models.3 stepsOpen guide
Using another app?
Any app that takes an OpenAI-compatible base URL works with the values above.
Ask for a guide on Discord
Coding tools
Coding agents and editors.
10 guides
- Claude CodeClaude Code can run on FreeTheAI's Anthropic-compatible Messages endpoint. Point ANTHROPIC_BASE_URL at FreeTheAI and choose which model fills each Claude slot.3 stepsOpen guide
- Codex CLICodex CLI talks to FreeTheAI through the OpenAI Responses API. Add FreeTheAI as a model provider in config.toml and keep the key in an environment variable.3 stepsOpen guide
- OpenCodeOpenCode adds FreeTheAI as a custom provider: the key goes in with /connect, the provider and models go in opencode.json.3 stepsOpen guide
- Kilo CodeKilo Code adds FreeTheAI as a custom provider with the OpenAI Compatible API and fetches the model list automatically.3 stepsOpen guide
- ClineCline connects to FreeTheAI with its OpenAI Compatible API provider.3 stepsOpen guide
- ContinueContinue adds FreeTheAI models in config.yaml with the openai provider and FreeTheAI as apiBase.2 stepsOpen guide
- AiderAider uses FreeTheAI through its OpenAI compatible setting: two environment variables and the openai/ model prefix.3 stepsOpen guide
- ZedZed adds FreeTheAI as an OpenAI compatible LLM provider for the agent panel.3 stepsOpen guide
- VS Code Copilot ChatVS Code chat adds FreeTheAI through its Custom Endpoint provider (bring your own key). It works even without a Copilot plan.4 stepsOpen guide
- Hermes AgentHermes Agent uses FreeTheAI as a custom endpoint, set up with hermes model or in config.yaml.3 stepsOpen guide
Using another app?
Any app that takes an OpenAI-compatible base URL works with the values above.
Ask for a guide on Discord
