@realtimex/email-automator

AI Email Automator - RealTimeX Local App

A private, agentic email management application designed specifically for the RealTimeX ecosystem. Automate your inbox with local AI, categorize communications, and generate smart drafts while maintaining 100% data sovereignty.

🚀 Vision: "Own Your Inbox"

Email Automator is a dedicated Local App for RealTimeX Desktop. It follows the Own Your Data philosophy by turning your email into a managed task list powered by your own infrastructure:

• RealTimeX Integration: Seamlessly connects with RealTimeX Desktop for LLM and TTS services.
• Zero Cloud Costs: Runs entirely on your own Supabase instance and local machine.
• Privacy First: Your emails are processed locally; no third-party data mining.
• Agentic Intelligence: A context-aware assistant that suggests "Winning Responses".

✨ Features

Core Capabilities

• Smart Categorization: AI classifies emails (Spam, Newsletter, Support, Client, etc.)
• Inbox Zero Engine: Auto-trash spam and archive newsletters
• Winning Responses: AI-generated draft replies for important emails
• Multi-Provider: Gmail (OAuth2) and Microsoft 365 (Device Flow)
• Automation Rules: Custom rules for auto-pilot email handling
• Real-time Sync: Live updates via Supabase subscriptions
• Background Scheduler: Automatic periodic email sync

Production Features

• Security: JWT auth, token encryption, rate limiting, input validation
• Hybrid Architecture: Edge Functions (serverless) + Local App (privacy)
• State Management: React Context with centralized app state
• Error Handling: Error boundaries, toast notifications, logging
• Analytics Dashboard: Email stats, category breakdown, sync history
• RealTimeX Integration: Works with RealTimeX Desktop as Local App

🛠 Tech Stack

Layer	Technologies
Frontend	React 19, Vite 7, TailwindCSS 4, Lucide Icons
Edge Functions	Deno, Supabase Functions (OAuth, DB proxy)
Local API	Node.js, Express 5, TypeScript (Sync, AI)
AI	OpenAI / Instructor-JS (supports Ollama, LM Studio)
Database	Supabase (PostgreSQL) with RLS
Testing	Vitest, Testing Library

🏁 Getting Started

Email Automator uses the "Bring Your Own Key" (BYOK) model, ensuring your data remains under your control within your own Supabase infrastructure.

Prerequisites

• RealTimeX Desktop: Installed and running. Required for AI processing (LLMs) and Text-to-Speech (TTS).
• Supabase Account: A free or paid account at supabase.com.

🚀 Quick Setup with the Wizard

The built-in Setup Wizard is the recommended way to get started. It automates the technical heavy lifting.

• Purchase & Launch: Open RealTimeX Desktop → Marketplace → Search for "Email Automator" and click Launch.
• Run the Setup Wizard: Choose Managed Provisioning and provide a Supabase Access Token. The wizard will automatically create your project, run migrations, and deploy Edge Functions.
• Create Your Account: Once ready, create your local user account and sign in to access the Dashboard.

For more detailed guides, visit the Documentation Hub.

🛠 Tech Stack

Layer	Technologies
Frontend	React 19, Vite 7, TailwindCSS 4, Lucide Icons
Edge Functions	Deno, Supabase Functions (OAuth, DB proxy)
Local API	Node.js, Express 5, TypeScript (Sync, AI)
AI Services	Powered by RealTimeX Desktop (Ollama, LM Studio, OpenAI, Anthropic)
Database	Supabase (PostgreSQL) with RLS

📂 Project Structure

├── api/                       # Local App (Express)
│   ├── server.ts              # Express entry point
│   └── src/
│       ├── services/          # Email sync, AI processing
├── docs/                      # Documentation (Multi-language)
├── src/                       # Frontend (React)
├── supabase/                  # Supabase Configuration
│   ├── functions/             # Edge Functions (OAuth, DB)
│   └── migrations/            # Database schema

🧪 Development & Testing

If you are a developer looking to contribute or run from source:

# Install dependencies
npm install

# Terminal 1: Local API (Default port: 3004)
npm run dev:api

# Terminal 2: Frontend
npm run dev

# Run Tests
npm run test:run

Note: Email Automator uses port 3004 by default to avoid conflicts with RealTimeX Desktop (ports 3001/3002).

📦 NPX Commands (Advanced)

Command	Description
npx @realtimex/email-automator	Start the Email Automator API server
npx @realtimex/email-automator-setup	Interactive setup wizard
npx @realtimex/email-automator-deploy	Deploy Edge Functions to Supabase

📄 License

MIT License - Copyright (c) 2026 RealTimeX Team