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




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.1a2

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.1a2
File Size Uploaded Provenance Actions
reena_userbot-0.3.1a2.tar.gz 1.0 MB Without provenance Details for reena_userbot-0.3.1a2.tar.gz

Built distribution (wheel)

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

Total release size: 2.1 MB

Release files / reena_userbot-0.3.1a2.tar.gz

Download URL reena_userbot-0.3.1a2.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
87661fb3168b0d3b162837ef7462f5b132392ca6cbb01cea49cc7226c3d233f5
BLAKE2b-256 checksum
How to use checksums
aa8701b9e1ab1e5d75b0b1abc0237937a73e6bb2241de88dd241fe55e9f51b9f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"44","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.1a2-py3-none-any.whl

Download URL reena_userbot-0.3.1a2-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
82cb0ef3c1b08cd95c5b110032c688b6c1a426bc3c5ef1dc197777c638feb6e8
BLAKE2b-256 checksum
How to use checksums
425f2e75e3abc856229b59c55f9aa56689c3919e7fcb6173037d7ab65a36a079
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"44","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for reena-userbot 0.3.1a2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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