V3SP3R README

The project's README from github.com/elder-plinius/V3SP3R. As one markdown file: README.md.

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

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.

License: GPL-3.0 Android Kotlin

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.

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):

Hardware Control

Direct control over all Flipper subsystems:

Multimodal Input

Ops Center

Built for reliability-obsessed users:

Alchemy Lab — Signal Synthesis

Build custom RF signals from scratch:

Payload Lab

AI-powered payload generation:

FapHub Browser

Browse and install Flipper applications:

Resource Browser

Find and download community resources:

Device Manager

Full Flipper visibility:

Risk & Permissions Engine

Every AI action is classified before execution:

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:

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

Model Why Use It Speed Cost
nousresearch/hermes-4 Outstanding tool-use — purpose-built for agentic workflows. Top pick for power users. Fast $$
anthropic/claude-opus-4.6 Most capable reasoning model. Exceptional at complex multi-step operations and signal analysis. Medium $$$$
anthropic/claude-sonnet-4 Best balance of speed, intelligence, and cost. Great default. Fast $$
anthropic/claude-haiku-4 Blazing fast for simple reads and quick commands. Fastest $
openai/gpt-4o Strong general-purpose alternative. Fast $$

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

Item Notes
Flipper Zero shop.flipperzero.one
Android device Android 8.0+ (API 26), Bluetooth required
OpenRouter account Free signup, pay-per-use — openrouter.ai

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:

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/:
    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

Action Description Risk Level
list_directory List files and folders Low
read_file Read file contents Low
write_file Create or modify files Medium
create_directory Create folders Low
delete Delete files or folders High
move / rename / copy File operations Medium-High
get_device_info Battery, firmware, hardware info Low
get_storage_info SD card and internal storage stats Low
execute_cli Run Flipper CLI commands Medium
push_artifact Push generated files to Flipper Medium
forge_payload AI-generate SubGHz/IR/BadUSB/NFC payloads Medium
subghz_transmit Transmit SubGHz signal High
ir_transmit Send infrared command Medium
nfc_emulate / rfid_emulate / ibutton_emulate Emulate credentials Medium
badusb_execute Run HID attack script High
launch_app Start a Flipper app Medium
led_control / vibro_control Hardware peripherals Low
search_faphub / install_faphub_app Browse & install apps Medium
browse_repo / download_resource / github_search Find community resources Low
request_photo Capture photo via smart glasses Low

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:

Security

Found a vulnerability? Please report it responsibly. See SECURITY.md for details.

License

GPL-3.0 — see LICENSE for the full text.

V3SP3R — AI-powered hardware hacking, in your pocket. Your Flipper Zero just got a brain upgrade.

V3SP3R (elder-plinius/V3SP3R)

Searching Database…

1.7K ·GitHub
V3SP3R
这是什么？Vesper（V3SP3R）是一个 Android 应用，它把 Flipper Zero 变成 AI 驱动的硬件破解助手，你可以完全通过自然语言、语音或照片来控制它。
这是装在我手机上的应用，还是刷进 Flipper 本体的东西？它是一个 Android 应用，通过蓝牙连接你的实体 Flipper Zero，并把 AI 生成的命令转发给它；Flipper 自身的固件不会被刷入任何东西。
怎么把它跑起来？在 Android Studio 中打开项目，等待 Gradle 同步，然后用 Build > Build APK(s) 生成 app/build/outputs/apk/debug/app-debug.apk，把它安装到手机上，在 Device 标签页通过蓝牙配对你的 Flipper，再在 Settings 中添加你的 OpenRouter 密钥。
我需要 OpenRouter API 密钥吗？需要——在 openrouter.ai 免费注册，创建一个密钥（以 sk-or- 开头），充值几美元额度，然后粘贴到 Vesper 的 Settings 里；你还需要一部带蓝牙的 Android 8.0+（API 26）手机和一个实体 Flipper Zero。
AI 会不会自己擅自发破坏性命令？不会——每个操作都会做风险分级：低风险读取自动执行，中风险写入会显示 diff，而 BadUSB 执行或 SubGHz 发送这类高风险操作需要明确的双击确认，系统/固件路径默认锁定。
有 iOS 版本吗？还没有——iOS（SwiftUI）移植版被列为项目仍需贡献的方向，所以目前只有 Android 版。
我的命令和 AI 操作会被记录到某处吗？会——AI 执行的每个操作都记录在审计日志（Audit Log）中，完整保存命令、结果和批准的历史，可筛选、可导出以便审查。
配合 Vesper 我该用哪个 AI 模型？README 建议日常使用从 nousresearch/hermes-4 或 anthropic/claude-sonnet-4 开始，当信号分析需要更深度的多步推理时切换到 claude-opus-4.6。
Alchemy Lab 是什么？它是一个可视化射频（RF）波形编辑器，用于从零构建自定义 SubGHz 信号——你可以叠加并融合多个波形模式，把结果直接导出到 Flipper 的 SD 卡。
我可以配合智能眼镜免手操作使用 Vesper 吗？可以——通过桥接服务器与 Mentra 智能眼镜配对，语音转录和相机照片会直接流入 Vesper，实现免手操作控制 Flipper。
AI 实际上能对我的 Flipper 做什么？它可以控制 SubGHz、红外、NFC/RFID/iButton 模拟、BadUSB 脚本、GPIO/LED/Vibro 外设，启动应用、生成并推送 payload、浏览和安装 FapHub 应用——所有操作在执行前都会做风险分级。
What are similar projects?unleashed-firmware, PwnPad, Claude-Red, dsh-redteam-model, hacker-roadmap, EchoMuse, PentestGPT, esp8266_deauther
Which topics is it in?ctf, bluetooth, voice-assistant, openrouter, hacking-tool, red-team, speech-recognition, iot, tts, penetration-testing, embedded, hacking
Creator
elder-plinius
Size
40.7 MB
Stars
1.7K
Updated
CommitMar 24
Age
7mo
Commits · 90 Days