Atomic Mail Agentic

                          

Atomic Mail Agentic

अपने एजेंट को एक वास्तविक इनबॉक्स दें

डैशबोर्ड · वेबसाइट · दस्तावेज़ · मुद्दे

---

खाते निःशुल्क हैं, 100 MB संग्रहण कोटा, कस्टम डोमेन शामिल, और एजेंट वर्कलोड के लिए उपयुक्त दर सीमाएँ।

---

Atomic Mail Agentic स्वायत्त AI एजेंटों के लिए एक ईमेल प्रदाता है, जिसे Atomic Mail द्वारा बनाया गया है। एजेंट अपना स्वयं का @atomicmail.ai इनबॉक्स पंजीकृत करते हैं और इसे अंत से अंत तक प्रबंधित करते हैं — कोई मानव सेटअप, सत्यापन, या निरंतर हस्तक्षेप नहीं।

सेवा JMAP (RFC 8620) पर आधारित है, इसलिए एजेंटों को एक पूर्ण मेलबॉक्स API मिलता है: मेल पढ़ें और भेजें, ड्राफ्ट बनाएं, थ्रेड प्रबंधित करें, खोजें, और बहुत कुछ। JMAP LLM प्रशिक्षण डेटा में अच्छी तरह से प्रस्तुत है, इसलिए मॉडल पहले से ही इसे धाराप्रवाह बोलते हैं — वे शायद ही कभी अनुरोध आकारों को गलत समझते हैं, जिसका अर्थ है कम पुनः प्रयास और अधिक विश्वसनीय स्वचालन।

पहुँच एक नवीन प्रूफ-ऑफ-वर्क (PoW) साइनअप प्रोटोकॉल द्वारा नियंत्रित है: CAPTCHA या मैन्युअल अनुमोदन के बिना मजबूत एंटी-दुरुपयोग गुण, इसलिए एजेंट पूरी तरह से हाथों-मुक्त ऑनबोर्ड और संचालन कर सकते हैं।

Atomic Mail कई मानक एकीकरण पथ प्रदान करता है — MCP, AgentSkill, REST API, और अधिक — जो इसे किसी भी एजेंट पर अत्यधिक उपलब्ध बनाता है: Claude Code, Codex, GitHub Copilot, Cursor, Hermes, OpenClaw, Pi, Kilo Code, और अन्य। आपका वर्कफ़्लो जो भी हो, आप आसानी से इनबॉक्स प्रबंधन स्वचालित कर सकते हैं।

यह रिपॉजिटरी क्लाइंट एकीकरण भेजती है: MCP, शेल CLI, ClawHub, Dify प्लगइन और अधिक, उन API को तीन टूल के माध्यम से उजागर करते हुए: register, jmap_request, और help। इस रिपो में सभी कनेक्टर काफी पतले हैं और मुख्य रूप से PoW प्रोटोकॉल की जटिलताओं को दूर करने के लिए आवश्यक हैं।

🚀 त्वरित स्थापना

💬 तैयार प्रॉम्प्ट (कोई भी एजेंट)

Read the instruction at https://atomicmail.ai (use default web_fetch tool or curl, if the former is not available) and create an inbox at Atomic Mail. Before creating ask for my preferred username. Make sure to complete all required post-install actions from the Atomic Mail instruction. Persist the instruction and make sure to refer it each time you interact with your inboxes. Usually standalone agents (e.g. Claude, Cursor, Kilo Code and others) are better suited for MCP use, while CLI-based agents (e.g. Claude Code, Open Code, Hermes, OpenClaw, Codex, Pi, etc) are better suited for AgentSkill use, but prefer your system/user guidelines.

🔌 MCP (stdio)

इसे अपने MCP होस्ट कॉन्फ़िग में जोड़ें (या बस अपने एजेंट से ऐसा करने के लिए कहें):

{
  "mcpServers": {
    "atomicmail": {
      "command": "npx",
      "args": ["-y", "@atomicmail/mcp-github"]
    }
  }
}

फिर होस्ट को पुनः आरंभ करें और अपने एजेंट से एक इनबॉक्स बनाने के लिए कहें।

🦞 ClawHub

openclaw skills install atomicmail

👩🏻 Hermes

hermes skills install clawhub/atomicmail

💻 AgentSkill

npx --package=@atomicmail/agent-skill-github atomicmail register --username "myagent" --watch scheduled
npx --package=@atomicmail/agent-skill-github atomicmail jmap_request --ops-file list_inbox.json
npx --package=@atomicmail/agent-skill-github atomicmail help

⚙️ REST API

केवल कस्टम कनेक्टर और उन्नत तर्क के लिए

दस्तावेज़ देखें: docs/rest-auth.md।

🌐 कस्टम डोमेन और डैशबोर्ड

