Alfred

KO | EN

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #claude-code #windows #codex #developer-tools #dsh

★ 40 Open GitHub ↗

WIP - Revamped Alfred [2.0]

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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

1. Clone the repository:
```bash
   git clone https://github.com/YourUsername/alfred.git
   cd alfred
   pip install -r requirements.txt
```

## Usage

To run specific plugin:

```r
ζ 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

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README