What it is

TikTokLive unofficial Python library. Connect TikTok LIVE websocket. Receive realtime events. Lives Python ecosystem. Distributed PyPI. License AGPL-3.0. Repository age five years. Last push 2026-09-10. Stars 1562. Forks 295. Open issues zero. Homepage docs. Discord support. Attach stream with creator @unique_id. No login. No credentials. No app. Related ports exist for Node.js, Java, C#, Go, Rust. Community docs include homepage, examples, Discord py-support channel.

Solves problem: developers need TikTok LIVE event data. Streamers, bot builders, analytics tools need comments, gifts, likes, follows, shares, viewer counts, battle events as they happen. Library reads events. Routes data into chat bots, gift trackers, overlays, alerts, moderation tools, text-to-speech readers, interactive livestream games. Category: Business Software, Customer Support and Success. The library exposes event objects for connection, comments, and other live room signals. Developers can process those signals in async Python code.

Key capabilities

• Connects TikTok LIVE stream via creator @unique_id. No login, credentials, app.
• Receives realtime chat comments through event handlers like CommentEvent. Handlers use decorators or add_listener.
• Tracks gifts, likes, follows, shares, viewer counts, battle PK scores.
• Handles gift streaks for donation alerts and gift tracking.
• Supports event-driven workflows with decorators and manual listeners.
• Runs blocking client.run() or non-blocking await client.start().
• Reacts deleted messages and room events for moderation tools.

Who uses it and how

• Stream developers build TikTok chat bots. Bots respond comments realtime.
• Streamers and alert builders create gift trackers. Trackers use live event data.
• OBS users create overlays and stream widgets. Widgets driven by TikTok LIVE events.
• Analytics builders collect viewer counts, likes, follows, battle scores from live rooms.
• Moderation and game developers react deleted messages, room events, comment activity.

Getting started

Install package with pip install TikTokLive from PyPI, create TikTokLiveClient with creator @unique_id, register event handlers, and call client.run() or await client.start(). README points examples folder for quickstart scripts: live chat reader, gift tracker, live status checker.

When to use it — and when not to

Use TikTokLive for Python prototypes, personal tools, bots, overlays, and learning event consumption, but do not use it for production because README says reverse engineering project, not production-ready. Euler Stream WebSocket API listed as production alternative. Self-hoster operates Python client and event handling logic, relies on TikTok livestream websocket behavior, and has no supported production-grade interface.

pip install TikTokLive

from TikTokLive import TikTokLiveClient
from TikTokLive.events import ConnectEvent, CommentEvent

# Create the client
client: TikTokLiveClient = TikTokLiveClient(unique_id="@isaackogz")


# Listen to an event with a decorator!
@client.on(ConnectEvent)
async def on_connect(event: ConnectEvent):
    print(f"Connected to @{event.unique_id} (Room ID: {client.room_id}")


# Or, add it manually via "client.add_listener()"
async def on_comment(event: CommentEvent) -> None:
    print(f"{event.user.nickname} -> {event.comment}")


client.add_listener(CommentEvent, on_comment)

if __name__ == '__main__':
    # Run the client and block the main thread
    # await client.start() to run non-blocking
    client.run()