Documentation

Find everything you need to get started and master Penligent.

Penligent — Quick Start Guide (Kali Edition)

Penligent Team

1. Preparation

  • Kali Linux is installed and up to date (official image recommended).
  • You have a user account with sudo privileges.
  • Penligent installation package (penligent.kali_amd64_1.0.3.deb) and platform credentials.
  • Ensure Kali has a working network connection.

2. Installation

  1. Transfer penligent.kali_amd64_1.0.3.deb to the Kali machine.
  2. Run the following in a terminal (requires sudo):
Bash
sudo dpkg -i penligent.kali_amd64_1.0.3.deb
  1. Recommended hardware resources: 16GB RAM and 4 CPU cores.

3. First Launch and Sign-in

  1. Start Penligent (run penligent from the Kali applications menu).
  2. Click Sign in on the main interface to authenticate.
  • If you cannot sign in, verify network connectivity, proxy settings, and credentials.

4. Project Configuration (Required when using AI-generated scripts or running Python scripts)

If you want Penligent to generate scripts with AI or execute Python scripts, complete the following configuration steps:

  1. Open Penligent → top-right Settings.
  2. Configure the AI script storage path via Ai generated script save path; ensure the directory is readable/writable.
  3. Configure the Python runtime via Python interpreter path. Using a Python virtual environment is recommended.
  4. Configure the Bash runtime via Bash interpreter path.
  5. Press Enter after inputting each setting for it to take effect.

5. Create a Task and Run a Penetration Test

  1. Click Create Task / New Task in the upper-left of the main interface.
  2. In the dialog that appears, begin your penetration testing workflow.

6. Tools and Integrations

  • Penligent can invoke tools already installed in Kali (e.g., nmap, hydra), provided permissions allow.
  • To add additional tools: open Penligent left sidebar → Tools / Integrations → add the tool path or command.
  • Installing Kali metapackages is recommended to increase detection coverage.

7. Advanced: Automated Installation Script and Configuration Import

We provide a project that can automatically install common tools and generate Penligent configuration files for one-click import to accelerate deployment:

GitHub repository: https://github.com/penligent/AI2PentestTool

  • Automatically install/configure commonly used penetration testing tools;
  • Export configuration files that can be directly imported into Penligent.

8. References (& Examples)

9. Troubleshooting & Quick Fixes

  • dpkg dependency errors during installation: Run sudo apt-get -f install, then retry dpkg -i.
  • Login failures: Check network and proxy settings, verify credentials, and confirm system time synchronization (NTP).
  • AI scripts fail to run / missing modules: Confirm AI-generated script path permissions and ensure the configured Python environment can install dependencies.
  • Penligent cannot find a tool: Verify the tool runs from CLI (which <tool>) and add the correct path in Penligent → Tools.
  • Dialogs hang or no recommended next action: Investigate system network status and memory utilization.

10. Recommendations & Security Notices

  • Avoid carrying out multiple tasks in the same conversation session; long context may slow analysis.
  • Always obtain explicit authorization for penetration testing; unauthorized testing may violate laws.
  • Assess potential impact before running noisy scans or exploit modules on production networks; prefer isolated or authorized scopes.
  • Regularly back up Penligent configuration and AI script directories to prevent accidental loss and ease migration.