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.13.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.13-py3-none-any.whl (12.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: civic_line_cli-1.13.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.13.tar.gz
Algorithm Hash digest
SHA256 523d7298963084336ec9269d1706d1fed7db52f84a9dc78434144f65c4732094
MD5 2b391d7549c87aef8a05bfa75c037be6
BLAKE2b-256 2d68128f022bddf4ffdf15261b5db69689cf88d865b9e8d95f66c84b474af5a8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: civic_line_cli-1.13-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.13-py3-none-any.whl
Algorithm Hash digest
SHA256 241a860195d1c06b9c0ff2552facf6b6c30a5337e2dd925390a4c7e6b0abcff6
MD5 06d76daf7ac60d947c39e8811df6eb4c
BLAKE2b-256 d3c718bed4d3685c5db1897c78e7082bc97541b8f717e6c9a7734795bb11d580

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