Metadata-Version: 2.4
Name: forgertele
Version: 1.0.1
Summary: Python library for Telegram with official APIs, anti-ban and SessionManager. By Green Forger @forgertele
Author-email: Green Forger <soporte@greenforger.com>
License-Expression: MIT
Project-URL: Homepage, https://t.me/forgertele
Keywords: forgertele,tdata,tdesktop,telegram,telethon,green-forger
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: telethon<2,>=1.36; python_version < "3.14"
Requires-Dist: telethon<2,>=1.43; python_version >= "3.14"
Requires-Dist: tgcrypto-pyrofork>=1.2.7
Provides-Extra: pyrogram
Requires-Dist: pyrofork>=2.3; extra == "pyrogram"
Dynamic: license-file

# ForgerTele

![Version](https://img.shields.io/badge/version-1.0.0-brightgreen)
![Python](https://img.shields.io/badge/python-3.11--3.14-blue)
![License](https://img.shields.io/badge/license-MIT-green)
![Telegram](https://img.shields.io/badge/Telegram-13.1.0-2CA5E0?logo=telegram&logoColor=white)
![Channel](https://img.shields.io/badge/channel-@forgertele-2CA5E0?logo=telegram&logoColor=white)

Python library for Telegram with official APIs, anti-ban protection and SessionManager.

**By [Green Forger](https://t.me/forgertele)** | **Channel: [@forgertele](https://t.me/forgertele)**

---

## Installation

```bash
pip install forgertele

# Or install latest from GitHub:
pip install git+https://github.com/Greenforger/forgertele.git
```

---

## Features

- Official Telegram APIs (Android, iOS, Desktop, macOS)
- Updated versions: Android 13.1.0 · iOS 13.1 · Desktop 7.3.1
- 4,896 Android devices from 2024-2026
- Persistent device fingerprint per account
- SessionManager — loads multiple .session files one by one
- Automatic banned/limited account detection
- Built-in anti-flood delays
- No Qt dependency — pure Python

---

## Basic Usage

```python
from forgertele.td import TDesktop
from forgertele.tl import TelegramClient
from forgertele.api import API, UseCurrentSession

tdesk = TDesktop("/path/to/tdata")
client = await tdesk.ToTelethon(
    session="account.session",
    flag=UseCurrentSession,
    api=API.TelegramAndroid
)
await client.connect()
```

## SessionManager

```python
from forgertele.session import SessionManager

manager = SessionManager("/path/to/sessions/")
await manager.load_all()
manager.summary()

for account in manager.active:
    await account.client.send_message(...)

await manager.disconnect_all()
```

## Anti-ban

```python
from forgertele.antiban import get_device_fingerprint, RateLimit, AccountStatus

fp = get_device_fingerprint("my_account", "android")
await RateLimit.wait_action()
status = await AccountStatus.check(client)
```

---

## Credits

Fork of [opentele-ng](https://github.com/stufently/opentele) — MIT License.
