Connect → LibreChat
Use AxForge with LibreChat
LibreChat is a
self-hosted, multi-model chat app. Add AxForge as a custom endpoint in
librechat.yaml.
Get LibreChat
LibreChat is a server you host, not an extension. The usual route is Docker
Compose from the project's repository — follow
their install guide, then
come back here for the endpoint. You need a running LibreChat and access to its
librechat.yaml and .env before the step below.
librechat.yaml
endpoints:
custom:
- name: "AxForge"
apiKey: "${AXFORGE_API_KEY}" # from your .env
baseURL: "https://api.axforge.ai/v1"
models:
default: ["chat"] # initial pick (required)
fetch: true # pull the full list from GET /v1/models
titleConvo: true
titleModel: "chat"
modelDisplayLabel: "AxForge"Put AXFORGE_API_KEY=your-axforge-key in your .env.
Three things to get right. apiKey is
mandatory — it cannot be blank (use "user_provided" to have each user
supply their own). baseURL must include /v1 (LibreChat
appends /chat/completions). Always populate default — if
fetch can't reach /v1/models it falls back to that list.
Check that it worked
Two things, and the second is the one that proves it end to end:
- AxForge is in the endpoint dropdown when you start a conversation.
- Its models load in the model list beside it, and a message gets a streamed reply.
- The call appears in the console at Billing & usage within a minute or two. Nothing else confirms that your key reached our API — a reply alone could be a cache or another provider.
When it does not work
| What you see | What it means | Fix |
|---|---|---|
| AxForge missing from the dropdown | librechat.yaml was not loaded, or the YAML is invalid | LibreChat logs a config error at startup — read the first lines of its log |
| Endpoint appears, models empty | it reached the file but not the API | check baseURL ends /v1 and the key resolved from .env |
401 | the key did not resolve | ${AXFORGE_API_KEY} must exist in the environment LibreChat runs in |
Run the self-test first when you are unsure — it says in one click whether the problem is your key, your quota or us, so you know whether the tool is worth debugging at all.