telebot-constructor 0.1.8

No-code Telegram bot constructor

telebot-constructor

Free & open-source no-code constructor of Telegram bots for grass-roots activist initiatives and human rights organizations. Focused on privacy both for bot users and admins. Developed by bots against war team.

How to use

:warning: Under construction

Development

Basic dev setup

1. Install Poetry (tested with versions 1.5 - 1.7). Then, install backend dependencies with

poetry install

# start new shell with poetry-created virtual env activated
poetry shell

If you have problems with poetry, you can manually create everything and install dependencies using pip from requirements.txt generated from poetry dependencies:

# example of virtual env creation and activation for unix systems
python3.12 -m venv venv
source venv/bin/activate

pip install -r requirements.txt

2. Start backend/API

# set environment variables (example for unix-like systems)
export TELEBOT_CONSTRUCTOR_USE_REDIS_EMULATION=1
export SECRETS_ENCRYPTION_KEY=if-wLoSw7gEbQgY1xLHrEgI4E357PRUAeGfZudnaYu0=  # dummy value

# run the web app
python run_polling.py

3. With npm v18+ install frontend and start dev server

npm install
npm run dev

4. Visit http://localhost:8081 in the browser.

Generate TS interfaces from backend data model

On any update to Pydantic data types on backend, run

npm run pydantic:to:ts

Check that JSON schema and Typescript types are updated accordingly.

Backend

Running tests with coverage check

coverage run -m pytest tests -vv
coverage html

Then you can review htmlcov/index.html in browser.

Running linters and code checks

black .
isort .
flake8
mypy

Adding/updating backend dependencies

We keep two versions of the same dependency list:

• poetry format (pyproject.toml + poetry.lock)
• regular pip's requirements.txt

To modify dependency list, use poetry add depdendency@contraint.

Then, re-generate requirements.txt with (there is a github action to check it)

poetry export -f requirements.txt --output requirements.txt 

Frontend

We use:

• Tailwind CSS
• flowbite component library, see docs
• svelvet (nodes/connections engine), see docs
• flowbite-icons-svelte for icons, see catalog