sepfazeli/campaignforge

CampaignForge is a tool for sending large batches of personalized email campaigns, built on the Django web framework. It lets you group customers into segments based on any attribute you choose, build email templates that change per recipient, and send tens of thousands of emails a day by splitting the work across background workers instead of one process trying to send everything at once. It comes with a REST API for managing subscribers, segments, templates, and campaigns, triggering sends, and checking delivery statistics as they come in. It also exposes the same operations through something called an MCP server, which means an AI assistant like Claude can be connected to drive campaigns directly through conversation instead of clicking through a dashboard. Under the hood, when a campaign is sent, the system splits recipients into fixed size batches, defaulting to 500 people per batch, and hands each batch to a background worker process managed by Celery, using Redis as the queue that holds pending work. Each worker then sends its batch of emails out through an email provider, with automatic retries if a send fails temporarily. Because the work is split into small batches handled by separate workers, you can add more worker processes to send faster without any single process becoming a bottleneck. To try it, you copy an example environment file, start everything with Docker Compose, then run a database migration and create an admin user, after which the REST API and admin panel are available locally. The project also includes setup docs for running without Docker.