WIP - Revamped Alfred [2.0]

Alfred - A Modular Recon and Exploitation Framework [EXPIREMTNAL PHASE]

Alfred is a Python-based framework designed to assist in various reconnaissance, exploitation, and post-exploitation tasks. It is highly modular, allowing users to easily add plugins to extend functionality. The framework supports running independent plugins, handling plugin arguments, and tracking execution results.

Features

Plugin System: Easily load and execute custom plugins.
Modular Design: Extend functionality by creating or importing new plugins.
NLP-Based Input Handling: Plugins understand user input through natural language processing, mapping the user's intent to specific actions using semantic parsing.
- en_core_web_sm - For tokenization and sentence segmentation
- all-MiniLM-L6-v2 - For semantic parsing, extracting the underlying intent and meaning from the input.
Execution Logging: Tracks plugin execution with logging functionality.
Error Handling: Gracefully handles errors during plugin loading and execution.
Plugin Support: Includes a port scanner and an echo message plugin for basic sanity checks.

Installation

Clone the repository:

   git clone https://github.com/YourUsername/alfred.git
   cd alfred
   pip install -r requirements.txt

Usage

To run specific plugin:

ζ python3 alfred.py                                                                                                                                                                                                                           
/home/kali/.local/lib/python3.11/site-packages/fuzzywuzzy/fuzz.py:11: UserWarning: Using slow pure-python SequenceMatcher. Install python-Levenshtein to remove this warning
  warnings.warn('Using slow pure-python SequenceMatcher. Install python-Levenshtein to remove this warning')
=== Alfred: Autonomous Pentest Assistant ===

[*] Loaded plugin: AquatonePlugin
2025-04-16 21:45:16,094 - INFO - Loaded plugin: AquatonePlugin
[*] Loaded plugin: EchoMessage
2025-04-16 21:45:16,096 - INFO - Loaded plugin: EchoMessage
[*] Loaded plugin: PingSweep
2025-04-16 21:45:16,099 - INFO - Loaded plugin: PingSweep
[*] Loaded plugin: PortScan
2025-04-16 21:45:16,102 - INFO - Loaded plugin: PortScan
2025-04-16 21:45:16,102 - INFO - Loading NLP models...
2025-04-16 21:45:16,827 - INFO - Use pytorch device_name: cpu
2025-04-16 21:45:16,828 - INFO - Load pretrained SentenceTransformer: all-MiniLM-L6-v2
2025-04-16 21:45:20,976 - INFO - Building action index...
Batches: 100%|███████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 2/2 [00:00<00:00,  7.82it/s]
Alfred > run nmap version scan on 10.0.2.15 and give me info
2025-04-16 21:45:41,540 - INFO - Processing instruction: run nmap version scan on 10.0.2.15 and give me info
2025-04-16 21:45:41,550 - INFO - Segmented into 2 parts: ['run nmap version scan on 10.0.2.15', 'give me info']
Batches: 100%|███████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 42.53it/s]
Batches: 100%|███████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 1/1 [00:00<00:00, 28.10it/s]
2025-04-16 21:45:41,634 - INFO - Processing action 1: run_nmap_scan
[*] Running plugin: PortScan with args {'target': '10.0.2.15', 'scan_type': 'version', 'options': ' -sV'}
2025-04-16 21:45:41,634 - INFO - Running plugin: PortScan with args {'target': '10.0.2.15', 'scan_type': 'version', 'options': ' -sV'}
[*] Starting port scan on 10.0.2.15 for ports 22,80,443...
2025-04-16 21:45:41,634 - INFO - Starting port scan on 10.0.2.15 for ports 22,80,443...
[*] Scan completed successfully.
2025-04-16 21:45:48,274 - INFO - Scan completed successfully.
[+] [10.0.2.15] 1 ports identified and stored.
2025-04-16 21:45:48,275 - SUCCESS - [10.0.2.15] 1 ports identified and stored.
{'host': '10.0.2.15', 'status': 'up', 'hostnames': '10.0.2.15', 'addresses': {'ipv4': '10.0.2.15'}, 'tcp_ports': {80: {'state': 'open', 'name': 'http', 'product': 'SimpleHTTPServer', 'version': '0.6', 'extrainfo': 'Python 3.11.6', 'cpe': 'cpe:/a:python:simplehttpserver:0.6', 'scripts': {'http-title': 'Directory listing for /', 'http-server-header': 'SimpleHTTP/0.6 Python/3.11.6'}}}}
[+] Plugin 'PortScan' executed successfully.
2025-04-16 21:45:48,275 - SUCCESS - Plugin 'PortScan' executed successfully.
[+] Plugin 'PortScan' executed in 6.64 seconds.
2025-04-16 21:45:48,275 - SUCCESS - Plugin 'PortScan' executed in 6.64 seconds.
2025-04-16 21:45:48,275 - ERROR - Error executing plugin PortScan: 'NoneType' object has no attribute 'get'
2025-04-16 21:45:48,275 - INFO - Processing action 2: explain
I encountered an error: 'NoneType' object has no attribute 'get'. I encountered an error: unknown error.
--------------------------------------------------

Available Plugins

EchoMessage: A simple plugin that echoes back the message. Just for sanity check.
PortScan: A plugin that performs a basic port scan on the target.

Alfred

Most Popular

WIP - Revamped Alfred [2.0]

Alfred - A Modular Recon and Exploitation Framework [EXPIREMTNAL PHASE]

Features

Installation

Usage