OTinstaller

ओपन-सोर्स कमांड लाइन टूल्स को नाम से इंस्टॉल, रन, अपडेट और रिमूव करें।

आप सूची में से एक टूल चुनते हैं। OTinstaller इसे अपने फ़ोल्डर में डाउनलोड करता है, चलाता है, और आउटपुट सेव करता है। आपको हर टूल के लिए अलग इंस्टॉल तरीका नहीं सीखना पड़ता।

otinstaller PyPI पर प्रकाशित है (संस्करण 0.0.1)।

आपको क्या चाहिए

एक Linux मशीन। Ubuntu 22.04 और 24.04, Debian 12, और Arch Linux पर टेस्ट किया गया है। Kali Linux को रिलीज़ से पहले हाथ से जाँचा जाता है।

Python 3.10 से 3.12, git, और venv मॉड्यूल। Debian, Ubuntu और Kali पर, उस मॉड्यूल को इससे इंस्टॉल करें:

sudo apt install python3-venv git

Ubuntu 26.04 LTS और Python 3.13+ वाले अन्य सिस्टम

Ubuntu 26.04 LTS डिफ़ॉल्ट रूप से Python 3.14 के साथ आता है, और अन्य डिस्ट्रीब्यूशन भी अब Python 3.13+ के साथ आते हैं। otinstaller और इसके कुछ प्रबंधित टूल्स को Python 3.10–3.12 चाहिए, इसलिए इन सिस्टम पर Python 3.12 स्पष्ट रूप से इंस्टॉल करें और otinstaller को उससे बने virtualenv के अंदर चलाएँ:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uv venv --python 3.12 ~/.otinstaller-venv
source ~/.otinstaller-venv/bin/activate
uv pip install otinstaller

uv से बने virtualenv में pip नहीं होता, इसलिए इंस्टॉल कमांड uv pip install otinstaller है। otinstaller का उपयोग करने से पहले किसी भी नए टर्मिनल में source ~/.otinstaller-venv/bin/activate फिर से चलाएँ। otinstaller doctor वह Python संस्करण प्रिंट करता है जिसके अंतर्गत यह चल रहा है और किसी भी पंजीकृत टूल को फ़्लैग करता है जिसे अलग संस्करण चाहिए।

Ubuntu 22.04 और 24.04 पर सिस्टम Python पहले से ही काम करता है। uv विधि केवल Ubuntu 26.04 पर टेस्ट की गई थी।

Python संस्करण संबंधी चेतावनियाँ

कुछ प्रबंधित टूल्स अभी तक Python 3.13+ का समर्थन नहीं करते। टेस्ट मैट्रिक्स Python 3.10–3.12 को कवर करता है। ज्ञात प्रभावित टूल्स:

• auto-archiver: Python <3.13 चाहिए (निर्भरता pdqhash को C++ कंपाइलर चाहिए, 3.13+ के लिए कोई wheel नहीं)
• telepathy: Python <3.13 चाहिए (निर्भरता googletrans/httpx हटाए गए cgi मॉड्यूल का उपयोग करता है)

यदि आप Python 3.13+ पर इंस्टॉल विफलताओं का सामना करते हैं, तो otinstaller को Python 3.12 virtualenv में चलाएँ।

OTinstaller इंस्टॉल करें

सिस्टम-व्यापी इंस्टॉलेशन के लिए, pipx install otinstaller का उपयोग करें। यह virtualenv के बिना आपके PATH पर otinstaller और ot कमांड प्रदान करता है।

वैकल्पिक रूप से, एक virtualenv बनाएँ और PyPI से इंस्टॉल करें:

python3 -m venv ~/.otinstaller-venv
source ~/.otinstaller-venv/bin/activate
pip install otinstaller

otinstaller का उपयोग करने से पहले किसी भी नए टर्मिनल में source ~/.otinstaller-venv/bin/activate फिर से चलाएँ।

सोर्स से इंस्टॉल करें

इस रिपॉज़िटरी से इंस्टॉल करने के लिए (डेवलपमेंट के लिए):

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

यदि अगली कमांड otinstaller: command not found कहती है, तो किसी भी नए टर्मिनल में इस फ़ोल्डर से source .venv/bin/activate फिर से चलाएँ।

मशीन की जाँच इससे करें:

otinstaller doctor

doctor Linux, Python, git, और venv के लिए [ok] या [problem] प्रिंट करता है। जारी रखने से पहले किसी भी [problem] लाइन को ठीक करें। यह अक्सर आपको इंस्टॉल करने वाला पैकेज बताता है।

अपना पहला टूल चलाएँ

init ~/.otinstaller/ बनाता है और एक ज़िम्मेदार-उपयोग सूचना दिखाता है। यह पूछता है Do you accept? [y/N]। y टाइप करें और Enter दबाएँ। ऐसा करने तक कुछ भी इंस्टॉल नहीं हो सकता।

otinstaller init

Sherlock एक उपयोगकर्ता नाम खोजता है। यह इंस्टॉल पूछता है Install? [y/N]। बड़ा N का मतलब है कि अकेले Enter का मतलब ना है। जारी रखने के लिए y टाइप करें।

otinstaller install sherlock
otinstaller run sherlock -- someexampleuser123

-- यह चिह्नित करता है कि otinstaller के अपने विकल्प कहाँ समाप्त होते हैं। इसके बाद का सब कुछ Sherlock को पास किया जाता है। जब रन समाप्त होता है, otinstaller उस फ़ोल्डर में results/ के अंतर्गत एक पथ प्रिंट करता है जहाँ आपने कमांड चलाई थी। वह फ़ाइल टूल का आउटपुट है।

