LangBot Plugin Infra

Plugin SDK, CLI, Plugin Runtime and Box sandbox runtime for LangBot.

English / 简体中文

Documentation · Plugin Market · LangBot

Overview

This repository is the shared infrastructure powering LangBot's plugin and sandbox subsystems. It is published to PyPI as the single langbot-plugin package and ships three things:

• Plugin SDK & CLI (lbp) — Python APIs, base classes and the lbp command for scaffolding, building, debugging and publishing plugins.
• Plugin Runtime (lbp rt) — the host process that discovers, installs and runs plugins, bridging them to LangBot over stdio or WebSocket.
• Box Runtime (lbp box) — the code-sandbox service backing LangBot's Box subsystem, executing untrusted code via Docker / nsjail / E2B backends.

LangBot depends on this package as the pinned langbot-plugin==<x.y.z> in its pyproject.toml; the canonical version lives in this repo's pyproject.toml.

The Runtime component (src/langbot_plugin/runtime/) is licensed separately under AGPL; everything else in this repository is Apache 2.0. See src/langbot_plugin/runtime/README.md.

Install

pip install langbot-plugin
# or, recommended
uv tool install langbot-plugin

lbp --help

CLI at a glance

Command	Purpose
lbp init <name>	Scaffold a new plugin project
lbp comp <Type>	Generate a component (Command / Tool / EventListener / KnowledgeEngine / Parser / Page)
lbp run	Run / remote-debug a plugin against a running LangBot
lbp build	Package the plugin into a distributable zip
lbp publish	Publish to the LangBot Plugin Market
lbp login / lbp logout	Authenticate with your LangBot account
lbp rt	Launch a standalone Plugin Runtime (control 5400, debug 5401)
lbp box	Launch a standalone Box sandbox runtime (default port 5410)
lbp ver	Print the CLI / package version

Component types

Plugins extend LangBot through six component types, scaffolded with lbp comp <Type>:

• Command — user-triggered actions (e.g. !weather tokyo)
• Tool — LLM-callable functions for AI agents
• EventListener — handlers for message-pipeline events
• KnowledgeEngine — custom knowledge-base retrieval for RAG
• Parser — custom message / content parsing
• Page — custom web page embedded in the LangBot admin panel

Documentation

• Plugin development tutorial — https://docs.langbot.app/zh/plugin/dev/tutor
• Debugging the Runtime / CLI / SDK — https://docs.langbot.app/zh/develop/plugin-runtime
• Dev environment setup — https://docs.langbot.app/zh/develop/dev-config

License

Apache 2.0, except the Plugin Runtime (src/langbot_plugin/runtime/) which is AGPL. See LICENSE and the Runtime README.