* 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>
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) orirm https://langbot.app/install.ps1 | iex(Windows). It installs lbctl, deploys LangBot and keeps it upgradable. Theuvx/pippaths 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:
-
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.
-
Working Directory: The package version does not require being run from the LangBot project root. You can run
langbotfrom any directory, and it will create adata/directory in your current working directory. -
Frontend Files: The frontend is pre-built and included in the package, so you don't need to run
npm buildseparately.
These differences are intentional to make the package more user-friendly and suitable for various deployment scenarios.