AnonSuite - Unified Security Toolkit for the Pragmatic Engineer

AnonSuite is a command-line toolkit I built after years of frustration with fragmented security tools. It pragmatically integrates battle-tested open-source components into a unified platform for multi-layered traffic obfuscation and network security auditing. This reflects a real-world development approach - balancing robust engineering with maintainable code that actually works in production.

Yes, absolutely! You can verify this immediately:

# Test it right now (works immediately after cloning)
git clone https://github.com/morningstarxcdcode/AnonSuite.git
cd AnonSuite
python src/anonsuite/main.py --demo
python src/anonsuite/main.py --health-check

Core functionality works immediately - no installation required. For full features, AnonSuite will tell you exactly what dependencies you need.

📖 Complete Real-World Usage Guide | 🧪 Run Validation Test

Immediate Usability Test (works right after cloning):

./validate_usability.sh  # Comprehensive validation

Quick Verification (3 commands):

python src/anonsuite/main.py --version    # ✓ Version info
python src/anonsuite/main.py --demo       # ✓ Feature demo  
python src/anonsuite/main.py --health-check  # ✓ System status

Production Use Cases:

• Security Professionals: Network assessment and anonymity management
• Students/Researchers: Interactive learning and concept exploration
• Penetration Testers: WiFi security testing and configuration management

• Multi-Tor Orchestration: Manages multiple Tor instances for circuit isolation and traffic routing
• Proxy Chaining: Integrates Privoxy and HAProxy for flexible proxy configurations
• Robust Logging: Detailed, timestamped logs for operational insight and debugging

• Network Reconnaissance: Comprehensive WiFi scanning and analysis
• WPS PIN Recovery: Pixiewps integration for WPS vulnerability testing
• Rogue AP Framework: WiFiPumpkin3 integration for access point simulation

• Modular Design: Built for extensibility and maintainability
• Absolute Path Reliance: Ensures binary discovery and execution reliability across environments
• Human-Coded Aesthetic: Code and documentation reflect natural, iterative development process

• macOS or Linux-based system
• Python 3.8 or higher
• sudo privileges for certain network operations
• Homebrew (macOS) or your system's package manager (Linux) for external dependencies

AnonSuite orchestrates external binaries. Install them via Homebrew (macOS) or your system's package manager:

# Install Tor
brew install tor

# Install Privoxy  
brew install privoxy

# Install HAProxy
brew install haproxy

# Install pidof (part of proctools on macOS)
brew install proctools

# Clone the repository
git clone https://github.com/morningstarxcdcode/AnonSuite.git
cd AnonSuite

# Make multitor scripts executable
chmod +x src/anonymity/multitor/multitor \
         src/anonymity/multitor/__init__ \
         src/anonymity/multitor/CreateTorProcess \
         src/anonymity/multitor/CreateProxyProcess

Important: multitor requires specific permissions and port availability. Follow these steps carefully:

1. Fix Tor Data Directory Ownership: Tor needs its data directory to be owned by the user it runs as. If previous runs created it as root, you must fix ownership:

   sudo chown -R $USER ~/Desktop/AnonSuite/src/anonymity/multitor/tor_9000
   # Repeat for any other tor_* directories if they exist

2. Resolve Privoxy Port Conflict: Privoxy's default port (8118) might be in use. You need to:

   • Kill any conflicting process:

     lsof -i :8118
     # If a process is listed, kill it (replace <PID> with the actual process ID)
     sudo kill <PID>

   • Change Privoxy's listening port: Edit its configuration file:

     sudo nano /opt/homebrew/etc/privoxy/config
     # Find the line: listen-address 127.0.0.1:8118
     # Change 8118 to an unused port, e.g., 8119:
     # listen-address 127.0.0.1:8119
     # Save and exit (CTRL+O, Enter, CTRL+X)

Once prerequisites and initial setup are complete, run multitor with your actual username. The output will be logged live to your terminal and saved to multitor.log.

# Replace <YOUR_USERNAME> with your actual system username
sudo /Users/$USER/Desktop/AnonSuite/src/anonymity/multitor/multitor \
  --user $USER \
  --socks-port 9000 \
  --control-port 9001 \
  --proxy privoxy \
  --haproxy yes

