tinymail

For something in between Mailchimp and Mailgun, but free.

This is a simple API based on FastAPI, SQLModel and Celery

What can you do with it ?

Import contacts with as many metadata as you want and filter automatically the wrong emails
Create marketing campaigns and filter contacts into segments
Get access to your campaigns's open rates
Send unique emails right now or at a specific date

How ?

Installation

git clone https://github.com/lmanhes/tinymail
pip install -r requirements.txt

Settings

Create a .env file (or create env var) with the following variables:

# Your EMAIL + SMTP config
MAIL_ADDRESS = "hello.tinymail.com"
MAIL_PWD = "tinymailpassword"
SMTP_HOST = "smtp.gmail.com"
SMTP_PORT = "465"
SMTP_SSL = "True"

CONF_TOKEN_SECRET_KEY # random string, useful for encryption of tokens inside mails
CONF_TOKEN_PASSWORD_SALT # random string, useful for encryption of tokens inside mails

DATABASE_URL
REDISCLOUD_URL 
BASE_URL = "https://myapi/" # this is the API base url

ENV_STATE # dev/staging/prod/...

Usage

Run the following commands to start:

a redis instance
a celery worker instance
the main web app

redis-server
celery -A app.worker worker -l info
uvicorn app.main:app

Alembic migrations

alembic revision --autogenerate -m "your message"
alembic upgrade head