OllamaHound एक मॉड्यूलर, RedTeam-उन्मुख टूलकिट है जो सार्वजनिक रूप से एक्सपोज़्ड Ollama सर्वरों की खोज, संस्करण फिंगरप्रिंटिंग, CVE एक्सपोज़र का वर्गीकरण, यह सत्यापित करना कि टेक्स्ट जनरेशन संभव है या नहीं, और (वैकल्पिक रूप से) नियंत्रित परीक्षण के लिए एक इंटरैक्टिव CLI सत्र सक्षम करना।

@@@@@@@@@@@@@@@@@@@@@@@@@@@#*#@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@%.-+-:#@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@+--=%@@@@@@@@-.@@@+ #@@@@@@@@@@@@@@@@@
@@@@@@@@@@@= %%+.=@@@%###-.@@@@= %@@@@@@@@@@@@@@@@
@@@@@@@@@@@-.@@@@..--====-.=@@@@.-@@@@@@@@@@@@@@@@
@@@@@@@@@@@# +#+-:*%@@@@@@@@@@@@- +@@@@@@@@@@@@@@@
@@*@@@@@#*+=:::.-*%@@@@@@@@@@@@@@%::%@@@@@@@@@@@@@
@+:-@@*----=***+==-=#@@@@@@@@@@@@@@::@@@@@@@@@@@@@
@*+#@=-==+=%@@@@%#=+:*%%%@@@@#++%@@+ %@@@@@@@@@@@@
+:=@#.+-@#=#@%+++%@:* =++==*@-  *@@-.@@@@@@@@@@@@@
%=+@+--*@@*=##+++%#.+::=@#%:+@%@@@@%.=@@@@@@@@@@@@
@@@@#.+-@@%=*@@@@@+.* =-:*@-=@@@@@@@* %@@@@@@@@@@@
@@@@@+:==#*=%@@@@*-=.:--+*-=@@@@@@@@+ %@@@@@@@@@@@
@@@@@@#=----+*++=--=**++*#%@@@@@@@@% =@@@@@@@@@@@@
@@@@@@@@%*-:---.+*%@@@@@@@@@@@@@@@@+-:+@@@@@@@@@@@
@@@@@@@@@@# ==:.%@@@@@@@@@@@@@@@@@@@@%.-@@@@@@@@@@
@@@@@@@@@@#.@@:.#@@@@@@@@@@@@@@#@@@@@@% *@@@@@@@@@
@@@@@@@@@*::--::=%@@@@@@@@@@@@::@@@@@@@ =@@@@@@@@@
@@@@@@@@-.#@@@@@-.@@@@@@@@@@#.-@@@@@@@@*.-@@@@@@@@
@@@@@@@@.-@@@@@%::@@@@@@@@%=.+@@@@@@@@@@%.-@@@@@@@
@@@@@@@@#::++=::+@@@@@@@%=:=%@@@@@%%@@@@@+ @@@@@@@
@@@@@@@@@@=.:: #@@@@@@@=.+@@@@@@%=:*@@@@@= @@@@@@@
@@@@@@@@@@@@%-.%@@@@@@# *@@@@@#-:+@@@@@@% +@@@@@@@
@@@@@@@@@@@@@.=@@@@@@@@=:===---*@@@@@@@@@.=@@@@@@@
@@@@@@@@@@@@@=.%@@@@@@@@#-##%@@@@@@@@@@@@.-@@@@@@@
@@@@@@@@@@@@@@= -%@@@@@@# #@@@@@@@@@@@@@# #@@@@@@@
@@@@@@@@@@@@@@@ .:=*%%@%#..*@@@@@@@@@@@+.+@@@@@@@@
@@@@@@@@@@@@@@@.=@*==- -=*. --==+*#**=:-#@@@@@@@@@
@@@@@@@@@@@@@@@:-@@@@# #@@+ %%##*..++#%@@@@@@@@@@@
@@@@@@@@@@@@@@@::@@@@-.@@@% *@@@@-:@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@*.=++::%@@@@::%@%+ *@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@%***%@@@@@@%=---=%@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@---OllamaHound---@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@---By 7h30th3r0n3---@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

विषय सूची

• मॉड्यूल
• सामान्य प्रवाह
• मुख्य विशेषताएँ (स्कैनर)
• आवश्यकताएँ
• त्वरित आरंभ
• कमांड चीट शीट
• स्कैनर आउटपुट
• नेविगेटर (स्कैनर CSV सहायक)
• कनेक्टर (इंटरैक्टिव CLI)
• स्क्रैपर (शॉडन सहायक)
• ऑर्केस्ट्रेटर फ़्लैग (उच्च-स्तरीय)
• आउटपुट फ़ाइलें (सारांश)
• मॉडल आकार पार्सिंग पर नोट्स
• सुरक्षा, नैतिकता और दायरा
• लेखक

