Metadata-Version: 2.4
Name: hatiyar
Version: 0.0.1
Summary: security toolkit designed for penetration testing, vulnerability assessment, and security research.
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: boto3>=1.7.84
Requires-Dist: boto3-stubs>=1.40.59
Requires-Dist: fastapi>=0.119.1
Requires-Dist: jinja2>=3.1.6
Requires-Dist: pluggy>=1.6.0
Requires-Dist: prompt-toolkit>=3.0.52
Requires-Dist: pydantic>=2.12.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: requests>=2.32.0
Requires-Dist: rich>=14.2.0
Requires-Dist: typer>=0.12.0
Requires-Dist: uvicorn>=0.38.0
Requires-Dist: mypy>=1.18.2
Requires-Dist: pre-commit>=4.3.0
Requires-Dist: pytest>=8.4.2
Requires-Dist: types-pyyaml>=6.0.12.20250915
Requires-Dist: types-requests>=2.32.4.20250913
Requires-Dist: ruff>=0.8.0
Requires-Dist: kubernetes>=34.1.0
Requires-Dist: docker>=7.1.0
Dynamic: license-file

# Hatiyar

[![Python](https://img.shields.io/badge/python-3.9%2B-blue)](https://www.python.org/)
[![PyPI](https://img.shields.io/pypi/v/hatiyar)](https://pypi.org/project/hatiyar/)
[![License: Custom](https://img.shields.io/badge/License-Custom-green)](LICENSE)

> 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

![hatiyar demo](/docs/src/assets/hatiyar.gif)

---

## 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+](https://www.python.org/downloads/)** - Modern Python with type hints support

**For development setup (optional):**
- **[git](https://git-scm.com/downloads)** - Version control for cloning the repository
- **[uv](https://docs.astral.sh/uv/getting-started/installation/)** - 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:

```bash
pip install hatiyar
```

Then run:

```bash
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

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

##### 2. Set Up with Makefile

```bash
make setup
```

This will:
- Create a virtual environment (`.venv`)
- Install all dependencies using `uv sync`
- Activate the environment automatically

##### 3. Verify Installation

```bash
make info
```

##### 4. Run the Framework

```bash
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](https://ajutamangdev.github.io/hatiyar/introduction/installation/).**

---

## 📖 Full Documentation

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

**[Hatiyar Documentation](https://ajutamangdev.github.io/hatiyar)**

---

## 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](https://github.com/ajutamangdev/hatiyar)** - Source code, issues, discussions
- **[Issue Tracker](https://github.com/ajutamangdev/hatiyar/issues)** - Report bugs, request features
- **[Discussions](https://github.com/ajutamangdev/hatiyar/discussions)** - Ask questions, share knowledge
- **[Discord Community](https://discord.gg/V9HghE8V7M)** - Join our community server


