langbot-plugin 0.4.6

This package contains the SDK, CLI for building plugins for LangBot, plus the runtime for hosting LangBot plugins

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.