gitwtfhub

wtf is campaignforge?

sepfazeli/campaignforge — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · developerComplexity · 4/5Setup · moderate

TL;DR

A Django based engine for sending large, personalized email campaigns in batches, with an API and AI agent access via MCP.

Mindmap

mindmap
  root((CampaignForge))
    What it does
      Email campaign engine
      Batch sending
      MCP server
    Tech stack
      Django
      Celery
      Redis
      PostgreSQL
    Use cases
      High volume email
      Segment targeting
      AI agent campaigns
    Audience
      Developers
      Marketing teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Send tens of thousands of personalized emails a day without one server becoming a bottleneck.

REASON 2

Segment customers by custom attributes and target each segment with different templates.

REASON 3

Let an AI agent like Claude trigger and manage email campaigns through MCP tools.

REASON 4

Track per-recipient delivery status and automatically retry failed sends.

What's in the stack?

PythonDjangoCeleryRedisPostgreSQL

How it stacks up

sepfazeli/campaignforge920linjerry-stack/capital-studioadya84/ha-world-cup-2026
Stars161616
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity4/53/52/5
Audiencedeveloperresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Docker Compose plus Redis and PostgreSQL to run the full stack.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Walk me through starting CampaignForge locally with Docker Compose.
Prompt 2
Explain how CampaignForge splits a campaign send into batches across Celery workers.
Prompt 3
Help me connect Claude Desktop to CampaignForge's MCP server.
Prompt 4
What would I need to change to scale CampaignForge's send throughput horizontally?

Frequently asked questions

wtf is campaignforge?

A Django based engine for sending large, personalized email campaigns in batches, with an API and AI agent access via MCP.

What language is campaignforge written in?

Mainly Python. The stack also includes Python, Django, Celery.

How hard is campaignforge to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is campaignforge for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.