Dice-бот на Питоне, развертывается в докер

В общем, если хотите собственный Dice-бот в тг - то добро пожаловать.

Режимы запуска:

• локальный запуск в режиме разработки через uv run (с загрузкой .env);
• развертывание на сервере (Debian) в контейнере через Docker Compose, описан ниже.

ВАЖНО!!! Перед тем, как запускать код бота, вам нужно создать собственный бот в Телеграм и получить токен к нему.

Инструкция тут: https://core.telegram.org/bots#how-do-i-create-a-bot (в сети навалом инструкций на русском)

Секреты (токен бота) не хранятся в Git, токен зададите при установке либо вручную прямо в коде.

Инструкция по использованию бота

Лежит тут.

Что в репо

• main.py — код бота
• Dockerfile — сборка контейнера
• docker-compose.yml — описание сервиса
• .env.example — шаблон секрета, где будет храниться ваш токен
• scripts/bootstrap.sh — первичное развертывание на новой машине
• scripts/update.sh — обновление (pull + rebuild + restart)
• pyproject.toml, uv.lock — зависимости для локальной разработки (uv)
• requirements.txt — перечень необходимых пакетов

Требования

Для разработки (локально)

• Python 3.12
• uv

Для сервера (Debian)

• Docker Engine
• Docker Compose plugin (команда docker compose должна работать)

Как установить в контейнер

Исходим из того, что Docker у вас уже установлен

Далее выполняем команды

git clone https://github.com/unavlab/Akira_sDiceBot.git
cd Akira_sDiceBot
chmod +x scripts/bootstrap.sh scripts/update.sh
./scripts/bootstrap.sh

Обновить код в контейнере:

./scripts/update.sh