---
id: emails
version: "1.1.2"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# emails — Modern python library for emails.

License: permissive · Maintenance: active · Downloads: 796.0K/mo

## What it is and what it does

python-emails is a high-level library for composing and sending emails in Python, sitting above the standard library's email and smtplib modules. It handles HTML and plain-text messages in a single object, manages attachments and inline images, supports template rendering, applies HTML transformations like CSS inlining, signs messages with DKIM, and sends via SMTP with TLS/SSL—all without requiring manual MIME tree construction.

The library is designed for developers who need more than basic plain-text SMTP but want to avoid boilerplate. It depends on python-dateutil for date handling, puremagic for file type detection, and dkimpy for cryptographic signing. The package is production-stable, actively maintained, and supports Python 3.10 through 3.14.

Use it for:

- Send transactional emails (receipts, confirmations) with HTML formatting and PDF attachments
- Render templated emails using Jinja2 or Mako with dynamic content and CSS inlining
- Build marketing or notification emails with inline images and HTML transformations
- Sign outgoing emails with DKIM for improved deliverability and authentication
- Load and transform email messages from external sources (URLs, files, ZIP archives)
- Integrate email sending into Django applications via the DjangoMessage class

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Build and send HTML and plain-text emails with attachments, inline images, template rendering, and DKIM signing through a high-level Python API.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive license. Install it if you need to send HTML emails, attach files, render templates, or sign with DKIM—features that would otherwise require substantial boilerplate. Skip it only if you need only minimal plain-text SMTP and want to avoid any dependencies.

## Install

pip install emails
uv add emails
poetry add emails

## Installing emails

Before you install: Low install friction with a pure-Python wheel. Active maintenance with a recent release 88 days ago and ongoing commits. Depends on python-dateutil, puremagic, and dkimpy—all stable, widely-used libraries.

License in practice: Apache 2.0 permissive license allows commercial and private use with minimal restrictions, making it suitable for most projects.

Quickstart:

pip install emails

import emails

message = emails.html(
    subject="Test",
    html="<p>Hello</p>",
    mail_from=("sender", "sender@example.com")
)
response = message.send(
    to="recipient@example.com",
    smtp={"host": "smtp.example.com", "port": 587, "tls": True}
)

Requires Python 3.10 or later. SMTP credentials and a working mail server are needed to send messages.

Verify before relying:

- Whether optional extras (html, jinja, async) are automatically installed or require explicit specification
- Performance characteristics when handling large attachments or bulk message composition
- Compatibility details with async/await patterns beyond the aiosmtplib integration mentioned

## Package facts

- License: Apache License 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 796.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

send emails python, html email builder, smtp email library, email attachments inline images, dkim email signing, email template rendering, compose emails python, email-delivery, smtp-client, html-email

[View on SkillFed](https://skillfed.io/packages/emails) · [View on PyPI](https://pypi.org/project/emails/)