aegis-mail-companion 1.0.17

aegis Mail Companion (aegis-mail-companion) — Autonomous AI Email & Tiered L1/L2 Support Bot

Part of the aegis-ai-suite Ecosystem — Multi-Agent · Multi-Provider (Outlook, Gmail, Zoho, IMAP) · Human-Governed · Jira-Correlated · Installable PWA

Aegis Mail Companion is an autonomous, self-hosted AI Email Companion and Tiered L1/L2 Customer & Engineering Support Bot. Connect Microsoft Outlook / Office 365, Google Gmail, Zoho Mail, or any Standard IMAP/SMTP server, configure Cloud or 100% Local LLMs (Ollama, vLLM, OpenAI, Anthropic, Gemini, Groq), and orchestrate 7 specialized Email AI Agents and 6 Email Skills in a single self-contained Python package.

⚡ 30-Second Quick Install & Immediate Browser Launch (macOS · Windows · Linux)

Installing aegis-mail-companion installs all required backend dependencies, the pre-built React + PWA web interface, the 7 Email Agents, and the 6 Email Skills in a single command. Run aegis-mail and it immediately launches in your browser:

# 1. Install the universal Python package from PyPI
pip install aegis-mail-companion

# 2. Configure your PostgreSQL + pgvector database URL (auto-creates database, extensions & all tables on startup)
export EXPORT_AEGIS_EMAIL_COMPANION_DB="postgresql://postgres:password@localhost:5432/aegis_mail_companion"

# 3. Launch the server & immediately open Mail Companion in your browser (http://localhost:8020)
aegis-mail
# (or `python3 -m aegis_mail_companion`)

Automatic Database & Vector RAG Provisioning: When EXPORT_AEGIS_EMAIL_COMPANION_DB (or --db-url) is set, the first service startup automatically creates the target database (if missing), enables vector (pgvector) + pg_trgm + pgcrypto extensions, applies all database tables/functions/indexes (kb_files, kb_parents, kb_chunks, projects, connectors, email_accounts, etc.), and saves the connection URL to ~/.aegis-mail-companion/settings.json.

Default Sign-In Credentials (Local Workspace)

• URL: http://localhost:8020 (opens automatically in your default browser; click Install App in the top bar to install as a standalone Desktop/Mobile PWA)
• Email: admin@example.com
• Password: admin1234

CLI Options (aegis-mail / aegis-mail-companion)

aegis-mail                                 # Start Mail Companion (:8020) & open browser immediately
aegis-mail --port 8080                     # Run on a custom port (e.g. http://localhost:8080)
aegis-mail --host 0.0.0.0 --port 8020      # Expose on LAN for team access
aegis-mail --no-browser                    # Run server headlessly without opening a browser tab
aegis-mail --update                        # Self-update to the latest release from PyPI via pip

✨ Key Features & Architecture

1. 📬 Multi-Provider Email Connectivity (With Built-in Step-by-Step Visual Setup Guides)

Every provider card includes an interactive ? Help button that opens a right-side step-by-step setup drawer with annotated screenshots and 1-click server presets:

• Microsoft Outlook / Office 365: OAuth 2.0 Web Redirect, Device Code flow, and Sovereign Cloud support (graph.microsoft.com, US Gov, 21Vianet) via Microsoft Graph API.
• Google Gmail: Google Workspace & personal Gmail via 16-digit App Password (imap.gmail.com:993 / smtp.gmail.com:587) or Google Cloud OAuth 2.0.
• Zoho Mail: Zoho OAuth 2.0 or Application-Specific Password across all regional data centers (imap.zoho.com, imappro.zoho.com, .eu, .in, .com.au, .jp).
• Standard Mail (IMAP/SMTP): 1-click presets and visual guides for cPanel / Corporate Mail, Apple iCloud Mail, Yahoo Mail, Fastmail, Namecheap PrivateEmail, Rackspace, and GoDaddy / Titan Mail.
• AES-256 / Fernet Encrypted Token Vault: All OAuth refresh tokens and IMAP/SMTP App Passwords are encrypted at rest.

2. 🤖 7 Specialized Email AI Agents (AI Agents Screen)

3. 🧠 6 Specialized Email Skills (Skills Library Screen)

1. Email Thread Digest & Delta Extraction (email_thread_digest)
2. Customer Sentiment, Urgency & L1/L2 Triage Routing (email_sentiment_triage)
3. L1 General Customer Support & FAQ Resolution (email_l1_faq_resolution)
4. L2 Technical Support, Log & Stack-Trace Diagnostics (email_l2_technical_diagnostics)
5. Jira & Project Ticket Correlation for Incoming Emails (email_jira_ticket_correlation)
6. Support Response QA, Tone Alignment & Policy Guardrails (email_response_qa_guardrails)

4. 🖥️ Installable Progressive Web App (PWA)

• Includes a Web App Manifest (manifest.webmanifest) and offline-capable Service Worker (sw.js).
• Click Install App in the top navigation bar on Chrome, Edge, Brave, or Safari (Add to Dock / Add to Home Screen) to run Mail Companion in its own standalone desktop or mobile window with quick-launch shortcuts to Email Config, AI Models, AI Agents, and Skills Library.

🔗 Ecosystem & Links

• Official Documentation & Setup Portal: https://aegis-mail-companion.vercel.app
• PyPI Author Profile: https://pypi.org/user/sachinbosep/
• Full Enterprise Suite (aegis-ai-suite): https://pypi.org/project/aegis-ai-suite/
• Official Aegis Portal: https://aegis-help.nilswa.com