hatiyar 0.0.1

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

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 modern security toolkit designed for penetration testing, vulnerability assessment, and security research. Built with Python 3.9+, it combines powerful security modules with an intuitive, Metasploit-inspired interface.

Key Features

• 🎯 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
• ☁️ Cloud Security - AWS, Azure, GCP security assessment tools
• ⚓ Kubernetes - Comprehensive K8s cluster enumeration and security testing
• 🔧 Modular Architecture - Easy extension with custom Python modules and YAML registration
• 🌐 Web Dashboard - (coming soon) Cloud compliance auditing interface

Why Hatiyar?

• ✅ Easy Installation - pip install hatiyar and you're ready
• ✅ Beginner Friendly - Clear documentation and intuitive commands
• ✅ Production Ready - Thoroughly tested with proper error handling
• ✅ Extensible - Add custom modules in minutes
• ✅ Active Development - Regular updates with new features

Roadmap: Additional CVE modules, enhanced cloud security tools, web UI dashboard, automation APIs, and CI/CD integrations

---

Quick Start

Get Hatiyar running in seconds:

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 the Full Installation Guide.

---

📖 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