Back to guides
Compare·September 21, 2026·12 min read

LobeChat vs LibreChat — the rename, the acquisition, and which one to self-host

One was renamed, the other was acquired — and the difference that decides it is where each keeps its configuration.

Last reviewed on .

LobeChat and LibreChat are both alive, and both changed identity after most comparisons of them were written: LobeChat is now LobeHub under a source-available licence, and LibreChat is now a ClickHouse project that is still MIT. The short answer: choose LibreChat when several people share one deployment and every endpoint, model list and permission should live in version-controlled configuration; choose LobeHub when one person or a small team wants a polished agent workspace with a desktop app, and will accept a heavier stack and a licence with a derivative-work condition.

Two traps sit on this query. On the LobeHub side it is the rename — search results, forks and tutorials still describe 1.x, and 2.0 deleted the authentication and storage variables those tutorials teach while keeping the provider ones, so a stale walkthrough half works. On the LibreChat side it is the acquisition, which turned a formerly paid add-on into a free self-hosted service, so older write-ups quote a subscription that has been announced for retirement.

What each project actually is today

LobeHub (formerly LobeChat)LibreChat
Repositorylobehub/lobehub — the old lobe-chat path returns 301danny-avila/LibreChat
LicenceLobeHub Community License, based on Apache 2.0 with added conditions; GitHub reports NOASSERTIONMIT, unchanged after the acquisition
OwnerLobeHub LLCClickHouse, since November 4, 2025
Version in package.json2.2.17, branch canaryv0.8.8-rc3; newest stable tag is v0.8.7
Stars / last push82,605 / September 18, 202644,329 / September 18, 2026
Self-descriptionRepository description: an agent operator that hires, schedules and reports on a team of agentsRepository description still reads "Enhanced ChatGPT Clone"; librechat.ai's own title is "The Open-Source AI Platform"

Repository figures read from the LobeHub and LibreChat GitHub APIs on September 19, 2026. Do not read either version from the GitHub Releases tab: LobeHub's releases are nightly pull-request builds and desktop canary prereleases, and LibreChat flags every release as a prerelease so /releases/latest returns nothing. Both projects' package.json is the honest source, and whether v0.8.8 has shipped stable was still unresolved on the day of this check.

The rename is documented rather than inferred: maintainer arvinxx wrote in Discussion #10007 on November 3, 2025 that "our product name will be upgraded from 'LobeChat' to 'LobeHub'". It is also incomplete — the LICENSE is titled LobeHub Community License while its body still calls the product LobeChat. The acquisition is equally on the record: ClickHouse's announcement says founder Danny Avila and his team joined, and that for existing deployments "operations continue unchanged".

Which one to pick, before the feature table

Your constraintPickWhy
Several people share one deploymentLibreChatEvery shareable entity — agents, prompts, MCP servers, files, conversations — carries its own access-control list, on top of per-role feature permissions and custom roles
Config must be reviewable and version controlledLibreChatThe documented way to add an endpoint is a YAML block in librechat.yaml; the docs describe no settings-pane equivalent
You want per-user spend caps inside the clientLibreChatA built-in token-credit balance with a start balance and optional automatic refills
You want a native desktop appLobeHubAn Electron desktop build for Windows, macOS and some Linux distributions; LibreChat's docs state plainly that it is a web application and not a native app
Long agent runs that survive a topic switchLobeHubGateway mode runs agents server-side and resumes sessions after a brief disconnect
One owner holds the keys, everyone else just chatsLobeHubProvider configuration is Owner-only and the AI Provider page is hidden from Members and Viewers
The licence has to be unambiguously permissiveLibreChatMIT; LobeHub's licence requires a commercial licence to distribute a derivative work
You are starting from a modest serverLibreChatGit plus Docker, and the docs say the default .env works out of the box; LobeHub needs Postgres 14+ (17 with pg_search recommended), object storage and, for server-side agent runs, a gateway container

