Raspberry Pi 5 Wardriving & Wireless Pentest Platform
WiFi • BLE • SDR | WPA3 Downgrade • Karma/MANA • Evil Twin | Part of MoMo Ecosystem

Features • Quick Start • Ecosystem • Docs • Contributing

Nexus • GhostBridge • Mimic

MoMo is a Raspberry Pi 5 based wireless security audit platform designed for penetration testers and security researchers. It combines the best features of Pwnagotchi, ESP32 Marauder, and WiFi Pineapple into one powerful, modular platform.

|| Feature | Description | Status | ||---------|-------------|--------| || Management Network | Dedicated wlan0 for tablet/phone control | ✅ | || AP Mode | Creates MoMo-Management hotspot | ✅ | || Client Mode | Connects to known WiFi network | ✅ | || Auto-Whitelist | Management network protected from attacks | ✅ | || Interface Isolation | wlan0=management, wlan1+=attack | ✅ | || Web UI Binding | Bind to management IP only | ✅ |

• Async-First Architecture - Non-blocking I/O with asyncio
• Clean Architecture - 4-layer separation (Presentation → Application → Domain → Infrastructure)
• Modern Plugin System - Marauder-inspired with lifecycle hooks & event communication
• Real-time Web UI - Dark theme dashboard with SSE updates
• Event-Driven - Pub/Sub event bus for decoupled components
• Hardware Auto-Detection - Automatic USB device identification & configuration
• Headless Ready - Management network separation for screenless operation
• 445 Unit Tests - Comprehensive test coverage with pytest-asyncio
• Nexus Integration - Seamless sync with MoMo-Nexus hub

curl -fsSL https://raw.githubusercontent.com/Momo-Master/MoMo/main/deploy/momo-quickstart.sh | sudo bash

# Clone repository
git clone https://github.com/Momo-Master/MoMo.git
cd MoMo

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -e ".[dev]"

# Verify installation
momo version
momo doctor

# Install with dev dependencies
pip install -e ".[dev]"
pre-commit install

# Run tests
pytest tests/ -v

# Run with dry-run (no hardware needed)
momo run -c configs/momo.yml --dry-run

momo/
├── core/                    # Event bus, plugin system, utilities
│   ├── events.py           # Pub/Sub event system
│   ├── plugin.py           # Modern plugin architecture
│   └── security.py         # Input sanitization
├── domain/                  # Pydantic models
│   └── models.py           # AccessPoint, GPSPosition, etc.
├── infrastructure/          # Hardware abstraction
│   ├── wifi/               # Scanner, RadioManager
│   ├── gps/                # GPS client, distance tracker
│   ├── ble/                # BLE scanner, GATT, HID, Beacon
│   ├── capture/            # Handshake capture
│   ├── eviltwin/           # Rogue AP, captive portal
│   ├── evilginx/           # [MOVED TO VPS] AiTM proxy
│   ├── wpa3/               # WPA3 detection & attacks
│   ├── karma/              # Karma/MANA attacks
│   ├── cracking/           # John local + Cloud proxy
│   ├── sdr/                # RTL-SDR, HackRF, spectrum
│   ├── hardware/           # Device registry, auto-detection
│   ├── management/         # Headless management network
│   └── database/           # Async SQLite repository
├── plugins/                 # Modern plugins (new architecture)
├── apps/
│   ├── momo_core/          # Main service loop
│   ├── momo_plugins/       # Legacy plugins
│   └── momo_web/           # Flask API + Web UI
└── config.py               # Pydantic configuration

Access the real-time dashboard:

# Get URL and token
momo web-url --show-token

# Access API
curl -H "Authorization: Bearer <token>" http://<ip>:8082/api/status

MoMo features a modern, Marauder-inspired plugin architecture:

from momo.core import BasePlugin, PluginMetadata, PluginType

