osintversehq/otinstallerInstala, executa, atualiza e remove ferramentas de linha de comando OSINT de código aberto por nome, com entradas tipadas, saída JSON e resultados salvos para fluxos de trabalho de reconhecimento automatizado.
Instale, execute, atualize e remova ferramentas de linha de comando de código aberto pelo nome.
Você escolhe uma ferramenta de uma lista. O OTinstaller a baixa para sua própria pasta, a executa e salva a saída. Você não precisa aprender um método de instalação diferente para cada ferramenta.
otinstaller é publicado no PyPI (versão 0.0.1).
Uma máquina Linux. Testado no Ubuntu 22.04 e 24.04, Debian 12 e Arch Linux. O Kali Linux é verificado manualmente antes de um lançamento.
Python 3.10 a 3.12, git e o módulo venv. No Debian, Ubuntu e Kali, instale esse módulo com:
sudo apt install python3-venv git
O Ubuntu 26.04 LTS vem com Python 3.14 por padrão, e outras distribuições agora também vêm com Python 3.13+. O otinstaller e algumas de suas ferramentas gerenciadas exigem Python 3.10–3.12, então nesses sistemas instale o Python 3.12 explicitamente e execute o otinstaller dentro de um virtualenv criado com ele:
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
Um virtualenv criado com uv não tem pip, então o comando de instalação é uv pip install otinstaller. Execute source ~/.otinstaller-venv/bin/activate novamente em qualquer novo terminal antes de usar o otinstaller. otinstaller doctor imprime a versão do Python sob a qual está sendo executado e sinaliza qualquer ferramenta registrada que precise de uma versão diferente.
O Python do sistema no Ubuntu 22.04 e 24.04 já funciona. O método com uv foi testado apenas no Ubuntu 26.04.
Algumas ferramentas gerenciadas ainda não suportam Python 3.13+. A matriz de testes cobre Python 3.10–3.12. Ferramentas afetadas conhecidas:
auto-archiver: requer Python <3.13 (a dependência pdqhash precisa de um compilador C++, sem wheel para 3.13+)telepathy: requer Python <3.13 (a dependência googletrans/httpx usa o módulo cgi removido)Se você encontrar falhas de instalação no Python 3.13+, execute o otinstaller em um virtualenv com Python 3.12.
Para instalação em todo o sistema, use pipx install otinstaller. Isso fornece os comandos otinstaller e ot no seu PATH sem um virtualenv.
Como alternativa, crie um virtualenv e instale a partir do PyPI:
python3 -m venv ~/.otinstaller-venv
source ~/.otinstaller-venv/bin/activate
pip install otinstaller
Execute source ~/.otinstaller-venv/bin/activate novamente em qualquer novo terminal antes de usar o otinstaller.
Para instalar a partir deste repositório (para desenvolvimento):
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Execute source .venv/bin/activate novamente a partir desta pasta em qualquer novo terminal se o próximo comando disser otinstaller: command not found.
Verifique a máquina com:
otinstaller doctor
doctor imprime [ok] ou [problem] para Linux, Python, git e venv. Corrija qualquer linha [problem] antes de continuar. Ele geralmente informa o pacote a instalar.
init cria ~/.otinstaller/ e mostra um aviso de uso responsável. Ele pergunta Do you accept? [y/N]. Digite y e pressione Enter. Nada pode ser instalado até que você faça isso.
otinstaller init
O Sherlock procura por um nome de usuário. Esta instalação pergunta Install? [y/N]. O N maiúsculo significa que apenas Enter significa não. Digite y para continuar.
otinstaller install sherlock
otinstaller run sherlock -- someexampleuser123
O -- marca onde terminam as opções do próprio otinstaller. Tudo depois dele é passado para o Sherlock. Quando a execução termina, o otinstaller imprime um caminho em results/ na pasta onde você executou o comando. Esse arquivo é a saída da ferramenta.
Para experimentar uma ferramenta diferente, use o nome dela do guia no lugar de sherlock.
Em vez de memorizar as flags de cada ferramenta, você pode usar prefixos de entrada tipada:
u: nome de usuário (ex.: u:johndoe)e: email (ex.: e:[email protected])p: telefone (ex.: p:+15551234567)d: domínio (ex.: d:example.com)url: URL (ex.: url:https://example.com)q: consulta de texto (ex.: q:search terms)geo: coordenadas (ex.: geo:32.22,-110.97)tg: canal do Telegram (ex.: tg:channelname)lat: latitude (ex.: lat:37.7749)lng: longitude (ex.: lng:-122.4194)Exemplo:
otinstaller run sherlock -- u:johndoe
otinstaller run ghunt -- u:johndoe e:[email protected]
Cada ferramenta declara quais tipos de entrada suporta. Use otinstaller info <tool> para ver o mapeamento.
Execute todas as ferramentas instaladas que suportam um determinado tipo de entrada:
otinstaller run --all u:johndoe
otinstaller run -a u:johndoe e:[email protected]
Apenas u, e, p, d e url funcionam com --all. Ferramentas que exigem credenciais de API são ignoradas, a menos que --include-credentialed seja passado.
Todo comando suporta --json para saída legível por máquina. Os comandos nunca solicitam entrada quando --yes ou -y é fornecido, ou quando stdin não é um terminal (modo CI). Os códigos de saída são estáveis: 0 = sucesso, 1 = erro, 2 = entrada inválida, 130 = interrompido.
Referência de comandos:
otinstaller init — Inicializa configuração e diretóriosotinstaller install <tool>... — Instala ferramentasotinstaller install --all — Instala todas as ferramentas disponíveis do registrootinstaller remove <tool>... / --all — Remove ferramentasotinstaller run <tool>... -- <args> — Executa ferramentasotinstaller run --all u:... — Executa todas as ferramentas correspondentesotinstaller run --live — Mostra uma tabela de status ao vivo para execuções paralelasotinstaller run --case <name> — Agrupa execuções sob um caso nomeadootinstaller info <tool> — Mostra detalhes da ferramentaotinstaller list / --installed — Lista ferramentasotinstaller search <query> — Pesquisa ferramentasotinstaller update / --all / --check-only — Atualiza ferramentasotinstaller check-updates — Verifica atualizações (somente leitura)otinstaller auto <target> — Detecta o tipo automaticamente e executa ferramentasotinstaller example <tool> — Mostra saída de exemplootinstaller keys check — Verifica chaves de APIotinstaller resume — Retoma trabalhos interrompidosotinstaller doctor — Executa diagnósticosotinstaller about — Mostra o banner about com créditosotinstaller extract <target> — Extrai indicadores de arquivos de resultado salvosotinstaller diff <tool> <target> — Compara as duas execuções mais recentes da mesma ferramenta contra o mesmo alvootinstaller playbook [name] [target] — Executa um playbookotinstaller playbook --list — Lista os playbooks disponíveisotinstaller <tool> — Mostra detalhes da ferramenta (o mesmo que info <tool>)Para agentes de IA: consulte llms.txt na raiz do repositório.
Os resultados são salvos automaticamente em ./results/<tool>/<target>/ usando o padrão de nome de arquivo <YYYYmmdd-HHMMSS>_<tool>_<target>_<runid>.<ext> mais um sidecar .meta.json. O diretório de resultados pode ser substituído com --output ou OTINSTALLER_RESULTS_DIR. Os resultados são salvos em ./results/ na pasta onde o comando é executado, então execute-o a partir da mesma pasta sempre.
Exemplo:
results/sherlock/testuser/20260929-123456_sherlock_testuser_abc123.txt
results/sherlock/testuser/20260929-123456_sherlock_testuser_abc123.meta.json