Skip to main content

Modular Telegram userbot

Project description

❄️ Reena Userbot

Reena is a modular Telegram userbot powered by aiogram and telethon.

Notice: Reena is currently in the alpha stage. Some features are unstable, parts of the planned functionality are still missing, and documentation is incomplete



Links


Reena CLI

Usage: reena [OPTIONS] COMMAND [ARGS]...

Options:
  -h, --help     Show this message and exit.

Commands:
  run
  alembic
  config

Installation

  • Using uv (recommended):
uv tool install reena-userbot
  • Using pipx:
pipx install reena-userbot
  • Or use any other installation method you prefer. Reena is just a Python package :)

Creating a Bot

Reena requires a Telegram bot created via BotFather

Bot setup guide
  1. Open BotFather
  2. Send the /newbot command
  3. Follow the interactive setup process to create your bot
  4. (Optional) Enable inline mode for the bot. See Bot inline mode setup below

Bot inline mode setup

To use inline features, you need to enable inline mode and inline feedback in BotFather.

Enable inline mode:

  1. Send the /setinline command
  2. Select or enter your bot
  3. Enter any inline placeholder text

Enable inline feedback:

  1. Send the /setinlinefeedback command
  2. Select or enter your bot
  3. Select or enter Enabled


Quick Setup

  1. Install Reena (see Installation)
  2. Create a bot (see Creating a Bot)
  3. (Optional) Create the configuration in advance with:
reena config create
  1. Run Reena:
reena run

If you skip step 3, Reena will offer to create and configure everything on first launch


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

reena_userbot-0.2.1a1.tar.gz (1.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

reena_userbot-0.2.1a1-py3-none-any.whl (1.0 MB view details)

Uploaded Python 3

File details

Details for the file reena_userbot-0.2.1a1.tar.gz.

File metadata

  • Download URL: reena_userbot-0.2.1a1.tar.gz
  • Upload date:
  • Size: 1.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.4 {"installer":{"name":"uv","version":"0.11.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for reena_userbot-0.2.1a1.tar.gz
Algorithm Hash digest
SHA256 31e4c186c46f6b3259eb77fad40fc7a3d1c6de8757bfee69721a0cde3d77fd4d
MD5 91ac51dc422fe6286b137c460be7fb16
BLAKE2b-256 feee0134a41997c948a1ac0a8d38db72bb711bbfeacc6a74478e8dd83ae8e5f0

See more details on using hashes here.

File details

Details for the file reena_userbot-0.2.1a1-py3-none-any.whl.

File metadata

  • Download URL: reena_userbot-0.2.1a1-py3-none-any.whl
  • Upload date:
  • Size: 1.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.4 {"installer":{"name":"uv","version":"0.11.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"43","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for reena_userbot-0.2.1a1-py3-none-any.whl
Algorithm Hash digest
SHA256 4ad7c6f3cc62ebdadf96317010246a802b2cf4aa0ff70c27b6a368782f06f730
MD5 0478605d07081fccda50f38de0b7d412
BLAKE2b-256 84bd723034656b1962a39806610cdc82b27bd10b3fef076213f2c2cfbfdde112

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page