cb-events

Async Python client for the Chaturbate Events API.

PyPI Tag Python OpenSSF Best Practices Builds License

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

Requirements

Python 3.11+

Installation

pip install cb-events

With uv:

uv add cb-events

Quick Start

import asyncio
from cb_events import Event, 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: 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.

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

License

MIT

Not affiliated with Chaturbate.

Project links

Data verified by PyPI on Jul 31, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for mountaingod2 from gravatar.com mountaingod2

Credits

Author: MountainGod2

GitHub Statistics

Data verified by PyPI on Jul 31, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Tags

api async chaturbate client events real-time streaming webcam

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cb_events-10.0.0.tar.gz (249.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cb_events-10.0.0-py3-none-any.whl (24.3 kB view details)

Uploaded Python 3

File details

Details for the file cb_events-10.0.0.tar.gz.

File metadata

  • Download URL: cb_events-10.0.0.tar.gz
  • Upload date:
  • Size: 249.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for cb_events-10.0.0.tar.gz
Algorithm Hash digest
SHA256 5ad225a940e6246e7465084b68553379e4991d2cc331b8e9c44e704a5983611f
MD5 39b9dbca392dd2f4c26eb935a6e64b66
BLAKE2b-256 936c7dc2bed42f5c8599f5299b7642a14040de67ba5baf82ccc02da3e8da47d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for cb_events-10.0.0.tar.gz:

Publisher: release.yml on MountainGod2/cb-events

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cb_events-10.0.0-py3-none-any.whl.

File metadata

  • Download URL: cb_events-10.0.0-py3-none-any.whl
  • Upload date:
  • Size: 24.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for cb_events-10.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 053c2353250fff39b9c36ef37e51407c80ea4d8a5a0f8fafe48acbdae325e62e
MD5 2b8d2c3bbfc1f5e3a174cff18c42acb5
BLAKE2b-256 9e3975bf1eb97f7d0ed3b84dd2dc6aa6eb630c33d73b0f9e7190351462de66de

See more details on using hashes here.

Provenance

The following attestation bundles were made for cb_events-10.0.0-py3-none-any.whl:

Publisher: release.yml on MountainGod2/cb-events

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

10.0.0 This release

2 files

9.2.0

2 files

9.1.2

2 files

9.1.1

2 files

9.1.0

2 files

9.0.2

2 files

9.0.1

2 files

9.0.0

2 files

8.1.3

2 files

8.1.2

2 files

8.1.1

2 files

8.1.0

2 files

8.0.10

2 files

8.0.9

2 files

8.0.8

2 files

8.0.7

2 files

8.0.6

2 files

8.0.5

2 files

8.0.4

2 files

8.0.3

2 files

8.0.2

2 files

8.0.1

2 files

8.0.0

2 files

7.1.2

2 files

7.1.1

2 files

7.1.0

2 files

7.0.1

2 files

7.0.0

2 files

6.3.1

2 files

6.3.0

2 files

6.2.0

2 files

6.1.4

2 files

6.1.3

2 files

6.1.2

2 files

6.1.1

2 files

6.1.0

2 files

6.0.0

2 files

5.9.1

2 files

5.9.0

2 files

5.8.2

2 files

5.8.1

2 files

5.8.0

2 files

5.7.0

2 files

5.6.5

2 files

5.6.4

2 files

5.6.3

2 files

5.6.2

2 files

5.6.1

2 files

5.6.0

2 files

5.5.1

2 files

5.5.0

2 files

5.4.0

2 files

5.3.0

2 files

5.2.2

2 files

5.2.1

2 files

5.2.0

2 files

5.1.1

2 files

5.1.0

2 files

5.0.0

2 files

4.10.1

2 files

4.10.0

2 files

4.9.2

2 files

4.9.1

2 files

4.9.0

2 files

4.8.0

2 files

4.7.1

2 files

4.7.0

2 files

4.6.1

2 files

4.6.0

2 files

4.5.2

2 files

4.5.1

2 files

4.5.0

2 files

4.4.3

2 files

4.4.2

2 files

4.4.1

2 files

4.4.0

2 files

4.3.0

2 files

4.2.1

2 files

4.2.0

2 files

4.1.1

2 files

4.1.0

2 files

4.0.4

2 files

4.0.3

2 files

4.0.2

2 files

4.0.1

2 files

4.0.0

2 files

3.1.2

2 files

3.1.1

2 files

3.1.0

2 files

3.0.5

2 files

3.0.4

2 files

3.0.3

2 files

3.0.2

2 files

3.0.1

2 files

3.0.0

2 files

2.5.0

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.7

2 files

2.3.6

2 files

2.3.5

2 files

2.3.4

2 files

2.3.3

2 files

2.3.1

2 files

2.3.0

2 files

2.2.0

2 files

2.1.0

2 files

2.0.0

2 files

1.13.0

2 files

1.12.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page