Skip to content

hemchdev/TempMailApp

Repository files navigation

TempMailApp

A temporary email service built with TypeScript, allowing users to generate disposable email addresses for privacy and convenience. TempMailApp can receive emails, manage inboxes, and automatically summarize incoming emails using Google Gemini AI.


Features

  • Generate disposable email addresses instantly for any use-case.
  • Receive and read emails in real-time to your temporary inbox.
  • AI-powered email summaries: Each email is summarized using the Gemini API, making it easy to scan messages quickly.
  • Delete or expire email addresses securely after use.
  • Clean, modern, and intuitive user interface.
  • Built with TypeScript for reliability and scalability.

Getting Started

Prerequisites

Installation

  1. Clone the repository

    git clone https://github.com/hemchdev/TempMailApp.git
    cd TempMailApp
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Create .env file

    Copy the .env.example file and update the required environment variables:

    cp .env.example .env

    Then edit .env and add your Gemini API key:

    GEMINI_API_KEY=your_gemini_api_key_here
    

    Note: The Gemini API key is required for the AI Summary feature to work.


Running the Application

  • Development mode:

    npm run dev
    # or
    yarn dev
  • Production build:

    npm run build
    npm start
    # or
    yarn build
    yarn start

AI Summary Feature

Whenever a new email arrives in your temporary inbox, TempMailApp uses the Gemini API to generate a quick, readable summary of the message. This helps you scan your inbox faster and understand the content at a glance.

  • The summary is displayed alongside the full email.
  • Requires a valid GEMINI_API_KEY in your .env file.

Acknowledgements

  • Inspired by open-source temporary mail services
  • AI summaries powered by Google Gemini API

Disclaimer: This application is intended for educational and personal use. Do not use it for unlawful activities.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages