Skip to main content

Dead simple email sending for developers

Project description

Civic Line CLI

Dead simple bulk email sending for civic engagement and voter outreach.


Send professional emails to your community in seconds, not hours. Built for organizers, campaigns, and civic tech projects.

Installation

pip install civic-line-cli

Quick Start

civicline

That's it. The interactive CLI guides you through everything.

How It Works

First Run

  1. Configure your SMTP settings (Gmail, Outlook, SendGrid, etc.)
  2. Save credentials securely to your local machine
  3. You're ready to send

Every Run After

  1. Choose to keep your saved settings or update them
  2. Connect to your database with email subscribers
  3. Compose and send your message

What You'll Need

  • Email provider: Any SMTP server (Gmail, Outlook, custom SMTP)
  • Database with contacts: A table called email_subscriptions containing your recipients
    • Must include at minimum: email addresses
    • Optional: names, custom fields for personalization

Features

Zero configuration hassle - Interactive prompts walk you through everything
🔐 Secure credential storage - Your passwords stay on your machine
📧 HTML emails - Rich formatting, images, and styling
📎 File attachments - Include PDFs, images, or documents
📊 Bulk sending - Send to hundreds or thousands from your database
🎨 Email templates - Reuse and customize pre-built templates
Built for speed - Optimized for sending large volumes efficiently

Perfect For

  • Political campaigns reaching voters
  • Community organizers sending updates
  • Nonprofits engaging supporters
  • Civic tech projects with email needs
  • Any project that needs simple, powerful email sending

Why Civic Line?

Most email tools are either:

  • Too complex (requiring extensive configuration)
  • Too expensive (enterprise pricing for basic sending)
  • Too limited (can't handle bulk or HTML)

Civic Line gives you enterprise email capabilities with CLI simplicity, perfect for civic projects that need to move fast.

Security

  • Credentials are stored locally using industry-standard encryption
  • No data is sent to external servers (except your email provider)
  • Database connections are closed immediately after use
  • All connections use secure protocols (TLS/SSL)

Support

Found a bug? Have a feature request?
Open an issue or contribute on GitHub.

License

MIT License - Build something great for your community!


Built for organizers, by organizers. Part of the Next Voters project.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

civic_line_cli-1.10.tar.gz (10.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

civic_line_cli-1.10-py3-none-any.whl (12.5 kB view details)

Uploaded Python 3

File details

Details for the file civic_line_cli-1.10.tar.gz.

File metadata

  • Download URL: civic_line_cli-1.10.tar.gz
  • Upload date:
  • Size: 10.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for civic_line_cli-1.10.tar.gz
Algorithm Hash digest
SHA256 3c3eff0f1096d3e5a1bee5ca1db1e76b64ecc3ea51e10bb580db13e36a069135
MD5 918b8fed28a6f04daee6fd3ea0df2980
BLAKE2b-256 760388d3600065f584aecca21f377cd46c3c0c6a0bc3cd743ee1b228d98da752

See more details on using hashes here.

File details

Details for the file civic_line_cli-1.10-py3-none-any.whl.

File metadata

  • Download URL: civic_line_cli-1.10-py3-none-any.whl
  • Upload date:
  • Size: 12.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for civic_line_cli-1.10-py3-none-any.whl
Algorithm Hash digest
SHA256 25a20963eb6fae55fd5d494016499de69f2d709c418532ecc45617b6ebaa4ce1
MD5 0ee5cb30e74c8d5fa0ead7418ea8173a
BLAKE2b-256 33eb91cab1ab640a22987fec93a3087815248036ff1c6a1fb2ca7c96689e3880

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page