Hermes OSINT v3.0 🏛️🧠

एजेंटिक OSINT विश्लेषक
संवादात्मक AI-संचालित जाँच। प्राकृतिक भाषा। विशेषज्ञ परिणाम। 🤖✨

v3.0 में नया क्या है 🎉

Hermes 3.0 पाइपलाइन-आधारित टूल ऑर्केस्ट्रेशन से संवादात्मक AI-संचालित जाँच प्लेटफ़ॉर्म की ओर एक पूर्ण प्रतिमान बदलाव है। Ollama के माध्यम से स्थानीय LLM द्वारा संचालित, Hermes अब प्राकृतिक भाषा क्वेरी को समझता है, स्वायत्त रूप से टूल का चयन और निष्पादन करता है, और निष्कर्षों को सुसंगत खुफिया रिपोर्टों में संश्लेषित करता है।

🧠 एजेंटिक इंटेलिजेंस

• प्राकृतिक भाषा इंटरफ़ेस - CLI फ़्लैग याद रखने के बजाय "Find everything about @johndoe" जैसे प्रश्न पूछें
• ReAct पैटर्न - सोचो → कार्य करो → निरीक्षण करो (Think → Act → Observe) चक्र बुद्धिमान, पुनरावृत्त जाँच के लिए
• स्वायत्त टूल चयन - LLM संदर्भ के आधार पर तय करता है कि कौन से टूल चलाने हैं
• उद्धरण-आधारित रिपोर्टिंग - प्रत्येक निष्कर्ष उसके स्रोत टूल से जोड़ा जाता है

💬 इंटरैक्टिव TUI

• संवादात्मक REPL - पेंटेस्टर-थीम वाले टर्मिनल इंटरफ़ेस में Hermes से चैट करें
• सत्र संरक्षण - /save और /load से जाँच सहेजें और फिर से शुरू करें
• संदर्भ प्रबंधन - स्वचालित सारांश लंबे सत्रों में टोकन ओवरफ़्लो को रोकता है
• रीयल-टाइम स्टेटस बार - मॉडल, संदर्भ उपयोग, और स्टील्थ मोड एक नज़र में

🔄 लचीले निष्पादन मोड

• TUI मोड (डिफ़ॉल्ट) - Ollama के साथ पूर्ण संवादात्मक अनुभव
• हेडलेस मोड - स्क्रिप्टिंग और स्वचालन के लिए --headless --query "..."
• लीगेसी मोड - LLM के बिना सीधे टूल एक्सेस के लिए hermes sherlock <user>

अवलोकन 🎯

Hermes एक सार्वभौमिक OSINT ऑर्केस्ट्रेशन प्लेटफ़ॉर्म है जो सर्वश्रेष्ठ-इन-क्लास ओपन-सोर्स खुफिया टूल को एक AI-संचालित वर्कफ़्लो में एकीकृत करता है। इसके बजाय कि आप Sherlock, TheHarvester, Holehe, और अन्य टूल को अलग-अलग मैन्युअल रूप से चलाएँ—बहुमूल्य जाँच समय बर्बाद करते हुए ⏰—Hermes का एजेंटिक कोर आपके इरादे को समझता है, टूल को बुद्धिमानी से व्यवस्थित करता है, स्रोतों के बीच परिणामों को सहसंबंधित करता है, और पेशेवर रिपोर्ट प्रदान करता है। 📊

क्या चीज़ Hermes को अलग बनाती है: 🌟

• 🧠 एजेंटिक AI ReAct पैटर्न के साथ—अपनी जाँच को LLM से संचालित करवाएँ
• 💬 प्राकृतिक भाषा क्वेरी—याद रखने के लिए कोई फ़्लैग नहीं, बस बताएँ कि आपको क्या चाहिए
• 🔒 सुरक्षा-प्रथम प्लगइन आर्किटेक्चर स्थिर कोड विश्लेषण के साथ—भरोसा अर्जित होता है
• 🐳 Docker आइसोलेशन ज़ीरो-ट्रस्ट टूल निष्पादन के लिए—सब कुछ सैंडबॉक्स करें
• ⚡ समानांतर प्रोसेसिंग बुद्धिमान संसाधन प्रबंधन के साथ—अनुक्रमिक से 2x तेज़
• 🧩 क्रॉस-टूल सहसंबंध इंजन संबंध मैपिंग के लिए—बिंदुओं को स्वचालित रूप से जोड़ें
• 🔧 विस्तार योग्य डिज़ाइन—कोर कोड को छुए बिना नए टूल जोड़ें

विशेषताएँ 💎

एजेंटिक कोर 🤖

