Skip to content

drkemp187/GhostFlash

Repository files navigation

  ██████  ██   ██  ██████  ███████ ████████     ███████ ██       █████  ███████ ██   ██
 ██       ██   ██ ██    ██ ██         ██        ██      ██      ██   ██ ██      ██   ██
 ██   ███ ███████ ██    ██ ███████    ██        █████   ██      ███████ ███████ ███████
 ██    ██ ██   ██ ██    ██      ██    ██        ██      ██      ██   ██      ██ ██   ██
  ██████  ██   ██  ██████  ███████    ██        ██      ███████ ██   ██ ███████ ██   ██

AI-Powered Firmware & App Generation for Cybersecurity Hardware

Stars License Python Boards Self-Learning

Plug in your device. GhostFlash detects it. The AI builds the firmware. You flash it.


What Is GhostFlash?

GhostFlash is an autonomous AI agent that generates custom firmware and applications for cybersecurity hardware — from Flipper Zero to HackRF to ESP32 mesh nodes. Describe what you want, plug in your device, and GhostFlash handles the rest: detection, code generation, compilation, and flashing.

It scrapes GitHub and GitLab daily, ingests the latest firmware projects, exploits, and tools, and continuously improves its own knowledge base. It gets smarter every single day.


Supported Hardware

Category Boards / Devices
Multi-tool Flipper Zero, ChameleonUltra
WiFi / BLE ESP32, ESP8266, ESP32-S3, ESP32-C3
Sub-GHz / RF HackRF One, YARD Stick One, CC1101 modules
BLE / Zigbee nRF52840, nRF24L01, CC2531
RP2040 Raspberry Pi Pico, Pico W, Waveshare boards
Mesh Network Meshtastic (T-Beam, T-Echo, Heltec v3)
Display / CPI Waveshare e-ink, SSD1306, TFT ST7789
Classic Arduino Nano/Uno (ATmega328P), STM32
Advanced Proxmark3, OpenWRT routers, Raspberry Pi Zero W

25+ boards and growing. New boards added automatically via the scraper agent.


Core Agents

1. Device Detection Agent

Plug in your hardware via USB. GhostFlash auto-identifies:

  • Board name and variant
  • Chip/MCU (e.g., ESP32-S3, STM32F4, nRF52840)
  • Flash size, RAM, architecture
  • Existing firmware (if any)
  • Available flash method (esptool, dfu-util, openocd, qFlipper)

2. Firmware Generation Agent

Describe your use case in plain English. The AI generates:

  • Full firmware source code (C/C++, MicroPython, Arduino, Zephyr RTOS)
  • Build configuration (CMakeLists.txt, platformio.ini, Makefile)
  • Flash instructions specific to your board
  • Compiled binary (where supported)

Example prompts:

"Build a WiFi deauth tool for ESP32 with OLED display"
"Create a Flipper Zero app that clones NFC cards and logs to SD"
"Generate Meshtastic mesh node firmware with GPS tracking and encryption"
"Write a BLE scanner for nRF52840 that logs to serial"

3. Scraper Agent (Daily)

Runs every 24 hours. Automatically:

  • Scrapes GitHub and GitLab for new firmware repos, tools, and exploits
  • Indexes by board, category, and use case
  • Feeds new knowledge into the generation model
  • Tracks trending projects and star velocity

4. Self-Learning Loop

The knowledge base grows continuously:

  • New repos → parsed → embedded → stored
  • Generation quality improves with every scrape cycle
  • Community contributions feed back into the model

Tiers

Tier Price Access
Ghost Free Free 5 generations/day, public tools only, community boards
Ghost Pro $29/mo Unlimited generations, all 25+ boards, priority compile
Ghost Elite $99/mo Offensive tooling, red team payloads, RF tools, advanced BLE
Ghost Black $299/mo Near-unrestricted access, custom board requests, private Discord, direct support

Tier verification is handled via API key. See tiers/README.md.


Quick Start

# Clone the repo
git clone https://github.com/drkemp187/GhostFlash.git
cd GhostFlash

# Install dependencies
pip install -r requirements.txt

# Plug in your device and detect it
python ghostflash.py detect

# Generate firmware
python ghostflash.py generate --prompt "WiFi scanner with OLED output" --board esp32

# Flash it
python ghostflash.py flash --board esp32 --port /dev/ttyUSB0

Architecture

GhostFlash/
├── agent/
│   ├── core/           # Orchestrator, API key validation, tier enforcement
│   ├── device_detect/  # USB detection, chip ID, flash method resolution
│   ├── firmware_gen/   # LLM-powered code generation per board/use-case
│   ├── scraper/        # Daily GitHub/GitLab scraper + indexer
│   └── self_learning/  # Embedding pipeline, knowledge base updater
├── boards/             # Board profiles (chip, arch, flash method, constraints)
├── tiers/              # Tier definitions and access control
├── scripts/            # Flash helpers, build wrappers
├── docs/               # Full documentation
└── .github/workflows/  # CI/CD + daily scraper automation

Sponsorship & Support

GhostFlash is community-powered. If this tool saves you hours, consider:

  • GitHub Sponsors — keep the scraper running and the AI sharp
  • Star this repo — it directly helps discoverability and funding
  • Share it — r/flipperzero, r/hacking, r/netsec, r/esp32, r/meshtastic

Enterprise and team licensing available. Contact via GitHub Issues.


Disclaimer

GhostFlash is a developer and research tool. Users are responsible for compliance with local laws. The Ghost Black tier is restricted to verified security professionals and researchers.


Built for the community. Powered by AI. Ghost in the wire.

About

AI-powered firmware & app generation agent for cybersecurity hardware — Flipper Zero, ESP32, HackRF, nRF52840, Meshtastic & more. Tiered access. Self-learning. Auto-flash.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages