Skip to content

Getting Started

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) │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Getting Started

First Launch

  1. Open MacHackerToolkit from Applications or Launchpad
  2. Grant permissions when prompted:
    • Bluetooth access
    • Local Network access
  3. The main Dashboard will appear

Interface Overview

┌─────────────────────────────────────────────────────────┐
│ [Sidebar]        │ [Content Area]                       │
│                  │                                      │
│ 📊 Dashboard     │  System Status                       │
│ 📡 Network       │  Quick Actions                       │
│ 📶 Wi-Fi         │  AI Insights                         │
│ 🔵 Bluetooth     │                                      │
│ 🔐 Passwords     │                                      │
│ 🔍 Forensics     │                                      │
│ ⚙️ RE Tools      │                                      │
│ 🤖 AI Hub        │                                      │
│ ⚙️ Settings      │                                      │
└─────────────────────────────────────────────────────────┘

Quick Actions

Action How to Access
AI Assistant ⌘⇧K or click sidebar
Quick Scan ⌘R or Dashboard
System Info Dashboard → System Status

Basic Workflow

1. Run a Network Scan

Network Scanner → Enter target (IP or CIDR) → Select scan type → Start Scan

2. Analyze Wi-Fi Networks

Wi-Fi Scanner → Click Scan → View discovered networks

3. Use AI Assistant

AI Assistant → Ask security questions → Get contextual help

Required Setup

Install Security Tools

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

Set Up AI (Recommended)

# Install Ollama
brew install ollama

# Start Ollama
ollama serve

# Pull models
ollama pull mistral
ollama pull llama3

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