# AKHMShare

**AKHMShare** is a universal Python library for Telegram bot mailing.  
It allows bot creators to send broadcast messages to Telegram users in a safe, scalable way.  

The library uses the Telegram Bot API directly and handles all background polling.  
The bot creator only needs to provide a `get_user_ids()` function and their bot credentials.

---

## Features

- Single main class: `AKHMShare`  
- Bot creator only provides `BOT_TOKEN`, `API_KEY`, `API_URL`, and `get_user_ids()`  
- Validates that the function returns a list/set of Telegram user IDs  
- Background polling (non-blocking)  
- Automatic duplicate message prevention  
- Direct Telegram Bot API integration (no external bot libraries required)

---

## Installation

Clone the repository and install:

```bash
git clone https://github.com/sk1llpy/akhmshare
cd akhmshare
pip install .
