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.15.tar.gz (10.6 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.15-py3-none-any.whl (12.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: civic_line_cli-1.15.tar.gz
  • Upload date:
  • Size: 10.6 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.15.tar.gz
Algorithm Hash digest
SHA256 32b0fbf7dd4bef435c26475e47ccf9dbd82d8f1ba0795107299fda4486cbccf0
MD5 7f057843602e36c8b6c75981222b4bd1
BLAKE2b-256 91181aeca7a49f8bcf725389b615d5795da374884a1558fc6b61ad626a2721dd

See more details on using hashes here.

File details

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

File metadata

  • Download URL: civic_line_cli-1.15-py3-none-any.whl
  • Upload date:
  • Size: 12.4 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.15-py3-none-any.whl
Algorithm Hash digest
SHA256 8b8fd215805fadb4a6f1b316f640636364f1ead9e8aa57cc9478970d4b1e1148
MD5 88566d74cc083acb5e648bc44b96a580
BLAKE2b-256 a018281085337bc51c93fa98440a534845939ef1f5e34d9996dabeff2313c8ce

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