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

Powered by Typer

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

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

Commands:
  version
  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


Creating an application

  1. Sign in to https://my.telegram.org/
  2. Open API development tools
  3. Create an application if needed
  4. Copy the api_id and api_hash

Quick Setup

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

If you skip step 4, 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.3.0a1.post1.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.3.0a1.post1-py3-none-any.whl (1.0 MB view details)

Uploaded Python 3

File details

Details for the file reena_userbot-0.3.0a1.post1.tar.gz.

File metadata

  • Download URL: reena_userbot-0.3.0a1.post1.tar.gz
  • Upload date:
  • Size: 1.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","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.3.0a1.post1.tar.gz
Algorithm Hash digest
SHA256 95b7490896d98dc199f31bbbb26de2a5aadbac820a9580170ba16123e1a601aa
MD5 43a9090a90347a9a38559a6c55788c63
BLAKE2b-256 9f6617e657e74263699159ecf11d84bb811f8c0ce2fd249a9424c0995f3646bd

See more details on using hashes here.

File details

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

File metadata

  • Download URL: reena_userbot-0.3.0a1.post1-py3-none-any.whl
  • Upload date:
  • Size: 1.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","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.3.0a1.post1-py3-none-any.whl
Algorithm Hash digest
SHA256 6415be4a25e81aada4807f38d704a11c621f42124896d7cae6cafdce82d60980
MD5 880122585d1a5c421517dbc5147f5192
BLAKE2b-256 746d07b55bacc8a67c7c25b81d70194e0ebe7ba430b53dc6c3bb4dc6c8d8f355

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