Two of those rows deserve the detail. LibreChat's access-control documentation describes three layers — per-role feature permissions, per-resource access-control lists, and system grants such as manage:users — with the built-in ADMIN and USER roles always present. LobeHub's workspace permissions are three fixed roles, Owner, Member and Viewer, where configuring providers, setting member budgets and viewing the audit log are all Owner-only and a Viewer cannot chat at all. Neither model is strictly richer for every team: LibreChat gives you finer grain and more to get wrong; LobeHub gives you one chokepoint and less to configure.

Migration cost is the other thing to price before you choose. Neither project documents an importer for the other's conversation history, and the stores have nothing in common — LibreChat runs on MongoDB, while LobeHub 2.0 runs only on a server-side PostgreSQL database. Treat a switch as a fresh deployment plus a manual move of prompts and agent definitions.

Agents, tools and knowledge bases

Both have moved well past "a chat window over an API", and both moved in 2026, so a comparison written from 2025 material is describing neither.

CapabilityLobeHubLibreChat
Where an agent runsServer-side in Gateway mode, with sessions that reconnect and resume after a brief disconnectIn the server process; agents can delegate to subagents with recursion and graph limits
Reusable agent capabilityA public Agent Market, plus skills and connectors installed workspace-wideAgent Skills — instructions, references, scripts, assets and permissions packaged into a capability an agent can invoke
Code executionCloud Sandbox powers the built-in code, shell, file and export toolsA self-hosted Apache-2.0 sandbox service you point at with LIBRECHAT_CODE_BASEURL
Admin surfaceWorkspace settings, Owner-only for providers and budgetsA bundled Admin Panel that edits the permission matrix directly, including custom roles
Feature toggles in configEnvironment variablesThe YAML interface block still works but seeds permissions for the default USER role only, and the docs say to prefer the Admin Panel for ongoing management

Dates are worth carrying here. LibreChat's v0.8.6 added Agent Skills and subagents, and v0.8.7 added native Anthropic custom endpoints, bundled the Admin Panel and released the Code Interpreter as open source — the changelog dates that release June 23, 2026 while the GitHub API stamps it June 24, so pick one and say which. LobeHub's public changelog is patchier: the newest file in its changelog directory is dated August 3, 2026, against a repository pushed on September 18, so roughly six weeks of shipped changes are not described in any user-facing changelog.

One boundary that applies to both: each indexes knowledge-base documents as vector entries — LobeHub's pricing page meters them by the entry — and that indexing step needs an embedding model, which Kunavo does not serve. Run it against a local model or an outside provider, whichever client you choose; it is a separate account from the chat key in both setups.

What it costs to run either one

Line itemLobeHubLibreChat
The softwareNo fee; source-available under the Community License$0, MIT
Hosted plan of its ownLobeHub Cloud, four published tiers plus EnterpriseNone — /pricing and /enterprise both return HTTP 404
DatabasePostgreSQL 14 or higher required; 17 or higher with pg_search recommended, via a ParadeDB Postgres 17 imageMongoDB, bundled in the compose file or hosted
Other servicesS3-compatible storage, optional Redis, a gateway container; ports 3210, 9000, 9001, 8787 and 8788 must be freeOptional search and retrieval services; Git and Docker are the stated prerequisites
Code executionCloud Sandbox, which defaults to LobeHub's hosted Market provider unless you switch itSelf-hosted ClickHouse/code-interpreter, Apache 2.0
Model tokensWhatever your provider bills — the only line that scales with use

Sources checked September 19, 2026: LobeHub's self-hosting overview, Docker Compose page and Cloud Sandbox variables; LibreChat's Docker install and Code Interpreter pages. Two operational footnotes worth having before you start: LibreChat's docs warn that the default MongoDB image needs AVX and crashes on Apple Silicon unless you pin mongo:4.4.18 in an override file, and LobeHub's compose page warns that an existing deployment upgraded without the new gateway settings will restart the gateway container in a loop and fall back to running agents in the browser, printing an ACTION REQUIRED warning in the app container's logs.

