मुख्यपृष्ठ
ai automation
Al Tools

How to Create Your Own Personal AI Email Automation Agent

Learn how to create a personal AI email automation agent using Python, Gmail API, AI, and GitHub with this complete step-by-step guide.
Krishana Gupta
Sumrize With Google Ai ChatGPT Grok Perplexity
AI Email Automation Agent GitHub project guide featured image
AI Email Automation Agent: GitHub project से Gmail automation करें

क्या आपको भी Gmail में हर दिन बार-बार एक जैसे काम करने पड़ते हैं? जैसे कि same type के emails को पढ़ना, उनका जवाब देना, या फिर कुछ emails को archive या delete करना। अगर हाँ, तो यह AI Email Automation Agent project आपके काम आ सकता है।

इस article में हम एक interesting GitHub project के बारे में बात करेंगे, जो AI की मदद से Gmail के कई कामों को automate करता है। यह project Python, Flask, और Google Gmail API का उपयोग करके बनाया गया है। आइए इसे विस्तार से समझते हैं।

AI Email Automation Agent क्या है?

यह एक enterprise-grade AI-powered Gmail automation platform है। इसे Python (Flask framework) में develop किया गया है और यह SQLite database, Google Gmail API, Google OAuth 2.0, और OpenRouter AI का उपयोग करता है।

सीधे शब्दों में कहें तो, यह एक ऐसा tool है जो AI की मदद से आपके Gmail account के साथ interact कर सकता है। आप इसे natural language commands दे सकते हैं, जैसे कि "मुझे कल आए सभी emails दिखाओ" या "इस email का reply तैयार करो"। यह system आपके commands को समझता है और उन्हें execute करता है।

इस project को खास तौर पर cPanel shared hosting और VPS environments पर deploy करने के लिए design किया गया है। यानी अगर आपके पास cPanel hosting है, तो आप इसे आसानी से वहाँ पर चला सकते हैं।

इस Project के साथ आप क्या कर सकते हैं?

GitHub repository में दी गई जानकारी के अनुसार, इस project का उपयोग करके आप निम्न काम कर सकते हैं:

  • AI Assistant Chat: आप natural language में commands दे सकते हैं। AI आपके emails को search, analyze, draft, reply, और organize कर सकता है।
  • Email Management: Gmail API के through आप emails को पढ़ सकते हैं, drafts create कर सकते हैं, emails send कर सकते हैं, archive, label, या trash में डाल सकते हैं।
  • Automation Workflows: आप visual automation builder का उपयोग करके rules बना सकते हैं। जैसे कि अगर किसी specific sender से email आता है, तो AI उसका reply तैयार करे।
  • Multi-Provider AI Support: यह OpenRouter, OpenAI, Google Gemini, Groq, DeepSeek, और custom OpenAI-compatible endpoints को support करता है।

Key Features

इस project की कुछ प्रमुख features को समझते हैं:

1. Controlled AI Assistant Chat

AI assistant के साथ आप natural language में बात कर सकते हैं। यह multi-turn conversation को maintain करता है, यानी आप बातचीत के दौरान previous context को भी use कर सकते हैं। सबसे महत्वपूर्ण बात यह है कि इसमें Safe Risk Gate लगा है। Low-risk operations जैसे search, read, report आदि automatic हो जाती हैं, लेकिन high-risk actions जैसे email send करना, delete करना, या workflows modify करने के लिए आपकी explicit confirmation ली जाती है।

2. Google Gmail API Integration

यह project official Google Gmail API का उपयोग करता है। OAuth 2.0 authentication के through आप अपना Gmail account connect कर सकते हैं। Tokens को encrypted storage में रखा जाता है। API की मदद से आप emails को search, read, draft create, send, reply (with proper email headers), archive, label, और trash कर सकते हैं।

3. Multi-Provider AI Router with Fallback Chain

यह system सिर्फ एक AI provider पर निर्भर नहीं है। यह OpenRouter के through multiple AI models को support करता है। अगर primary model काम नहीं करता, तो यह automatically fallback model, फिर secondary provider, और अंत में safe pause & alert पर चला जाता है। यानी आपका system कभी बीच में नहीं रुकेगा।

4. Behavioral Training & Knowledge Base

आप AI को custom tone rules, financial/refund constraints, और conciseness limits के साथ train कर सकते हैं। FAQ और company knowledge base articles को automatically AI prompts में inject किया जा सकता है।

