OllamaHound é um kit modular, orientado a Red Team, para descobrir servidores Ollama publicamente expostos, identificar versões, classificar exposição a CVEs, validar se a geração de texto é possível e (opcionalmente) ativar uma sessão CLI interativa para testes controlados.

@@@@@@@@@@@@@@@@@@@@@@@@@@@#*#@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@%.-+-:#@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@+--=%@@@@@@@@-.@@@+ #@@@@@@@@@@@@@@@@@
@@@@@@@@@@@= %%+.=@@@%###-.@@@@= %@@@@@@@@@@@@@@@@
@@@@@@@@@@@-.@@@@..--====-.=@@@@.-@@@@@@@@@@@@@@@@
@@@@@@@@@@@# +#+-:*%@@@@@@@@@@@@- +@@@@@@@@@@@@@@@
@@*@@@@@#*+=:::.-*%@@@@@@@@@@@@@@%::%@@@@@@@@@@@@@
@+:-@@*----=***+==-=#@@@@@@@@@@@@@@::@@@@@@@@@@@@@
@*+#@=-==+=%@@@@%#=+:*%%%@@@@#++%@@+ %@@@@@@@@@@@@
+:=@#.+-@#=#@%+++%@:* =++==*@-  *@@-.@@@@@@@@@@@@@
%=+@+--*@@*=##+++%#.+::=@#%:+@%@@@@%.=@@@@@@@@@@@@
@@@@#.+-@@%=*@@@@@+.* =-:*@-=@@@@@@@* %@@@@@@@@@@@
@@@@@+:==#*=%@@@@*-=.:--+*-=@@@@@@@@+ %@@@@@@@@@@@
@@@@@@#=----+*++=--=**++*#%@@@@@@@@% =@@@@@@@@@@@@
@@@@@@@@%*-:---.+*%@@@@@@@@@@@@@@@@+-:+@@@@@@@@@@@
@@@@@@@@@@# ==:.%@@@@@@@@@@@@@@@@@@@@%.-@@@@@@@@@@
@@@@@@@@@@#.@@:.#@@@@@@@@@@@@@@#@@@@@@% *@@@@@@@@@
@@@@@@@@@*::--::=%@@@@@@@@@@@@::@@@@@@@ =@@@@@@@@@
@@@@@@@@-.#@@@@@-.@@@@@@@@@@#.-@@@@@@@@*.-@@@@@@@@
@@@@@@@@.-@@@@@%::@@@@@@@@%=.+@@@@@@@@@@%.-@@@@@@@
@@@@@@@@#::++=::+@@@@@@@%=:=%@@@@@%%@@@@@+ @@@@@@@
@@@@@@@@@@=.:: #@@@@@@@=.+@@@@@@%=:*@@@@@= @@@@@@@
@@@@@@@@@@@@%-.%@@@@@@# *@@@@@#-:+@@@@@@% +@@@@@@@
@@@@@@@@@@@@@.=@@@@@@@@=:===---*@@@@@@@@@.=@@@@@@@
@@@@@@@@@@@@@=.%@@@@@@@@#-##%@@@@@@@@@@@@.-@@@@@@@
@@@@@@@@@@@@@@= -%@@@@@@# #@@@@@@@@@@@@@# #@@@@@@@
@@@@@@@@@@@@@@@ .:=*%%@%#..*@@@@@@@@@@@+.+@@@@@@@@
@@@@@@@@@@@@@@@.=@*==- -=*. --==+*#**=:-#@@@@@@@@@
@@@@@@@@@@@@@@@:-@@@@# #@@+ %%##*..++#%@@@@@@@@@@@
@@@@@@@@@@@@@@@::@@@@-.@@@% *@@@@-:@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@*.=++::%@@@@::%@%+ *@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@%***%@@@@@@%=---=%@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@---OllamaHound---@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@---Por 7h30th3r0n3---@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Índice

• Módulos
• Fluxo típico
• Principais recursos (Scanner)
• Requisitos
• Início rápido
• Folha de referência de comandos
• Saída do Scanner
• Navigator (ajudante de CSV do scanner)
• Connector (CLI interativa)
• Scraper (ajudante do Shodan)
• Flags do Orchestrator (alto nível)
• Arquivos de saída (resumo)
• Notas sobre a interpretação do tamanho do modelo
• Segurança, ética e escopo
• Autor

Módulos

Recursos

• ⚡ Varredura em larga escala com sockets assíncronos e interface de progresso rica
• 🧠 Classificação de versão + CVE para exposição a RCE/DoS
• ✅ Validação de modelo via /api/tags e /api/generate
• 🧭 Filtros do Navigator para deduplicação, ordenação e exportação
• 💬 Connector interativo para testar prompts com segurança

Fluxo típico

1. Coletar alvos (opcional) → results/scraper/targets.txt
2. Escanear alvos → results/scanner/<prefixo>_AAAAMMDD_HHMMSS.csv
3. Navegar + filtrar resultados → exportações opcionais em JSON/CSV
4. Conectar a um host/modelo escolhido → CLI interativa

Você pode fazer isso passo a passo ou executar o Orchestrator para encadear as três primeiras etapas.

Principais recursos (Scanner)

• Varredura rápida e assíncrona usando asyncio + aiohttp (milhares de sockets simultâneos)
• Interface de progresso (ETA, taxa de transferência, conclusão) via rich
• Relatório CSV com timestamp: <prefixo>_AAAAMMDD_HHMMSS.csv
• Tabela de saída colorida
  • RCE: vermelho
  • DoS: amarelo
  • Corrigido: verde
• Interpretação de versão
  • GET /api/version → fallback GET /version → fallback cabeçalho Server
• Classificação de CVE
  • CVE-2024-7773 (RCE): versão < 0.1.47
  • CVE-2025-0317 (DoS): versão <= 0.3.14
• Descoberta e validação de modelos
  • Enumera modelos via GET /api/tags
  • Testa geração via POST /api/generate
• Ordenação inteligente
  • Hosts onde /api/generate retorna HTTP 200 sobem para o topo
• Filtros poderosos
  • --gen-ok-only mantém apenas hosts com /api/generate funcionando
  • --vuln-only mantém apenas hosts classificados como RCE/DoS
  • --show-unknown inclui hosts com versões desconhecidas/não interpretáveis
• Ajustável
  • múltiplas portas, timeouts, concorrência, prefixo do CSV

Requisitos

• Python 3.10+
• Pacotes:
  • aiohttp
  • rich
  • packaging
  • requests
  • shodan

Instalar dependências:

python3 -m pip install -U aiohttp rich packaging requests shodan

Usar Docker:

docker build -t ollamahound .
docker run -it --rm ollamahound <scripts ollamahound>

Início rápido

Início rápido mínimo (2–3 comandos)

Opção A (mais rápida): coletar → escanear → conectar

python3 ollamaScraper.py
python3 ollamaScanner.py results/scraper/targets.txt --gen-ok-only
python3 ollamaConnector.py --scan-csv results/scanner/ollama_scan_*.csv

Opção B (comando único): pipeline do orchestrator

python3 ollamaOrchestrator.py --scan-gen-ok-only

Orchestrator (coleta → escaneamento → conexão em um comando)