core-runtime
Start, configure, deploy, inspect, and troubleshoot LangBot core runtime boot, Application wiring, config.yaml, health checks, Docker or standalone Plugin Runtime and Box modes.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- core-runtime
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Start, configure, deploy, inspect, and troubleshoot LangBot core runtime boot, Application wiring, config.yaml, health checks, Docker or standalone Plugin Runtime and Box modes.
- disable-model-invocation
- true
02 资源文件 3
- 参考文档references/deployment-and-operations.md2.7 KB
- 参考文档references/startup-and-configuration.md3.1 KB
- 参考文档references/troubleshooting.md1.7 KB
03 SKILL.md 正文
Core Runtime
Use this sub-skill when the task is about getting LangBot running, reasoning about the boot graph, changing runtime configuration, deployment topology, startup flags, health/resource reporting, or operational probes.
Read First
- references/startup-and-configuration.md
for entry points,
config.yaml, boot stages, and local startup commands. - references/deployment-and-operations.md for Docker/Compose/Kubernetes, Plugin Runtime, Box Runtime, and resource probes.
- references/troubleshooting.md for startup, config, port, dependency, and runtime-service failures.
Core Facts
main.pydelegates tolangbot.__main__.main().- The
langbotconsole script accepts--standalone-runtime,--standalone-box,--debug, and an operatormigrate --cloudsubcommand. - First startup generates missing data/config files and initializes the database before serving HTTP.
BuildAppStagewires the long-livedApplicationobject: managers, services, runtime connectors, controllers, storage, telemetry, and task management.- The HTTP controller serves Quart/Hypercorn on
api.portand mounts MCP at/mcpafter route registration. - Default local data lives under the current working directory's
data/when running the package or source command.
Typical Workflows
Local source startup
uv sync --dev
uv run main.py
If you intentionally installed a local sibling SDK checkout, preserve it with:
uv run --no-sync main.py
Use --standalone-runtime when an external Plugin Runtime is already running,
and --standalone-box when an external Box Runtime is already running.
Package startup
uvx langbot
# or
pip install langbot
langbot --help
langbot
Health check
curl http://127.0.0.1:5300/healthz
Expect code: 0 plus resource counters. If the route is unavailable, diagnose
boot, port binding, config generation, and dependency installation before
looking at higher-level pipeline behavior.
Boundaries
- HTTP route auth and MCP tool design belong to
api-mcp-web. - Platform message flow, adapters, pipelines, providers, and tools belong to
platform-pipeline-provider. - Plugin Runtime and Box API details belong to
plugin-box-skills. - Database migrations, RAG, vector backends, storage, and tenancy belong to
persistence-rag-workspaces. - Verification selection belongs to
testing-qa.
Validation
Use startup-focused checks before broad suites:
python scripts/langbot_repo_doctor.py --repo-root /path/to/LangBot
uv run --python 3.12 pytest tests/e2e -q --tb=short
Only run long resource probes or cloud soak gates when the task is specifically about runtime retention, capacity, or production stability.
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.