Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

❄️ 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


Metadata

Release files for reena-userbot 0.3.1a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reena-userbot 0.3.1a1
File Size Uploaded
reena_userbot-0.3.1a1.tar.gz 1.0 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for reena-userbot 0.3.1a1
File Interpreter ABI Platform
reena_userbot-0.3.1a1-py3-none-any.whl Python 3 none any Details

Total release size: 2.1 MB

Release files / reena_userbot-0.3.1a1.tar.gz

Download URL reena_userbot-0.3.1a1.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
f645b6a7a2e2553d47cdd3e226fcebec02b3fdfee2027c4a3430ee3f85d0d777
BLAKE2b-256 checksum
How to use checksums
2d1e09788b5c229841c76c1e8f9cfb994e0ce87abc1c72ee89f691aa6daf5358
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","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}

Release files / reena_userbot-0.3.1a1-py3-none-any.whl

Download URL reena_userbot-0.3.1a1-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
9903961b4e7339253f9481a8335a4f939448e93ff01ea183f57861356cdd9667
BLAKE2b-256 checksum
How to use checksums
8f3e8d268bf7cf4e712b966e460cd0aa05d854f1ee661864b9526f3783450d6f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.19 {"installer":{"name":"uv","version":"0.11.19","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}
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page