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

Uploaded Python 3

File details

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

File metadata

  • Download URL: civic_line_cli-1.11.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.11.tar.gz
Algorithm Hash digest
SHA256 bd715d3d67530e4a5eda6b2c162bbab8c2bb1996b2ceaaf5dc1e61f612326707
MD5 e1586e397f898838750abed1df4c9b17
BLAKE2b-256 c735f978692c206c7229d65935218a3b267f40e812b869603923d3097a3b77d2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: civic_line_cli-1.11-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.11-py3-none-any.whl
Algorithm Hash digest
SHA256 3621a3084513304da1856d94295271fb405acde48c67dfdc5f63d89671219207
MD5 ec7be5fa3f6afda39589737ce2e63829
BLAKE2b-256 7e0dcae13e846858f063653c92d8f049587c4d6d992989fe3fba6355a05d74ca

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