osintversehq/otinstallerInstalle, exécute, met à jour et supprime des outils OSINT en ligne de commande open source par nom, avec des entrées typées, une sortie JSON et des résultats enregistrés pour les workflows de reconnaissance automatisés.
Installez, exécutez, mettez à jour et supprimez des outils en ligne de commande open source par leur nom.
Vous choisissez un outil dans une liste. OTinstaller le télécharge dans son propre dossier, l'exécute et enregistre la sortie. Vous n'avez pas à apprendre une méthode d'installation différente pour chaque outil.
otinstaller est publié sur PyPI (version 0.0.1).
Une machine Linux. Testé sur Ubuntu 22.04 et 24.04, Debian 12 et Arch Linux. Kali Linux est vérifié manuellement avant chaque version.
Python 3.10 à 3.12, git et le module venv. Sur Debian, Ubuntu et Kali, installez ce module avec :
sudo apt install python3-venv git
Ubuntu 26.04 LTS est livré avec Python 3.14 par défaut, et d'autres distributions sont désormais également livrées avec Python 3.13+. otinstaller et certains des outils qu'il gère nécessitent Python 3.10–3.12, donc sur ces systèmes, installez explicitement Python 3.12 et exécutez otinstaller dans un virtualenv créé avec celui-ci :
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 créé par uv n'a pas pip, donc la commande d'installation est uv pip install otinstaller. Exécutez à nouveau source ~/.otinstaller-venv/bin/activate dans tout nouveau terminal avant d'utiliser otinstaller. otinstaller doctor affiche la version de Python sous laquelle il s'exécute et signale tout outil enregistré qui en nécessite une différente.
Le Python système sur Ubuntu 22.04 et 24.04 fonctionne déjà. La méthode uv n'a été testée que sur Ubuntu 26.04.
Certains outils gérés ne prennent pas encore en charge Python 3.13+. La matrice de tests couvre Python 3.10–3.12. Outils connus comme affectés :
auto-archiver : nécessite Python <3.13 (la dépendance pdqhash nécessite un compilateur C++, pas de wheel pour 3.13+)telepathy : nécessite Python <3.13 (la dépendance googletrans/httpx utilise le module cgi supprimé)Si vous rencontrez des échecs d'installation sur Python 3.13+, exécutez otinstaller dans un virtualenv Python 3.12.
Pour une installation à l'échelle du système, utilisez pipx install otinstaller. Cela fournit les commandes otinstaller et ot dans votre PATH sans virtualenv.
Alternativement, créez un virtualenv et installez depuis PyPI :
python3 -m venv ~/.otinstaller-venv
source ~/.otinstaller-venv/bin/activate
pip install otinstaller
Exécutez à nouveau source ~/.otinstaller-venv/bin/activate dans tout nouveau terminal avant d'utiliser otinstaller.
Pour installer depuis ce dépôt (pour le développement) :
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Exécutez à nouveau source .venv/bin/activate depuis ce dossier dans tout nouveau terminal si la commande suivante indique otinstaller: command not found.
Vérifiez la machine avec :
otinstaller doctor
doctor affiche [ok] ou [problem] pour Linux, Python, git et venv. Corrigez toute ligne [problem] avant de continuer. Il indique souvent le paquet à installer.
init crée ~/.otinstaller/ et affiche un avis d'utilisation responsable. Il demande Do you accept? [y/N]. Tapez y et appuyez sur Entrée. Rien ne peut être installé tant que vous ne l'avez pas fait.
otinstaller init
Sherlock recherche un nom d'utilisateur. Cette installation demande Install? [y/N]. Le N majuscule signifie qu'Entrée seul signifie non. Tapez y pour continuer.
otinstaller install sherlock
otinstaller run sherlock -- someexampleuser123
Le -- marque la fin des options propres à otinstaller. Tout ce qui suit est transmis à Sherlock. Lorsque l'exécution se termine, otinstaller affiche un chemin sous results/ dans le dossier où vous avez exécuté la commande. Ce fichier est la sortie de l'outil.
Pour essayer un autre outil, utilisez son nom du guide à la place de sherlock.
Au lieu de mémoriser les options de chaque outil, vous pouvez utiliser des préfixes d'entrée typés :
u: nom d'utilisateur (par ex., u:johndoe)e: e-mail (par ex., e:[email protected])p: téléphone (par ex., p:+15551234567)d: domaine (par ex., d:example.com)url: URL (par ex., url:https://example.com)q: requête textuelle (par ex., q:search terms)geo: coordonnées (par ex., geo:32.22,-110.97)tg: canal Telegram (par ex., tg:channelname)lat: latitude (par ex., lat:37.7749)lng: longitude (par ex., lng:-122.4194)Exemple :
otinstaller run sherlock -- u:johndoe
otinstaller run ghunt -- u:johndoe e:[email protected]
Chaque outil déclare les types d'entrée qu'il prend en charge. Utilisez otinstaller info <tool> pour voir la correspondance.
Exécutez tous les outils installés qui prennent en charge un type d'entrée donné :
otinstaller run --all u:johndoe
otinstaller run -a u:johndoe e:[email protected]
Seuls u, e, p, d et url fonctionnent avec --all. Les outils nécessitant des identifiants API sont ignorés sauf si --include-credentialed est passé.
Chaque commande prend en charge --json pour une sortie lisible par machine. Les commandes ne demandent jamais d'interaction lorsque --yes ou -y est fourni, ou lorsque stdin n'est pas un terminal (mode CI). Les codes de sortie sont stables : 0 = succès, 1 = erreur, 2 = entrée invalide, 130 = interrompu.
Référence des commandes :
otinstaller init — Initialiser la configuration et les répertoiresotinstaller install <tool>... — Installer des outilsotinstaller install --all — Installer tous les outils disponibles du registreotinstaller remove <tool>... / --all — Supprimer des outilsotinstaller run <tool>... -- <args> — Exécuter des outilsotinstaller run --all u:... — Exécuter tous les outils correspondantsotinstaller run --live — Afficher un tableau d'état en direct pour les exécutions parallèlesotinstaller run --case <name> — Regrouper les exécutions sous un cas nomméotinstaller info <tool> — Afficher les détails d'un outilotinstaller list / --installed — Lister les outilsotinstaller search <query> — Rechercher des outilsotinstaller update / --all / --check-only — Mettre à jour les outilsotinstaller check-updates — Vérifier les mises à jour (lecture seule)otinstaller auto <target> — Détecter automatiquement le type et exécuter les outilsotinstaller example <tool> — Afficher un exemple de sortieotinstaller keys check — Vérifier les clés APIotinstaller resume — Reprendre les tâches interrompuesotinstaller doctor — Exécuter les diagnosticsotinstaller about — Afficher la bannière about avec les créditsotinstaller extract <target> — Extraire les indicateurs des fichiers de résultats enregistrésotinstaller diff <tool> <target> — Comparer les deux exécutions les plus récentes du même outil sur la même cibleotinstaller playbook [name] [target] — Exécuter un playbookotinstaller playbook --list — Lister les playbooks disponiblesotinstaller <tool> — Afficher les détails d'un outil (identique à info <tool>)Pour les agents IA : voir llms.txt à la racine du dépôt.