SwapLayer

The Anti-Vendor-Lock-in Framework for Django

One Interface. Any Provider. Zero Rewrites.

What is SwapLayer?

SwapLayer is a unified infrastructure layer for Django that protects you from vendor lock-in.

Instead of coupling your code directly to Stripe, AWS, or Twilio, you write against one consistent interface and swap providers by changing a single configuration line.

The Problem

# ❌ Tightly coupled - if Stripe fails, you rewrite everything
import stripe
customer = stripe.Customer.create(email='user@example.com')

The Solution

# ✅ Provider-agnostic - swap providers in settings
from swap_layer import get_provider
payments = get_provider('payments')
customer = payments.create_customer(email='user@example.com')

Quick Start

1. Install

SwapLayer has optional dependencies - install only what you need:

# Install with specific providers
pip install swaplayer[stripe]        # Just Stripe billing
pip install swaplayer[identity]      # Just WorkOS/Auth0
pip install swaplayer[email,sms]     # Email + SMS

# Or install everything
pip install swaplayer[all]

Available extras:

• stripe - Stripe payment processing
• identity - WorkOS/Auth0 OAuth/SSO
• email - Enhanced email (django-anymail)
• sms - Twilio/AWS SNS messaging
• aws - AWS services (S3, SNS)
• mcp - AI assistant integration
• all - Everything

2. Configure

# settings.py
from swap_layer.settings import SwapLayerSettings

SWAPLAYER = SwapLayerSettings(
    email={'provider': 'django'},
    payments={'provider': 'stripe', 'stripe': {'secret_key': '...'}},
    sms={'provider': 'twilio', 'twilio': {'account_sid': '...'}},
    storage={'provider': 'django'},
)

3. Use Anywhere

from swap_layer import get_provider

# Email
get_provider('email').send(to='user@example.com', subject='Hello')

# Payments  
get_provider('payments').create_customer(email='user@example.com')

# SMS
get_provider('sms').send(to='+1555555', message='Welcome!')

Features

🤖 AI Assistant Integration

SwapLayer includes an MCP (Model Context Protocol) server that exposes provider management as tools for AI assistants:

# Install with MCP support
pip install 'swaplayer[mcp]'

# Run the MCP server
swaplayer-mcp

AI assistants can now help you:

• Configure and switch providers through conversation
• Send test emails/SMS to verify integrations
• Get provider setup instructions and capabilities
• Inspect your current configuration

Perfect for AI-powered development workflows! → MCP Documentation

📚 Full Documentation

→ docs/ - One doc per module:

• Email - Email providers
• Billing - Payment processing
• SMS - SMS messaging
• Storage - File storage
• Identity Platform - OAuth/SSO
• Identity Verification - KYC
• MCP Server - AI assistant integration
• Architecture - Design patterns
• Contributing - Help improve SwapLayer

Why SwapLayer?

✅ Avoid Vendor Lock-in - Never get trapped by a single provider
✅ Consistent Interface - Same API across all vendors
✅ Type Safe - Pydantic validation catches errors early
✅ Battle Tested - Wraps proven tools (django-storages, django-anymail)
✅ Zero Rewrites - Swap providers with configuration changes only
✅ AI-Powered - Built-in MCP server for AI assistant integration

License

MIT - Because avoiding vendor lock-in should be free.

→ Read Full Documentation