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.10+

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 12, 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:
Newer release available (10.0.0)

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 12, 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.10

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-9.1.2.tar.gz (214.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-9.1.2-py3-none-any.whl (23.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for cb_events-9.1.2.tar.gz
Algorithm Hash digest
SHA256 a11276168f59fc6db87c7135cdb4ba808290c0914ec5e187371c91c31951c901
MD5 378512c14722ffed2837784d1b0331ff
BLAKE2b-256 ef023f8e7d2b95e2fd9c6bd1ec3b6b1d5368034c08a420a80842439e136ab76a

See more details on using hashes here.

Provenance

The following attestation bundles were made for cb_events-9.1.2.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-9.1.2-py3-none-any.whl.

File metadata

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

File hashes

Hashes for cb_events-9.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6344274c8810eb325b67691b6539df24831c722fcd4f74db8507b42c88daa1f3
MD5 24fe0c6997ad84cbb10f5a65dc3da0ff
BLAKE2b-256 95e095236da1b9e70e53992adcb27b1103f406bbd427009ee9ae23c104fcb6d4

See more details on using hashes here.

Provenance

The following attestation bundles were made for cb_events-9.1.2-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

10.0.0

2 files

9.2.0

2 files

This release

9.1.2 This release

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