5. Visual Automation Builder & Workflow Engine

इसमें एक multi-condition evaluator है जो sender, domain, subject keywords, AI intent classification, और attachment के आधार पर conditions evaluate करता है। इसके अलावा 3-Tier Safety Levels हैं:

  • Level 1 (Draft Only): AI reply तैयार करता है और Gmail draft के रूप में save करता है।
  • Level 2 (Approval Required): Response तैयार करता है और dashboard पर approval card बनाता है।
  • Level 3 (Trusted Automation): अगर AI confidence threshold से ज़्यादा है, तो auto-send कर देता है।

6. Enterprise Security & cPanel Ready

इसमें bootstrap credentials (admin / admin123) हैं, लेकिन first login पर password change करना mandatory है। Passwords को cryptographically hashed किया जाता है (scrypt / pbkdf2)। Sensitive tokens को AES/Fernet के through encrypt किया जाता है।

Technologies Used

GitHub repository में दी गई जानकारी के अनुसार, इस project में निम्न technologies का उपयोग किया गया है:

Technology Purpose
Python Programming Language
Flask Web Framework
SQLite Database
Google Gmail API Gmail Integration
Google OAuth 2.0 Authentication
OpenRouter AI AI Model Router
Material Design 3 User Interface
cPanel / Phusion Passenger Deployment

यह Project कैसे काम करता है?

इस project का workflow कुछ इस तरह से काम करता है:

  1. User अपने Gmail account को OAuth 2.0 के through authenticate करता है।
  2. User AI assistant chat में natural language command देता है, जैसे "कल आए सभी emails search करो"।
  3. AI command को process करता है। अगर यह low-risk operation है (जैसे search, read), तो यह directly execute हो जाता है।
  4. अगर high-risk action है (जैसे email send करना), तो system user से visual confirmation मांगता है।
  5. Automation workflows के लिए, user visual builder में rules define करता है। System नियमित रूप से (cPanel Cron के through) नए emails को check करता है और rules के अनुसार action लेता है।

Requirements

GitHub repository के अनुसार, इस project को चलाने के लिए निम्न requirements हैं:

  • Python 3.10 या उससे higher version
  • pip और virtualenv (Python package managers)
  • Google Account (Gmail API के लिए)
  • Google Cloud Console में project create करना और Gmail API enable करना
  • OpenRouter API Key (AI features के लिए)
  • cPanel hosting (अगर production deployment के लिए)
  • Environment variables की configuration

How to Install the Project

GitHub repository में installation के लिए दो options दिए गए हैं।

Option A: Python Package के रूप में Install करें (Recommended)

सबसे पहले, Official GitHub Repository को open करें और project को clone या download करें।

git clone https://github.com/YouBTech01/AI-Email-Automation-Agent.git
cd AI-Email-Automation-Agent

फिर virtual environment create और activate करें:

python -m venv venv
# Windows पर:
.\venv\Scripts\activate
# Linux/macOS पर:
source venv/bin/activate

अब package को editable mode में install करें:

pip install -e .

Option B: Standard Dependency Installation

अगर आप package के रूप में install नहीं करना चाहते, तो सीधे requirements install करें:

pip install -r requirements.txt

How to Configure the Project

Installation के बाद configuration करना होता है।

Step 1: Environment Variables Setup

.env.example file को .env में copy करें:

# Windows पर:
copy .env.example .env
# Linux/macOS पर:
cp .env.example .env

Step 2: Environment Variables भरें

.env file में निम्न variables को set करें:

  • SECRET_KEY: अपनी secret key डालें
  • GOOGLE_CLIENT_ID: Google Cloud Console से प्राप्त Client ID
  • GOOGLE_CLIENT_SECRET: Google Cloud Console से प्राप्त Client Secret
  • OPENROUTER_API_KEY: OpenRouter से प्राप्त API Key

Step 3: Google Cloud OAuth Configuration

Google Cloud Console में जाएँ:

  1. New project create करें (जैसे AI Email Agent)
  2. Gmail API enable करें
  3. OAuth Consent Screen configure करें
    • User Type: External (या Internal अगर Google Workspace है)
    • Scopes: https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/gmail.compose, openid, email, profile
  4. Credentials create करें
    • Type: OAuth 2.0 Client ID
    • Application Type: Web application
    • Authorized redirect URIs: http://127.0.0.1:5000/gmail/oauth2callback (local) या https://yourdomain.com/gmail/oauth2callback (production)
  5. Client ID और Client Secret copy करके .env में डालें

