fastogram 0.0.5

Opinionated FastAPI + Aiogram project generator (FastGram template)

Fastogram

Opinionated FastAPI + Aiogram project generator — like django-admin startproject for FastGram.

Installation

pip install fastogram

Or with uv:

uv add fastogram

Usage

Create a new project:

fastogram new my-telegram-bot

This creates my-telegram-bot/ with the full FastGram template. Then:

cd my-telegram-bot
uv sync
# Edit .env with your TELEGRAM_BOT_TOKEN
python manage.py setup
python manage.py run --reload

Options

fastogram new my-bot              # Create ./my-bot/
fastogram new .                   # Scaffold in current directory (ignores .venv)
fastogram new . --force           # Scaffold in a non-empty current directory
fastogram new my-bot -d ~/code    # Create ~/code/my-bot/

---

For maintainers: syncing the template

When you update FastGram (architecture changes, bug fixes, etc.), sync the template into the CLI so pip install fastogram users get the latest:

cd cli/FastoGram
python scripts/sync_template.py

Or with a custom FastGram path:

FASTGRAM_SOURCE=/path/to/FastGram python scripts/sync_template.py

The sync copies FastGram → src/fastogram/templates/fastgram/, excluding .git, .venv, and other generated files. Rebuild and publish a new fastogram release after syncing.

Publishing to PyPI

# 1. Create .pypi-token with your PyPI API token (from pypi.org/manage/account/token/)
echo "pypi-your-token-here" > .pypi-token

# 2. Publish (defaults to patch bump: 0.0.3 -> 0.0.4)
make publish

# Publish with a minor or major bump
make publish BUMP=minor
make publish BUMP=major

# Publish with an explicit version
make publish VERSION=1.2.3

.pypi-token is in .gitignore — it will never be committed.