A collection of cross-integrated utils and components for Telegram bots.
Connect botspot components to an aiogram dispatcher. Featured: user_data and send_safe. Access components via the singleton deps object and deps_getters.
Needs Python ≥ 3.12 and a bot token from @BotFather.
Clone the botspot-template, copy example.env, enable the components you want, then run:
git clone https://github.com/calmmage/botspot-template.git your-bot-name
cd your-bot-name
cp example.env .env # set TELEGRAM_BOT_TOKEN
python run.pyComponent usage examples live in examples/. Generally, you can access components via singleton deps and deps_getters:
from botspot.utils.deps_getters import get_bot, get_database, get_schedulerAgents: follow AGENTS.md for the component checklist and the examples/base_bot pattern.
This repo is the library (v0.10.39). Add it from git — the PyPI botspot project is an older 0.1.x snapshot:
uv add git+https://github.com/calmmage/botspot.git| Surface | What it is |
|---|---|
| Core | BotManager wires components into your aiogram dispatcher |
| Components | Data, features, middleware, QoL — enable with env / settings. Featured: user_data |
| Utils | send_safe (split, format, auto-delete) and deps_getters |
| Commands | @botspot_command builds /help and the Telegram command menu |
| This page, install, example | docs/index.md |
| Component demos | examples/ |
| Agent install / conventions | AGENTS.md |
| Vulnerability reports | SECURITY.md |
uv run pytest # tests
uv run ruff check botspotGPL-3.0 — see LICENSE. Vulnerabilities: SECURITY.md.