कोई अलग टूल आज़माने के लिए, sherlock के स्थान पर गाइड से उसका नाम उपयोग करें।

टाइप्ड इनपुट

प्रत्येक टूल के फ़्लैग याद रखने के बजाय, आप टाइप्ड इनपुट प्रीफ़िक्स का उपयोग कर सकते हैं:

• u: उपयोगकर्ता नाम (जैसे, u:johndoe)
• e: ईमेल (जैसे, e:[email protected])
• p: फ़ोन (जैसे, p:+15551234567)
• d: डोमेन (जैसे, d:example.com)
• url: URL (जैसे, url:https://example.com)
• q: टेक्स्ट क्वेरी (जैसे, q:search terms)
• geo: निर्देशांक (जैसे, geo:32.22,-110.97)
• tg: Telegram चैनल (जैसे, tg:channelname)
• lat: अक्षांश (जैसे, lat:37.7749)
• lng: देशांतर (जैसे, lng:-122.4194)

उदाहरण:

otinstaller run sherlock -- u:johndoe
otinstaller run ghunt -- u:johndoe e:[email protected]

प्रत्येक टूल घोषित करता है कि यह कौन से इनपुट प्रकार का समर्थन करता है। मैपिंग देखने के लिए otinstaller info <tool> का उपयोग करें।

All मोड

किसी दिए गए इनपुट प्रकार का समर्थन करने वाले प्रत्येक इंस्टॉल किए गए टूल को चलाएँ:

otinstaller run --all u:johndoe
otinstaller run -a u:johndoe e:[email protected]

--all के साथ केवल u, e, p, d, और url काम करते हैं। API क्रेडेंशियल की आवश्यकता वाले टूल्स को छोड़ दिया जाता है जब तक कि --include-credentialed पास न किया जाए।

एजेंट-अनुकूल उपयोग

प्रत्येक कमांड मशीन-पठनीय आउटपुट के लिए --json का समर्थन करता है। जब --yes या -y दिया जाता है, या जब stdin टर्मिनल नहीं है (CI मोड), तो कमांड कभी प्रॉम्प्ट नहीं करते। एग्ज़िट कोड स्थिर हैं: 0 = सफलता, 1 = त्रुटि, 2 = अमान्य इनपुट, 130 = बाधित।

कमांड संदर्भ:

• otinstaller init — कॉन्फ़िग और डायरेक्टरीज़ इनिशियलाइज़ करें
• otinstaller install <tool>... — टूल्स इंस्टॉल करें
• otinstaller install --all — रजिस्ट्री से सभी उपलब्ध टूल्स इंस्टॉल करें
• otinstaller remove <tool>... / --all — टूल्स रिमूव करें
• otinstaller run <tool>... -- <args> — टूल्स चलाएँ
• otinstaller run --all u:... — सभी मेल खाते टूल्स चलाएँ
• otinstaller run --live — समानांतर रन के लिए लाइव स्टेटस टेबल दिखाएँ
• otinstaller run --case <name> — रन को एक नामित केस के अंतर्गत समूहित करें
• otinstaller info <tool> — टूल विवरण दिखाएँ
• otinstaller list / --installed — टूल्स की सूची बनाएँ
• otinstaller search <query> — टूल्स खोजें
• otinstaller update / --all / --check-only — टूल्स अपडेट करें
• otinstaller check-updates — अपडेट की जाँच करें (केवल-पढ़ने योग्य)
• otinstaller auto <target> — प्रकार स्वतः पहचानें और टूल्स चलाएँ
• otinstaller example <tool> — उदाहरण आउटपुट दिखाएँ
• otinstaller keys check — API कुंजियाँ जाँचें
• otinstaller resume — बाधित जॉब्स फिर से शुरू करें
• otinstaller doctor — डायग्नोस्टिक्स चलाएँ
• otinstaller about — क्रेडिट के साथ about बैनर दिखाएँ
• otinstaller extract <target> — सेव किए गए परिणाम फ़ाइलों से संकेतक निकालें
• otinstaller diff <tool> <target> — एक ही टूल के एक ही लक्ष्य के विरुद्ध दो सबसे हाल के रन की तुलना करें
• otinstaller playbook [name] [target] — एक playbook चलाएँ
• otinstaller playbook --list — उपलब्ध playbooks की सूची बनाएँ
• otinstaller <tool> — टूल विवरण दिखाएँ (info <tool> के समान)

AI एजेंट्स के लिए: रिपॉज़िटरी रूट पर llms.txt देखें।

परिणाम

परिणाम स्वचालित रूप से ./results/<tool>/<target>/ में फ़ाइलनाम पैटर्न <YYYYmmdd-HHMMSS>_<tool>_<target>_<runid>.<ext> और एक .meta.json साइडकार का उपयोग करके सेव किए जाते हैं। परिणाम डायरेक्टरी को --output या OTINSTALLER_RESULTS_DIR से ओवरराइड किया जा सकता है। परिणाम उस फ़ोल्डर में ./results/ में सेव किए जाते हैं जहाँ कमांड चलाई जाती है, इसलिए इसे हर बार उसी फ़ोल्डर से चलाएँ।

उदाहरण:

results/sherlock/testuser/20260929-123456_sherlock_testuser_abc123.txt
results/sherlock/testuser/20260929-123456_sherlock_testuser_abc123.meta.json

API कुंजियाँ

एक env फ़ाइल सभी API कुंजियाँ रखती है: ~/.otinstaller/.env, अनुमतियाँ 600। प्रत्येक टूल को केवल वे कुंजियाँ मिलती हैं जो वह अपनी रजिस्ट्री प्रविष्टि में घोषित करता है। सत्यापित करने के लिए otinstaller keys check का उपयोग करें।

Resume