One thing this page could not settle: what a self-hosted LobeHub's default sandbox provider actually sends off your own machine. The documentation states the default (SANDBOX_PROVIDER=market), that MARKET_BASE_URL points at https://market.lobehub.com unless you change it, that an Onlyboxes-compatible provider can replace it, and how a trusted-client credential pair is configured — but not what content the default sends to that service. If that matters to you, read the setting before you enable the built-in code, shell and file tools.

LobeHub Cloud prices, and the number the page shows twice

LobeHub's plan cards default to the yearly toggle, so a quick look reports $9.9, $19.9 and $39.9. The plan comparison table below them on the same page gives the monthly figures. Both are true — $118.8 ÷ 12 = $9.90 — but only one of them is what you pay to be billed monthly.

PlanBilled monthlyBilled yearlyMonthly creditsStorage
Free$0$0500,00010.0 MB files, 100 vector entries
Starter$12.9$118.8 (= $9.9/month)5,000,0001.0 GB files, 5,000 vector entries
Premium$24.9$238.8 (= $19.9/month)15,000,0002.0 GB files, 10,000 vector entries
Ultimate$49.9$478.8 (= $39.9/month)35,000,0004.0 GB files, 20,000 vector entries
EnterpriseNot published — contact salesBulleted as commercial license, brand theming, user management and "Self-hosted Provider"

Read from lobehub.com/pricing on September 19, 2026. Three qualifications. The Free tier is model-gated rather than merely small: in the comparison table fourteen frontier model rows, GPT-6 Astra among them, read "Not supported" in the Free column, which is why the hero line offering a free trial of GLM-5.3-Flash and GPT-6 Astra sits directly above a Free card that marks GPT-6 Astra unsupported — confirm in the product, not from the headline. The three paid tiers say additional credit packages are available for purchase without stating a size or price anywhere on the page. And the Enterprise bullet "Self-hosted Provider" is never defined on that page, so this page does not say what it includes; it is not a requirement to self-host LobeHub, which the Community License already permits.

Bring-your-own provider keys are not a paid feature: that row carries a checkmark in all four columns including Free, read from the icon markup rather than from a summary. Whether LobeHub Cloud accepts an arbitrary custom base URL, as opposed to your own key for one of its listed providers, is not stated in the documentation and this page does not claim it either way. The self-hosted path is the one the documentation covers.

What a LobeHub credit is worth, by our arithmetic

LobeHub publishes credits per million tokens per model but never a credit-to-dollar rate, and the pricing FAQ that might answer it renders in the browser rather than in the page source. So the conversion below is our arithmetic, not LobeHub's statement. On the five rows we could check against a vendor's standing list rate, their credit figure equals that rate exactly, which implies 1,000,000 credits ≈ US$1.00 of list-price usage. The sixth row, Gemini 3.8 Flash, matches that vendor's current introductory rate rather than its standing list price — the same arithmetic against a temporarily lower number, and a reminder that the pattern tracks whatever a vendor charges this month.

