---
id: django-naomi
version: "0.8"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# django-naomi — Email backend for Django. Preview your email in browser instead of sending it.

License: permissive · Maintenance: abandoned · Downloads: 115.4K/mo

## What it is and what it does

django-naomi replaces Django's default email backend to capture outgoing emails and serve them as viewable messages in your web browser instead of sending them through SMTP. This is designed for development environments where you want to inspect email content without a working mail server or to debug message formatting. Emails are stored as files in a configurable temporary directory, and attachments are displayed as links.

The package requires only Django and a writable directory on disk; it has no external runtime dependencies. Setup involves adding 'naomi' to INSTALLED_APPS, setting EMAIL_BACKEND to the NaomiBackend class, and specifying an EMAIL_FILE_PATH directory. Once configured, every email your Django application sends is intercepted and made available for inspection in the browser instead of being transmitted.

Use it for:

- Debug email formatting and content during local development without access to a working SMTP server.
- Preview transactional emails (password resets, confirmations, notifications) before they reach users.
- Inspect email attachments and verify they are generated correctly without sending test messages.
- Develop and test email-heavy features in isolated environments where external mail services are unavailable.

## Worth the install?

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

django-naomi is a Django email backend that intercepts outgoing emails and displays them in your web browser instead of sending them via SMTP, useful for development and debugging.

No. The package is abandoned (last release 2015-08-15, last commit 2019-12-12) and targets obsolete Python versions (2.6–3.4). Compatibility with modern Django and Python is unverified. For current projects, use actively maintained alternatives.

## Install

pip install django-naomi
uv add django-naomi
poetry add django-naomi

## Installing django-naomi

Before you install: Installation is straightforward with no runtime dependencies, but the package is abandoned—last release was 2015-08-15 and last commit 2019-12-12. It targets Python 2.6–3.4, versions now obsolete.

License in practice: MIT license is permissive and poses no restrictions on use, modification, or distribution.

Quickstart:

pip install django-naomi

Add to Django settings:
INSTALLED_APPS += ('naomi',)
EMAIL_BACKEND = "naomi.mail.backends.naomi.NaomiBackend"
EMAIL_FILE_PATH = "/path/to/writable/dir"

EMAIL_FILE_PATH directory must be writable; compatibility with modern Django and Python versions is unverified.

Verify before relying:

- Compatibility with modern Django versions (3.x, 4.x, 5.x) and current Python releases.
- Whether the browser preview interface works with current web standards and browsers.
- Current maintainer status and whether pull requests or issues are being reviewed.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 115.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django email preview development, email backend browser testing, django debug email locally, smtp alternative development, email interception django, django-email-dev, abandoned

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