reena-userbot 0.3.1a1

Modular Telegram userbot

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

---

• Quick Setup
• Links
• Reena CLI
• Installation
• Creating a Bot
• Creating an application

---

Links

• Reena Repository
• Reena on PyPI
• Reena Community Chat

---

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

4. Run Reena:

reena run

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

---