TikTokLive
TikTok Live Python Client
Decision gist · record as of 2026-08-14
Yes, if you are building a hobby or experimental tool that needs real-time TikTok livestream data and can tolerate API instability. The library is actively maintained, has low install friction, and offers a straightforward event-driven API. However, do not use it for production systems—the author explicitly warns it is reverse-engineered and unstable. If you need reliability, use the official Euler Stream WebSocket API instead. Also verify that AGPL licensing aligns with your project's requirements.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- This is a reverse-engineering project; the documentation notes it is not production-ready and recommends using the WebSocket API for production use.
- Low install friction with a pure-Python wheel.
License · maintenance · safety
AGPL (permissive) — Licensed under AGPL with permissive treatment classification. Verify your use case aligns with AGPL's copyleft requirements, particularly if integrating into proprietary or closed-source applications.
last release 2026-07-21 (24 days) · last repo commit 2026-08-13 · 1,525 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 153,978 downloads/mo, #10,863 on PyPI
Alternatives
Verify before relying
pip install TikTokLive
from TikTokLive import TikTokLiveClient
from TikTokLive.events import ConnectEvent, CommentEvent
client = TikTokLiveClient(unique_id="@creator_username")
@client.on(ConnectEvent)
async def on_connect(event: ConnectEvent):
print(f"Connected to @{event.unique_id}")
client.run()- Whether the reverse-engineered API remains stable across TikTok client updates or if frequent maintenance is required to maintain compatibility.
- Rate limiting, connection limits, or account restrictions that may apply when connecting to multiple livestreams or high-frequency polling.
- Whether proxy support (web_proxy, ws_proxy parameters) fully mitigates TikTok's connection restrictions or if additional measures are needed.
What it is and what it does
TikTokLive is an unofficial Python client that connects to TikTok livestreams and streams real-time events—comments, gifts, likes, follows, and other viewer interactions—by creator username. It wraps reverse-engineered TikTok APIs and uses WebSocket connections to receive live data. The library is built on httpx for HTTP requests, websockets for streaming, and protobuf for message serialization, and it supports both blocking (run()) and non-blocking (start()) connection modes.
The package is actively maintained but explicitly not production-ready; the author recommends the official Euler Stream WebSocket API for production deployments. It is useful for building chat bots, stream overlays, analytics tools, and other real-time integrations with TikTok livestreams, but users must accept the risk that reverse-engineered APIs can break without notice and that TikTok may impose connection limits or other restrictions.
Use it for
- Build a chat bot that listens to comments and gifts in a TikTok livestream and responds or logs events in real time.
- Create a stream overlay or dashboard that displays live viewer interactions (comments, follows, gifts) for content creators.
- Aggregate and analyze TikTok livestream engagement metrics and viewer behavior for a single creator or multiple streams.
- Integrate TikTok livestream events into a unified chat or notification system alongside other streaming platforms.
- Develop a moderation or filtering tool that monitors and processes comments and user actions during a live broadcast.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a hobby or experimental tool that needs real-time TikTok livestream data and can tolerate API instability.
The library is actively maintained, has low install friction, and offers a straightforward event-driven API. However, do not use it for production systems—the author explicitly warns it is reverse-engineered and unstable. If you need reliability, use the official Euler Stream WebSocket API instead. Also verify that AGPL licensing aligns with your project's requirements.
Install
tiktoklive on PyPI
Before you install
Low install friction with a pure-Python wheel. Actively maintained as of 2026-08-13 with 1525 repository stars. Requires 11 runtime dependencies including httpx, websockets_proxy, and protobuf libraries, which are standard ecosystem packages.
Requires Python 3.10 or later. This is a reverse-engineering project; the documentation notes it is not production-ready and recommends using the WebSocket API for production use.
License in practice
Licensed under AGPL with permissive treatment classification. Verify your use case aligns with AGPL's copyleft requirements, particularly if integrating into proprietary or closed-source applications.
Quickstart
pip install TikTokLive
from TikTokLive import TikTokLiveClient
from TikTokLive.events import ConnectEvent, CommentEvent
client = TikTokLiveClient(unique_id="@creator_username")
@client.on(ConnectEvent)
async def on_connect(event: ConnectEvent):
print(f"Connected to @{event.unique_id}")
client.run()Verify before relying
- Whether the reverse-engineered API remains stable across TikTok client updates or if frequent maintenance is required to maintain compatibility.
- Rate limiting, connection limits, or account restrictions that may apply when connecting to multiple livestreams or high-frequency polling.
- Whether proxy support (web_proxy, ws_proxy parameters) fully mitigates TikTok's connection restrictions or if additional measures are needed.
Package facts
| License | AGPL permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 11 packageshttpxpyeeffmpywebsockets_proxybetterproto2async-timeoutmashumaroprotobuf3-to-dictprotobufTikTokLiveProtoEulerApiSdk |
| Maintenance | Actively maintained 24 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 153,978 / month, #10,863 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Topic :: Software Development :: Build Tools |
Evidence: tiktoklive-6.6.6-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “tiktok live chat api”
- TikTokLiveConnect to TikTok livestreams and receive real-time events (chats,…
- tiktok-business-api-sdk-officialProvides Python client libraries for the TikTok Business API,…
- TikTokApiUnofficial Python wrapper for retrieving public TikTok data—trending…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also TikTokApi · tiktok-business-api-sdk-official · stream-chat · py-nextbusnext · binance-connector · kiteconnect · late-sdk · tastytrade · zernio-sdk · dingtalk-stream