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

Uploaded Python 3

File details

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

File metadata

  • Download URL: civic_line_cli-1.9.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.9.tar.gz
Algorithm Hash digest
SHA256 3d0148933b6a73bf16417f6bb917bc1977a8d0c7dfce6e4d32237709b4c38f2b
MD5 dd65a898df1ad4f5af8cfa361bc1e749
BLAKE2b-256 bd7d3db17eb36e38f9de5ab78fbb49fb50091a12ab07eb00c58e39c2cf453c62

See more details on using hashes here.

File details

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

File metadata

  • Download URL: civic_line_cli-1.9-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.9-py3-none-any.whl
Algorithm Hash digest
SHA256 19eddbd195a1e2c7a3d363da74ad6f78a5fc308c33b6bf04f6ca06d3ae438585
MD5 f2ac3b3ce0384f46d6f4cede2fdfdeba
BLAKE2b-256 01759d0dca43540923524e64e3da71ed6d11ab6454629047c04ae6834984d8c9

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