cb-events 9.0.0

Async Python client for the Chaturbate Events API.

CB Events

Async Python client for the Chaturbate Events API.

Provides event polling, typed models, retries, and routing.

Requirements

Python 3.10+

Installation

pip install cb-events

With uv:

uv add cb-events

Quick Start

import asyncio
from cb_events import EventClient, EventType, Router

router = Router()

events_url = "https://eventsapi.chaturbate.com/events/your_username/your_api_token/"


@router.on(EventType.TIP)
async def handle_tip(event) -> None:
    if event.user and event.tip:
        print(f"{event.user.username} tipped {event.tip.tokens} tokens")


async def main() -> None:
    async with EventClient(events_url) as client:
        async for event in client:
            await router.dispatch(event)


asyncio.run(main())

Create an API token at https://chaturbate.com/statsapi/authtoken/ with Events API scope. You can create multiple tokens. Deleting a token revokes its access within up to one minute.

Features

• Async iterator client for long-polling events.
• Typed event models for tips, chat/messages, follows, broadcasts, and other event types.
• Router handlers are registered by event type.
• Retry and rate-limiting support.
• Client configuration for timeouts, strict validation, and retries.

Links

• Documentation
• Examples
• Changelog
• PyPI