osintversehq/otinstallerInstalliert, führt aus, aktualisiert und entfernt Open-Source-OSINT-Kommandozeilenwerkzeuge nach Namen, mit typisierten Eingaben, JSON-Ausgabe und gespeicherten Ergebnissen für automatisierte Reconnaissance-Workflows.
Installieren, ausführen, aktualisieren und entfernen Sie Open-Source-Kommandozeilenwerkzeuge anhand ihres Namens.
Sie wählen ein Werkzeug aus einer Liste. OTinstaller lädt es in seinen eigenen Ordner herunter, führt es aus und speichert die Ausgabe. Sie müssen nicht für jedes Werkzeug eine andere Installationsmethode lernen.
otinstaller ist auf PyPI veröffentlicht (Version 0.0.1).
Eine Linux-Maschine. Getestet auf Ubuntu 22.04 und 24.04, Debian 12 und Arch Linux. Kali Linux wird vor einer Veröffentlichung manuell geprüft.
Python 3.10 bis 3.12, git und das Modul venv. Installieren Sie dieses Modul auf Debian, Ubuntu und Kali mit:
sudo apt install python3-venv git
Ubuntu 26.04 LTS liefert standardmäßig Python 3.14 mit, und andere Distributionen liefern inzwischen ebenfalls Python 3.13+ mit. otinstaller und einige seiner verwalteten Werkzeuge erfordern Python 3.10–3.12, daher installieren Sie auf diesen Systemen Python 3.12 explizit und führen otinstaller in einer damit erstellten virtuellen Umgebung aus:
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
Eine von uv erstellte virtuelle Umgebung hat kein pip, daher lautet der Installationsbefehl uv pip install otinstaller. Führen Sie source ~/.otinstaller-venv/bin/activate in jedem neuen Terminal erneut aus, bevor Sie otinstaller verwenden. otinstaller doctor gibt die Python-Version aus, unter der es läuft, und kennzeichnet jedes registrierte Werkzeug, das eine andere benötigt.
Das System-Python auf Ubuntu 22.04 und 24.04 funktioniert bereits. Die uv-Methode wurde nur auf Ubuntu 26.04 getestet.
Einige verwaltete Werkzeuge unterstützen Python 3.13+ noch nicht. Die Testmatrix deckt Python 3.10–3.12 ab. Bekannte betroffene Werkzeuge:
auto-archiver: erfordert Python <3.13 (Abhängigkeit pdqhash benötigt einen C++-Compiler, kein Wheel für 3.13+)telepathy: erfordert Python <3.13 (Abhängigkeit googletrans/httpx verwendet das entfernte Modul cgi)Wenn bei Python 3.13+ Installationsfehler auftreten, führen Sie otinstaller in einer virtuellen Python-3.12-Umgebung aus.
Für eine systemweite Installation verwenden Sie pipx install otinstaller. Dies stellt die Befehle otinstaller und ot in Ihrem PATH ohne virtuelle Umgebung bereit.
Alternativ erstellen Sie eine virtuelle Umgebung und installieren Sie von PyPI:
python3 -m venv ~/.otinstaller-venv
source ~/.otinstaller-venv/bin/activate
pip install otinstaller
Führen Sie source ~/.otinstaller-venv/bin/activate in jedem neuen Terminal erneut aus, bevor Sie otinstaller verwenden.
Um aus diesem Repository zu installieren (für die Entwicklung):
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Führen Sie source .venv/bin/activate aus diesem Ordner in jedem neuen Terminal erneut aus, wenn der nächste Befehl otinstaller: command not found meldet.
Prüfen Sie die Maschine mit:
otinstaller doctor
doctor gibt [ok] oder [problem] für Linux, Python, git und venv aus. Beheben Sie jede [problem]-Zeile, bevor Sie fortfahren. Sie nennt oft das zu installierende Paket.
init erstellt ~/.otinstaller/ und zeigt einen Hinweis zur verantwortungsvollen Nutzung an. Es fragt Do you accept? [y/N]. Geben Sie y ein und drücken Sie Enter. Bis dahin kann nichts installiert werden.
otinstaller init
Sherlock sucht nach einem Benutzernamen. Diese Installation fragt Install? [y/N]. Das große N bedeutet, dass Enter allein Nein bedeutet. Geben Sie y ein, um fortzufahren.
otinstaller install sherlock
otinstaller run sherlock -- someexampleuser123
Das -- markiert, wo otinstallers eigene Optionen enden. Alles danach wird an Sherlock übergeben. Wenn der Lauf abgeschlossen ist, gibt otinstaller einen Pfad unter results/ in dem Ordner aus, in dem Sie den Befehl ausgeführt haben. Diese Datei ist die Ausgabe des Werkzeugs.
Um ein anderes Werkzeug auszuprobieren, verwenden Sie dessen Namen aus der Anleitung anstelle von sherlock.
Anstatt sich die Flags jedes Werkzeugs zu merken, können Sie typisierte Eingabepräfixe verwenden:
u: Benutzername (z. B. u:johndoe)e: E-Mail (z. B. e:[email protected])p: Telefon (z. B. p:+15551234567)d: Domain (z. B. d:example.com)url: URL (z. B. url:https://example.com)q: Textabfrage (z. B. q:search terms)geo: Koordinaten (z. B. geo:32.22,-110.97)tg: Telegram-Kanal (z. B. tg:channelname)lat: Breitengrad (z. B. lat:37.7749)lng: Längengrad (z. B. lng:-122.4194)Beispiel:
otinstaller run sherlock -- u:johndoe
otinstaller run ghunt -- u:johndoe e:[email protected]
Jedes Werkzeug deklariert, welche Eingabetypen es unterstützt. Verwenden Sie otinstaller info <tool>, um die Zuordnung zu sehen.
Führen Sie jedes installierte Werkzeug aus, das einen bestimmten Eingabetyp unterstützt:
otinstaller run --all u:johndoe
otinstaller run -a u:johndoe e:[email protected]
Nur u, e, p, d und url funktionieren mit --all. Werkzeuge, die API-Anmeldedaten erfordern, werden übersprungen, es sei denn, --include-credentialed wird übergeben.
Jeder Befehl unterstützt --json für maschinenlesbare Ausgabe. Befehle fragen niemals nach, wenn --yes oder -y angegeben wird oder wenn stdin kein Terminal ist (CI-Modus). Exit-Codes sind stabil: 0 = Erfolg, 1 = Fehler, 2 = ungültige Eingabe, 130 = unterbrochen.
Befehlsreferenz:
otinstaller init — Konfiguration und Verzeichnisse initialisierenotinstaller install <tool>... — Werkzeuge installierenotinstaller install --all — Alle verfügbaren Werkzeuge aus der Registry installierenotinstaller remove <tool>... / --all — Werkzeuge entfernenotinstaller run <tool>... -- <args> — Werkzeuge ausführenotinstaller run --all u:... — Alle passenden Werkzeuge ausführenotinstaller run --live — Eine Live-Statustabelle für parallele Läufe anzeigenotinstaller run --case <name> — Läufe unter einem benannten Fall gruppierenotinstaller info <tool> — Werkzeugdetails anzeigenotinstaller list / --installed — Werkzeuge auflistenotinstaller search <query> — Werkzeuge durchsuchenotinstaller update / --all / --check-only — Werkzeuge aktualisierenotinstaller check-updates — Auf Aktualisierungen prüfen (schreibgeschützt)otinstaller auto <target> — Typ automatisch erkennen und Werkzeuge ausführenotinstaller example <tool> — Beispielausgabe anzeigenotinstaller keys check — API-Schlüssel prüfenotinstaller resume — Unterbrochene Aufträge fortsetzenotinstaller doctor — Diagnose ausführenotinstaller about — Das About-Banner mit Credits anzeigenotinstaller extract <target> — Indikatoren aus gespeicherten Ergebnisdateien extrahierenotinstaller diff <tool> <target> — Die zwei jüngsten Läufe desselben Werkzeugs gegen dasselbe Ziel vergleichenotinstaller playbook [name] [target] — Ein Playbook ausführenotinstaller playbook --list — Verfügbare Playbooks auflistenotinstaller <tool> — Werkzeugdetails anzeigen (entspricht info <tool>)Für KI-Agenten: siehe llms.txt im Repository-Stammverzeichnis.