Metadata-Version: 2.4
Name: tce-sdk
Version: 1.5.5
Summary: TeleControl Engine (TCE) Python SDK
Author-email: Kyle Express Team <dev@klexpress.net>
License: MIT
Project-URL: Homepage, https://gitlab.com/gh-platform-team/telecontrol-engine-tce
Keywords: telegram,bot,tce,supervisor,mtproto
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: websocket-client>=1.8.0

# 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

```bash
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)

```python
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)

```python
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](https://gitlab.com/gh-platform-team/telecontrol-engine-tce)