• ReAct एजेंट लूप सोचो → कार्य करो → निरीक्षण करो चक्र के साथ
• Ollama एकीकरण स्थानीय LLM इंफ़्रेंस के लिए (Llama 3, Mistral, आदि)
• टूल रजिस्ट्री फ़ंक्शन कॉलिंग के लिए JSON Schema परिभाषाओं के साथ
• संदर्भ प्रबंधक रोलिंग सारांश के साथ (8B मॉडल के लिए 24k वर्ण सीमा)
• सत्र भंडार जाँच की स्थिति सहेजने/लोड करने के लिए

इंटरैक्टिव TUI 💻

• prompt_toolkit REPL स्थायी इतिहास के साथ (~/.hermes_history)
• पेंटेस्टर-थीम वाली स्टाइलिंग हरे/सियान/नारंगी रंगों के साथ
• डायनामिक स्टेटस बार मॉडल, संदर्भ %, और मोड दिखाता है
• स्लैश कमांड: /help, /tools, /status, /save, /load, /export, /clear, /exit

टूल ऑर्केस्ट्रेशन 🎼

• शुरू से ही 6 एकीकृत OSINT टूल (Sherlock, TheHarvester, h8mail, Holehe, PhoneInfoga, Subfinder) 🛠️
• प्लगइन आर्किटेक्चर निर्बाध तृतीय-पक्ष टूल एकीकरण के लिए 🔌
• स्थैतिक सुरक्षा स्कैनर निष्पादन से पहले प्लगइन कोड को मान्य करता है—कोई आश्चर्य नहीं! 🛡️
• मल्टी-मोड निष्पादन: Docker कंटेनर, नेटिव बाइनरी, या हाइब्रिड स्वतः-पता लगाना 🎭
• स्टील्थ मोड प्रवर्तन - सक्षम होने पर सक्रिय प्रोबिंग टूल को ब्लॉक करता है 🥷

प्रदर्शन 🚀

• समानांतर निष्पादन अनुक्रमिक रनों की तुलना में 2x गति सुधार देता है ⚡
• स्मार्ट संसाधन स्केलिंग CPU कोर और मेमोरी का स्वतः पता लगाता है 💻
• अस्थायी कंटेनर स्वतः स्पिन अप, निष्पादित, और नष्ट हो जाते हैं 🌪️
• कॉन्फ़िगर करने योग्य वर्कर्स --workers फ़्लैग के माध्यम से बारीक-ट्यून किए गए समवर्ती के लिए 🎛️

इंटेलिजेंस 🧠

• क्रॉस-टूल सहसंबंध विभिन्न डेटा स्रोतों के बीच संबंधों की पहचान करता है 🔍
• फ़ज़ी डीडुप्लिकेशन बुद्धिमानी से अनावश्यक निष्कर्षों को समाप्त करता है 🎯
• एकीकृत एंटिटी स्कीमा सभी टूल में आउटपुट को सामान्यीकृत करता है 📐
• स्रोत विशेषता ट्रैक करता है कि किस टूल ने कौन सा निष्कर्ष खोजा 📝
• विश्वसनीयता स्कोरिंग निष्कर्षों की विश्वसनीयता को मापता है ⭐

त्वरित आरंभ 🏃‍♂️💨

पूर्वापेक्षाएँ ✅

• Python 3.10 या उच्चतर 🐍
• Docker (कंटेनरीकृत टूल निष्पादन के लिए) 🐳
• स्थापित मॉडल के साथ Ollama (TUI/एजेंटिक मोड के लिए) 🧠

स्थापना 📦

# Clone and install
git clone https://github.com/Expert21/hermes-osint.git
cd hermes-osint
pip install -r requirements.txt
pip install .

# Install Ollama and pull a model
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.1:8b

# Health check
hermes --doctor  # 🏥 Make sure everything's ready!

मूल उपयोग 🎮

# 🧠 TUI Mode (default) - Conversational AI interface
hermes
# Then chat naturally: "Find social accounts for johndoe"

# 📜 Headless Mode - For scripting and automation
hermes --headless --query "Investigate the domain example.com"

# 🔧 Legacy Mode - Direct tool access (no LLM required)
hermes sherlock johndoe
hermes theharvester example.com
hermes holehe [email protected]

TUI कमांड 💬

/help          # Show all commands
/tools         # List available investigation tools
/status        # Show current session status
/save          # Save session to file
/load          # Load a previous session
/sessions      # List all saved sessions
/export FILE   # Export report (md, pdf, html, csv, stix)
/stealth       # Toggle stealth mode
/clear         # Clear conversation
/exit          # Exit Hermes

उन्नत उपयोग 🎯

# Stealth mode - passive tools only
hermes --stealth
# Blocks: sherlock, holehe, phoneinfoga
# Allows: theharvester, subfinder, h8mail

# Specific model selection
hermes --model mistral:7b

# Headless with output
hermes --headless --query "Find subdomains for target.com" --output report.md