AnonSuite/
├── src/                    # Core application code
│   ├── anonsuite.py       # Main CLI interface
│   ├── config_manager.py  # Configuration management system
│   ├── anonymity/         # Tor and proxy modules
│   │   └── multitor/      # Core multitor scripts and helpers
│   │       ├── multitor
│   │       ├── __init__
│   │       ├── CreateTorProcess
│   │       ├── CreateProxyProcess
│   │       ├── helpers
│   │       ├── settings
│   │       └── multitor.log # Operational logs
│   └── wifi/              # WiFi auditing tools
│       ├── pixiewps_wrapper.py
│       ├── wifipumpkin_wrapper.py
│       └── wifi_scanner.py
├── tests/                 # Comprehensive test suite
│   ├── unit/              # Unit tests
│   ├── integration/       # Integration tests
│   └── security/          # Security tests
├── docs/                  # Project documentation
│   ├── installation.md    # Installation guide
│   ├── user-guide.md      # User documentation
│   └── troubleshooting.md # Troubleshooting guide
├── config/                # Configuration files
├── plugins/               # Plugin system
├── run/                   # Runtime files and logs
├── .github/               # GitHub Actions CI/CD workflows
│   └── workflows/
│       └── ci.yml         # Automated testing pipeline
├── .env.example           # Environment variables template
├── architect-state.json   # Project state tracking
├── pyproject.toml         # Python project configuration
└── README.md              # You are here

# Start the interactive menu
python src/anonsuite.py

# Check version and health
python src/anonsuite.py --version
python src/anonsuite.py --health-check

# Anonymity operations
python src/anonsuite.py --start-anonymity
python src/anonsuite.py --anonymity-status
python src/anonsuite.py --new-circuit

# WiFi operations
python src/anonsuite.py --wifi-scan
python src/anonsuite.py --wifi-scan --wifi-interface wlan0

# Configuration management
python src/anonsuite.py --config-wizard
python src/anonsuite.py --list-profiles
python src/anonsuite.py --create-profile production

# Plugin system
python src/anonsuite.py --list-plugins
python src/anonsuite.py --run-plugin "Network Info Plugin"

The project includes a comprehensive testing framework:

# Run all tests
pytest

# Run specific test categories
pytest tests/unit/          # Unit tests
pytest tests/integration/   # Integration tests  
pytest tests/security/      # Security tests

# Run with coverage
pytest --cov=src --cov-report=html

A GitHub Actions workflow ensures code quality and consistency:

• Linting: ruff check and ruff format --check
• Type Checking: mypy src/
• Security Scanning: bandit and safety
• Testing: pytest across multiple Python versions
• Multi-OS Support: Ubuntu and macOS

• Installation Guide: Comprehensive setup instructions
• User Guide: Detailed usage documentation
• Troubleshooting: Common issues and solutions
• multitor.log: Detailed operational logs for debugging

This toolkit is designed for:

• Authorized penetration testing
• Security research and education
• Network security assessment
• Compliance validation

• Unauthorized use is prohibited
• Always obtain explicit permission
• Respect local laws and regulations
• No warranty or liability

The developers are not responsible for misuse of this software. Users must ensure compliance with applicable laws and obtain proper authorization before conducting any security assessments.

We welcome contributions! The project follows standard open-source practices:

1. Fork the repository
2. Create a feature branch
3. Make your changes with tests
4. Ensure all tests pass
5. Submit a pull request

See our Contributing Guide for detailed guidelines.

• Developer: morningstarxcdcode
• LinkedIn: Sourav Rajak
• GitHub: @morningstarxcdcode

• Repository: AnonSuite on GitHub
• Issues: Report bugs and request features at GitHub Issues
• Discussions: Join community discussions at GitHub Discussions

This project is licensed under the MIT License - see the LICENSE file for details.

Special thanks to the developers of the integrated tools:

• trimstray for multitor
• P0cL4bs for wifipumpkin3
• wiire-a for pixiewps

Important: This tool is for authorized security testing only. Always ensure you have proper permission before conducting any security assessments. The developers assume no liability for misuse of this software.