_{v1.0.0 "Neon Genesis" · ESP32 16MB · WiFi + BLE + NRF24 + RF + IR
Created by Arjun TM · @imarjunarz}

---

🧠 What is HexPulse?

HexPulse is a production-grade, modular firmware that transforms your ESP device into an AI-powered portable intelligence platform. Built on battle-tested ESP32 foundations, supercharged with cloud AI and cyberpunk aesthetics.

"Your device is no longer just a tool it's an intelligent companion."

🤖 HexMind AI Cloud AI Chat Gemini · ChatGPT	⌨️ BLE Keyboard Phone / BT Input Full QWERTY	📡 WiFi Arsenal Scanner · Sniffer Deauth · Wardriving	📶 BLE Scanner Device Analysis Fingerprinting	🔌 NRF24 Tools Spectrum Analyzer Channel Scanner
📻 RF 435MHz Signal Capture Protocol Replay	🔴 IR Blaster Remote Clone Multi-protocol	🌐 WebUI Panel Browser Control hexpulse.local	🎮 JS Runtime Scripting Engine On-Device Code	⬆️ OTA Updates Wireless Flash SD Card / WiFi

---

⚡ Quick Install

Flash HexPulse directly from your browser — no tools needed

	Step	What To Do
🔌	1	Plug your ESP device into your PC with a USB-C data cable
🌐	2	Open the Web Flasher in Chrome or Edge
⚡	3	Click "DEPLOY HEXPULSE" and select your COM port
⏳	4	Wait ~2 minutes while the firmware is written
✅	5	Done! Your device reboots into HexPulse automatically

Tip

Zero setup required. No Python, no drivers, no terminal. Just click and flash.

Important

Only Chrome, Edge, and Opera support Web Serial. Safari and Firefox will not work.

---

💾 Other Install Methods

📂 SD Card Flash — No PC needed after download

1. Download the firmware ZIP from Releases
2. Extract to get firmware.bin
3. Copy to a FAT32 MicroSD card (max 32GB)
4. Insert into your ESP device → Power on
5. Navigate to Config → OTA Update → SD Card Update
6. Select firmware.bin → Confirm → Done! 🎉

🔧 esptool.py — Command line flash

pip install esptool

esptool.py --chip esp32 --port COM5 --baud 921600 \
  write_flash -z \
  0x1000 bootloader.bin \
  0x8000 partitions.bin \
  0x10000 firmware.bin

Use /dev/ttyUSB0 on Linux/Mac. Hold BOOT button if connection fails.

🛠️ PlatformIO — Build from source

git clone https://github.com/cyberkallan/hexpulse
cd hexpulse/firmware-main
pio run -e hackcat-v3 -t upload
pio device monitor -b 115200

---

🤖 HexMind AI

_{Cloud-powered AI assistant running on your ESP device}

Quick Start Connect to WiFi → WiFi → Connect Open HexMind AI → AI Settings Select provider (Gemini = free tier) Enter API key Open HexMind AI → AI Chat Start chatting! 🧠

API Keys Provider Free? Link Google Gemini ⭐ ✅ 15 RPM aistudio.google.com OpenAI 💰 Pay platform.openai.com Custom 🔧 Self Any OpenAI-compatible endpoint

What can HexMind do?

	Capability	Description
💬	Chat	Ask about protocols, vulnerabilities, networking
📡	WiFi Intel	Auto-analyze scan results for security issues
📶	BLE Intel	Identify IoT devices and security posture
📋	Reports	Generate security diagnostic reports
💾	Export	Save conversations to SD card

Note

API keys are stored on device EEPROM only. Never in source code, never transmitted except to the AI provider over HTTPS.

---

📱 Hardware

Component Spec MCU ESP32-WROOM 240MHz Flash 16MB RAM 520KB SRAM Display 1.3" OLED 128×64 Battery 800mAh LiPo Charging USB-C

Radio Spec WiFi 2.4GHz 802.11 b/g/n Bluetooth BLE 4.2 + Classic NRF24 NRF24L01 2.4GHz RF 435MHz TX/RX IR TX + RX Storage MicroSD up to 32GB

---

🎨 Cyberpunk Themes

Theme	Color	Style
⚡ Neon Cyan	#00FFFF	HexPulse signature
🟢 Toxic Green	#00FF00	Matrix terminal
🔴 Pulse Red	#FF0000	Alert mode
🟡 HexMind Gold	#FFD400	AI mode
🎨 +15 Classic	Various	Built-in collection

---

📁 Project Structure

hexpulse/
├── firmware-main/                  # Full firmware source code
│   ├── src/
│   │   ├── main.cpp                # Boot sequence + main loop
│   │   ├── core/                   # UI, menus, themes, settings
│   │   └── modules/
│   │       ├── hexmind/            # ★ AI Chat + BLE Keyboard
│   │       ├── wifi/               # WiFi pentesting suite
│   │       ├── ble/                # BLE analysis tools
│   │       ├── rf/                 # RF 435MHz tools
│   │       └── ir/                 # IR blaster
│   ├── boards/                     # Board-specific profiles
│   ├── flash/                      # Web flasher source
│   └── docs/                       # Documentation
├── web-flasher-dist/               # ★ Ready-to-host flasher
├── boards/                         # Board JSON definitions
├── scripts/                        # Build scripts
└── platformio.ini                  # PlatformIO configuration

---

🔒 Security

	Aspect	Detail
🔑	API Keys	Device EEPROM only — never in source code
🔐	HTTPS	All cloud AI traffic encrypted via TLS
🚫	No Telemetry	Zero data collection, zero phone-home
📖	Open Source	Full source code auditable by anyone
🔒	OTA Auth	Password-protected firmware updates
🌐	Web Flasher	100% client-side — no server backend

Caution

Disclaimer: HexPulse is for authorized security testing and education only. Always obtain written authorization before testing systems you do not own.

---

📜 Credits

Arjun TM Creator & Developer @cyberkallan @imarjunarz

Bruce Firmware Base Framework pr3y/Bruce GPL-3.0

HexMind AI Intelligence Layer hexmind.space Gemini + OpenAI

GPL-3.0 License — Free to use, modify, and distribute.

---

HexPulse v1.0.0 "Neon Genesis"
Built with ⚡ by Arjun TM
HexMind AI Ecosystem