Quick Start
Jump into using HunterX with these practical examples. From basic scans to AI-assisted testing, these examples will have you assessing targets in minutes.
Basic Scanning
Quick Scan with Default Settings
python hunterx.py -u http://testphp.vulnweb.com --profile bounty
Performs a basic scan using the bounty hunter profile, which balances speed and coverage for bug bounty scenarios.
Full Scan with All Skills
python hunterx.py -u http://testphp.vulnweb.com --preset full -p payloads
Executes a comprehensive scan using all 41 security skills and the full payload set.
Stealth Scan for Production Targets
python hunterx.py -u https://target.com --stealth high --threads 2
Conducts a low-noise scan suitable for production environments with high stealth level and reduced thread count.
Advanced Scanning Techniques
Authentication Scanning
Test authenticated sections of applications with various authentication methods:
- Basic Auth:
--auth basic --username admin --password secret - Bearer Token:
--auth bearer --token eyJhbGciOiJIUzI1NiIs... - Form Login:
--auth form --username admin --password secret --login-url http://target.com/login --username-field user --password-field pass
AI-Assisted Scanning
Leverage AI for enhanced vulnerability analysis and validation:
- Ollama (Local):
--ai --ai-model llama3.2 --ai-provider ollama - OpenAI (Cloud):
--ai --ai-model gpt-4 --ai-provider openai - Custom Settings:
--ai --ai-model gpt-4 --ai-temperature 0.3 --ai-max-retries 3
Multiple Targets & Output Formats
Scan multiple targets and generate reports in various formats:
- Targets File:
-f targets.txt --profile bounty - JSON Output:
--report-format json - HTML Report:
--report-format html - SARIF Format:
--report-format sarif(for VS Code/GitHub CodeQL)
API Server Mode
Run HunterX as a service for programmatic scanning and integration with other tools:
Start the API Server
python hunterx.py api
Starts the API server on the default port (8443) for RESTful access to all HunterX functionality.
Custom Port & Debugging
python hunterx.py api --port 8080 --debug
Run the server on a custom port with debug logging enabled for development and troubleshooting.
Pre-configured AI Provider
python hunterx.py api --port 8443 --ai-provider openai --ai-model gpt-4
Start the API server with OpenAI GPT-4 pre-configured for AI-assisted scanning.