Skip to content
python

Async API core —Python KBVE

A toolbox installed in pieces: an async HTTP, WebSocket and gRPC server stack behind the server extra, on a pydantic + PyYAML core with a whole-site SEO auditor, MDX and SVG helpers, Blender bake tooling, and ArgoCD and Unreal command-line scripts.

Small by default

The base install is pydantic and PyYAML. The server stack — aiohttp, fastapi, uvicorn, grpcio, protobuf — used to come with it, so auditing a static site installed a gRPC runtime; now it is an extra.

  • PyPI — kbve, Python 3.14.
  • Extras — server, blender (opt-in).
kbvePackage
Python 3.14Language
HTTP · WS · gRPCServes
MITLicense

What it gives you

Features

Async API core

Extra server — kbve.api, grpc, health, proto and server for HTTP, WebSocket and gRPC, with lazily resolved AppServer, HttpServer, GrpcServer and HealthCheck.

Blender toolchain

kbve.blender bakers (retarget, VAT, turf, turntable, GLB export, model sprites) run inside Blender; extra blender adds Pillow and numpy for the image passes either side of a bake.

SEO/SEM auditor

kbve.seo static frontmatter and MDX analysis for a whole site, on the base install, via kbve-seo-audit and kbve-seo-report.

Ops and engine scripts

kbve-argocd-annotate and kbve-argocd-label edit manifests without cluster access; kbve-unreal-clangd and kbve-unreal-check drive UBT and clang.

Get started

Usage

install & dev
pip install kbve
pip install 'kbve[server]'

# development inside the KBVE monorepo
moon run kbve-py:test
moon run kbve-py:lint
moon run kbve-py:build

Questions

Frequently asked

What is the kbve Python library?

kbve is a toolbox installed in pieces. The server extra is an API layer for async HTTP, WebSocket and gRPC (AppServer, HttpServer, GrpcServer, health checks); the base install is pydantic and PyYAML, enough for the SEO auditor, models and the stdlib-only modules — mdx, svg, ai, utils, config and tasks.

How do I install the kbve Python package?

pip install kbve for the core, pip install 'kbve[server]' for the HTTP/WebSocket/gRPC stack, and pip install 'kbve[blender]' for the Pillow/numpy image passes. It requires Python 3.14. Top-level names such as AppServer resolve lazily, so import kbve works without the server extra and says which extra to install when one is missing.

What command-line tools does kbve ship?

Blender bakers and their image passes (kbve-blender-retarget, -vat, -turf, -turntable, -glb, kbve-model-sprites, kbve-sprite-postprocess, kbve-skin-variant and the turntable packers), the SEO auditor (kbve-seo-audit, kbve-seo-report), ArgoCD manifest annotate and label tools, and Unreal helpers that shell out to UBT and clang (kbve-unreal-clangd, kbve-unreal-check).

Discuss on the forum

Questions, fixes and notes on this page live in the KBVE forum.