██╗   ██╗ ██████╗ ███████╗██████╗ ███████╗██████╗
 ██║   ██║╚════██╗██╔════╝██╔══██╗██╔════╝██╔══██╗
 ██║   ██║ █████╔╝███████╗██████╔╝█████╗  ██████╔╝
 ╚██╗ ██╔╝ ╚═══██╗╚════██║██╔═══╝ ██╔══╝  ██╔══██╗
  ╚████╔╝ ██████╔╝███████║██║     ███████╗██║  ██║
   ╚═══╝  ╚═════╝ ╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝

V3SP3R — The AI Brain for Your Flipper Zero

Talk to your Flipper Zero like it's your partner-in-hacking. Vesper turns your pocket hacking tool into an AI-powered command center — controlled entirely through natural language from your Android device or smart glasses.

No menus. No manuals. Just natural language prompting.

Why Vesper?

The Flipper Zero is one of the most versatile hardware hacking tools ever made — but navigating its menus, managing files, and crafting signals by hand is tedious. Vesper eliminates the friction. Plug in an AI brain via OpenRouter, connect over Bluetooth, and you have a voice-commanded hardware lab in your pocket.

• Instant expertise — Don't memorize SubGHz protocols or IR formats. Just say what you want.
• Real-time control — The AI reads your Flipper's state, executes commands, and reports back in seconds.
• Multimodal input — Voice commands, photo analysis, and text chat. Use your phone camera or smart glasses to show the AI what you're looking at.
• Signal alchemy — Build, layer, and export custom RF waveforms with a visual editor.
• Smart glasses integration — Pair with Mentra smart glasses for hands-free, heads-up Flipper control.
• Safety-first architecture — Every AI action is risk-classified. Destructive operations require explicit confirmation. System paths are locked by default.

Whether you're a security researcher, a red teamer, a CTF competitor, a hardware tinkerer, or just someone who wants to understand the invisible signals around you — Vesper makes the Flipper Zero dramatically more accessible and more powerful.

Features

Chat — AI-Driven Flipper Control

Talk to your Flipper in plain English (voice or text): - "Show me my SubGHz captures" - "What's my battery level?" - "Create a backup of all my IR remotes" - "Generate a BadUSB script that opens a reverse shell" - "Change the frequency in garage.sub to 315MHz"

Hardware Control

Direct control over all Flipper subsystems: - SubGHz — Transmit and analyze RF signals - Infrared — Send and record IR commands - NFC / RFID / iButton — Emulate stored credentials - BadUSB — Execute HID attack scripts - GPIO / LED / Vibro — Control hardware peripherals - App Launcher — Start any Flipper app by name

Multimodal Input

• Voice input — Speak commands using on-device speech recognition
• Photo analysis — Snap a picture of a remote, a device label, or anything — the AI sees what you see
• Text-to-speech — AI responses read aloud via OpenRouter TTS
• Smart glasses — Hands-free voice + camera via Mentra glasses bridge

Ops Center

Built for reliability-obsessed users: - Pipeline Health — BLE/RPC/CLI readiness and diagnostics at a glance - Runbooks — One-tap recovery and smoke-test sequences - Live Status — Transport and command pipeline behavior in one view

Alchemy Lab — Signal Synthesis

Build custom RF signals from scratch: - Visual waveform editor with real-time preview - Layer and fuse multiple signal patterns - Export directly to your Flipper's SD card

Payload Lab

AI-powered payload generation: - BadUSB scripts, SubGHz signals, IR remotes, NFC tags - Validated before deployment — the AI checks format and safety - Direct push to Flipper storage

FapHub Browser

Browse and install Flipper applications: - Search the Flipper app catalog - One-tap install to your device

Resource Browser

Find and download community resources: - Search GitHub for Flipper-compatible files - Browse repositories and download directly to your Flipper

Device Manager

Full Flipper visibility: - Battery, storage, firmware info, and connection status - Scan, pair, and manage BLE connections - Direct file browsing and management

Risk & Permissions Engine

Every AI action is classified before execution: - Low risk — Read-only ops execute automatically - Medium risk — File writes show a diff for review - High risk — Destructive ops require double-tap confirmation - Blocked — System/firmware paths require explicit unlock

Configure auto-approve per risk tier in Settings to move faster when you trust the workflow.

Audit Log

Every action the AI takes is logged: - Full history of commands, results, and approvals - Filterable by action type and session - Exportable for compliance and review

Recommended AI Models

Vesper works with any model on OpenRouter. For the best experience:

Our recommendation: Start with Hermes 4 or Claude Sonnet 4 for daily use. Reach for Claude Opus 4.6 when you need deep reasoning.

Quick Start

Requirements

1. Prep Your Flipper

1. Charge it up (USB-C)
2. Update firmware via qFlipper (recommended)
3. Enable Bluetooth: Settings > Bluetooth > ON

2. Get an OpenRouter API Key

1. Sign up at openrouter.ai
2. Go to Keys > Create Key
3. Copy the key (sk-or-...) — you'll paste this into Vesper
4. Add $5-10 in credits to start (most conversations cost pennies)

3. Build & Install

git clone https://github.com/elder-plinius/V3SP3R.git
cd V3SP3R

Open the project in Android Studio, let Gradle sync, then:

• Build > Build APK(s) or hit the green play button
• APK output: app/build/outputs/apk/debug/app-debug.apk

