[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74494":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":22,"topics":25,"createdAt":9,"pushedAt":9,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":15,"starSnapshotCount":15,"syncStatus":14,"lastSyncTime":29,"discoverSource":30},74494,"V3SP3R","elder-plinius\u002FV3SP3R","elder-plinius","AI Flipper control",null,"Java",1063,193,16,2,0,13,23,56,39,91.96,"GNU Affero General Public License v3.0",false,"main",true,[],"2026-06-12 04:01:15","```\n ██╗   ██╗ ██████╗ ███████╗██████╗ ███████╗██████╗\n ██║   ██║╚════██╗██╔════╝██╔══██╗██╔════╝██╔══██╗\n ██║   ██║ █████╔╝███████╗██████╔╝█████╗  ██████╔╝\n ╚██╗ ██╔╝ ╚═══██╗╚════██║██╔═══╝ ██╔══╝  ██╔══██╗\n  ╚████╔╝ ██████╔╝███████║██║     ███████╗██║  ██║\n   ╚═══╝  ╚═════╝ ╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝\n```\n\n# V3SP3R — The AI Brain for Your Flipper Zero\n\n> **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.\n\nNo menus. No manuals. Just natural language prompting.\n\n[![License: GPL-3.0](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-GPL--3.0-blue.svg)](LICENSE)\n[![Android](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAndroid-8.0%2B-green.svg)](https:\u002F\u002Fdeveloper.android.com)\n[![Kotlin](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FKotlin-2.2-purple.svg)](https:\u002F\u002Fkotlinlang.org)\n\n---\n\n## Why Vesper?\n\nThe 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.\n\n- **Instant expertise** — Don't memorize SubGHz protocols or IR formats. Just say what you want.\n- **Real-time control** — The AI reads your Flipper's state, executes commands, and reports back in seconds.\n- **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.\n- **Signal alchemy** — Build, layer, and export custom RF waveforms with a visual editor.\n- **Smart glasses integration** — Pair with Mentra smart glasses for hands-free, heads-up Flipper control.\n- **Safety-first architecture** — Every AI action is risk-classified. Destructive operations require explicit confirmation. System paths are locked by default.\n\nWhether 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.\n\n---\n\n## Features\n\n### Chat — AI-Driven Flipper Control\nTalk to your Flipper in plain English (voice or text):\n- *\"Show me my SubGHz captures\"*\n- *\"What's my battery level?\"*\n- *\"Create a backup of all my IR remotes\"*\n- *\"Generate a BadUSB script that opens a reverse shell\"*\n- *\"Change the frequency in garage.sub to 315MHz\"*\n\n### Hardware Control\nDirect control over all Flipper subsystems:\n- **SubGHz** — Transmit and analyze RF signals\n- **Infrared** — Send and record IR commands\n- **NFC \u002F RFID \u002F iButton** — Emulate stored credentials\n- **BadUSB** — Execute HID attack scripts\n- **GPIO \u002F LED \u002F Vibro** — Control hardware peripherals\n- **App Launcher** — Start any Flipper app by name\n\n### Multimodal Input\n- **Voice input** — Speak commands using on-device speech recognition\n- **Photo analysis** — Snap a picture of a remote, a device label, or anything — the AI sees what you see\n- **Text-to-speech** — AI responses read aloud via OpenRouter TTS\n- **Smart glasses** — Hands-free voice + camera via Mentra glasses bridge\n\n### Ops Center\nBuilt for reliability-obsessed users:\n- **Pipeline Health** — BLE\u002FRPC\u002FCLI readiness and diagnostics at a glance\n- **Runbooks** — One-tap recovery and smoke-test sequences\n- **Live Status** — Transport and command pipeline behavior in one view\n\n### Alchemy Lab — Signal Synthesis\nBuild custom RF signals from scratch:\n- Visual waveform editor with real-time preview\n- Layer and fuse multiple signal patterns\n- Export directly to your Flipper's SD card\n\n### Payload Lab\nAI-powered payload generation:\n- BadUSB scripts, SubGHz signals, IR remotes, NFC tags\n- Validated before deployment — the AI checks format and safety\n- Direct push to Flipper storage\n\n### FapHub Browser\nBrowse and install Flipper applications:\n- Search the Flipper app catalog\n- One-tap install to your device\n\n### Resource Browser\nFind and download community resources:\n- Search GitHub for Flipper-compatible files\n- Browse repositories and download directly to your Flipper\n\n### Device Manager\nFull Flipper visibility:\n- Battery, storage, firmware info, and connection status\n- Scan, pair, and manage BLE connections\n- Direct file browsing and management\n\n### Risk & Permissions Engine\nEvery AI action is classified before execution:\n- **Low risk** — Read-only ops execute automatically\n- **Medium risk** — File writes show a diff for review\n- **High risk** — Destructive ops require double-tap confirmation\n- **Blocked** — System\u002Ffirmware paths require explicit unlock\n\nConfigure **auto-approve** per risk tier in Settings to move faster when you trust the workflow.\n\n### Audit Log\nEvery action the AI takes is logged:\n- Full history of commands, results, and approvals\n- Filterable by action type and session\n- Exportable for compliance and review\n\n---\n\n## Recommended AI Models\n\nVesper works with any model on [OpenRouter](https:\u002F\u002Fopenrouter.ai). For the best experience:\n\n| Model | Why Use It | Speed | Cost |\n|-------|-----------|-------|------|\n| **`nousresearch\u002Fhermes-4`** | Outstanding tool-use — purpose-built for agentic workflows. Top pick for power users. | Fast | $$ |\n| **`anthropic\u002Fclaude-opus-4.6`** | Most capable reasoning model. Exceptional at complex multi-step operations and signal analysis. | Medium | $$$$ |\n| **`anthropic\u002Fclaude-sonnet-4`** | Best balance of speed, intelligence, and cost. Great default. | Fast | $$ |\n| **`anthropic\u002Fclaude-haiku-4`** | Blazing fast for simple reads and quick commands. | Fastest | $ |\n| **`openai\u002Fgpt-4o`** | Strong general-purpose alternative. | Fast | $$ |\n\n**Our recommendation:** Start with **Hermes 4** or **Claude Sonnet 4** for daily use. Reach for **Claude Opus 4.6** when you need deep reasoning.\n\n---\n\n## Quick Start\n\n### Requirements\n\n| Item | Notes |\n|------|-------|\n| **Flipper Zero** | [shop.flipperzero.one](https:\u002F\u002Fshop.flipperzero.one) |\n| **Android device** | Android 8.0+ (API 26), Bluetooth required |\n| **OpenRouter account** | Free signup, pay-per-use — [openrouter.ai](https:\u002F\u002Fopenrouter.ai) |\n\n### 1. Prep Your Flipper\n1. Charge it up (USB-C)\n2. Update firmware via [qFlipper](https:\u002F\u002Fflipperzero.one\u002Fupdate) (recommended)\n3. Enable Bluetooth: Settings > Bluetooth > ON\n\n### 2. Get an OpenRouter API Key\n1. Sign up at [openrouter.ai](https:\u002F\u002Fopenrouter.ai)\n2. Go to **Keys** > **Create Key**\n3. Copy the key (`sk-or-...`) — you'll paste this into Vesper\n4. Add $5-10 in credits to start (most conversations cost pennies)\n\n### 3. Build & Install\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Felder-plinius\u002FV3SP3R.git\ncd V3SP3R\n```\n\nOpen the project in [Android Studio](https:\u002F\u002Fdeveloper.android.com\u002Fstudio), let Gradle sync, then:\n\n- **Build > Build APK(s)** or hit the green play button\n- APK output: `app\u002Fbuild\u002Foutputs\u002Fapk\u002Fdebug\u002Fapp-debug.apk`\n\nInstall via USB debugging or transfer the APK to your phone.\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Command-line build (no Android Studio)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```bash\n# Requires Android SDK and JDK 17+\n.\u002Fgradlew assembleDebug\n# APK: app\u002Fbuild\u002Foutputs\u002Fapk\u002Fdebug\u002Fapp-debug.apk\n```\n\u003C\u002Fdetails>\n\n### 4. First Launch\n1. **Grant permissions** — Bluetooth, Location (required for BLE scanning), Notifications\n2. **Add your API key** — Settings > paste your OpenRouter key\n3. **Connect** — Device tab > Scan > tap your Flipper\n4. **Go** — Chat tab > start talking to your Flipper\n\n---\n\n## Smart Glasses Setup (Optional)\n\nVesper supports hands-free operation via Mentra smart glasses.\n\n1. Deploy the bridge server from `mentra-bridge\u002F`:\n   ```bash\n   cd mentra-bridge\n   npm install && npm run build && npm start\n   ```\n2. In Vesper Settings, enable **Smart Glasses** and enter the bridge URL\n3. Voice transcriptions from your glasses flow directly to Vesper\n4. The AI can request photos through your glasses camera\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────────────────┐\n│              Vesper App                  │\n├─────────────────────────────────────────┤\n│  UI Layer (Jetpack Compose + Hilt)      │\n│  ├── Chat Screen (voice, images, text)  │\n│  ├── Ops Center                         │\n│  ├── Alchemy Lab & Payload Lab          │\n│  ├── File Browser & FapHub              │\n│  ├── Signal Arsenal & Spectral Oracle   │\n│  └── Device & Settings Screens          │\n├─────────────────────────────────────────┤\n│  Domain Layer                           │\n│  ├── VesperAgent (AI orchestration)     │\n│  ├── CommandExecutor (risk enforcement) │\n│  ├── RiskAssessor + PermissionService   │\n│  ├── ForgeEngine (payload generation)   │\n│  ├── DiffService + AuditService         │\n│  └── Signal Processing                  │\n├─────────────────────────────────────────┤\n│  Data Layer                             │\n│  ├── OpenRouterClient (LLM API)         │\n│  ├── FlipperBleService (BLE transport)  │\n│  ├── GlassesIntegration (Mentra bridge) │\n│  ├── Room Database (chat + audit)       │\n│  └── Encrypted DataStore (settings)     │\n└─────────────────────────────────────────┘\n```\n\n## Project Structure\n\n```\nV3SP3R\u002F\n├── app\u002Fsrc\u002Fmain\u002Fjava\u002Fcom\u002Fvesper\u002Fflipper\u002F\n│   ├── ai\u002F                     # AI integration\n│   │   ├── OpenRouterClient.kt # LLM API, tool calling, JSON repair\n│   │   ├── VesperAgent.kt      # Conversation orchestrator\n│   │   ├── VesperPrompts.kt    # System prompts\n│   │   ├── PayloadEngine.kt    # Payload generation\n│   │   └── FlipperToolExecutor.kt\n│   ├── ble\u002F                    # Bluetooth\n│   │   ├── FlipperBleService.kt\n│   │   ├── FlipperProtocol.kt\n│   │   ├── FlipperFileSystem.kt\n│   │   └── MarauderBridge.kt\n│   ├── glasses\u002F                # Smart glasses\n│   │   ├── GlassesIntegration.kt\n│   │   └── GlassesBridgeClient.kt\n│   ├── voice\u002F                  # Voice I\u002FO\n│   │   ├── SpeechRecognitionHelper.kt\n│   │   └── ElevenLabsTtsService.kt\n│   ├── domain\u002F\n│   │   ├── executor\u002F           # Command execution & risk\n│   │   ├── model\u002F              # Data models\n│   │   ├── service\u002F            # Audit, diff, permissions\n│   │   └── protocol\u002F           # SubGHz, Pwnagotchi\n│   ├── data\u002F                   # Persistence & settings\n│   ├── security\u002F               # Input validation, sanitization\n│   ├── ui\u002F                     # Jetpack Compose screens\n│   │   ├── screen\u002F\n│   │   ├── viewmodel\u002F\n│   │   ├── components\u002F\n│   │   └── theme\u002F\n│   └── widget\u002F                 # Home screen widget\n├── mentra-bridge\u002F              # Smart glasses bridge server (Node.js)\n├── docs\u002F                       # Architecture docs, schemas\n└── gradle\u002F                     # Build configuration\n```\n\n---\n\n## Supported Actions\n\n| Action | Description | Risk Level |\n|--------|-------------|------------|\n| `list_directory` | List files and folders | Low |\n| `read_file` | Read file contents | Low |\n| `write_file` | Create or modify files | Medium |\n| `create_directory` | Create folders | Low |\n| `delete` | Delete files or folders | High |\n| `move` \u002F `rename` \u002F `copy` | File operations | Medium-High |\n| `get_device_info` | Battery, firmware, hardware info | Low |\n| `get_storage_info` | SD card and internal storage stats | Low |\n| `execute_cli` | Run Flipper CLI commands | Medium |\n| `push_artifact` | Push generated files to Flipper | Medium |\n| `forge_payload` | AI-generate SubGHz\u002FIR\u002FBadUSB\u002FNFC payloads | Medium |\n| `subghz_transmit` | Transmit SubGHz signal | High |\n| `ir_transmit` | Send infrared command | Medium |\n| `nfc_emulate` \u002F `rfid_emulate` \u002F `ibutton_emulate` | Emulate credentials | Medium |\n| `badusb_execute` | Run HID attack script | High |\n| `launch_app` | Start a Flipper app | Medium |\n| `led_control` \u002F `vibro_control` | Hardware peripherals | Low |\n| `search_faphub` \u002F `install_faphub_app` | Browse & install apps | Medium |\n| `browse_repo` \u002F `download_resource` \u002F `github_search` | Find community resources | Low |\n| `request_photo` | Capture photo via smart glasses | Low |\n\n---\n\n## Troubleshooting\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Flipper not found when scanning\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n1. On Flipper: Settings > Bluetooth > make sure it's ON\n2. Toggle Bluetooth off\u002Fon on your phone\n3. Make sure Flipper isn't connected to another device (e.g. qFlipper)\n4. Move within 3 feet \u002F 1 meter\n5. Check that Location permission is granted (required for BLE scanning on Android)\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Build failed in Android Studio\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n1. Ensure JDK 17+ is installed\n2. File > Sync Project with Gradle Files\n3. Build > Clean Project > Rebuild Project\n4. If still failing: close Android Studio, delete `.gradle` folder, reopen\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>AI not responding\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n1. Verify your OpenRouter API key in Settings\n2. Check your OpenRouter credit balance at [openrouter.ai](https:\u002F\u002Fopenrouter.ai)\n3. Check internet connection\n4. Try a different model — some may be temporarily unavailable\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>\"Could not parse tool arguments\" errors\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nThis means the AI model returned malformed JSON. Vesper includes automatic JSON repair, but some models are more reliable than others. Try:\n1. Tap **Retry** on the error message\n2. Switch to a recommended model (Hermes 4, Claude Sonnet 4)\n3. Simplify your request\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Permission denied errors\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n- Some Flipper paths are protected by default (system files, firmware areas)\n- Go to Settings > Permissions to unlock specific paths\n- Enable auto-approve per risk tier to move faster\n- Blocked paths always require manual unlock\n\u003C\u002Fdetails>\n\n---\n\n## Contributing\n\nContributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting a PR.\n\nAreas that need love:\n- iOS version (SwiftUI)\n- Signal format parsers (new protocols)\n- Additional payload templates\n- UI\u002FUX improvements\n- Translations \u002F i18n\n- Test coverage\n\n---\n\n## Security\n\nFound a vulnerability? Please report it responsibly. See [SECURITY.md](SECURITY.md) for details.\n\n---\n\n## Safety & Legal\n\n- Vesper is a tool for **education and legitimate security research**\n- Only use on devices you own or have explicit authorization to test\n- All AI actions are logged and auditable\n- The AI refuses clearly malicious requests\n- Destructive operations require explicit user confirmation\n- You are responsible for complying with all applicable laws in your jurisdiction\n\n---\n\n## License\n\nGPL-3.0 — see [LICENSE](LICENSE) for the full text.\n\n---\n\n**V3SP3R** — AI-powered hardware hacking, in your pocket. Your Flipper Zero just got a brain upgrade.\n","V3SP3R 项目是一个基于AI的Flipper Zero控制工具。它通过自然语言处理技术，让用户能够通过Android设备或智能眼镜以语音指令的方式与Flipper Zero进行交互，无需手动操作复杂的菜单选项。该项目支持即时的专业知识获取、实时控制反馈以及多模态输入方式（包括语音、图片分析和文本聊天），并且集成了信号波形构建器和智能眼镜兼容性等功能。特别适用于安全研究人员、红队成员、CTF竞赛选手以及硬件爱好者，在提高工作效率的同时降低了使用门槛。","2026-06-11 03:50:10","high_star"]