Pluggable Telegram bot and userbot based on Telethon
Go to file
udf 27d7b5ed82
Merge branch 'master' of https://git.togrand.xyz/uniborg/uniborg
2019-09-09 09:35:39 +02:00
stdplugins Count messages and sort by top posters 2019-09-07 08:08:07 +00:00
uniborg await the now async remove_plugin 2019-04-30 20:44:08 +02:00
.gitignore add *.session-journal to `.gitignore` 2018-07-03 11:26:45 +03:00
LICENSE Initial commit 2018-04-06 18:47:57 +03:00
README.md Don't allow unloading _core 2018-07-01 17:44:56 +03:00
requirements-stdborg.txt create stdborg requirements file 2018-06-01 01:18:34 +01:00
requirements.txt Fix #13 2018-07-01 16:19:27 +03:00
stdborg.py Use connection_retries 2018-06-21 18:57:06 +03:00

README.md

uniborg

Pluggable asyncio Telegram userbot based on Telethon.

installing

Simply clone the repository and run the main file:

git clone https://github.com/uniborg/uniborg.git
cd uniborg
python stdborg.py

design

The modular design of the project enhances your Telegram experience through plugins which you can enable or disable on demand.

Each plugin gets the borg, logger and storage magical variables to ease their use. Thus creating a plugin as easy as adding a new file under the plugin directory to do the job:

# stdplugins/myplugin.py
from telethon import events

@borg.on(events.NewMessage(pattern='hi'))
async def handler(event):
    await event.reply('hey')

internals

The core features offered by the custom TelegramClient live under the uniborg/ directory, with some utilities, enhancements and the core plugin.

learning

Check out the already-mentioned plugins directory to learn how to write your own, and consider reading Telethon's documentation.