Skip to content

README.md

Latest commit

 

History

History
206 lines (159 loc) · 7.98 KB

README.md

File metadata and controls

206 lines (159 loc) · 7.98 KB

🛡️ UHT-Framework: UfaqTech Hacking Toolkit

A Modern, Multi-OS Cybersecurity Framework for Penetration Testing & Ethical Hacking

GitHub stars GitHub forks License

📚 Table of Contents

✨ Introduction

Welcome to UHT (Ufaq Hacking Toolkit) — a cutting-edge, modular, and intuitive CLI framework designed to simplify and accelerate cybersecurity workflows.

Developed by Awais Nawaz, UHT consolidates powerful open-source and commercial tools for penetration testing, ethical hacking, and security assessments.

🚀 Forget managing dozens of repos. UHT makes setup, updates, and tool management seamless across OS platforms.

🚀 Features

  • 🌐 Multi-OS Support: Linux (Debian/Ubuntu, Arch, Termux), macOS, Windows
  • 🖥️ Modern CLI: Clean, color-coded, intuitive interface
  • ⚙️ Dynamic Tool Management: All tools defined in tools.json
  • 📦 Automated Installer: Installs all system and Python dependencies
  • 🔄 Update Tools & Framework: One-click CLI-based updates
  • 📁 Organized Directory Layout: Tools, logs, wordlists, configs
  • 📝 Logs: All actions are logged for troubleshooting

📁 Directory Structure

UHT-Framework/
├── uht.py                  # Main CLI launcher
├── install.sh              # OS + env setup script
├── config/
│   ├── tools.json          # Tool metadata
│   └── settings.json       # Global config
├── lib/                    # Core Python modules
│   ├── os_utils.py
│   ├── menu_handler.py
│   ├── tool_manager.py
│   └── update_checker.py
├── tools/                  # Installed tools
├── wordlists/              # Wordlists (seclists, rockyou.txt)
├── logs/                   # Logs for installs/errors
├── README.md               # This file
└── LICENSE                 # MIT License

🛠️ Getting Started

1. Clone the Repository

git clone https://github.com/UfaqTech/UHT-Framework.git

2. Run the Installer

cd UHT-Framework
bash install.sh

This installs:

  • Git, Python, pip, and system tools
  • Virtual environment (venv)
  • Python libraries: termcolor, json5, requests

3. Activate Virtual Environment

source venv/bin/activate      # Linux/macOS/Termux
.\venv\Scripts\activate       # Windows CMD
.\venv\Scripts\Activate.ps1   # Windows PowerShell

4. Launch UHT CLI

python3 uht.py

⚙️ Usage

  • ✅ Install Tools from categories (Recon, Exploit, Web Hacking, etc.)
  • 🔄 Update installed tools or the full framework
  • 🏃‍♂️ Run Tools directly via CLI interface
  • 🔍 Browse Tools with easy-to-navigate menu

➕ Adding New Tools

Edit config/tools.json to add a tool.
Example entry (latest JSON structure):

{
  "category": "Category Name",
  "tools": [
    {
      "name": "ToolName",
      "repo_url": "https://github.com/example/tool.git",
      "description": "Describe the tool here.",
      "path": "toolname",
      "os_support": ["linux", "windows", "termux", "mac"],
      "dependencies": {
        "linux": ["dependency1", "dependency2"],
        "termux": ["dependency1", "dependency2"],
        "windows": ["dependency1", "dependency2"],
        "mac": ["dependency1", "dependency2"]
      },
      "post_install": {
        "linux": ["command1", "command2"],
        "termux": ["command1", "command2"],
        "windows": ["command1", "command2"],
        "mac": ["command1", "command2"]
      },
      "run": {
        "linux": "run_command_here",
        "termux": "run_command_here",
        "windows": "run_command_here.exe",
        "mac": "run_command_here"
      }
    }
  ]
},

🤝 Contributing to UHT-Framework

We ❤️ contributions! Whether it’s fixing bugs, improving documentation, or adding new tools — your help makes UHT stronger.

GitHub forks
➡️ Click the Fork button above to start contributing!

🔹 How to Contribute

  1. Fork this repository

    • Click the Fork button (top-right of the repo or above).

  2. Clone your fork locally

    git clone https://github.com/<your-username>/UHT-Framework.git
cd UHT-Framework

📄 License

This project is licensed under the MIT License.

📬 Contact & Connect

Portfolio
GitHub
LinkedIn
Twitter
Telegram
WhatsApp Channel
Email

📈 SEO & Keywords

Optimized for Google Search and GitHub discovery, the following keywords enhance visibility of the UHT-Framework (UfaqTech Hacking Toolkit) by Awais Nawaz.

  • Core Project: UHT Framework, UfaqTech Hacking Toolkit, UHT Cybersecurity Framework, UHT Ethical Hacking, UfaqTech Penetration Testing, UHT Security Toolkit
  • Developer & Organization: Awais Nawaz Cybersecurity, UfaqTech Open-Source Projects, Awais Nawaz Ethical Hacking, UfaqTech Security Tools, Awais Nawaz GitHub
  • Ethical Hacking & Pentesting: Ethical Hacking Framework, Penetration Testing Tools, Red Teaming Toolkit, Bug Bounty Tools, Cybersecurity Automation Toolkit, Ethical Hacking CLI Tools
  • Specific Tools: OSINT Tools, Nmap Hacking Tool, theHarvester OSINT, Recon-ng Framework, Vulnerability Scanning, Exploitation Tools
  • Platform & Compatibility: Multi-OS Security Tools, Linux Hacking Tools, Termux Cybersecurity, Windows Penetration Testing, macOS Ethical Hacking, Cross-Platform Cybersecurity
  • GitHub Discoverability: GitHub Security Tools, GitHub Ethical Hacking, GitHub Penetration Testing, Open-Source Cybersecurity GitHub, UfaqTech GitHub Projects
  • General Cybersecurity: Cybersecurity Toolkit, Network Security Tools, Web Security Framework, Vulnerability Assessment Tools, Threat Analysis Tools, Real-Time Security Monitoring
  • Long-Tail Keywords: UHT Framework for Ethical Hacking, Penetration Testing with UHT, OSINT Tools for Bug Bounty, Multi-OS Cybersecurity Framework, Red Teaming with UHT

🔍 These keywords are strategically chosen to boost ranking on Google and GitHub search results, helping researchers, ethical hackers, and penetration testers easily find and use UHT.

Made with ❤️ by Awais Nawaz (UfaqTech)
Empowering Cybersecurity with Simplicity & Speed.