A Python-based toolkit for Information Gathering & Reconnaissance

Argus is an all-in-one, Python-powered toolkit designed to streamline the process of information gathering and reconnaissance. With a user-friendly interface and a suite of powerful modules, Argus empowers you to explore networks, web applications, and security configurations efficiently and effectively.

This tool is intended for educational and ethical use only. The author is not liable for any illegal use or misuse of this tool. Users are solely responsible for their actions and must ensure they have explicit permission to scan the target systems.

Take a look at Argus in action: Take a look at Argus in action:

git clone https://github.com/jasonxtn/argus.git
cd argus
python -m argus

pip install argus-recon
argus

git clone https://github.com/jasonxtn/argus.git
cd argus
chmod +x install.sh && ./install.sh
python -m argus

git clone https://github.com/jasonxtn/argus.git
cd argus
docker build -t argus-recon:latest .
docker run -it --rm -v $(pwd)/results:/app/results argus-recon:latest

1. Launch Argus:

   argus
   # or if running from folder: python -m argus

2. Browse available modules:

   argus> modules
   

3. Select a module:

   argus> use 1
   

4. Set target and options:

   argus> set target example.com
   argus> set threads 10
   

5. Run the module:

   argus> run
   

# Basic workflow
modules          # Browse available modules
use 42           # Select module 42
set target example.com
run              # Execute module

# Search and filter
search ssl       # Find SSL-related modules
modules tag:dns  # Filter by capability tag

# Batch operations
runall infra     # Run all infrastructure modules
runfav           # Run favorite modules

# Information
show modules     # Detailed module list
helpmod 42       # Module-specific help
scope            # Current configuration
show api_status  # Check API configuration

$ argus

argus> modules
argus> use 1
argus> set target example.com
argus> set threads 10
argus> run

argus> modules -d
argus> use 65
argus> set max_pages 200
argus> run

argus> show api_status
argus> fav add 1
argus> runfav

# Browse all modules
modules

# Filter by category
modules infra    # Network & Infrastructure
modules web      # Web Application Analysis  
modules sec      # Security & Threat Intelligence

# Search by capability
search dns       # Find DNS-related modules
search ssl       # Find SSL/TLS modules
search api       # Find API testing modules

# Get detailed help
helpmod 42       # Module-specific help
show modules -d  # Detailed module list

Pre‑configured scan depths and behaviors for different use cases:

Usage:

argus> profile deep
argus> run 1 3 8

Enhance functionality by configuring API keys in config/settings.py or as environment variables:

export VIRUSTOTAL_API_KEY="your_key_here"
export SHODAN_API_KEY="your_key_here"
export CENSYS_API_ID="your_id_here"
export CENSYS_API_SECRET="your_secret_here"
export GOOGLE_API_KEY="your_key_here"
export HIBP_API_KEY="your_key_here"

Check API status:

argus> show api_status

Edit config/settings.py to customize:

• Default request timeouts and retry logic
• Thread limits and concurrency settings
• Export settings (TXT/CSV output)
• Logging levels and destinations
• User agent strings and headers

make help          # Show all available commands
make install       # Install Argus
make install-dev   # Install with development dependencies
make test          # Run tests
make lint          # Run code linting
make format        # Format code with black/isort
make docker-build  # Build Docker image
make security-check # Run security analysis

Major refactor: Complete CLI redesign and module expansion

• New interactive CLI - Full command-line interface with 25+ commands
• 135 modules - Expanded from 50 modules
• Better UI - Professional formatting and progress tracking
• Multi-threading - Improved performance with concurrent execution
• API integrations - Shodan, VirusTotal, Censys, SSL Labs support
• Export capabilities - TXT, CSV, JSON output formats
• Configuration system - Profiles, settings, and API key management
• Module discovery - Search, browse, and favorite modules
• Batch operations - Run multiple modules simultaneously

Original simple number-based interface

• Simple number input system (1-50)
• Basic 50 reconnaissance modules
• Console text output only
• Fixed configuration settings

Note: Version 2.0 introduces breaking changes. Users must learn new CLI commands instead of the previous number-based system.

If this tool has been helpful to you, please consider giving us a star on GitHub! Your support means a lot to us and helps others discover the project.

• Check existing issues before reporting
• Provide detailed reproduction steps
• Include system information and error logs