Files
RockChinQandClaude Opus 5.5 608709f6aa docs: recommend the one-line lbctl installer (READMEs + docs) instead of uvx (#3070)
* docs: recommend the one-line lbctl installer instead of uvx

Every README now leads self-hosting with the one-line installer
(install.sh / install.ps1), which installs lbctl and deploys LangBot
natively or with Docker. The uvx one-liner is removed from the READMEs and
kept only as a development path in dev-docs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: make the one-line lbctl installer the recommended deployment

- Add a "One-Line Install (Recommended)" page in zh/en/ja and list it first
  under LangBot deployment.
- Turn the uvx package-manager page into a development-only path with a
  warning pointing to the installer.
- Lead the update guide with `lbctl upgrade`; point the getting-started
  guide and feature list to the installer; replace uvx quick starts in
  articles.
- Mention `lbctl install --extra seekdb` next to the SeekDB notes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(recipes): point the self-host prerequisite to the one-line installer

Regenerated all 420 recipe pages from scripts/generate-recipes.mjs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(tests): count the 3 new one-line install pages in static build checks

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 19:38:58 +08:00
..

---
title: "Models"
description: "Configure LLM providers in LangBot: OpenAI GPT, Anthropic Claude, Google Gemini, DeepSeek, Qwen, Ollama and OpenAI-compatible models."
---

## LangBot Models

LangBot Models is an official model service provided by LangBot. When you initialize a local instance with your LangBot Space account, available models will be automatically added to your instance without any configuration. You will receive a certain amount of free quota to get started quickly.

<img src="/images/zh/deploy/models/langbot_models.png" alt="langbot_models" />

For specific available models, please check [LangBot Space](https://space.langbot.app/models).

## Custom Models

You can also add models from other sources.

### LLM Model

Models will be used by pipelines to process messages. The first model you configure will be set as the model for the default pipeline.

![arch](/images/zh/deploy/models/arch.png)

You can add multiple models, and then select which model to use in the pipeline.

<img width="400px" src="/images/zh/deploy/models/model_config.png" alt="model_config" />

Enter these four parameters: `Model Name`, `Model Provider`, `Request URL`, and `API Key`, then submit.

For model capabilities, enable the ones the underlying model actually supports:

- **Vision**: enable to recognize images
- **Tool Use** (function calling / tool use): enable so the LLM can call tools during a conversation

<Note>
**Tool Use must be enabled on the model whenever you want to use tools from MCP servers, sandbox built-ins (`exec`/`read`/`write`/`edit`/`glob`/`grep`), or Skills.** Without it, even if the pipeline binds those extensions, the Agent won't call any tools.

The underlying model has to actually support function calling for this checkbox to take effect — check the model provider's docs if unsure.
</Note>

### Embedding Model

Embedding models are used to compute vector representations of messages. If you need to use knowledge bases, please configure this model.

<img width="400px" src="/images/zh/deploy/models/embedding_model.png" alt="embedding_model" />

Enter these four parameters: `Model Name`, `Model Provider`, `Request URL`, and `API Key`, then submit. After that, please configure the knowledge base to use this model.

### Using the seekdb Built-in Embedding Model (Optional Dependency Required)
The model needs no request parameters. Use `lbctl install --extra seekdb` for the one-line (lbctl native) install, `uv sync --extra seekdb` for source deployments or `uvx --from 'langbot[seekdb]@latest' langbot` for package deployments. Docker/Kubernetes deployments need the official image with the `-seekdb` suffix (for example `rockchin/langbot:latest-seekdb`); the default image does not include SeekDB. Native deployment support depends on the available `pylibseekdb` wheel.
- On the "Embedding Model" page, select "seekdb-built-in";
- Click "Save" to use it immediately;
- Then select this model in your knowledge base to take effect.

### Using Chroma Built-in Embedding Model (Zero Configuration)
The system has integrated Chroma's built-in embedding model (all-MiniLM-L6-v2), no parameters required.
- On the "Embedding Model" page, select "chroma-built-in";
- Click "Save" to use it immediately;
- Then select this model in your knowledge base to take effect.

### Rerank Model

Rerank models re-score RAG retrieval results to significantly improve the precision of knowledge base answers. When a knowledge base returns multiple candidate documents, the rerank model uses a cross-encoder to precisely score each document's relevance to the query, selecting only the most relevant content.

Enter `Model Name` and select `Model Provider`, then submit. After that, select this model in your pipeline's "AI" configuration.

<Tip>
Rerank models are optional. Without one, knowledge base results are used in their original retrieval order. With a rerank model configured, results are re-scored and only the top-K most relevant results are kept.
</Tip>