Noctumbra-Mail

provenance:github:smouj/Noctumbra-Mail

WHAT THIS AGENT DOES

Noctumbra-Mail is an AI agent designed for stealth email triage and autonomous response orchestration. It operates on the GitHub platform and is primarily written in Python. This agent automates email management tasks, potentially helping users achieve inbox zero. It leverages techniques like text classification and SMTP for sending responses. The agent is suitable for individuals or teams seeking to streamline their email workflow and reduce manual effort.

PROBLEM IT SOLVES

Noctumbra-Mail solves the problem of overwhelming email inboxes by automatically triaging and responding to messages. Users would benefit from this agent instead of manual processing to save time and improve efficiency in managing their email communications.

View Source ↗First seen 3mo agoNot yet hireable

CAPABILITIES & CONSTRAINTS

TECH & STACK

ai-agentpythonemail-automationimapsmtptext-classification

README

# Noctumbra-Mail

<p align="center">
  <img src="./assets/branding/logo.svg" alt="Noctumbra-Mail logo" width="88" />
</p>

![Language](https://img.shields.io/badge/language-Python%203.11%2B-blue)
![License](https://img.shields.io/github/license/smouj/Noctumbra-Mail)
![Last Commit](https://img.shields.io/github/last-commit/smouj/Noctumbra-Mail)
![CI](https://img.shields.io/github/actions/workflow/status/smouj/Noctumbra-Mail/ci.yml?branch=main)
[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20this%20project-ff5f5f?logo=ko-fi&logoColor=white)](https://ko-fi.com/smouj013_dev)

<p align="center">
  <a href="./README.md"><img src="https://img.shields.io/badge/README-English-1f6feb?style=for-the-badge" alt="English"></a>
  <a href="./README.es.md"><img src="https://img.shields.io/badge/README-Español-c92a2a?style=for-the-badge" alt="Español"></a>
</p>

**Zero-touch email orchestration with policy-safe automation.**

## Vision
Classifies, drafts, and automates repetitive email actions through local logic.

## What problem it solves
Inbox overload reduces response quality and speed.

## Core superpower
- ⚡ **Autonomous triage and draft pipelines with controlled execution**

## Key use cases
- ✅ Inbox triage
- ✅ Draft generation
- ✅ Unsubscribe automation
- ✅ Email action routing


## API surface
`POST /send`, `POST /classify`, `POST /draft`, `POST /unsubscribe`, `GET /health`

## Technical stack
- **Core stack:** FastAPI + IMAP/SMTP adapters + local NLP
- **Runtime:** local-first, self-hosted friendly
- **Infra:** Docker Compose + Caddy + Redis/Chroma/Ollama compatibility

## Current status (Feb 2026)
- ✅ Public scaffold available
- ✅ Bilingual README (EN default + ES)
- ✅ CI + release baseline configured
- 🚧 Feature hardening in progress

## Quick start
```bash
git clone https://github.com/smouj/Noctumbra-Mail.git
cd Noctumbra-Mail
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m src.noctumbra_mail.cli --help
```

## Documentation
- [Implementation Guide](./docs/IMPLEMENTATION.md)
- [Architecture](./docs/ARCHITECTURE.md)
- [Runbook](./docs/RUNBOOK.md)
- [Deployment Guide](./docs/DEPLOYMENT.md)
- [Release Process](./docs/RELEASE.md)
- [Changelog](./CHANGELOG.md)

## Contributing
Contributions are welcome. Please read [CONTRIBUTING.md](./CONTRIBUTING.md).

## License
MIT © 2026 smouj

---

### Other skills
Explore the full ecosystem here: **[smouj/smouj](https://github.com/smouj/smouj)**

**Signature:** [@Smouj013](https://x.com/smouj013)

PUBLIC HISTORY

First discoveredMar 21, 2026

IDENTITY

inferred

Identity inferred from code signals. No PROVENANCE.yml found.

Is this yours? Claim it →

METADATA

platformgithub

first seenFeb 23, 2026

last updatedFeb 24, 2026

last crawled2 months ago

version—

README BADGE

Add to your README:

![Provenance](https://getprovenance.dev/api/badge?id=provenance:github:smouj/Noctumbra-Mail)