डिफ़ॉल्ट रूप से एक इनबॉक्स <name>@atomicmail.ai पर रहता है, जो PoW साइनअप के माध्यम से हाथों-मुक्त बनाया गया है। अपने स्वयं के डोमेन (support@yourcompany.com) से भेजने के लिए, इसे डैशबोर्ड में एक बार सेट करें — एजेंट प्रवाह से अलग एक मानव नियंत्रण तल, क्योंकि इसके लिए आपके स्वामित्व वाले डोमेन पर DNS परिवर्तन की आवश्यकता होती है।

वहाँ आप एक डोमेन जोड़ते और सत्यापित करते हैं (TXT स्वामित्व + MX रिकॉर्ड; पुनः चलाने योग्य, प्रसार आमतौर पर मिनटों में) और उस पर इनबॉक्स बनाते हैं — प्रत्येक को एक पूर्ण पता (agent@yourcompany.com) और Connect संवाद से एक API कुंजी मिलती है, जिसमें डोमेन-संरेखित From के लिए भेजना हस्ताक्षरित होता है।

क्लाइंट नहीं बदलते — समान jmap_request, प्रीसेट, और JMAP आकार। एक कस्टम-डोमेन इनबॉक्स एक लॉगिन है, PoW पंजीकरण नहीं: इसकी API कुंजी (atomicmail register --api-key "…") या OAuth से कनेक्ट करें। $INBOX वास्तविक पते (agent@yourcompany.com) पर हल होता है, इसलिए स्व-संबोधन और From बिना अतिरिक्त कॉन्फ़िग के सही रहते हैं।

पूर्ण मार्गदर्शिका: docs/custom-domains.md।

🤖 आपका एजेंट क्या कर सकता है

Atomic Mail को एक एजेंट के माध्यम से चलाने के लिए डिज़ाइन किया गया है — मैन्युअल इनबॉक्स सेटअप के माध्यम से नहीं। आप सादे भाषा में एक वर्कफ़्लो का वर्णन करते हैं; एजेंट एक @atomicmail.ai पता पंजीकृत करता है, मेल भेजता और प्राप्त करता है, और थ्रेड जारी रखता है। आप स्क्रिप्ट कॉन्फ़िगर नहीं करते, टैब के बीच API कुंजी कॉपी नहीं करते, या JMAP याद नहीं करते। सब कुछ स्वचालित है।

यदि एजेंट फंस जाता है, तो एकीकरण अपने आप ठीक होने के लिए बनाया गया है: help एम्बेडेड दस्तावेज़ (प्रीसेट, क्रॉन, समस्या निवारण) भेजता है, बंडल किए गए JSON प्रीसेट सामान्य संचालन को कवर करते हैं, और त्रुटियों में आगे क्या प्रयास करना है इसके संकेत शामिल होते हैं।

उदाहरण वर्कफ़्लो

न्यूज़लेटर डाइजेस्ट — "अपने इनबॉक्स को इन न्यूज़लेटर्स की सदस्यता दें, सब कुछ पढ़ें, और मुझे AI टूलिंग के लिए महत्वपूर्ण चीज़ों का दैनिक डाइजेस्ट ईमेल करें।" एजेंट एक समर्पित इनबॉक्स का मालिक है, शोर को फ़िल्टर करता है, और केवल वही सतह पर लाता है जो आपकी रुचियों से मेल खाता है — आपके व्यक्तिगत मेलबॉक्स को छुए बिना।

सहायता इनबॉक्स — "support@ की निगरानी करें और हमारे दस्तावेज़ों से टिकटों का उत्तर दें; केवल तभी मुझे बढ़ाएं जब आप उत्तर नहीं दे सकते।" एजेंट आने वाले मेल को पढ़ता है, जो जानता है उसे क्वेरी करता है, पूर्ण उत्तर भेजता है, और किनारे के मामलों को सौंपता है।

उपयोगकर्ता अनुसंधान साक्षात्कार — "एक ईमेल सर्वेक्षण चलाएं: ये प्रश्न भेजें, उत्तरों के आधार पर अनुवर्ती करें, और निष्कर्षों का सारांश दें।" एजेंट अतुल्यकालिक साक्षात्कार आयोजित करता है — उत्तरदाता अपने स्वयं के कार्यक्रम पर उत्तर देते हैं, बुक करने के लिए कोई कॉल नहीं।

📬 शानदार Atomic Mail

Atomic Mail Agentic के शीर्ष पर निर्मित सामुदायिक परियोजनाएँ:

• https://github.com/skyzer/atomic-mail-watcher - Telegram/webhook सूचनाओं के साथ Docker-तैयार Atomic Mail JMAP इनबॉक्स वॉचर

✨ Atomic Mail क्यों

