Kitty-Hack: Your Hacking Cat Assistant

Only works on Linux!

!!! IMPORTANT LEGAL & ETHICAL DISCLAIMER !!!

By using Kitty-Hack, you acknowledge and agree to the following stringent terms:

• STRICTLY FOR EDUCATIONAL & ETHICAL USE: Kitty-Hack is designed for informational and educational purposes only, specifically within the context of ethical hacking, cybersecurity research, and authorized penetration testing. It MUST NOT be used for any illegal, unethical, or malicious activities. Unauthorized access to computer systems, data breaches, creation or distribution of malware, or any other illegal hacking activities are strictly prohibited and against the intended use of this tool.
• NO PROFESSIONAL ADVICE: Kitty-Hack does not provide professional, legal, or cybersecurity advice. All responses are generated by an Artificial Intelligence model (Gemma 3) and are for informational purposes only. Do not rely on its output as a substitute for expert consultation, independent verification, or legal guidance.
• USER RESPONSIBILITY: You are solely and entirely responsible for your interactions with Kitty-Hack and for any actions you take based on its responses. Engaging in hacking activities without explicit, legal authorization is illegal and can lead to severe civil and criminal penalties. Use extreme caution and exercise your own discretion.
• AI ACCURACY & LIMITATIONS: While designed to be helpful, AI-generated content may contain inaccuracies, biases, or outdated information. It may "hallucinate" facts or provide incorrect cybersecurity advice. Its knowledge is based on its training data and does not have access to real-time information or the latest vulnerabilities.
• LICENSE COMPLIANCE: Your use of the underlying Gemma 3 model is governed by the Google Gemma Terms of Use and Prohibited Use Policy. You must comply with these terms, a copy of which is available in this repository's LICENSE file.

Proceeding with this software implies full acceptance of these terms.

---

Introduction

Kitty-Hack is your personal AI assistant specializing in cybersecurity and ethical hacking topics. He's a posh and snarky feline, ready to help you navigate the digital landscape... within legal and ethical bounds, of course.

Features

• Interactive chat interface
• Terminal access
• Output followup
• Temporary memory
• Permanent memory. (can be cleared with /clearmemory)
• Persona-driven responses
• Leverages the powerful Gemma 3 AI model

Installation

1. Clone the repository:

   If you don't have python:

   sudo apt install python3-full
   

   Then clone the repository

   git clone https://github.com/TheMongoose/Kitty-Hack
   cd Kitty-Hack
   

2. Create and activate a Python virtual environment (recommended):

   python3 -m venv venv
   source venv/bin/activate
   

3. Install the required Python dependencies:

   pip install -r requirements.txt
   

4. Download the Gemma GGUF model: The AI model itself (gemma-3-4b-it-Q4_K_M.gguf) is NOT included in this repository due to its large size and licensing terms. You must download it separately.

   Model Name: unsloth/gemma-3-4b-it-GGUF Specific File: gemma-3-4b-it-Q4_K_M.gguf

AI download

python3 download.py

Usage

python3 kitty_hack.py

Commands

# to edit token amount (defalt 120)
>>> /tokens

# to clear CLI
>>> /clear

# to clear memory
>>> /clearmemory

Happy hacking!!!