tce-sdk 1.5.5

TeleControl Engine (TCE) Python SDK

TCE Python SDK (tce-sdk)

The Python client library for the TeleControl Engine (TCE). This SDK provides a simple interface to connect and communicate with the TCE Master Hub, allowing you to build persistent plugins or one-off automation scripts.

Installation

pip install tce-sdk

Features

• Dual-Mode Communication: Supports both BotAPI and MTProto (User account) messaging.
• WebSocket & Socket Support: Connect effortlessly to local or cloud-based Master Hubs.
• Rich Messaging: Send text, images, and files with full caption support and Inline Keyboards.
• Auto-Routing: Easily send messages to other bots using reply_to_bot=True.

Quick Example (Plugin)

from tce import BotPluginSDK

sdk = BotPluginSDK("MyPlugin", host="localhost", port=8080)

@sdk.add_command("/ping", "Test ping")
def handle_ping(args, from_id):
    return "🏓 Pong!", None

sdk.start()

Quick Example (One-off Utility)

from tce import BotPluginSDK

sdk = BotPluginSDK("Pinger", host="localhost", port=8080)

if sdk.connect():
    sdk.send_message(12345678, "🔔 Hello from utility script!")
    sdk.close()

Links

• Main Project: telecontrol-engine-tce