# Aegis Mail Companion (`aegis-mail-companion`)

> Autonomous AI Email Companion & Tiered L1/L2 Support Bot for Microsoft 365 / Outlook, Google Gmail, Zoho Mail, and Universal IMAP/SMTP. Published as an official Python package on PyPI (`pip install aegis-mail-companion`).

- **Official Portal:** https://aegis-mail-companion.nilswa.com/
- **PyPI Package:** https://pypi.org/project/aegis-mail-companion/
- **Current Version:** 1.0.31
- **Python CLI Entrypoints:** `aegis-mail` and `aegis-mail-companion`
- **Default Local Web UI:** `http://localhost:8020`
- **Author:** Sachin Bose Pulikkathara (https://pypi.org/user/sachinbosep/)
- **License:** Apache-2.0 / Commercial-Friendly Open License

## Quick Start (Python / pip)

```bash
pip install -U aegis-mail-companion
aegis-mail
```

## Core Capabilities

- **5-Stage Deterministic L1/L2 Email Support Pipeline:**
  1. Stage 1 — Intake & Sentiment Triage (`email-triage-classifier`)
  2. Stage 2 — Knowledge Base & SOP RAG Retrieval (`kb-sop-retriever`)
  3. Stage 3 — Autonomous L1 Auto-Resolution or Escalation (`l1-resolution-drafter`)
  4. Stage 4 — L2 Engineering Root-Cause & Jira Ticket Bot (`l2-jira-escalation-agent`)
  5. Stage 5 — Executive SLA & Audit Digest (`sla-compliance-auditor`)
- **20 Specialized Email AI Agents & 19 Reusable Email Skills:** Ready to test, customize, or chain via `/agents`.
- **Universal Email Connectivity:** Connect Microsoft 365 / Outlook, Google Gmail, Zoho Mail, or any standard IMAP/SMTP server in Standalone Mode or Project + Knowledge Base Mode.
- **1-Click Cloud Deployment Hub:** Built-in deployment blueprints and live verification for Vercel, Render, Railway, Fly.io, Google Cloud Run, and AWS App Runner.

## Documentation & Portal Sitemap

- [Overview & Architecture](https://aegis-mail-companion.nilswa.com/): Complete overview of the 5-stage L1/L2 pipeline, 20 Email AI Agents, and multi-provider inbox architecture.
- [Python Download, Setup & Live PyPI Telemetry](https://aegis-mail-companion.nilswa.com/download): Step-by-step `pip install aegis-mail-companion` guide, CLI flags, environment variables, and real-time ClickHouse PyPI download analytics.
- [1-Click Cloud Deployment Hub](https://aegis-mail-companion.nilswa.com/cloud-deploy): Deploy Aegis Mail Companion to Vercel, Render, Railway, Fly.io, Docker, or Cloud Run.
- [Email Provider Configuration Guides](https://aegis-mail-companion.nilswa.com/providers): App Password and OAuth2 setup for Microsoft Outlook / 365, Google Gmail, Zoho Mail, and custom IMAP/SMTP.
- [20 Email AI Agents & 19 Skills Library](https://aegis-mail-companion.nilswa.com/agents): Full catalog of pre-built Email AI Agents and deterministic skills.
- [Documentation Manual & API Reference](https://aegis-mail-companion.nilswa.com/docs): Detailed operational manual, security vault architecture, and troubleshooting guide.
- [Full Context for LLMs (llms-full.txt)](https://aegis-mail-companion.nilswa.com/llms-full.txt): Extended technical specification, CLI flags, and agent definitions for AI agents.