मॉड्यूल

विशेषताएँ

• ⚡ उच्च‑स्तरीय स्कैनिंग async सॉकेट और समृद्ध प्रगति UI के साथ
• 🧠 संस्करण + CVE वर्गीकरण RCE/DoS एक्सपोज़र के लिए
• ✅ मॉडल सत्यापन /api/tags और /api/generate के माध्यम से
• 🧭 नेविगेटर फ़िल्टर डीडुप, सॉर्टिंग और निर्यात के लिए
• 💬 इंटरैक्टिव कनेक्टर सुरक्षित रूप से प्रॉम्प्ट परीक्षण के लिए

सामान्य प्रवाह

1. लक्ष्य स्क्रैप करें (वैकल्पिक) → results/scraper/targets.txt
2. लक्ष्य स्कैन करें → results/scanner/<prefix>_YYYYMMDD_HHMMSS.csv
3. परिणाम नेविगेट करें + फ़िल्टर करें → वैकल्पिक JSON/CSV निर्यात
4. चुने गए होस्ट/मॉडल से कनेक्ट करें → इंटरैक्टिव CLI

आप इसे चरण-दर-चरण कर सकते हैं या पहले तीन चरणों को जोड़ने के लिए ऑर्केस्ट्रेटर चला सकते हैं।

मुख्य विशेषताएँ (Scanner)

• तेज़, अतुल्यकालिक स्कैनिंग asyncio + aiohttp का उपयोग कर (हजारों सॉकेट इन-फ़्लाइट)
• प्रगति UI (ETA, थ्रूपुट, पूर्णता) rich के माध्यम से
• टाइमस्टैम्प्ड CSV रिपोर्टिंग: <prefix>_YYYYMMDD_HHMMSS.csv
• रंगीन तालिका आउटपुट
  • RCE: लाल
  • DoS: पीला
  • Patched: हरा
• संस्करण पार्सिंग
  • GET /api/version → फ़ॉलबैक GET /version → फ़ॉलबैक Server हेडर
• CVE वर्गीकरण
  • CVE-2024-7773 (RCE): संस्करण < 0.1.47
  • CVE-2025-0317 (DoS): संस्करण <= 0.3.14
• मॉडल डिस्कवरी और सत्यापन
  • GET /api/tags के माध्यम से मॉडलों की गणना
  • POST /api/generate के माध्यम से जनरेशन का परीक्षण
• स्मार्ट सॉर्टिंग
  • वे होस्ट जहाँ /api/generate HTTP 200 लौटाता है, सबसे ऊपर आते हैं
• शक्तिशाली फ़िल्टर
  • --gen-ok-only केवल कार्यशील /api/generate वाले होस्ट रखता है
  • --vuln-only केवल RCE/DoS वर्गीकृत होस्ट रखता है
  • --show-unknown अज्ञात/अपार्सेबल संस्करणों वाले होस्ट शामिल करता है
• ट्यून करने योग्य
  • मल्टी‑पोर्ट, टाइमआउट, समवर्तीता, CSV उपसर्ग

आवश्यकताएँ

• पायथन 3.10+
• पैकेज:
  • aiohttp
  • rich
  • packaging
  • requests
  • shodan

निर्भरताएँ स्थापित करें:

python3 -m pip install -U aiohttp rich packaging requests shodan

Docker का उपयोग करें:

docker build -t ollamahound .
docker run -it --rm ollamahound <ollamahound scripts>

त्वरित आरंभ

त्वरित आरंभ न्यूनतम (2–3 कमांड)

विकल्प A (सबसे तेज़): स्क्रैप → स्कैन → कनेक्ट

python3 ollamaScraper.py
python3 ollamaScanner.py results/scraper/targets.txt --gen-ok-only
python3 ollamaConnector.py --scan-csv results/scanner/ollama_scan_*.csv

विकल्प B (एक-शॉट): ऑर्केस्ट्रेटर पाइपलाइन

python3 ollamaOrchestrator.py --scan-gen-ok-only

ऑर्केस्ट्रेटर (एक-शॉट स्क्रैप → स्कैन → कनेक्ट)

ollamaOrchestrator.py केवल स्क्रैपर, स्कैनर, फिर कनेक्टर चलाता है ताकि आप एक ही कमांड में शॉडन हार्वेस्टिंग से इंटरैक्टिव CLI तक जा सकें। स्क्रैपर और कनेक्टर इंटरैक्टिव रहते हैं, लेकिन ऑर्केस्ट्रेटर आपके लिए उनके आउटपुट को जोड़ देता है।

python3 ollamaOrchestrator.py --scan-gen-ok-only --scan-vuln-only