https://t.me/ffmemesbot

• 2025-10-12 -- Added a persistent "share" button under every meme that links back to the bot via the same deep link we place in the caption. Hypothesis: when users forward a meme, Telegram strips callback buttons (like/dislike) but keeps external links, so this extra button should survive forwards and convert more viewers back into bot sessions. Monitor engagement and roll back if the button hurts the meme experience.

1. cp .env.example .env
2. docker network create ffmemes_network
3. docker-compose up -d --build

Don't forget to fill the local .env file with all envs you need.

Before sending a PR you must test your new code. The easiest way is to run ipython shell, then import the functions you may need and test them. Note that ipython can run async functions without wrapping them with asyncio.run(...).

Format the code with ruff --fix and ruff format

• Create an automatic migration from changes in src/database.py

• Run migrations

• Downgrade migrations

All tests are integrational and require DB connection.

One of the choices I've made is to use default database (postgres), separated from app's app database.

• Using default database makes it easier to run tests in CI/CD environments, since there is no need to setup additional databases
• Tests are run with upgrading & downgrading alembic migrations. It's not perfect, but works fine.

Run tests

The template is using Just.

It's a Makefile alternative written in Rust with a nice syntax.

You can find all the shortcuts in justfile or run the following command to list them all:

Info about installation can be found here.

We are using pg_dump and pg_restore to backup and restore the database.

• Backup

• Copy the backup file or a directory with all backups to your local machine

• Restore

• SET pg_trgm.similarity_threshold = 0.6;