souleyez 2.22.0__tar.gz → 2.24.0__tar.gz

{souleyez-2.22.0 → souleyez-2.24.0}/BETA_README.md

@@ -21,7 +21,7 @@ Welcome to the SoulEyez beta! Thank you for helping us test and improve this pen
 
 > ⚠️ **Important**: Only use SoulEyez on systems you have explicit authorization to test.
 
-## Version: 2.22.0
+## Version: 2.24.0
 
 ### What's Included
 
@@ -76,6 +76,8 @@ pipx ensurepath          # Add pipx apps to your PATH
 source ~/.bashrc         # Reload your shell (or close and reopen terminal)
 ```
 
+> **Kali Linux users:** Kali uses zsh by default. Use `source ~/.zshrc` instead of `source ~/.bashrc`
+
 > 💡 **What's pipx?** It's like `apt` but for Python command-line tools. It keeps each tool isolated so they don't conflict with each other.
 
 ### Step 2: Install SoulEyez
@@ -246,4 +248,4 @@ Happy hacking! 🛡️
 
 ---
 
-**Version**: 2.22.0 | **Release Date**: January 2026 | **Maintainer**: CyberSoul Security
+**Version**: 2.24.0 | **Release Date**: January 2026 | **Maintainer**: CyberSoul Security

{souleyez-2.22.0/souleyez.egg-info → souleyez-2.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: souleyez
-Version: 2.22.0
+Version: 2.24.0
 Summary: AI-Powered Penetration Testing Platform with 40+ integrated tools
 Author-email: CyberSoul Security <contact@cybersoulsecurity.com>
 Maintainer-email: CyberSoul Security <contact@cybersoulsecurity.com>
@@ -72,7 +72,7 @@ Welcome to the SoulEyez beta! Thank you for helping us test and improve this pen
 
 > ⚠️ **Important**: Only use SoulEyez on systems you have explicit authorization to test.
 
-## Version: 2.22.0
+## Version: 2.24.0
 
 ### What's Included
 
@@ -127,6 +127,8 @@ pipx ensurepath          # Add pipx apps to your PATH
 source ~/.bashrc         # Reload your shell (or close and reopen terminal)
 ```
 
+> **Kali Linux users:** Kali uses zsh by default. Use `source ~/.zshrc` instead of `source ~/.bashrc`
+
 > 💡 **What's pipx?** It's like `apt` but for Python command-line tools. It keeps each tool isolated so they don't conflict with each other.
 
 ### Step 2: Install SoulEyez
@@ -297,4 +299,4 @@ Happy hacking! 🛡️
 
 ---
 
-**Version**: 2.22.0 | **Release Date**: January 2026 | **Maintainer**: CyberSoul Security
+**Version**: 2.24.0 | **Release Date**: January 2026 | **Maintainer**: CyberSoul Security

{souleyez-2.22.0 → souleyez-2.24.0}/README.md

@@ -133,7 +133,7 @@ See [docs/CONFIG.md](souleyez/docs/CONFIG.md) for complete configuration options
 # Install pipx if needed
 sudo apt install pipx
 pipx ensurepath
-source ~/.bashrc
+source ~/.bashrc    # Kali Linux: use 'source ~/.zshrc' instead
 
 # Install SoulEyez
 pipx install souleyez