उपलब्ध टूल 🛠️

आर्किटेक्चर 🏗️

v3.0 एजेंटिक आर्किटेक्चर

User Input → CLI (cli.py)
                ├── TUI Mode → AgentLoop → Ollama → ToolExecutor → Adapters
                ├── Headless → AgentLoop → Single Query → Report
                └── Legacy → ToolExecutor Direct (no LLM)

कंपोनेंट प्रवाह

┌─────────────┐
│ User Query  │ 💬 "Find info about johndoe"
└──────┬──────┘
       │
       ▼
┌─────────────────┐
│   AgentLoop     │ 🧠 ReAct: Think → Act → Observe
│  (agent_loop.py)│
└────────┬────────┘
         │
         ├──────────────────┬────────────────┐
         ▼                  ▼                ▼
┌──────────────┐   ┌───────────────┐  ┌─────────────┐
│ ToolRegistry │   │ContextManager │  │ SessionStore│
│(tool_registry)│  │(context_mgr.py)│ │(session_store)│
└──────┬───────┘   └───────────────┘  └─────────────┘
       │
       ▼
┌──────────────────────┐
│   ToolExecutor       │ 🔧 Validates + Executes
│  (tool_executor.py)  │
└──────────┬───────────┘
           │
           ▼
┌─────────────────────────┐
│ ExecutionStrategy       │ 🎭 Docker/Native/Hybrid
│ (execution_strategy.py) │
└──────────┬──────────────┘
           │
           ▼
    ┌──────────────┐
    │ Tool Adapters│ 🔌 Sherlock, TheHarvester, etc.
    └──────┬───────┘
           │
           ▼
    ┌─────────────┐      ┌──────────────┐
    │ Raw Results │─────▶│Deduplication │ ✨
    └─────────────┘      └──────┬───────┘
                                │
                                ▼
                         ┌─────────────┐
                         │   Report    │ 📊
                         │ (exporter)  │
                         └─────────────┘

मुख्य कंपोनेंट 🔑

एजेंट परत (src/agent/)

• AgentLoop 🧠: Ollama फ़ंक्शन कॉलिंग के साथ ReAct पैटर्न
• ToolRegistry 📋: LLM टूल उपयोग के लिए JSON Schema परिभाषाएँ
• ToolExecutor 🔧: इनपुट मान्य करता है, स्टील्थ लागू करता है, एडेप्टर से पुल बनाता है
• ContextManager 📊: रोलिंग सारांश, टोकन ओवरफ़्लो रोकता है
• SessionStore 💾: सेव/लोड कार्यक्षमता के लिए JSON दृढ़ता
• TUI 💻: पेंटेस्टर स्टाइलिंग के साथ prompt_toolkit REPL

ऑर्केस्ट्रेशन परत (src/orchestration/)

• ExecutionStrategy 🎭: Docker/नेटिव/हाइब्रिड मोड चयन
• DockerManager 🐳: SHA256 सत्यापन के साथ अस्थायी कंटेनर
• TaskManager ⚡: संसाधन सीमाओं के साथ समानांतर निष्पादन

सुरक्षा परत (src/security/)

• PluginSecurityScanner 🛡️: AST-आधारित स्थैतिक विश्लेषण
• InputValidator ✅: इंजेक्शन रोकथाम, पाथ ट्रैवर्सल सुरक्षा
• SecretsManager 🔐: एन्क्रिप्टेड क्रेडेंशियल स्टोरेज

सुरक्षा 🔐

एजेंट सुरक्षा 🛡️

• ग्राउंडिंग नियम LLM अनुमान को रोकते हैं—स्रोत उद्धृत करें या चुप रहें
• स्टील्थ मोड प्रवर्तन सक्षम होने पर सक्रिय प्रोबिंग टूल को ब्लॉक करता है
• इनपुट सत्यापन निष्पादन से पहले सभी टूल पैरामीटर पर
• संदर्भ सीमाएँ टोकन ओवरफ़्लो के माध्यम से प्रॉम्प्ट इंजेक्शन को रोकती हैं

कंटेनर आइसोलेशन 🐳🔒

• SHA256 डाइजेस्ट पिनिंग इमेज छेड़छाड़ को रोकती है ✅
• अस्थायी जीवनचक्र निष्पादन के तुरंत बाद कंटेनर नष्ट कर देता है 🌪️
• संसाधन सीमाएँ (768MB RAM, 50% CPU, 64 PIDs) 🚦
• नेटवर्क आइसोलेशन कॉन्फ़िगर करने योग्य DNS और प्रॉक्सी समर्थन के साथ 🌐
• गैर-रूट निष्पादन (UID/GID 65534:65534) 👥

प्लगइन सुरक्षा 🛡️

