Skip to main content

tg-feedback-bot-ru

Телеграм‑бот для обработки пользовательских обращений: принимает сообщения из личных чатов, пересылает их администраторам и позволяет отвечать пользователям из приватных и групповых чатов. Хранение состояния всегда выполняется в PostgreSQL (SQLAlchemy + aiotgbot storage).

Требования

  • Python 3.14+
  • PostgreSQL для хранения состояния

Переменные окружения

Приложение полностью конфигурируется через env vars (см. src/tg_feedback_bot_ru/settings.py). Подготовьте файл .env или используйте пример bot_env.example.

Переменная Назначение
TZ Часовой пояс процесса (Europe/Moscow, UTC и т.д.).
TG_TOKEN Bot API token. Можно передать напрямую или через Docker secret.
ADMIN_USERNAME Telegram username администратора без @.
CHAT_LIST_SIZE Размер списка последних чатов для быстрых ответов (1–20).
POSTGRES_DSN DSN PostgreSQL в формате SQLAlchemy async (postgresql+asyncpg://…).

Все переменные обязательны (для CHAT_LIST_SIZE и POSTGRES_DSN есть значения по умолчанию, но в проде лучше задавать их явно).

Локальная разработка

uv sync --group dev
uv run python -m tg_feedback_bot_ru

Полезные команды:

  • uv run ruff format --check src/tg_feedback_bot_ru
  • uv run ruff check src/tg_feedback_bot_ru
  • uv run mypy src/tg_feedback_bot_ru
  • uv run basedpyright

Docker

Официальный образ собирается GitHub Actions из опубликованной версии PyPI. Локально можно:

docker build --build-arg BOT_VERSION=0.3.0 -t tg-feedback-bot-ru:0.3.0 .
docker run --env-file bot_env.example tg-feedback-bot-ru:0.3.0

В проде используйте образ ghcr.io/gleb-chipiga/tg-feedback-bot-ru:<tag> (теги совпадают с v* релизами). Он ожидает переменные окружения из таблицы выше и запускает консольный скрипт tg-feedback-bot-ru.

Metadata

Release files for tg-feedback-bot-ru 0.4.4

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

Source distribution (sdist)

Source distribution for tg-feedback-bot-ru 0.4.4
File Size Uploaded Provenance Actions
tg_feedback_bot_ru-0.4.4.tar.gz 12.3 kB Without provenance Details for tg_feedback_bot_ru-0.4.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tg-feedback-bot-ru 0.4.4
File Interpreter ABI Platform Actions
tg_feedback_bot_ru-0.4.4-py3-none-any.whl Python 3 none any Details for tg_feedback_bot_ru-0.4.4-py3-none-any.whl

Total release size: 28.5 kB

Release files / tg_feedback_bot_ru-0.4.4.tar.gz

Download URL tg_feedback_bot_ru-0.4.4.tar.gz
Size 12.3 kB
Tags Source
SHA-256 checksum
How to use checksums
4b2d44697838cfbff6bbd224a002a7fb99be995c94967a1cbfd801fbd0f0aae5
BLAKE2b-256 checksum
How to use checksums
73d5df18753e7ce39421611f7c7ab5221b793cc6448397789897b24d9fb5bad0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / tg_feedback_bot_ru-0.4.4-py3-none-any.whl

Download URL tg_feedback_bot_ru-0.4.4-py3-none-any.whl
Size 16.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9cd1c75c34fb02e3faf6a059c57b824407a21a74d8d7beb65638efc027a3ddf9
BLAKE2b-256 checksum
How to use checksums
6e65a8339d3fa6e33b3f490c23b361a3e41a2cd9e9e3acdc2e74e83b357d6bc4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.11 {"installer":{"name":"uv","version":"0.9.11"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for tg-feedback-bot-ru 0.4.4

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