KaliGPT: Agentic AI Assistant for OffSec (Ethical Hacking, OSINT, Pentesting)

Developed by Krishna Dwivedi (aka SudoHopeX)

NOTE: Work in Progress!

This tool is in development phase right now.

Making it MCP Server & Client Supportable

Making local models less resource intensive

Making local models perform online searches for up-to-date support

If You can Contribute, you're welcomed Click to contact SudoHopeX ASAP

Objective

KaliGPT is an Agentic AI Assistance (built on Gemini, llama, Mistral, ChatGPT) fine tuned for ethical hackers & students in offensive security making workflows smarter, faster, and more accessible.

• Install Mistral, Llama via ollama and ChatGPT via both CLI (if have pro plan) and GUI (for free).
• Install AI's in just fewer or one commands.
• Use all AI via a single laucher either with or without prompt just by specifying model code.
• Use AI in Linux directly via CLI or GUI ( only for KaliGPT by OpenAI ) for faster and better experience.
• Interactive guidance on cyber security, Ethical Hacking & many more.

Project Description

KaliGPT Unified: Use AI's on Linux systems easily for interacting with state-of-the-art AI models, including:

• Google Gemini 2.5 Flash (API required, Free, Online)
• ChatGPT 4.0 (API required, Paid, Online)
• Mistral and Llama 3 (via local install, Offline, Resource intensive)
• KaliGPT (OpenAI GPT) - Web (browser-based) if API access is unavailable
• This tool ensures flexibility whether you have paid API access, want to run models locally, or prefer using the web interface via your browser.

Note: KaliGPT should serve as an assistant—not a substitute. Always verify AI-generated results.

Features ✨

• Automated installation of all dependencies for KaliGPT, including Python requirements and Ollama setup.
• Flexible AI backend selection: Use Gemini 2.5 Flash, ChatGPT 4.0, local Mistral/Llama 3 via Ollama, or web interface for OpenAI GPT.
• CLI with colorfull responses: Interact via terminal (mainly) or GUI (only ChatGPT).
• Web automation: If no API is available, script can launch Chromium (or other browsers, configurable via editing the binary) for web-based chat with arg -cw.
• Open source & MIT Licensed.

Tech Stack & Requirements

Linux system  ( to be tested on Kali, Debian, etc. )
Bash shell
Python 3.13.x  (for API/CLI)
openai - python module  ( library )
rich - python module
google.genai - python module
requests -  python module  ( library )
Ollama  ( for local models installation & uses )
Chromium or other supported browsers ( for web use )
      

Installation 📩

To integrate KaliGPT into your setup, follow platform-specific instructions:

1. Clone the repository and run the installer:
git clone https://github.com/SudoHopeX/KaliGPT.git

2. Move to KaliGPT
cd KaliGPT

3. Install a KaliGPT Model
sudo bash kaligpt_unified.sh --model <model-number>

4. e.g. installing KaliGPT with gemini 2.5 Flash
sudo bash kaligpt_unified.sh --model 5

See kaligpt installer usages for more

KaliGPT Installer Usages

use the command bash kaligpt_unified.sh --help to see installer usages

KaliGPT Installer v1.1 ~ SudoHopeX

KaliGPT Installer Available commands:
   --model <model-num>         -  install a specific model
   --listmodels                -  list available models
   --uninstall-m <model-num>   -  uninstall a specific model
   --uninstall                 -  uninstall KaliGPT (everything)
   --help                      -  print this usage info

KaliGPT Available MODELs:
   1) OpenAI ChatGPT ( OpenAI, Free, Online ) [ Requires API KEY ]
   2) Mistral    ( Free, Offline - Min 6GB Data Required)
   3) Llama      ( Free, Offline )
   4) KaliGPT -web based ( OpenAI, Free, Online )
   5) Google Gemini 2.5 Flash (Google, Free, Online) Required API Key ]
      [Note: opttion 4 required 1 time logging & keep logged in config in chromium if not]

Usages Examples:
   sudo bash kaligpt_unified.sh --model 1       # install OpenAI ChatGPT4.0 with API access
   sudo bash kaligpt_unified.sh --model 2       # install KaliGPT (Mistral AI locally)
   bash kaligpt_unified.sh --help               # print script usages
   sudo bash kaligpt_unified.sh --uninstall-m 1 # uninstall OpenAI installed files
   sudo bash kaligpt_unified.sh --uninstall     # uninstall KaliGPT (everything)

      

KaliGPT Usages

use command kaligpt -hto see below usages after installation

KaliGPT v1.1 - An Agentic AI Assitance for OffSec

Usages:
        kaligpt [MODE] [FLAG(Optional)] [Prompt (Optional)]

MODES: (Must Included)

    -c  [--chatgpt]           =  use ChatGPT-4o (Online)
    -cw [--chatgpt-web]       =  use KaliGPT in Web Browser (Online)
                    ( requires 1 time login & keep logged in configs on web )
    -g  [--gemini]            =  use Gemini 2.5 Flash (Online)
    -m  [--mistral]           =  use Mistral via Ollama (Offline)
    -l  [--llama]             =  use LlaMa via Ollama (Offline)
    -i  [--install]           = install a model bu using --model <model-num>
    -lm [--list-models]       = list KaliGPT available models
    -u  [--uninstall]         = uninstall a model or KaliGPT (everything)
    -h  [--help]              =  show this help message and exit

FLAGS:
    --model <model-num>        = specify a model to install (with --install)
    --uninstall-m <model-num>  =  uninstall a specific model (with --uninstall)
    --uninstall-k              =  uninstall KaliGPT (everything) (with --uninstall)


Examples:
     kaligpt -g "How to Scan a website for subdomains using tools"
     kaligpt -l "Help me find XXS on a target.com"
     kaligpt --install --model 5  // install KaliGPT powered by Gemini 2.5 Flash
     kaligpt -u --uninstall-m 1   // uninstall KaliGPT powered by ChatGPT 
     kaligpt -cw    // launch ChatGPT GPT in web

 NOTE: do not pass prompt with -cw
       Must include a MODE & use flags only with specified mode
       Read README.md or Documentation at sudohopex.github.io for more info. 

Switching AI Backends

You can choose between:

• ChatGPT 4.0 (OpenAI, Paid, Online, API key required)
• Mistral or Llama 3 (local, free, heavy resource intensive, via Ollama)
• Gemini 2.5 Flash (Google, Free, Online, Requires API Key)
• Web interface (no key required, but automates browser only for KaliGPT via OpenAI)

Changing Default Browser for KaliGPT web

To switch from Chromium to another browser, follow these steps:

• 1. Open /usr/local/bin/kaligpt in a text editor e.g sudo nano /usr/local/bin/kaligpt
• 2. Find the section referencing chromium and comment it
• 3. Uncomment or add your preferred browser's binary (e.g., firefox, brave-browser, etc.).
• Save and run the launcher kaligpt -cw.

Planned Improvements

• MCP Server & Client support with tools for OffSec
• Online Search capabilities for local models like Mistral/Llama
• Make local models work with less resource requirements
• Native Kali Linux CLI integration (e.g. sidebar plugin or context support).
• Enhanced explanation layers and modular workflows.

License

This project is licensed under MIT & non-commercial License. See License for more details

Acknowledgement

Inspired by My Own Intution to make it 😎😊

For more info, Visit: KaliGPT GitHub Repo