@@ -142,6 +142,8 @@ pipx install souleyez
 souleyez setup
 ```
 
+> **Kali Linux users:** Kali uses zsh by default. Use `source ~/.zshrc` instead of `source ~/.bashrc`
+
 See [docs/user-guide/installation.md](souleyez/docs/user-guide/installation.md) for detailed instructions.
 
 ---

{souleyez-2.22.0 → souleyez-2.24.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "souleyez"
-version = "2.22.0"
+version = "2.24.0"
 description = "AI-Powered Penetration Testing Platform with 40+ integrated tools"
 readme = "BETA_README.md"
 license = {text = "MIT"}

souleyez-2.24.0/souleyez/__init__.py

@@ -0,0 +1 @@
+__version__ = '2.24.0'

{souleyez-2.22.0 → souleyez-2.24.0}/souleyez/core/msf_sync_manager.py

@@ -29,15 +29,25 @@ logger = logging.getLogger(__name__)
 
 def get_msf_database_config() -> Optional[Dict[str, Any]]:
     """
-    Get MSF database configuration from ~/.msf4/database.yml
+    Get MSF database configuration from ~/.msf4/database.yml or system-wide config.
+
+    Checks user config first, then falls back to system-wide config (Kali Linux).
 
     Returns:
         Dictionary with database config or None if not found/parseable
     """
-    db_yml_path = Path.home() / ".msf4" / "database.yml"
-
-    if not db_yml_path.exists():
-        logger.debug(f"MSF database.yml not found at {db_yml_path}")
+    # Check user config first, then system-wide config (Kali uses system-wide)
+    user_db_path = Path.home() / ".msf4" / "database.yml"
+    system_db_path = Path('/usr/share/metasploit-framework/config/database.yml')
+
+    db_yml_path = None
+    if user_db_path.exists():
+        db_yml_path = user_db_path
+    elif system_db_path.exists():
+        db_yml_path = system_db_path
+
+    if not db_yml_path:
+        logger.debug("MSF database.yml not found in user or system config")
         return None
 
     try:

{souleyez-2.22.0 → souleyez-2.24.0}/souleyez/detection/validator.py

@@ -156,8 +156,10 @@ class DetectionValidator:
         job_command = _reconstruct_command(job)
         # Use started_at or finished_at for execution time
         executed_at = job.get('started_at') or job.get('finished_at') or job.get('created_at')
-        # Job is successful if status is 'done'
-        success = job.get('status') == 'done'
+        # Job ran successfully if status is done, no_results, or warning
+        # (all of these sent network traffic that should be detectable by SIEM)
+        job_status = job.get('status', '')
+        success = job_status in ('done', 'no_results', 'warning')
 
         # Extract target IP from command (common patterns)
         target_ip = None

{souleyez-2.22.0 → souleyez-2.24.0}/souleyez/docs/README.md

@@ -1,7 +1,7 @@
 # SoulEyez Documentation
 
-**Version:** 2.22.0
-**Last Updated:** January 6, 2026
+**Version:** 2.24.0
+**Last Updated:** January 8, 2026
 **Organization:** CyberSoul Security
 
 Welcome to the SoulEyez documentation! This documentation covers architecture, development, user guides, and operational information for the SoulEyez penetration testing platform.

{souleyez-2.22.0 → souleyez-2.24.0}/souleyez/docs/user-guide/installation.md

@@ -40,12 +40,14 @@ pipx is the Python community's recommended way to install CLI applications. It h
 # One-time setup
 sudo apt install pipx
 pipx ensurepath
-source ~/.bashrc
+source ~/.bashrc    # Kali Linux: use 'source ~/.zshrc' instead
 
 # Install SoulEyez
 pipx install souleyez
 ```
 