Install via USB debugging or transfer the APK to your phone.

Command-line build (no Android Studio)

# Requires Android SDK and JDK 17+
./gradlew assembleDebug
# APK: app/build/outputs/apk/debug/app-debug.apk

4. First Launch

1. Grant permissions — Bluetooth, Location (required for BLE scanning), Notifications
2. Add your API key — Settings > paste your OpenRouter key
3. Connect — Device tab > Scan > tap your Flipper
4. Go — Chat tab > start talking to your Flipper

Smart Glasses Setup (Optional)

Vesper supports hands-free operation via Mentra smart glasses.

1. Deploy the bridge server from mentra-bridge/: bash cd mentra-bridge npm install && npm run build && npm start
2. In Vesper Settings, enable Smart Glasses and enter the bridge URL
3. Voice transcriptions from your glasses flow directly to Vesper
4. The AI can request photos through your glasses camera

Architecture

┌─────────────────────────────────────────┐
│              Vesper App                  │
├─────────────────────────────────────────┤
│  UI Layer (Jetpack Compose + Hilt)      │
│  ├── Chat Screen (voice, images, text)  │
│  ├── Ops Center                         │
│  ├── Alchemy Lab & Payload Lab          │
│  ├── File Browser & FapHub              │
│  ├── Signal Arsenal & Spectral Oracle   │
│  └── Device & Settings Screens          │
├─────────────────────────────────────────┤
│  Domain Layer                           │
│  ├── VesperAgent (AI orchestration)     │
│  ├── CommandExecutor (risk enforcement) │
│  ├── RiskAssessor + PermissionService   │
│  ├── ForgeEngine (payload generation)   │
│  ├── DiffService + AuditService         │
│  └── Signal Processing                  │
├─────────────────────────────────────────┤
│  Data Layer                             │
│  ├── OpenRouterClient (LLM API)         │
│  ├── FlipperBleService (BLE transport)  │
│  ├── GlassesIntegration (Mentra bridge) │
│  ├── Room Database (chat + audit)       │
│  └── Encrypted DataStore (settings)     │
└─────────────────────────────────────────┘

Project Structure

V3SP3R/
├── app/src/main/java/com/vesper/flipper/
│   ├── ai/                     # AI integration
│   │   ├── OpenRouterClient.kt # LLM API, tool calling, JSON repair
│   │   ├── VesperAgent.kt      # Conversation orchestrator
│   │   ├── VesperPrompts.kt    # System prompts
│   │   ├── PayloadEngine.kt    # Payload generation
│   │   └── FlipperToolExecutor.kt
│   ├── ble/                    # Bluetooth
│   │   ├── FlipperBleService.kt
│   │   ├── FlipperProtocol.kt
│   │   ├── FlipperFileSystem.kt
│   │   └── MarauderBridge.kt
│   ├── glasses/                # Smart glasses
│   │   ├── GlassesIntegration.kt
│   │   └── GlassesBridgeClient.kt
│   ├── voice/                  # Voice I/O
│   │   ├── SpeechRecognitionHelper.kt
│   │   └── ElevenLabsTtsService.kt
│   ├── domain/
│   │   ├── executor/           # Command execution & risk
│   │   ├── model/              # Data models
│   │   ├── service/            # Audit, diff, permissions
│   │   └── protocol/           # SubGHz, Pwnagotchi
│   ├── data/                   # Persistence & settings
│   ├── security/               # Input validation, sanitization
│   ├── ui/                     # Jetpack Compose screens
│   │   ├── screen/
│   │   ├── viewmodel/
│   │   ├── components/
│   │   └── theme/
│   └── widget/                 # Home screen widget
├── mentra-bridge/              # Smart glasses bridge server (Node.js)
├── docs/                       # Architecture docs, schemas
└── gradle/                     # Build configuration

Supported Actions

Troubleshooting

Flipper not found when scanning

1. On Flipper: Settings > Bluetooth > make sure it's ON
2. Toggle Bluetooth off/on on your phone
3. Make sure Flipper isn't connected to another device (e.g. qFlipper)
4. Move within 3 feet / 1 meter
5. Check that Location permission is granted (required for BLE scanning on Android)

Build failed in Android Studio

1. Ensure JDK 17+ is installed
2. File > Sync Project with Gradle Files
3. Build > Clean Project > Rebuild Project
4. If still failing: close Android Studio, delete .gradle folder, reopen

AI not responding

1. Verify your OpenRouter API key in Settings
2. Check your OpenRouter credit balance at openrouter.ai
3. Check internet connection
4. Try a different model — some may be temporarily unavailable

"Could not parse tool arguments" errors

This means the AI model returned malformed JSON. Vesper includes automatic JSON repair, but some models are more reliable than others. Try: 1. Tap Retry on the error message 2. Switch to a recommended model (Hermes 4, Claude Sonnet 4) 3. Simplify your request

Permission denied errors

• Some Flipper paths are protected by default (system files, firmware areas)
• Go to Settings > Permissions to unlock specific paths
• Enable auto-approve per risk tier to move faster
• Blocked paths always require manual unlock

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before submitting a PR.

Areas that need love: - iOS version (SwiftUI) - Signal format parsers (new protocols) - Additional payload templates - UI/UX improvements - Translations / i18n - Test coverage

Security

Found a vulnerability? Please report it respons