h-osint (h-osint)

टर्मिनल के लिए एक लोकल-फर्स्ट, कीबोर्ड-चालित OSINT वर्कबेंच — Neovim-शैली कीबाइंड्स, Lua कॉन्फ़िग, 12 थीम, और एक लोकल SQLite केस स्टोर। कोई अकाउंट नहीं, कोई क्लाउड बैकएंड नहीं, कोई टेलीमेट्री नहीं।

kitty ~ » h-osint

रिपॉज़िटरी: h-osint · बाइनरी: h-osint · वेबसाइट: https://t-beckett.gitlab.io/h-osint/

h-osint पूरी तरह से आपकी मशीन पर चलता है। केस नोट्स, सॉक-पपेट ट्रैकिंग, और हर लुकअप के निष्कर्ष एक ही लोकल SQLite फ़ाइल में रहते हैं — यहाँ कोई सर्वर कंपोनेंट नहीं, कोई सिंक नहीं, और यह टूल आपके केस डेटा को कहीं अपलोड नहीं करता। हर मॉड्यूल जो किसी तीसरे-पक्ष की सेवा (HaveIBeenPwned, Shodan, WiGLE, Nominatim, RDAP, crt.sh, NVD, Team Cymru, ip-api.com) से बात करता है, वह आपकी अपनी API key के साथ करता है जहाँ एक की आवश्यकता होती है, और केवल इसलिए क्योंकि आपने वह विशिष्ट लुकअप चलाया।

एक और OSINT टूल क्यों?

क्योंकि अच्छे OSINT तकनीक संदर्भ (TCM Security की OSINT Fundamentals, TCM OSINT resource list) कोई सॉफ़्टवेयर नहीं देते, और जो सॉफ़्टवेयर मौजूद है वह या तो एकल-उद्देश्य वाली CLI स्क्रिप्ट्स का ढेर है (Sherlock, theHarvester, ...) या एक भारी-भरकम GUI (Maltego)। h-osint टर्मिनल-ऐप इकोसिस्टम के उन हिस्सों को उधार लेता है जो पहले से ही प्रीमियम महसूस होते हैं और प्रसिद्ध तकनीकों के चारों ओर एक सुसंगत वर्कबेंच रखता है:

यह किसके लिए है

• सुरक्षा शोधकर्ता और थ्रेट-इंटेल विश्लेषक जो अधिकृत रेकॉन करते हैं
• पत्रकार और ओपन-सोर्स अन्वेषक जो सत्यापन/जियोलोकेशन कार्य करते हैं (Bellingcat-शैली की कार्यप्रणाली, उसका ऑटोमेशन नहीं)
• ट्रस्ट एंड सेफ्टी टीमें जो अपने ही ब्रांड की इम्पर्सोनेशन/टाइपोस्क्वाट जाँच करती हैं
• OSINT छात्र (जैसे TCM Security का कोर्स करने वाले) जो बारह ब्राउज़र टैब के बजाय पूरे वर्कफ़्लो का अभ्यास एक जगह करना चाहते हैं
• कोई भी जो चाहता है कि उसके केस नोट्स, API keys, और निष्कर्ष उसकी अपनी डिस्क पर रहें

यह उन चीज़ों के लिए नहीं बनाया गया है, और जानबूझकर छोड़ता है, जिनका एकमात्र वास्तविक उपयोग स्टॉकिंग, उत्पीड़न, अनधिकृत घुसपैठ, या चोरी हुए क्रेडेंशियल डंप के साथ काम करना है — ये रेखाएँ कहाँ खींची गई हैं और क्यों, इसके लिए docs/ETHICS.md देखें।

क्विकस्टार्ट

git clone https://gitlab.com/t-beckett/h-osint.git
cd h-osint

# Build prerequisites: a C compiler + linker (for the bundled SQLite and
# vendored Lua) and pkg-config. On Debian/Ubuntu:
sudo apt install build-essential pkg-config

cargo build --release
./target/release/h-osint          # launches the TUI
./target/release/h-osint --help   # see the scriptable subcommands

वैकल्पिक बाहरी टूल्स जो Tools स्क्रीन के अधिक हिस्से को अनलॉक करते हैं: whois (RDAP-असमर्थित TLD फ़ॉलबैक), dig (DNS रिकॉर्ड + AXFR जाँच), exiftool, nmap, openssl, curl। ऐप इनके बिना भी ठीक चलता है — यह बताता है कि क्या गायब है बजाय चुपचाप विफल होने के।