Note: अपनी API keys, OAuth secrets, और passwords को कभी publicly share न करें।

How to Use the Project

Configuration के बाद, project को use करने का तरीका:

  1. Application Start करें:

    ai-email-agent

    या सीधे Python से:

    python app.py

  2. Browser में Open करें:

    http://127.0.0.1:5000 पर जाएँ।

  3. Login करें:

    • Username: admin
    • Password: admin123

    First login पर system आपको एक strong password set करने के लिए prompt करेगा।

  4. Gmail Account Connect करें:

    Settings → Gmail & OAuth में जाकर Connect Gmail Account पर click करें।

  5. AI Assistant Use करें:

    Chat interface में natural language commands दें।

  6. Automation Workflows Create करें:

    Visual Automation Builder का उपयोग करके rules define करें।

Project Folder Structure

Repository में निम्न important folders और files हैं:

AI-Email-Automation-Agent/
├── ai/                    # AI related modules
├── auth/                  # Authentication modules
├── automation/            # Automation workflow engine
├── chat/                  # Chat interface
├── config/                # Configuration files
├── cron/                  # Cron job scripts
├── database/              # Database models and helpers
├── gmail/                 # Gmail API integration
├── reports/               # Reporting modules
├── routes/                # Flask routes
├── static/                # Static files (CSS, JS, images)
├── storage/                # Encrypted storage
├── templates/             # HTML templates
├── tests/                 # Test files
├── .env.example           # Environment variables example
├── app.py                 # Main application entry point
├── passenger_wsgi.py      # cPanel Passenger WSGI entry point
├── pyproject.toml         # Project configuration
├── requirements.txt       # Python dependencies
└── README.md              # Project documentation

Advantages

इस project के कुछ genuine benefits:

  • Open Source: Source code publicly available on GitHub, आप इसे अपनी आवश्यकता के अनुसार modify कर सकते हैं।
  • Multi-Provider AI Support: सिर्फ एक AI provider पर निर्भर नहीं, fallback chain के साथ कई providers को support करता है।
  • Enterprise Security: Passwords hashed, tokens encrypted, और high-risk actions पर confirmation लेना mandatory है।
  • cPanel Ready: Shared hosting पर deploy करने के लिए specially designed है।
  • Visual Automation Builder: बिना code लिखे automation rules बना सकते हैं।
  • Duplicate Guard: किसी email पर duplicate action होने से बचाता है।

Limitations

किसी भी project की तरह, इसके भी कुछ limitations और considerations हैं:

  • Technical Knowledge Required: इसे setup करने के लिए Python, command line, और API configuration की basic समझ होनी चाहिए।
  • Google Cloud Console Setup: Gmail API enable करने और OAuth credentials बनाने के लिए Google Cloud Console का उपयोग करना होता है।
  • OpenRouter API Key: AI features के लिए OpenRouter API key की आवश्यकता है।
  • Hosting Dependency: cPanel shared hosting के लिए design किया गया है, हालाँकि standalone VPS पर भी चल सकता है।
  • Database: SQLite का उपयोग किया गया है, जो small to medium scale के लिए ठीक है, लेकिन बहुत बड़े deployments के लिए आपको दूसरे database पर migrate करना पड़ सकता है।
  • Production Deployment: Production में deploy करने से पहले आपको security best practices का पालन करना चाहिए और default credentials बदलने चाहिए।

क्या यह Beginner Friendly है?

इस project को beginner-friendly कहना थोड़ा मुश्किल है। अगर आपको Python, command line, और API configuration की basic जानकारी है, तो आप इसे setup कर सकते हैं। Repository में detailed instructions दी गई हैं।

हालाँकि, अगर आप complete beginner हैं और coding या server management का experience नहीं है, तो आपको थोड़ी मुश्किल हो सकती है। खासकर Google Cloud Console में OAuth setup करना और cPanel पर deploy करना थोड़ा technical हो सकता है।

एक अच्छी बात यह है कि repository में step-by-step instructions दी गई हैं, और passenger_wsgi.py file भी दी गई है जो cPanel deployment को आसान बनाती है।

