⚔️ PENTESTER-Automated Offensive Security Suite

Introduction

PENTESTER is a command-line driven, interactive offensive security toolkit designed for penetration testers, security professionals, and ethical hackers. This tool provides streamlined access to popular open-source tools like nmap, nikto, sqlmap, and faraday, wrapped in a guided interface. Each tool is invoked with clear usage tips and optional auto-install functionality.

Crafted with flair by Sahiko, it brings mystical aesthetics and practical automation into one terminal-driven experience.

---

✨ Features

• 📦 Interactive CLI menu for categorized tasks:
  • Information Gathering
  • Vulnerability Scanning
  • Exploitation
  • Reporting
• 💥 Real-time command execution and usage guidance
• 🛡️ Kali Linux optimized, but works on any Debian-based system
• 🧭 Globally executable via pentester command after setup

---

🔧 Installation

Run the following in your Linux terminal:

# Clone the repository
git clone https://github.com/s4sahiko/pentester.git

# Change directory
cd pentester

# Make setup script executable
chmod +x setup.sh

# Run setup (auto-installs dependencies and registers tool globally)
sudo ./setup.sh

🛡️ Requires sudo privileges for installing packages and moving the tool to /usr/local/bin.

After setup, you can launch the tool from anywhere using:

pentester

---

🧪 Supported Tools (Pre-installed or auto-installed)

Tool	Purpose
nmap	Port scanning and service detection
nikto	Web vulnerability scanner
sqlmap	SQL injection testing and exploitation
faraday	Reporting platform integration

Each tool is wrapped with interactive prompts and examples.

---

🐍 Dependencies

• Python 3
• Tools: nmap, nikto, sqlmap, faraday-manage (auto-installed if missing)
• Debian/Ubuntu-based OS recommended (e.g., Kali Linux)

---

📋 Example Usage

pentester

You will be prompted to choose a category and task interactively. The tool handles command construction and execution for you.

---

📁 Repository Structure

pentester/
├── pentester.py   # Main script (CLI interface)
├── setup.sh       # Optional setup script (auto-installs, registers pentester globally)
└── README.md      # Documentation

---

🔐 Disclaimer

This tool is intended for educational and authorized penetration testing use only. Misuse may violate laws and policies. The author is not responsible for unauthorized usage.

---

Let the firewalls tremble and the logs weep. ⚔️

#🧭– Pentester Tool Suite

Welcome to the Pentester User Guide.

---

🔧 Tool Categories & Usage

1. Information Gathering

• Tool: nmap
• Use: Scans ports, detects services, identifies OS, and maps networks.
• Examples:

  nmap -sS -sV -T4 <target>
  nmap -O <target>
  nmap -A <target>
  nmap -sU -p 53,67 <target>
  

2. Vulnerability Scanning

• Tool: nikto

• Use : Scans web servers for known vulnerabilities and security issues.

• Examples:

    nikto -h http://example.com
    nikto -h https://secure.site -ssl
    nikto -h http://example.com -Tuning 123b
    nikto -h http://example.com -output results.html
  

3. Exploitation

• Tool: sqlmap

• Use: Identifies and exploits SQL injection vulnerabilities.

• Examples:

    sqlmap -u "http://site.com?id=1" --dbs
    sqlmap -u "http://site.com" --batch --current-user
    sqlmap -u "http://site.com" -D dbname -T users --dump
    sqlmap -u "http://site.com" --os-shell
  

4. Reporting

• Tool:faraday-manage

• Use: Opens the Faraday console for organizing test data and vulnerability reports.

• Examples:

    faraday-manage run
    faraday-manage create-user
    faraday-manage list-users
  
    🛠️ Troubleshooting

5.Problem: pentester command not found

• Solution:

    sudo ln -s /path/to/pentester.py /usr/local/bin/pentester
    chmod +x /usr/local/bin/pentester
  

6.Problem: Tool not installed (e.g., sqlmap: command not found)

• Solution:

    sudo apt update && sudo apt install sqlmap
  

7.Problem: Permission denied errors

• Solution:

    Run the script or command with sudo, e.g.:- sudo pentester
  

8.Problem: Network connectivity issues

• Solution:

     Ensure you are connected to the internet. Tools like nmap and sqlmap require live targets.
  

⚠️ Always use responsibly. Only engage targets you are authorized to assess.

/-SAHIKO