Files
LangBot/dev-docs/PYPI_INSTALLATION.md
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

3.9 KiB

LangBot PyPI Package Installation

End users: use the one-line installer instead — curl -fsSL https://langbot.app/install.sh | bash (macOS/Linux) or irm https://langbot.app/install.ps1 | iex (Windows). It installs lbctl, deploys LangBot and keeps it upgradable. The uvx / pip paths below are kept for development and quick experiments.

Quick Start with uvx

For a throwaway local run without lbctl (development / quick testing only):

uvx langbot

This will automatically download and run the latest version of LangBot.

SeekDB support is optional and is not installed by the command above. If you want to use the SeekDB vector database or the built-in SeekDB embedding model, run LangBot with the seekdb extra:

uvx --from 'langbot[seekdb]@latest' langbot

The extra includes native dependencies whose supported operating systems may be narrower than LangBot's. In particular, the current Apple Silicon wheels require macOS 15 or later. The default Chroma backend does not have this requirement.

Install with pip/uv

You can also install LangBot as a regular Python package:

# Using pip
pip install langbot

# Using uv
uv pip install langbot

# Include optional SeekDB support
pip install 'langbot[seekdb]'
# or: uv pip install 'langbot[seekdb]'

Then run it:

langbot

Or using Python module syntax:

python -m langbot

Installation with Frontend

When published to PyPI, the LangBot package includes the pre-built frontend files. You don't need to build the frontend separately.

Data Directory

When running LangBot as a package, it will create a data/ directory in your current working directory to store configuration, logs, and other runtime data. You can run LangBot from any directory, and it will set up its data directory there.

Command Line Options

LangBot supports the following command line options:

  • --standalone-runtime: Use standalone plugin runtime
  • --debug: Enable debug mode

Example:

langbot --debug

Comparison with Other Installation Methods

PyPI Package (uvx/pip)

  • Pros: Easy to install and update, no need to clone repository or build frontend
  • Cons: Less flexible for development/customization

Docker

  • Pros: Isolated environment, easy deployment
  • Cons: Requires Docker

Manual Source Installation

  • Pros: Full control, easy to customize and develop
  • Cons: Requires building frontend, managing dependencies manually

Development

If you want to contribute or customize LangBot, you should still use the manual installation method by cloning the repository:

git clone https://github.com/langbot-app/LangBot
cd LangBot
uv sync
cd web
npm install
npm run build
cd ..
uv run main.py

Updating

To update to the latest version:

# With pip
pip install --upgrade langbot

# With uv
uv pip install --upgrade langbot

# With uvx (automatically uses latest)
uvx langbot

System Requirements

  • Python 3.11 or higher (lower than Python 4)
  • Operating System: Linux, macOS, or Windows

Differences from Source Installation

When running LangBot from the PyPI package (via uvx or pip), there are a few behavioral differences compared to running from source:

  1. Version Check: The package version does not prompt for user input when the Python version is incompatible. It simply prints an error message and exits. This makes it compatible with non-interactive environments like containers and CI/CD.

  2. Working Directory: The package version does not require being run from the LangBot project root. You can run langbot from any directory, and it will create a data/ directory in your current working directory.

  3. Frontend Files: The frontend is pre-built and included in the package, so you don't need to run npm build separately.

These differences are intentional to make the package more user-friendly and suitable for various deployment scenarios.