• स्थैतिक विश्लेषण eval(), exec(), os.system(), और शेल इंजेक्शन का पता लगाता है 🚨
• दो-स्तरीय ट्रस्ट मॉडल टूल प्लगइन को कोर प्लगइन से अलग करता है 🏛️
• क्षमता घोषणाएँ स्पष्ट रूप से आवश्यक अनुमतियाँ परिभाषित करती हैं 📋

आउटपुट प्रारूप 📄

Hermes /export के माध्यम से कई प्रारूपों में रिपोर्ट उत्पन्न करता है—आपका डेटा, आपका तरीका! 🎨

📦 JSON - प्रोग्रामेटिक उपभोग के लिए संरचित डेटा

📝 Markdown - टेबल के साथ स्वच्छ, GitHub-संगत प्रारूप

🌐 HTML - एम्बेडेड CSS और आँकड़ों के साथ उत्तरदायी डिज़ाइन

📄 PDF - कार्यकारी सारांश के साथ पेशेवर स्वरूपण

📊 CSV - स्प्रेडशीट आयात के लिए सरल सारणीबद्ध प्रारूप

🔒 STIX 2.1 - उद्योग-मानक खतरा खुफिया प्रारूप

लाइसेंस ⚖️

AGPL-3.0 (सामुदायिक संस्करण) 🆓

Hermes OSINT GNU Affero General Public License v3.0 के तहत लाइसेंस प्राप्त है।

इसका अर्थ क्या है: 💡

• ✅ व्यक्तिगत और व्यावसायिक उद्देश्यों के लिए उपयोग करने के लिए स्वतंत्र
• ✅ ओपन सोर्स—कोड देखें, संशोधित करें, और वितरित करें
• ✅ कॉपीलेफ़्ट—संशोधन भी AGPL-3.0 के तहत ओपन-सोर्स होने चाहिए
• ⚠️ नेटवर्क उपयोग = वितरण—यदि आप Hermes को सेवा के रूप में चलाते हैं, तो आपको अपना स्रोत कोड साझा करना ही होगा

पूर्ण शर्तों के लिए LICENSE फ़ाइल देखें।

उपयोग के मामले 💼

🔍 सुरक्षा अनुसंधान - प्राकृतिक भाषा क्वेरी के साथ खतरों की जाँच करें

🤝 उचित परिश्रम (Due Diligence) - "इस व्यक्ति/कंपनी के बारे में सब कुछ बताएँ"

👣 डिजिटल फ़ुटप्रिंट विश्लेषण - अपने संगठन के जोखिम को समझें

📈 प्रतिस्पर्धी खुफिया - संवादात्मक रूप से प्रतिस्पर्धियों पर शोध करें

🎯 खतरा खुफिया - AI-संचालित ट्राइएज के साथ संकेतक एकत्र करें

📰 जांच पत्रकारिता - Hermes को बिंदु जोड़ने दें

कानूनी और नैतिक अस्वीकरण ⚖️

केवल अधिकृत OSINT गतिविधियों के लिए। ⚠️ उपयोगकर्ता उचित प्राधिकरण प्राप्त करने, लागू कानूनों का पालन करने, और इस टूल का नैतिक रूप से उपयोग करने के लिए पूरी तरह ज़िम्मेदार हैं।

अनुमत उपयोग: ✅

• सार्वजनिक रूप से उपलब्ध जानकारी एकत्र करना
• अधिकृत सुरक्षा मूल्यांकन
• व्यक्तिगत डिजिटल फ़ुटप्रिंट विश्लेषण
• स्थानीय कानूनों और विनियमों का अनुपालन

निषिद्ध उपयोग: 🚫

• उत्पीड़न, पीछा करना, या धमकाना
• अनधिकृत पहुँच प्रयास
• गोपनीयता कानून उल्लंघन
• प्लेटफ़ॉर्म सेवा शर्तों का उल्लंघन

डेवलपर्स इस टूल के दुरुपयोग के लिए कोई दायित्व नहीं मानते हैं। 🙅‍♂️

योगदान 🤝

योगदान का स्वागत है! 🎉 प्लगइन निर्माण दिशानिर्देशों के लिए कृपया PLUGIN_DEVELOPMENT.md और विस्तृत उपयोग दस्तावेज़ीकरण के लिए USAGE.md देखें।

विचार हैं? बग मिले? टूल जोड़ना चाहते हैं? एक issue खोलें या PR सबमिट करें! 💪

लेखक ✍️

Isaiah Myles (@Expert21)

उभरते साइबर सुरक्षा पेशेवर | पेंटेस्टर मानसिकता | मायने रखने वाले टूल बनाने वाला 🛠️⚡

• 🐛 मुद्दे (Issues): GitHub Issues
• 📧 ईमेल: [email protected]