class MyPlugin(BasePlugin):
    """My awesome plugin."""
    
    @staticmethod
    def metadata() -> PluginMetadata:
        return PluginMetadata(
            name="my_plugin",
            version="1.0.0",
            author="Your Name",
            description="What my plugin does",
            plugin_type=PluginType.CUSTOM,
            priority=100,
        )
    
    async def on_start(self) -> None:
        self.log.info("My plugin started!")
        await self.emit("started", {"status": "ready"})
    
    async def on_stop(self) -> None:
        self.log.info("My plugin stopped!")

UNLOADED → LOADING → LOADED → STARTING → RUNNING → STOPPING → STOPPED
                ↓                                        ↓
              ERROR ←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←←← ERROR

See momo/plugins/example_plugin.py for a complete template.

Edit configs/momo.yml:

mode: aggressive              # Full offensive mode

interface:
  name: wlan1
  regulatory_domain: "00"     # Global (unrestricted)

aggressive:
  enabled: true
  max_deauth_per_min: 0       # Unlimited
  ssid_blacklist: []          # Your networks (protected)
  ssid_whitelist: []          # Target focus (optional)

ble:
  enabled: true
  scan_duration: 5.0
  detect_beacons: true

eviltwin:
  enabled: false
  portal_template: generic    # generic, hotel, corporate, facebook, google, router

karma:
  enabled: false
  respond_to_all: true        # Respond to all probe requests
  capture_eap: true           # Capture EAP credentials

wpa3:
  enabled: true
  auto_downgrade: false       # Auto-attempt WPA3→WPA2 downgrade

sdr:
  enabled: false
  device_type: rtlsdr         # rtlsdr, hackrf
  bias_tee: false             # Enable bias tee (RTL-SDR V3/V4)

hardware:
  auto_detect: true           # Auto-detect USB devices
  auto_configure: true        # Auto-configure detected devices

management:
  enabled: true
  interface: wlan0            # Pi5 internal WiFi (management only)
  mode: ap                    # ap = hotspot, client = join network
  ap_ssid: MoMo-Management    # Management network SSID
  ap_password: MoMoAdmin2024! # Change this!
  auto_whitelist: true        # Protect from self-attack
  bind_web_to_management: true

cracking:
  enabled: true
  use_john: true              # Local cracking with John
  cloud_enabled: false        # Enable when Nexus configured
  nexus_api_url: ""           # Nexus API for cloud cracking

plugins:
  enabled: 
    - wardriver
    - active_wifi
    - ble_scanner

momo version                  # Show version
momo doctor                   # System diagnostics
momo run -c momo.yml          # Start capture loop
momo run --dry-run            # Simulate without hardware
momo status                   # Show runtime status
momo rotate-now               # Force log rotation
momo web-url --show-token     # Show Web UI credentials

Total: 445 Tests Passing ✅

Contributions are welcome! Please read our contributing guidelines:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing)
5. Open a Pull Request

pip install -e ".[dev]"
pre-commit install
pytest tests/ -v --cov=momo

MoMo is part of a larger offensive security ecosystem. Each project is designed to work together seamlessly.

                         ☁️ Cloud (Hashcat GPU + Evilginx)
                                    │
                         ┌──────────▼──────────┐
                         │    MoMo-Nexus       │
                         │    Central Hub      │
                         └──────────┬──────────┘
                                    │
          ┌─────────────────────────┼─────────────────────────┐
          │                         │                         │
   ┌──────▼──────┐          ┌───────▼───────┐         ┌──────▼──────┐
   │  🔵 MoMo    │          │ 👻 GhostBridge│         │ 🎭 Mimic    │
   │   WiFi/BLE  │          │   Network     │         │  USB Attack │
   │    Pi 5     │          │   Implant     │         │  Pi Zero    │
   └─────────────┘          └───────────────┘         └─────────────┘

MoMo is designed for authorized security testing and educational purposes only.

• Only use on networks you own or have explicit written permission to test
• Respect local laws and regulations regarding wireless security testing
• The developers are not responsible for misuse of this tool

This project is licensed under the MIT License - see the LICENSE file for details.

Part of the 🔥 MoMo Ecosystem
_{Inspired by Pwnagotchi, ESP32 Marauder, and WiFi Pineapple}

MoMo • Nexus • GhostBridge • Mimic