इस Project का उपयोग किसे करना चाहिए?

यह project निम्न users के लिए उपयोगी हो सकता है:

  • Small Business Owners: जो daily आने वाले customer emails को automate करना चाहते हैं।
  • Freelancers और Consultants: जो अपने email management को streamline करना चाहते हैं।
  • Developers: जो AI और email automation में interest रखते हैं और open source project को explore करना चाहते हैं।
  • System Administrators: जो cPanel hosting पर Python applications deploy करना चाहते हैं।
  • Tech Enthusiasts: जो नए AI tools और automation techniques सीखना चाहते हैं।

GitHub Source Code

इस project का पूरा source code GitHub पर उपलब्ध है। आप इसे नीचे दिए गए link पर जाकर देख सकते हैं, clone कर सकते हैं, और अपनी आवश्यकता के अनुसार modify कर सकते हैं।

👉 Official GitHub Repository

आप View the Source Code on GitHub पर जाकर project files, commits, और issues को भी देख सकते हैं।

Frequently Asked Questions

1. AI Email Automation Agent क्या है?
यह एक open source GitHub project है जो AI की मदद से Gmail के कई कामों को automate करता है।

2. क्या यह project completely free है?
Repository में Enterprise MIT License दी गई है। हालाँकि, commercial use से पहले license terms को ध्यान से पढ़ लें।

3. इस project को चलाने के लिए किन technologies की आवश्यकता है?
Python 3.10+, Flask, SQLite, Google Gmail API, Google OAuth 2.0, और OpenRouter AI।

4. क्या मैं इस project को अपनी cPanel hosting पर deploy कर सकता हूँ?
हाँ, यह project खास तौर पर cPanel shared hosting (Phusion Passenger) के लिए design किया गया है।

5. क्या इस project में AI model को change किया जा सकता है?
हाँ, यह OpenRouter, OpenAI, Google Gemini, Groq, DeepSeek, और custom OpenAI-compatible endpoints को support करता है।

6. क्या यह project safe है?
Repository में security architecture का विवरण दिया गया है। Passwords hashed हैं, tokens encrypted हैं, और high-risk actions पर confirmation लेना mandatory है। फिर भी, production में use करने से पहले security best practices का पालन करें।

7. क्या मुझे OpenRouter API key की आवश्यकता होगी?
हाँ, AI features का उपयोग करने के लिए OpenRouter API key की आवश्यकता है।

8. क्या इस project में कोई demo available है?
Repository में demo URL का उल्लेख नहीं है। आप local system पर install करके इसे test कर सकते हैं।

9. क्या यह project G Suite / Google Workspace account के साथ काम करता है?
हाँ, OAuth Consent Screen में Internal user type select करके Google Workspace account के साथ भी use किया जा सकता है।

10. क्या इस project में email scheduling feature है?
Repository में email scheduling की कोई विशेष feature का उल्लेख नहीं है। Automation workflows के through आप rules define कर सकते हैं।

Final Verdict

AI Email Automation Agent एक powerful और enterprise-grade open source project है। यह AI और Gmail API के combination से email management को automate करने का एक बढ़िया तरीका प्रदान करता है।

क्या यह project अच्छा है?
हाँ, अगर आपको email automation की आवश्यकता है और आपके पास basic technical knowledge है, तो यह project आपके लिए उपयोगी हो सकता है।

किसे इस project का उपयोग करना चाहिए?
Small business owners, freelancers, developers, और tech enthusiasts जो AI और automation में interest रखते हैं।

क्या ध्यान रखना चाहिए?

  • Setup करने से पहले repository में दी गई instructions को ध्यान से पढ़ें।
  • Default credentials (admin/admin123) को तुरंत change करें।
  • API keys और secrets को कभी publicly share न करें।
  • Production में use करने से पहले security best practices का पालन करें।

कुल मिलाकर, यह एक solid project है जो AI-powered email automation को accessible बनाता है। अगर आप इसे setup करने में सक्षम हैं, तो यह आपका बहुत समय बचा सकता है।

अगर आप बिना coding के AI की मदद से चीज़ें बनाना पसंद करते हैं, तो हमारी यह guide भी ज़रूर पढ़ें: फ्री में AI से Website कैसे बनाएं? (कोडिंग की ज़रूरत नहीं!)

एक टिप्पणी भेजें