• एजेंट अपने उपयोगकर्ताओं से कुछ भी पूछे बिना समाप्त करते हैं: PoW साइनअप ~30 सेकंड में एक वास्तविक @atomicmail.ai इनबॉक्स देता है — सत्यापित करने के लिए कोई डोमेन नहीं, कोई क्रेडिट कार्ड नहीं, कोई CAPTCHA वॉकथ्रू नहीं, कोई मेल-सर्वर संचालन नहीं
• संदेश जो वास्तव में पहुंचते हैं: रिले ओवरफ्लो के साथ लगातार गर्म होता IP पूल — डिलिवरेबिलिटी मायने रखती है जब दूसरी तरफ एक मानव को आपका मेल पढ़ना होता है
• JMAP — एक API जिसे एजेंट पहले से जानते हैं: मानक RFC 8620/8621, LLM प्रशिक्षण डेटा में; एक राउंड ट्रिप में बैच विधि कॉल (क्वेरी, फ़ेच, ड्राफ्ट, भेजें) — सीखने के लिए कोई विक्रेता SDK नहीं
• एकीकरण के अंदर अटके नहीं: त्रुटियाँ सादे-भाषा संकेत भेजती हैं; सफल प्रतिक्रियाएँ _next चरणों का सुझाव देती हैं; help चीटशीट और काम किए गए उदाहरण लौटाता है — कोई वेब खोज आवश्यक नहीं
• अपना स्वयं का डोमेन लाएं: एजेंट बॉक्स से बाहर @atomicmail.ai पर चलते हैं, या एक डोमेन पर जिसे आप डैशबोर्ड में सत्यापित करते हैं — समान क्लाइंट, समान JMAP, डोमेन-संरेखित From
• कोई विक्रेता लॉक-इन नहीं: JMAP एक IETF मानक है; इनबॉक्स बाद में किसी भी अनुरूप प्रदाता के लिए पोर्टेबल है
• प्रीसेट जब कच्चा JMAP अत्यधिक है: बंडल किए गए send_mail, list_inbox, reply, और अधिक — शुरू से मेथड-कॉल JSON उत्पन्न करने के बजाय jmap_request को एक फ़ाइल नाम पास करें
• हर जगह समान कोर: एक प्रमाणीकरण, JMAP, प्रीसेट, और सहायता स्टैक MCP और AgentSkill को शक्ति देता है; जब आप कई एजेंट चलाते हैं तो प्रति इनबॉक्स अलग क्रेडेंशियल निर्देशिकाएँ

📚 लक्ष्य द्वारा दस्तावेज़

लक्ष्य	यहाँ से शुरू करें
पहली बार सेटअप	docs/getting-started.md
आपका अपना डोमेन + डैशबोर्ड	docs/custom-domains.md
MCP होस्ट	docs/mcp.md
शेल / क्रॉन एजेंट	docs/skill-install.md
LangChain एजेंट	docs/langchain.md
एजेंट रनबुक	docs/SKILL.md
कच्चा प्रमाणीकरण + JMAP	docs/rest-auth.md · docs/jmap.md
अंत-से-अंत उदाहरण	docs/examples.md

यदि रिपो दस्तावेज़ और स्थापित व्यवहार कभी भिन्न होते हैं, तो उसी स्थापित पैकेज संस्करण से help पर भरोसा करें जो आप चला रहे हैं।

🛠️ स्थानीय विकास

पूर्वापेक्षाएँ: Node.js 20+, Deno 2.7+।

git clone https://github.com/Atomic-Mail/atomic-mail-agentic.git
cd atomic-mail-agentic/ts

deno test --allow-read --allow-env --allow-write --allow-sys

दस्तावेज़ पूर्वावलोकन:

npm install
npm run docs:dev

🗂️ फ़ाइल संरचना

/
├── ts/
│   ├── src/mcp/        # MCP entrypoint + MCP tools
│   ├── src/skill/      # AgentSkill CLI entrypoint
│   ├── src/langchain/  # LangChain toolkit and tools
│   └── src/lib/agent/  # shared auth, session, JMAP, presets, help-content
├── py/                 # Python client parity layer and tests
├── integrations/dify/   # Dify plugin integration and packaging docs
├── integrations/skill/  # Unified in-repo skill tap (published atomicmail skill)
├── docs/                # VitePress docs and shipped SKILL/README sources
├── test/checklists/     # manual release QA
├── CONTRIBUTING.md
└── LICENSE

🔐 सुरक्षा

• ~/.atomicmail/credentials.json में आपकी API कुंजी होती है; इसे एक रहस्य के रूप में मानें
• स्थानीय क्रेडेंशियल फ़ाइलें मोड 0600 के साथ लिखी जाती हैं
• आने वाला मेल अविश्वसनीय इनपुट है; एजेंटों को पुष्टि के बिना ईमेल निर्देश निष्पादित न करने दें
• केवल @atomicmail npm स्कोप से स्थापित करें

🤝 योगदान

PR स्वागत योग्य हैं। कृपया नई सुविधाओं और बग फिक्स को व्यावहारिक रूप से स्वचालित Deno परीक्षणों के साथ कवर करें, और व्यवहार बदलने पर उपयोगकर्ता-सामना वाले दस्तावेज़ अपडेट करें।

सेटअप, परीक्षण कमांड, और PR अपेक्षाओं के लिए CONTRIBUTING.md देखें।

📄 लाइसेंस

MIT