Skip to content

Installation

Jump to bottom
N0K71RN4L edited this page Apr 21, 2026 · 2 revisions 
┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│   🛡️  **Mac Hacker Toolkit**                              v1.0.3 • 2026-04-21 │
│                                                                              │
│   🔗 [Home](Home)  📖 [Getting Started](Getting-Started)  🔧 [Tools](Tool-Reference) │
│   📡 [Architecture](Architecture)  🔐 [Security](Security)  🤝 [Contributing](Contributing) │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Installation Guide

Prerequisites

Before installing Mac Hacker Toolkit, ensure you have:

Required Software

Software Version Install Command
macOS 14.0+ -
Xcode 15.0+ Mac App Store
Homebrew Latest /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
XcodeGen Latest brew install xcodegen

System Requirements

Component Minimum Recommended
RAM 8 GB 16 GB
Storage 2 GB 10 GB
Apple Silicon M1 M2/M3/M4

Installation Methods

Method 1: DMG Installation (Recommended for Users)

  1. Download the latest .dmg from Releases
  2. Mount the DMG: 
    hdiutil attach MacHackerToolkit-*.dmg
  3. Drag MacHackerToolkit.app to Applications
  4. Eject the DMG: 
    hdiutil detach /Volumes/Mac\ Hacker\ Toolkit

Method 2: Build from Source (Recommended for Developers)

# Clone the repository
git clone https://github.com/noktirnal42/mac_hacker_toolkit.git
cd mac_hacker_toolkit

# Generate Xcode project
xcodegen generate

# Build the application
xcodebuild -scheme MacHackerToolkit -configuration Release build \
    CODE_SIGN_IDENTITY="-" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO

Post-Installation Setup

1. Install Security Tools

Run the installation script to install all required tools:

cd mac-hacker-toolkit
./scripts/install.sh

This script installs tools across these categories:

  • Network scanners (nmap, masscan, rustscan)
  • Wi-Fi tools (aircrack-ng, wireguard-tools)
  • Bluetooth tools (bettercap)
  • Password crackers (hashcat, john)
  • Reverse engineering tools (radare2, binwalk)

2. Set Up AI Features (Optional)

# Install Ollama
brew install ollama

# Start Ollama service
ollama serve

# Pull recommended models
ollama pull mistral
ollama pull llama3

3. Grant Permissions

On first launch, grant these permissions in System Settings:

Permission Purpose
Bluetooth Discover nearby BLE devices
Local Network Network scanning
Full Disk Access Forensics tools

Troubleshooting

"App is damaged"

xattr -cr /Applications/MacHackerToolkit.app

"Tools not found"

Ensure Homebrew is in your PATH:

echo 'export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

"AI features not working"

Verify Ollama is running:

ollama list

Next Steps

🍎 Brand & Resources

Resource Link
📖 Documentation Wiki Home
📦 Releases GitHub Releases
🐛 Issues GitHub Issues
💬 Discussions GitHub Discussions
📜 License MIT License

🔐 Mac Hacker Toolkit — Built with ❤️ for the security community

Clone this wiki locally