Model (third-party rows, LobeHub's own table)LobeHub credits per 1M in / outVendor published rate per 1M in / outImplied rate
Claude Sonnet 4.63M / 15M$3.00 / $15.001M credits ≈ $1
Claude Opus 55M / 25M$5.00 / $25.001M credits ≈ $1
Claude Haiku 4.51M / 5M$1.00 / $5.001M credits ≈ $1
GPT-5.6 Terra2M / 12M$2.00 / $12.001M credits ≈ $1
GPT-5.6 Luna0.2M / 1.2M$0.20 / $1.201M credits ≈ $1
Gemini 3.8 Flash0.75M / 3.75M$1.50 / $7.50 standing list; $0.75 / $3.75 current introductory rate1M credits ≈ $1 against the introductory rate, ≈ $2 against list

Credit figures from LobeHub's credit table, list prices from each vendor's published rate as recorded in Kunavo's own catalog, both on September 19, 2026. If the inference holds, Premium's 15,000,000 credits are about $15 of list-price model usage for $24.9 billed monthly, and Free's 500,000 credits are about $0.50 a month. Treat that as a reading of a pattern, not a quoted rate — LobeHub could reprice any row without changing anything it has published, and the page states no conversion you could hold it to.

Pointing either client at one API key

This is the sharpest practical difference between them, and it is about doors rather than features. LibreChat's documented door is a file. LobeHub's documented doors are environment variables and a settings pane, and neither is a file you can review in a pull request.

LibreChat's custom endpoint takes both protocols. Leaving provider unset gives you the OpenAI-compatible client; setting provider: 'anthropic' routes the same block through the native Messages client, and the documentation says in so many words to use it "for Anthropic itself or Anthropic-compatible gateways that speak the native Messages API".

librechat.yaml
version: 1.3.16          # librechat.example.yaml, checked 2026-09-19
endpoints:
  custom:
    # OpenAI-compatible route — the default when no provider is set.
    - name: 'Kunavo'
      apiKey: '${KUNAVO_API_KEY}'
      baseURL: 'https://api.kunavo.com/v1'
      models:
        default: ['claude-sonnet-4-6', 'gpt-5-6-terra', 'gemini-3-8-flash']
        fetch: true            # fills the picker from GET /v1/models
      titleConvo: true
      titleModel: 'claude-haiku-4-5'
      modelDisplayLabel: 'Kunavo'

    # Native Messages route — same key, different protocol, no /v1 suffix.
    - name: 'Kunavo (Messages)'
      provider: 'anthropic'
      apiKey: '${KUNAVO_API_KEY}'
      baseURL: 'https://api.kunavo.com'
      headers:
        anthropic-version: '2023-06-01'
      models:
        default: ['claude-sonnet-4-6', 'claude-opus-5']
        fetch: false           # docs: models.fetch is not used here
      modelDisplayLabel: 'Kunavo'

Three limits to know before you rely on it. Dynamic model fetching is not used for native Anthropic endpoints, so that list is hand-maintained. If you set baseURL: 'user_provided' so each person supplies their own URL, LibreChat does not forward your configured header templates to that destination — header-based routing quietly stops working in that mode. And tokenConfig, the per-model rates LibreChat uses for context-usage display, cost breakdowns, balance transactions and multi-endpoint agent billing, is metadata you type yourself; it never learns a gateway's real rates, so both the figures shown and the credits deducted are only as correct as what you entered.

Self-hosted LobeHub keeps the provider environment variables its 1.x documentation taught — the authentication and storage ones are a different story, covered below. The one that bites is the /v1 suffix: LobeHub forwards to the URL you give it, and its own docs warn that a missing or extra suffix shows up as an empty assistant message rather than an error.

.env
# LobeHub, self-hosted. The /v1 suffix belongs in the VALUE — LobeHub
# forwards to the URL you give it instead of rebuilding the OpenAI path.
OPENAI_API_KEY=sk-kn-...
OPENAI_PROXY_URL=https://api.kunavo.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6,+gpt-5-6-terra,+claude-haiku-4-5

# Native Messages route, if you prefer it. Root only, no /v1.
ANTHROPIC_API_KEY=sk-kn-...
ANTHROPIC_PROXY_URL=https://api.kunavo.com

# 2.0 requires these two and no longer reads ACCESS_CODE, Clerk or NextAuth.
AUTH_SECRET=...
JWKS_KEY=...

Variables checked against LobeHub's .env.example and the model-provider page on September 19, 2026. The OPENAI_MODEL_LIST syntax is documented on the model list page: -all hides the built-in catalogue first, +id adds one back, and =Display Name renames it. In the UI the equivalent path is Settings then Language Model, and current source also ships a create-a-provider flow whose SDK type list includes openai, azure, azureai, anthropic, google, cloudflare, ollama and seven more.

One variable set you will be offered by search engines and should not use: CUSTOM_PROVIDER_COUNT, CUSTOM_PROVIDER_N_BASE_URL and CUSTOM_AI_PROVIDERS. They come from a feature request opened in February 2026 that maintainer arvinxx closed on March 20, 2026 with "we don't plan to support this feature in the community edition", and they appear nowhere in .env.example. Also check the age of any LobeHub walkthrough before following it: 2.0's breaking changes removed ACCESS_CODE, Clerk, NextAuth and the client-side database mode, and added AUTH_SECRET and JWKS_KEY as required. Kunavo's own LobeHub setup guide is filed under the former name and was written against the 1.x environment: the three provider variables it teaches are still correct in 2.x, but its surrounding assumptions about authentication are not.

A worked estimate for the model bill

The client is free either way, so the only line that scales is tokens. These figures are illustrative token arithmetic, not measured costs and not a bill ceiling. Assume one person's month of interactive chat: 400 turns, each sending 10,000 input tokens of accumulated context and receiving 600 output tokens4M input and 240K output tokens in total, with no caching. Rates are live Kunavo catalog prices per million tokens.

ModelInput / output per 1MEstimated month
Claude Haiku 4.5$0.40 / $2.00$2.08
Gemini 3.8 Flash$0.525 / $2.625$2.73
GPT-5.6 Terra$0.70 / $4.20$3.81
Claude Sonnet 4.6$1.20 / $6.00$6.24
Claude Opus 5$2.00 / $10.00$10.40

Read it against the shape of a subscription rather than as a winner. Under these assumptions that month costs $2.08 on Claude Haiku 4.5 and $10.40 on Claude Opus 5 — a spread wide enough that which model you pick matters more than which client you run it in. The same month priced in LobeHub Cloud credits at their published rates would be 5.2M credits on Haiku 4.5 and 15.6M on Sonnet 4.6, so this Sonnet month already runs past Premium's 15,000,000-credit allowance and into credit packages whose price is not published. That comparison is arithmetic on two published tables, not a like-for-like quote: a subscription also buys storage, sync and the hosted product, and metered credit buys none of that.

Kunavo's catalog amount is a billing floor rather than a cap: when the upstream reports its charge, the bill is the greater of catalog cost and upstream cost times the applicable markup. Cache charges and external tools sit outside this example. The minimum top-up is $10 in prepaid credit — a funding minimum, not a task fee or a monthly plan. See billing details.

Setting it up, and what to check first

Whichever you choose, the first request is the cheap test. Call GET /v1/models with your key before you debug a container: if it returns a list, the URL and key are fine and an empty picker is the client's model list, not the endpoint. For LobeHub, start at the LobeHub integration guide and read it as a configuration reference rather than a compatibility test — neither client was runtime-tested against Kunavo for this page. For LibreChat there is no Kunavo setup page yet; the YAML above plus LibreChat vs Open WebUI covers the same ground, and the client directory records what is and is not known about its endpoint behaviour. Create a Kunavo account when you are ready to fund a key.

If you are still choosing an interface rather than a provider, AnythingLLM vs Open WebUI compares two more self-hosted options, and the OpenAI-compatible API guide explains what any of these clients is actually sending.

FAQ

Is LobeChat the same as LobeHub?

Yes — LobeChat was renamed LobeHub, and the rename is structural rather than cosmetic. The old repository path github.com/lobehub/lobe-chat returns an HTTP 301 to github.com/lobehub/lobehub, and maintainer arvinxx announced on 2025-11-03 that the product name would be upgraded from LobeChat to LobeHub. The repository description now calls it an agent operator rather than a chat framework. The rename is also incomplete: the LICENSE file is titled LobeHub Community License but its body still says LobeChat throughout. If a tutorial you are following mentions ACCESS_CODE, Clerk, NextAuth or a client-side browser database, it describes 1.x and no longer applies.

Which is better, LobeChat or LibreChat?

Neither is better in general, and they have drifted apart enough that the choice is usually obvious once you name your constraint. LibreChat is MIT, file-driven and built for many people sharing one deployment: per-resource access control lists on agents, prompts, MCP servers and files, custom roles, and a built-in per-user token-credit balance. LobeHub is a source-available agent workspace with a native desktop app, server-side agent runs with resumable sessions, and an owner-only chokepoint on provider configuration — its docs note a workspace can have more than one owner. Pick LibreChat for a shared, auditable, version-controlled deployment; pick LobeHub for a polished workspace for one person or a small team that accepts a licence with a derivative-work condition.

Is LibreChat still free after the ClickHouse acquisition?

Yes, as far as anything published says. ClickHouse announced the acquisition on 2025-11-04, described LibreChat as an open-source AI chat platform, and said that for existing deployments operations continue unchanged with ongoing investment in the open-source project and community. That announcement does not name a licence; the MIT licence is a separate check, and the GitHub API still reports MIT on danny-avila/LibreChat. LibreChat also publishes no pricing page at all — librechat.ai/pricing and /enterprise both return HTTP 404 — so there is no LibreChat plan to buy. What you pay is your own server, database and the model tokens from whichever API you point it at. Third-party companies sell managed LibreChat hosting at their own prices; those are their prices, not LibreChat's.

Does LobeChat cost money to self-host?

There is no fee, but it is not plain open source either. LobeHub self-hosting is governed by the LobeHub Community License, which is based on Apache 2.0 with added conditions: commercial use as a frontend and backend service is permitted without modifying the source, while developing and distributing a derivative work requires a commercial licence from LobeHub LLC. The running cost is the stack: the self-hosting docs require PostgreSQL 14 or higher and recommend 17 or higher with the pg_search extension for full-text search, plus S3-compatible object storage, optionally Redis, and a gateway container alongside the app if you want server-side agent runs. The Enterprise plan lists a Self-hosted Provider bullet, which the pricing page does not define; whatever it covers, it is not permission to self-host LobeHub, because the Community License already grants that.

Can LobeHub and LibreChat use the same API key?

They can, if the endpoint speaks a protocol both clients support. LibreChat takes a custom endpoint as a block in librechat.yaml with apiKey and baseURL, and setting provider: anthropic routes that block through its native Messages client instead of the OpenAI-compatible one. Self-hosted LobeHub takes OPENAI_API_KEY plus OPENAI_PROXY_URL, or ANTHROPIC_API_KEY plus ANTHROPIC_PROXY_URL, and can also be configured in Settings then Language Model. Note the asymmetry in the URL: the OpenAI-compatible value normally ends in /v1 while the Messages value is the API root. Kunavo publishes a setup guide for the LobeHub side; nothing on this page is a runtime compatibility test of either client.

Does LibreChat's code interpreter cost money?

Not in the current documentation. LibreChat's Code Interpreter page says it is powered by ClickHouse/code-interpreter, an open-source Apache-2.0 sandboxed code-execution service you self-host and point LibreChat at with LIBRECHAT_CODE_BASEURL, and it quotes no price and describes no subscription. Older write-ups refer to a paid LibreChat Code Interpreter API; this page found no current, citable source for such a plan or for any retirement schedule, so it quotes no price and makes no claim about one. If you subscribed to something before the ClickHouse acquisition, check your own account rather than trusting a third-party figure.

How do I migrate from one to the other?

There is no conversation-history importer between them, so plan on starting fresh and moving only your prompts and agent definitions by hand. The larger migration cost is in the data stores, which have nothing in common: LibreChat keeps its state in MongoDB, while LobeHub 2.0 runs only on a server-side PostgreSQL database — 14 or higher required, 17 or higher with the pg_search extension recommended — and removed the client-side database mode entirely. Migrating within LobeHub also counts: a 1.x deployment upgrading to 2.x loses ACCESS_CODE, Clerk and NextAuth, and gains two required variables, AUTH_SECRET and JWKS_KEY.

Checked September 19, 2026: both GitHub repository APIs, both package.json files, LobeHub's LICENSE and .env.example, the redirect from the old lobe-chat path, lobehub.com/pricing's own markup, HTTP status of librechat.ai/pricing and /enterprise, and LibreChat's custom-endpoint documentation source; re-checked September 21, 2026 against ClickHouse's acquisition announcement, LobeHub issue #12288 and both projects' self-hosting docs. Statements about LobeHub's self-hosting stack, permissions and sandbox, and about LibreChat's access control, balance system and Code Interpreter, come from each project's current documentation rather than from a deployment run here. Neither client was runtime-tested against Kunavo. Kunavo token rates come from the live catalog, and every dollar example is illustrative token arithmetic.