कॉन्फ़िग

पहली बार चलाने पर, h-osint आपके लिए एक पूरी तरह टिप्पणीयुक्त डिफ़ॉल्ट कॉन्फ़िग ~/.config/h-osint/init.lua पर लिखता है (यदि वहाँ अभी तक कुछ नहीं है) — हाथ से कॉपी करने के लिए कुछ नहीं है। अपनी थीम, API keys, कस्टम थीम, और कीमैप ओवरराइड सेट करने के लिए उस फ़ाइल को खोलें। इसमें कुछ भी आवश्यक नहीं है; हर फ़ील्ड का एक समझदार डिफ़ॉल्ट है और हर मॉड्यूल जिसे key चाहिए वह बताता है बजाय चुपचाप विफल होने के। (इस रेपो में शिप्ड config/init.lua वही सटीक टेम्पलेट है जो उपयोग किया जाता है — यदि आप पहले ऐप लॉन्च नहीं करना चाहते तो इसे यहाँ पढ़ें।)

विशेषताएँ

सभी 22 मूल रूप से निर्धारित OSINT क्षमताएँ plus 6 विस्तारित टूल्स — पूर्ण स्थिति/मॉड्यूल मैपिंग docs/FEATURES.md में:

नोट्स और केस फ़ाइलें · सॉक पपेट / पर्सोना मैनेजर · सर्च-इंजन डॉर्क बिल्डर · रिवर्स इमेज सर्च हैंडऑफ · EXIF व्यूअर Kitty-प्रोटोकॉल इनलाइन प्रीव्यू के साथ · फ़िज़िकल-लोकेशन और जियोलोकेशन टूल्स · ईमेल OSINT (format/MX/Gravatar) · लीक हुए डेटा का OSINT (HaveIBeenPwned breaches + pastes) · पीपल OSINT · फ़ोन नंबर OSINT · Sherlock-शैली यूज़रनेम OSINT · वेबसाइट OSINT (DNS, RDAP, crt.sh, Wayback, SPF/DMARC/DKIM, robots.txt/sitemap) · सोशल मीडिया OSINT · वायरलेस नेटवर्क OSINT (WiGLE) · IP OSINT (जियोलोकेशन, रिवर्स DNS, Team Cymru के माध्यम से ASN/BGP, RDAP) · MAC OSINT · बाहरी-टूल ऑर्केस्ट्रेशन · ऑटोमेशन पाइपलाइन · Markdown रिपोर्ट लेखन · लो-लेवल सुरक्षा OSINT (TLS सर्ट्स, सुरक्षा हेडर) · plus Shodan होस्ट इंटेलिजेंस, एक हैश आइडेंटिफ़ायर, एक URL रीडायरेक्ट एक्सपैंडर, एक CVE/NVD लुकअप, एक टाइपोस्क्वाट/लुक-अलाइक-डोमेन स्कैनर, और एक DNS ज़ोन-ट्रांसफ़र (AXFR) मिसकॉन्फ़िगरेशन जाँच।

कीबाइंड्स

तीन मोड, Neovim-स्वाद वाले — पूरी तालिका KEYBINDINGS.md में:

उपरोक्त सभी को init.lua से ओवरराइड किया जा सकता है। इन-ऐप चीट शीट के लिए कभी भी ? दबाएँ।

थीम

:theme <name> या init.lua में theme सेट करें — पूरी पैलेट तालिका और कस्टम-थीम प्रारूप THEMES.md में:

ocean-depths · forest-canopy · modern-minimalist · arctic-frost · botanical-garden · midnight-galaxy · nord · catppuccin-frappe · everforest · gruvbox · onedark · tokyonight (default)

हर थीम समान 12 सिमेंटिक रोल्स (bg/fg/accent/danger/...) को मैप करती है — कोई भी स्क्रीन कभी नाम से किसी थीम को विशेष रूप से संभालती नहीं है — और आप Rust कोड को छुए बिना init.lua में पूरी तरह अपनी खुद की थीम परिभाषित कर सकते हैं।

CLI (ऑटोमेशन / स्क्रिप्टिंग)