+> **Kali Linux users:** Kali uses zsh by default. Use `source ~/.zshrc` instead of `source ~/.bashrc`
+
 On first run, SoulEyez will prompt you to install pentesting tools (nmap, sqlmap, gobuster, etc.).
 
 ```bash

{souleyez-2.22.0 → souleyez-2.24.0}/souleyez/main.py

@@ -173,7 +173,7 @@ def _check_privileged_tools():
 
 
 @click.group()
-@click.version_option(version='2.22.0')
+@click.version_option(version='2.24.0')
 def cli():
     """SoulEyez - AI-Powered Pentesting Platform by CyberSoul Security"""
     from souleyez.log_config import init_logging
@@ -1388,19 +1388,24 @@ def _run_doctor(fix=False, verbose=False):
     path_dirs = os.environ.get('PATH', '').split(':')
     pipx_bin = str(Path.home() / '.local' / 'bin')
     go_bin = str(Path.home() / 'go' / 'bin')
+
+    # Detect shell config file (zsh for Kali, bash for others)
+    shell = os.environ.get('SHELL', '/bin/bash')
+    shell_rc = '~/.zshrc' if 'zsh' in shell else '~/.bashrc'
+
     if pipx_bin in path_dirs:
         if verbose:
             check_pass("PATH includes ~/.local/bin (pipx)")
     else:
         if Path(pipx_bin).exists() and any(Path(pipx_bin).iterdir()):
-            check_warn("~/.local/bin not in PATH", "Add to ~/.bashrc: export PATH=\"$HOME/.local/bin:$PATH\"")
+            check_warn("~/.local/bin not in PATH", f"Add to {shell_rc}: export PATH=\"$HOME/.local/bin:$PATH\"")
 
     if go_bin in path_dirs:
         if verbose:
             check_pass("PATH includes ~/go/bin")
     else:
         if Path(go_bin).exists() and any(Path(go_bin).iterdir()):
-            check_warn("~/go/bin not in PATH", "Add to ~/.bashrc: export PATH=\"$HOME/go/bin:$PATH\"")
+            check_warn("~/go/bin not in PATH", f"Add to {shell_rc}: export PATH=\"$HOME/go/bin:$PATH\"")
 
     # Check database is writable
     if db_path.exists():
@@ -1430,8 +1435,10 @@ def _run_doctor(fix=False, verbose=False):
     # Section 7: MSF Database (if msfconsole available)
     if shutil.which('msfconsole'):
         click.echo(click.style("Metasploit", bold=True))
+        # Check user config first, then system-wide config (Kali uses system-wide)
         msf_db = Path.home() / '.msf4' / 'database.yml'
-        if msf_db.exists():
+        system_msf_db = Path('/usr/share/metasploit-framework/config/database.yml')
+        if msf_db.exists() or system_msf_db.exists():
             check_pass("MSF database configured")
         else:
             check_fail("MSF database not initialized", "msfdb init")

{souleyez-2.22.0 → souleyez-2.24.0}/souleyez/ui/interactive.py

@@ -29526,11 +29526,11 @@ def _check_msfdb_ready() -> bool:
         click.echo("  The Metasploit database needs to be initialized for full functionality.")
         click.echo("  Without it, you won't be able to store hosts, credentials, or loot.")
         click.echo()
-        if click.confirm("  Initialize database now? (runs: msfdb init)", default=True):
+        if click.confirm("  Initialize database now? (runs: sudo msfdb init)", default=True):
             click.echo()
-            click.echo(click.style("  Running msfdb init...", fg='cyan'))
+            click.echo(click.style("  Running sudo msfdb init...", fg='cyan'))
             try:
-                result = subprocess.run(['msfdb', 'init'], capture_output=False, text=True)
+                result = subprocess.run(['sudo', 'msfdb', 'init'], capture_output=False, text=True)
                 if result.returncode == 0:
                     click.echo(click.style("  Database initialized successfully!", fg='green'))
                     click.echo()

{souleyez-2.22.0 → souleyez-2.24.0}/souleyez/ui/setup_wizard.py

@@ -834,14 +834,16 @@ def _install_ollama() -> bool:
 
     click.echo()
     click.echo("  Installing Ollama...")
-    click.echo("  " + click.style("(This may take a minute)", fg='bright_black'))
+    click.echo("  " + click.style("(This may take a minute - downloading ~100MB)", fg='bright_black'))
     click.echo()
 
     try:
-        # Run the official Ollama install script - let it output directly to terminal
+        # Run the official Ollama install script with timeout
+        # Add curl timeouts to fail faster on network issues
         result = subprocess.run(
-            ['bash', '-c', 'curl -fsSL https://ollama.ai/install.sh | sh'],
-            check=False
+            ['bash', '-c', 'curl --connect-timeout 30 --max-time 300 -fsSL https://ollama.ai/install.sh | sh'],
+            check=False,
+            timeout=360  # 6 minute total timeout
         )
 
         if result.returncode == 0:
@@ -853,10 +855,25 @@ def _install_ollama() -> bool:
         else:
             click.echo()
             click.echo("  " + click.style("✗ Installation failed", fg='red'))
-            click.echo("  You can install manually from https://ollama.ai")
+            click.echo("  " + click.style("This is usually a network issue (slow connection or timeout).", fg='yellow'))
+            click.echo()
+            click.echo("  To install manually:")
+            click.echo("    curl -fsSL https://ollama.ai/install.sh | sh")
+            click.echo()
+            click.echo("  Or visit: https://ollama.ai")
             click.pause("  Press any key to continue...")
             return False
 
+    except subprocess.TimeoutExpired:
+        click.echo()
+        click.echo("  " + click.style("✗ Installation timed out", fg='red'))
+        click.echo("  " + click.style("The download took too long. Check your internet connection.", fg='yellow'))
+        click.echo()
+        click.echo("  To install manually:")
+        click.echo("    curl -fsSL https://ollama.ai/install.sh | sh")
+        click.pause("  Press any key to continue...")
+        return False
+
     except Exception as e:
         click.echo()
         click.echo(click.style(f"  ✗ Error: {e}", fg='red'))

{souleyez-2.22.0 → souleyez-2.24.0}/souleyez/ui/tool_setup.py

@@ -82,32 +82,38 @@ def _ensure_path_configured():
         os.environ["PATH"] = ":".join(new_paths) + ":" + current_path
 
 
-def _add_paths_to_bashrc():
-    """Add tool paths to ~/.bashrc if not already present."""
-    bashrc = Path.home() / ".bashrc"
+def _add_paths_to_shell_rc():
+    """Add tool paths to shell rc files (bash and zsh) if not already present."""
     paths_to_add = [
         ('export PATH="$HOME/go/bin:$PATH"', "go/bin"),
         ('export PATH="$HOME/.local/bin:$PATH"', ".local/bin"),
     ]
 
-    if not bashrc.exists():
-        return
+    # Update both .bashrc and .zshrc (Kali Linux uses zsh by default)
+    rc_files = [
+        Path.home() / ".bashrc",
+        Path.home() / ".zshrc",
+    ]
 
-    try:
-        content = bashrc.read_text()
-        additions = []
-
-        for line, marker in paths_to_add:
-            if marker not in content:
-                additions.append(line)
-
-        if additions:
-            with open(bashrc, "a") as f:
-                f.write("\n# Added by souleyez setup\n")
-                for line in additions:
-                    f.write(line + "\n")
-    except Exception:
-        pass  # Don't fail on PATH configuration issues
+    for rc_file in rc_files:
+        if not rc_file.exists():
+            continue
+
+        try:
+            content = rc_file.read_text()
+            additions = []
+
+            for line, marker in paths_to_add:
+                if marker not in content:
+                    additions.append(line)
+
+            if additions:
+                with open(rc_file, "a") as f:
+                    f.write("\n# Added by souleyez setup\n")
+                    for line in additions:
+                        f.write(line + "\n")
+        except Exception:
+            pass  # Don't fail on PATH configuration issues
 
 
 def _run_command(cmd: str, console, description: str = "", capture: bool = False) -> tuple:
@@ -319,15 +325,16 @@ def _ensure_msfdb_initialized(console):
 
     if not click.confirm("  Initialize MSF database now?", default=True):
         console.print()
-        console.print("  [yellow]Skipped.[/yellow] Run 'msfdb init' manually when needed.")
+        console.print("  [yellow]Skipped.[/yellow] Run 'sudo msfdb init' manually when needed.")
         return
 
     console.print()
     console.print("  [dim]Initializing MSF database (this may take a minute)...[/dim]")
 
     try:
+        # Use sudo for msfdb init (required on Kali and some other distros)
         result = subprocess.run(
-            [msfdb_path, 'init'],
+            ['sudo', msfdb_path, 'init'],
             capture_output=True,
             timeout=300  # 5 minute timeout
         )
@@ -392,32 +399,12 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
     console.print(f"  Detected OS: [bold]{distro_names.get(distro, distro)}[/bold]")
     console.print()
 
+    # Show distro-specific messaging
     if distro in ('kali', 'parrot'):
         console.print("  [green]✓ You're on a pentesting distro![/green]")
-        console.print("    All tools should be available via apt install.")
+        console.print("    Most tools are available via apt. Some may use pipx or direct download.")
         console.print()
-        _show_tool_status(console)
-
-        if check_only:
-            return
-
-        missing = get_missing_tools(distro)
-        if missing:
-            console.print()
-            if install_all or click.confirm("  Install missing tools via apt?", default=True):
-                _install_apt_tools(console, missing)
-        else:
-            console.print("  [green]✓ All tools are installed![/green]")
-
-        # Configure sudoers for privileged scans
-        _configure_sudoers(console)
-
-        # Initialize MSF database if needed
-        _ensure_msfdb_initialized(console)
-        return
-
-    # Ubuntu/Debian path
-    if distro in ('ubuntu', 'debian'):
+    elif distro in ('ubuntu', 'debian'):
         console.print("  [yellow]Note:[/yellow] Some pentesting tools aren't in Ubuntu/Debian repos.")
         console.print("  This wizard will install them using pipx, go, snap, or from source.")
         console.print()
@@ -431,6 +418,8 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
     if not missing:
         console.print()
         console.print("  [green]✓ All tools are installed![/green]")
+        # Still need to run post-install tasks (sudoers, MSF db, etc.)
+        _run_post_install_tasks(console, distro)
         return
 
     console.print()
@@ -528,8 +517,8 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
             else:
                 failed_tools.append(tool['name'])
 
-    # Configure PATH in bashrc
-    _add_paths_to_bashrc()
+    # Configure PATH in shell rc files (bash and zsh)
+    _add_paths_to_shell_rc()
 
     # Final status
     console.print()
@@ -547,6 +536,15 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
     _ensure_path_configured()
     _show_tool_status(console)
 
+    # Run post-install tasks
+    _run_post_install_tasks(console, distro)
+
+
+def _run_post_install_tasks(console, distro: str):
+    """Run tasks that should happen after tool installation or when all tools are present."""
+    # Ensure PATH is configured in shell rc files
+    _add_paths_to_shell_rc()
+
     # Configure passwordless sudo for privileged scans
     _configure_sudoers(console)
 
@@ -554,12 +552,14 @@ def run_tool_setup(check_only: bool = False, install_all: bool = False):
     _ensure_msfdb_initialized(console)
 
     # Remind about PATH for pipx/go tools
-    if distro in ('ubuntu', 'debian'):
-        console.print()
-        console.print("  [yellow]Important:[/yellow] To use newly installed tools, either:")
-        console.print("    1. Restart your terminal, OR")
+    console.print()
+    console.print("  [yellow]Important:[/yellow] To use newly installed tools, either:")
+    console.print("    1. Restart your terminal, OR")
+    if distro in ('kali', 'parrot'):
+        console.print("    2. Run: [cyan]source ~/.zshrc[/cyan]  (Kali uses zsh)")
+    else:
         console.print("    2. Run: [cyan]source ~/.bashrc[/cyan]")
-        console.print()
+    console.print()
 
 
 def _show_tool_status(console):

{souleyez-2.22.0 → souleyez-2.24.0}/souleyez/utils/tool_checker.py

@@ -223,9 +223,9 @@ EXTERNAL_TOOLS = {
         },
         'dalfox': {
             'command': 'dalfox',
-            'install_kali': 'ARCH=$(uname -m | sed "s/x86_64/amd64/;s/aarch64/arm64/") && wget -q https://github.com/hahwul/dalfox/releases/download/v2.12.0/dalfox-linux-${ARCH}.tar.gz -O /tmp/dalfox.tar.gz && tar -xzf /tmp/dalfox.tar.gz -C /tmp && sudo mv /tmp/dalfox-linux-${ARCH} /usr/local/bin/dalfox && sudo chmod +x /usr/local/bin/dalfox && rm /tmp/dalfox.tar.gz',
-            'install_ubuntu': 'ARCH=$(uname -m | sed "s/x86_64/amd64/;s/aarch64/arm64/") && wget -q https://github.com/hahwul/dalfox/releases/download/v2.12.0/dalfox-linux-${ARCH}.tar.gz -O /tmp/dalfox.tar.gz && tar -xzf /tmp/dalfox.tar.gz -C /tmp && sudo mv /tmp/dalfox-linux-${ARCH} /usr/local/bin/dalfox && sudo chmod +x /usr/local/bin/dalfox && rm /tmp/dalfox.tar.gz',
-            'install_method': 'kali_only',
+            'install_kali': 'go install github.com/hahwul/dalfox/v2@latest',
+            'install_ubuntu': 'go install github.com/hahwul/dalfox/v2@latest',
+            'install_method': 'go',
             'description': 'XSS vulnerability scanner'
         },
     },
@@ -721,6 +721,7 @@ def check_msfdb_status() -> Dict[str, any]:
         - message: str - Human-readable status message
     """
     import subprocess
+    from pathlib import Path
 
     result = {
         'initialized': False,
@@ -734,6 +735,32 @@ def check_msfdb_status() -> Dict[str, any]:
         result['message'] = 'msfdb command not found - Metasploit may not be installed'
         return result
 
+    # Helper to check if PostgreSQL is running
+    def check_postgresql_running() -> bool:
+        try:
+            proc = subprocess.run(
+                ['systemctl', 'is-active', 'postgresql'],
+                capture_output=True,
+                text=True,
+                timeout=5
+            )
+            return proc.returncode == 0 and 'active' in proc.stdout.lower()
+        except Exception:
+            return False
+
+    # Helper to check system-wide MSF database config (Kali fallback)
+    def check_system_config() -> bool:
+        """Check if system-wide database.yml exists with valid PostgreSQL config."""
+        config_path = Path('/usr/share/metasploit-framework/config/database.yml')
+        if config_path.exists():
+            try:
+                content = config_path.read_text()
+                # Check for PostgreSQL adapter configuration
+                return 'adapter: postgresql' in content and 'database: msf' in content
+            except Exception:
+                return False
+        return False
+
     try:
         # Run msfdb status
         proc = subprocess.run(
@@ -743,10 +770,23 @@ def check_msfdb_status() -> Dict[str, any]:
             timeout=10
         )
         output = proc.stdout + proc.stderr
-
-        # Parse output for status indicators
         output_lower = output.lower()
 
+        # Check if msfdb requires root (common on Kali)
+        if 'run as root' in output_lower or (proc.returncode != 0 and 'error' in output_lower):
+            # Fall back to checking system config file and PostgreSQL status
+            result['running'] = check_postgresql_running()
+            if check_system_config():
+                result['initialized'] = True
+                if result['running']:
+                    result['connected'] = True
+                    result['message'] = 'Database initialized and running'
+                else:
+                    result['message'] = 'Database initialized but PostgreSQL not running - run: sudo systemctl start postgresql'
+            else:
+                result['message'] = 'Need sudo to verify - run: sudo msfdb status'
+            return result
+
         # Check if database is initialized
         if 'no database' in output_lower or 'not initialized' in output_lower:
             result['message'] = 'Database not initialized - run: msfdb init'

{souleyez-2.22.0 → souleyez-2.24.0/souleyez.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: souleyez
-Version: 2.22.0
+Version: 2.24.0
 Summary: AI-Powered Penetration Testing Platform with 40+ integrated tools
 Author-email: CyberSoul Security <contact@cybersoulsecurity.com>
 Maintainer-email: CyberSoul Security <contact@cybersoulsecurity.com>
@@ -72,7 +72,7 @@ Welcome to the SoulEyez beta! Thank you for helping us test and improve this pen
 
 > ⚠️ **Important**: Only use SoulEyez on systems you have explicit authorization to test.
 
-## Version: 2.22.0
+## Version: 2.24.0
 
 ### What's Included
 
@@ -127,6 +127,8 @@ pipx ensurepath          # Add pipx apps to your PATH
 source ~/.bashrc         # Reload your shell (or close and reopen terminal)
 ```
 
+> **Kali Linux users:** Kali uses zsh by default. Use `source ~/.zshrc` instead of `source ~/.bashrc`
+
 > 💡 **What's pipx?** It's like `apt` but for Python command-line tools. It keeps each tool isolated so they don't conflict with each other.
 
 ### Step 2: Install SoulEyez
@@ -297,4 +299,4 @@ Happy hacking! 🛡️
 
 ---
 
-**Version**: 2.22.0 | **Release Date**: January 2026 | **Maintainer**: CyberSoul Security
+**Version**: 2.24.0 | **Release Date**: January 2026 | **Maintainer**: CyberSoul Security

souleyez-2.22.0/souleyez/__init__.py

@@ -1 +0,0 @@
-__version__ = '2.22.0'