osintversehq/otinstallerInstalla, esegue, aggiorna e rimuove strumenti OSINT da riga di comando open-source per nome, con input tipizzati, output JSON e risultati salvati per flussi di lavoro di ricognizione automatizzati.
Installa, esegui, aggiorna e rimuovi strumenti open-source da riga di comando tramite il loro nome.
Scegli uno strumento da una lista. OTinstaller lo scarica nella propria cartella, lo esegue e salva l'output. Non devi imparare un metodo di installazione diverso per ogni strumento.
otinstaller è pubblicato su PyPI (versione 0.0.1).
Una macchina Linux. Testato su Ubuntu 22.04 e 24.04, Debian 12 e Arch Linux. Kali Linux viene verificato manualmente prima di una release.
Python da 3.10 a 3.12, git e il modulo venv. Su Debian, Ubuntu e Kali, installa quel modulo con:
sudo apt install python3-venv git
Ubuntu 26.04 LTS include Python 3.14 per impostazione predefinita, e altre distribuzioni ora includono anch'esse Python 3.13+. otinstaller e alcuni degli strumenti che gestisce richiedono Python 3.10–3.12, quindi su questi sistemi installa esplicitamente Python 3.12 ed esegui otinstaller all'interno di un virtualenv creato con esso:
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
Un virtualenv creato con uv non ha pip, quindi il comando di installazione è uv pip install otinstaller. Esegui di nuovo source ~/.otinstaller-venv/bin/activate in ogni nuovo terminale prima di usare otinstaller. otinstaller doctor stampa la versione di Python con cui è in esecuzione e segnala qualsiasi strumento registrato che ne richieda una diversa.
Il Python di sistema su Ubuntu 22.04 e 24.04 funziona già. Il metodo uv è stato testato solo su Ubuntu 26.04.
Alcuni strumenti gestiti non supportano ancora Python 3.13+. La matrice di test copre Python 3.10–3.12. Strumenti noti interessati:
auto-archiver: richiede Python <3.13 (la dipendenza pdqhash necessita di un compilatore C++, nessun wheel per 3.13+)telepathy: richiede Python <3.13 (la dipendenza googletrans/httpx usa il modulo cgi rimosso)Se riscontri errori di installazione su Python 3.13+, esegui otinstaller in un virtualenv Python 3.12.
Per un'installazione a livello di sistema, usa pipx install otinstaller. Questo fornisce i comandi otinstaller e ot nel tuo PATH senza un virtualenv.
In alternativa, crea un virtualenv e installa da PyPI:
python3 -m venv ~/.otinstaller-venv
source ~/.otinstaller-venv/bin/activate
pip install otinstaller
Esegui di nuovo source ~/.otinstaller-venv/bin/activate in ogni nuovo terminale prima di usare otinstaller.
Per installare da questo repository (per lo sviluppo):
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Esegui di nuovo source .venv/bin/activate da questa cartella in ogni nuovo terminale se il comando successivo dice otinstaller: command not found.
Verifica la macchina con:
otinstaller doctor
doctor stampa [ok] o [problem] per Linux, Python, git e venv. Risolvi qualsiasi riga [problem] prima di continuare. Spesso ti indica il pacchetto da installare.
init crea ~/.otinstaller/ e mostra un avviso di uso responsabile. Chiede Do you accept? [y/N]. Digita y e premi Invio. Nulla può essere installato finché non lo fai.
otinstaller init
Sherlock cerca un nome utente. Questa installazione chiede Install? [y/N]. La N maiuscola significa che Invio da solo significa no. Digita y per continuare.
otinstaller install sherlock
otinstaller run sherlock -- someexampleuser123
Il -- segna dove finiscono le opzioni proprie di otinstaller. Tutto ciò che segue viene passato a Sherlock. Al termine dell'esecuzione, otinstaller stampa un percorso sotto results/ nella cartella in cui hai eseguito il comando. Quel file è l'output dello strumento.
Per provare uno strumento diverso, usa il suo nome dalla guida al posto di sherlock.
Invece di ricordare i flag di ogni strumento, puoi usare prefissi di input tipizzati:
u: username (es., u:johndoe)e: email (es., e:[email protected])p: telefono (es., p:+15551234567)d: dominio (es., d:example.com)url: URL (es., url:https://example.com)q: query testuale (es., q:search terms)geo: coordinate (es., geo:32.22,-110.97)tg: canale Telegram (es., tg:channelname)lat: latitudine (es., lat:37.7749)lng: longitudine (es., lng:-122.4194)Esempio:
otinstaller run sherlock -- u:johndoe
otinstaller run ghunt -- u:johndoe e:[email protected]
Ogni strumento dichiara quali tipi di input supporta. Usa otinstaller info <tool> per vedere la mappatura.
Esegui ogni strumento installato che supporta un dato tipo di input:
otinstaller run --all u:johndoe
otinstaller run -a u:johndoe e:[email protected]
Solo u, e, p, d e url funzionano con --all. Gli strumenti che richiedono credenziali API vengono saltati a meno che non venga passato --include-credentialed.
Ogni comando supporta --json per un output leggibile dalla macchina. I comandi non chiedono mai conferma quando viene fornito --yes o -y, o quando stdin non è un terminale (modalità CI). I codici di uscita sono stabili: 0 = successo, 1 = errore, 2 = input non valido, 130 = interrotto.
Riferimento dei comandi:
otinstaller init — Inizializza configurazione e directoryotinstaller install <tool>... — Installa strumentiotinstaller install --all — Installa tutti gli strumenti disponibili dal registrootinstaller remove <tool>... / --all — Rimuovi strumentiotinstaller run <tool>... -- <args> — Esegui strumentiotinstaller run --all u:... — Esegui tutti gli strumenti corrispondentiotinstaller run --live — Mostra una tabella di stato in tempo reale per esecuzioni paralleleotinstaller run --case <name> — Raggruppa le esecuzioni sotto un caso con nomeotinstaller info <tool> — Mostra i dettagli dello strumentootinstaller list / --installed — Elenca gli strumentiotinstaller search <query> — Cerca strumentiotinstaller update / --all / --check-only — Aggiorna strumentiotinstaller check-updates — Verifica aggiornamenti (sola lettura)otinstaller auto <target> — Rileva automaticamente il tipo ed esegui gli strumentiotinstaller example <tool> — Mostra un output di esempiootinstaller keys check — Verifica le chiavi APIotinstaller resume — Riprendi i job interrottiotinstaller doctor — Esegui la diagnosticaotinstaller about — Mostra il banner about con i creditiotinstaller extract <target> — Estrai indicatori dai file di risultato salvatiotinstaller diff <tool> <target> — Confronta le due esecuzioni più recenti dello stesso strumento sullo stesso targetotinstaller playbook [name] [target] — Esegui un playbookotinstaller playbook --list — Elenca i playbook disponibiliotinstaller <tool> — Mostra i dettagli dello strumento (come info <tool>)Per gli agenti AI: vedi llms.txt nella radice del repository.
I risultati vengono salvati automaticamente in ./results/<tool>/<target>/ usando il modello di nome file <YYYYmmdd-HHMMSS>_<tool>_<target>_<runid>.<ext> più un file collaterale .meta.json. La directory dei risultati può essere sovrascritta con --output o OTINSTALLER_RESULTS_DIR. I risultati vengono salvati in ./results/ nella cartella in cui viene eseguito il comando, quindi eseguilo dalla stessa cartella ogni volta.
Esempio:
results/sherlock/testuser/20260929-123456_sherlock_testuser_abc123.txt
results/sherlock/testuser/20260929-123456_sherlock_testuser_abc123.meta.json