हर मॉड्यूल का मूल लॉजिक हेडलेस रूप से पहुँच योग्य है, ताकि आप इसे अन्य टूल्स में पाइप कर सकें या cron से चला सकें:

h-osint username johndoe
h-osint domain example.com
h-osint ip 8.8.8.8
h-osint asn 8.8.8.8
h-osint email [email protected]
h-osint mac AA:BB:CC:DD:EE:FF
h-osint phone "+1 555 0100"
h-osint dork --site example.com --filetype pdf "quarterly report"
h-osint breach [email protected] --api-key YOUR_HIBP_KEY
h-osint shodan 1.2.3.4 --api-key YOUR_SHODAN_KEY
h-osint hash 5f4dcc3b5aa765d61d8327deb882cf99
h-osint expand https://bit.ly/example
h-osint cve CVE-2024-3094
h-osint typosquat example.com
h-osint security example.com
h-osint axfr example.com ns1.example.com
h-osint pipeline example.com --steps domain,ip --case 1
h-osint report 1 --out case-1.md

प्रोजेक्ट लेआउट

src/
  main.rs, cli.rs        entry point + headless CLI
  app.rs                 tab/mode state machine, :command execution
  config.rs, keymap.rs   Lua config loading, modal keybind resolution
  themes/mod.rs           12 built-in themes + custom-theme support
  db.rs                  SQLite case/notes/findings/personas storage
  ui/                    tab bar, status bar (mode pill), help popup
  modules/
    notes.rs, sockpuppet.rs        full modules (state + DB + UI)
    dork.rs, exif.rs, username.rs  full modules (logic + UI)
    domain.rs, network.rs,         pure OSINT logic (no UI — see
    identity.rs, geo.rs            lookup.rs for the shared screen)
    lookup.rs                      generic single-input screen used by
                                    Domain/IP/MAC/Email/Phone/Breach/Geo/
                                    Wireless/People/Social/Shodan/Hash/
                                    UrlExpand/Cve/Typosquat/Security/Axfr/
                                    ReverseImage
    tools.rs, automation.rs, report.rs   full modules
docs/
  ARCHITECTURE.md   how it's wired together + where to extend it
  FEATURES.md       every requested + extended feature -> module mapping
  ETHICS.md         responsible-use scope and why some modules are limited
THEMES.md           full palette table + how to define a custom theme
KEYBINDINGS.md      the complete keybind + command reference
CONTRIBUTING.md     dev setup, how to add a module, commit style
SECURITY.md         responsible-disclosure policy for this tool itself
CODE_OF_CONDUCT.md
CHANGELOG.md
config/init.lua     example config
site/               source for the project website (published via GitLab Pages)
.gitlab-ci.yml       build/lint/test + Pages deploy

वेबसाइट और CI

site/ में स्टैटिक प्रोजेक्ट होमपेज है; .gitlab-ci.yml हर पुश पर बिल्ड और लिंट करता है और डिफ़ॉल्ट ब्रांच पर site/ को GitLab Pages पर प्रकाशित करता है, https://t-beckett.gitlab.io/h-osint/ पर।

ईमानदार चेतावनी

यह प्रोजेक्ट मूल रूप से एक ऐसे वातावरण में स्कैफ़ोल्ड किया गया था जहाँ crates.io के विरुद्ध cargo build के लिए नेटवर्क एक्सेस नहीं था। हर पंक्ति की शुद्धता के लिए हाथ से समीक्षा की गई (टाइप्स, बॉरो-चेकर आकार, दस्तावेज़ीकृत crate संस्करणों के विरुद्ध API सिग्नेचर), लेकिन एक ताज़ा क्लोन के पहले cargo build को असली सत्यापन चरण मानें — CI पाइपलाइन हर पुश पर इसे, cargo clippy, और cargo test चलाती है, इसलिए main पर एक हरा पाइपलाइन ही वास्तविक गारंटी है। विशिष्ट स्थानों के लिए जो दूसरी नज़र के सबसे योग्य हैं (MAC OUI तालिका कवरेज, फ़ोन पार्सिंग सटीकता, ASN प्रतिक्रिया पार्सिंग), docs/ARCHITECTURE.md का "Known gaps" अनुभाग देखें।

लाइसेंस

MIT — LICENSE देखें। © T. Beckett.