TikTokLiveProto 0.2.0

Clean-room betterproto2/Pydantic Python bindings for the TikTok Webcast Protobuf schema.

TikTokLiveProto

Python betterproto2 bindings for the TikTok Webcast Protobuf schema.

Install

pip install TikTokLiveProto

Usage

Import the version you need from the version package:

from TikTokLiveProto.v1 import WebcastResponse, WebcastChatMessage
from TikTokLiveProto.v2 import WebcastPushFrame

These are generated betterproto2.Message classes, using pydantic dataclasses for field validation.

Layout

• src/slim/v1/**/*.proto, src/slim/v2/**/*.proto (in the repo root) — canonical schemas
• targets/python/TikTokLiveProto/src/TikTokLiveProto/{v1,v2} — generated by protoc + python-betterproto2, committed to the repo, regenerated by CI when any .proto under src/slim/ changes
• targets/python/TikTokLiveProto/src/TikTokLiveProto/__init__.py — keeps the root package minimal while the actual generated code lives directly in TikTokLiveProto.v1 and TikTokLiveProto.v2

That means the committed package tree stays small:

src/TikTokLiveProto/
  __init__.py
  v1/
    __init__.py
    message_pool.py
  v2/
    __init__.py
    message_pool.py