Hatiyar

Modern security toolkit for penetration testing, vulnerability assessment, and security research.

⚠️ IMPORTANT: Hatiyar is intended for educational, research, and defensive security use only.
Do not use this software on systems you do not own or do not have explicit written permission to test. Misuse may result in civil or criminal liability.

Quick Demo

Overview

Hatiyar is a security toolkit designed for penetration testing, vulnerability assessment, and security research.

It provides:

• Interactive CLI (REPL) - Metasploit-like shell for exploring and executing security modules
• CVE Exploit Modules - Pre-built, tested exploits for known vulnerabilities
• Enumeration Tools - Cloud, network and system reconnaissance capabilities
• Modular Architecture - Easy extension with custom Python modules and YAML registration
• Cloud Compliance Auditing - (coming soon) via web dashboard

Future roadmap: Additional CVE modules, enhanced security tools, web UI, automation APIs, and integration capabilities

Quick Start

Get Hatiyar running in seconds:

For the complete quick start guide, visit: Quick Start Documentation

Prerequisites

For pip installation (recommended):

• Python 3.9+ - Modern Python with type hints support

For development setup (optional):

• git - Version control for cloning the repository
• uv - Fast Python package installer
• build-essential - C compiler and build tools for Makefile-based setup
  • Linux: sudo apt install build-essential (Debian/Ubuntu) or sudo dnf install gcc make (Fedora/RHEL)
  • macOS: xcode-select --install (Xcode Command Line Tools)

Installation

Option 1: Install via pip (Recommended)

The fastest way to get started:

pip install hatiyar

Then run:

hatiyar              # Launch interactive shell
hatiyar shell        # Same as above
python -m hatiyar    # Alternative way to run

Option 2: Development Setup (From Source)

For contributors or users who want the latest development version:

1. Clone the Repository

git clone https://github.com/ajutamangdev/hatiyar.git
cd hatiyar

2. Set Up with Makefile

make setup

This will:

• Create a virtual environment (.venv)
• Install all dependencies using uv sync
• Activate the environment automatically

3. Verify Installation

make info

4. Run the Framework

make shell           # Interactive shell
make serve           # Web server (coming soon)

For detailed installation instructions, Docker setup, and platform-specific guides, see:

• Quick Start Guide - Get up and running quickly
• Full Installation Guide - Detailed setup for all platforms

📖 Full Documentation

For comprehensive guides, tutorials, API documentation, and usage examples, visit the full documentation:

Hatiyar Documentation

Security Disclaimer

This tool is provided for educational and authorized security testing purposes only. Users must:

• Only test systems they own or have explicit written permission to test
• Comply with all applicable local, state, and federal laws
• Use responsibly and ethically
• Never use for malicious purposes or unauthorized access

The developers assume no liability for misuse of this software.

Support & Community

• GitHub Repository - Source code, issues, discussions
• Issue Tracker - Report bugs, request features
• Discussions - Ask questions, share knowledge
• Discord Community - Join our community server