Skip to content

smouj/Noctumbra-Mail

Noctumbra-Mail

Noctumbra-Mail logo

Language License Last Commit CI Ko-fi

English Español

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

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

Contributing

Contributions are welcome. Please read CONTRIBUTING.md.

License

MIT © 2026 smouj


Other skills

Explore the full ecosystem here: smouj/smouj

Signature: @Smouj013

Releases

No releases published

Packages

 
 
 

Contributors

Languages