FlipperClaw turns your Flipper Zero into a physical AI agent. Ask questions, control hardware, run autonomous tasks — all from a $10 ESP32-S3 and a Flipper Zero.
// What is it?
FlipperClaw is a ReAct AI agent that runs entirely on an ESP32-S3. Your Flipper Zero becomes the screen, keyboard, and hardware bridge.
Ask it anything. Give it tasks. Let it run while you sleep. It streams responses live to your Flipper's OLED, uses real tools to browse the web, read NFC tags, fire IR blasts, and schedule jobs that run automatically — even when you're not there.
No app. No cloud. No subscription. Just a $10 ESP32-S3, a Flipper Zero, and four jumper wires.
// Capabilities
A full ReAct agent loop running on a $10 microcontroller, with real tools that touch the physical world.
Tokens stream live to your Flipper's OLED as the model generates them. No waiting, no spinner — just real-time output on a 128×64 screen.
Up to 5 tool-call iterations per prompt. The agent reasons, acts, observes, and repeats — all visible on screen as it happens.
SOUL.md, USER.md, MEMORY.md, and daily notes on SPIFFS. The agent knows who you are across every session — no context lost between reboots.
Drop tasks into HEARTBEAT.md. FlipperClaw wakes every 30 minutes, acts on pending items, and marks them done automatically.
Schedule recurring or one-shot prompts.
"Summarize today's AI news every morning at 9am."
Persisted across reboots in cron.json.
Read NFC tags, replay Sub-GHz signals, fire IR commands — all via agent tools. The AI can touch the real world.
// Setup
Three steps from unboxing to running your first AI agent on hardware.
Connect 4 jumper wires between your Flipper Zero's GPIO header and the ESP32-S3. TX→RX, RX→TX, GND, 5V. Both devices run 3.3V logic — no level shifter needed. That's it.
Flash the ESP32 with idf.py flash.
Build the Flipper app with ufbt.
Drop your WiFi SSID, password, and API key into fc_secrets.h.
Open FlipperClaw on your Flipper. Type a prompt with the d-pad. Hit OK. Watch the agent think, search, and respond in real time on the OLED.
// API surface
Every tool is callable by the agent at runtime. Hardware tools route through the Flipper over UART.
| Tool | Description |
|---|---|
| web_search | Search the web via Tavily or Brave API and return ranked results |
| get_current_time | Fetch UTC time from an NTP server and sync the ESP32 system clock |
| remember | Append a fact to MEMORY.md so it persists across all future sessions |
| flipper_nfc_read hardware | Ask the Flipper to scan an NFC tag and return UID, type, and raw bytes |
| flipper_subghz_replay hardware | Trigger replay of a previously captured Sub-GHz signal file from SPIFFS |
| flipper_ir_send hardware | Fire an IR command via the Flipper's built-in IR blaster — protocol, address, command |
| cron_add | Schedule a recurring or one-shot prompt with a cron expression or delay |
| cron_list | List all pending scheduled jobs with their IDs, schedules, and next run time |
| cron_remove | Cancel a scheduled job by its ID — takes effect immediately |
// Bill of materials
Everything you need is off-the-shelf. Total cost under $185.
Components
Wiring diagram
✓ Both devices run 3.3V logic — no level shifter needed.
// Model support
Swap providers at runtime via the serial CLI. No reflash required.
Fast, cheap, and purpose-built for tool use. Haiku-4-5 handles multi-step ReAct loops efficiently within the ESP32-S3's memory constraints. Lowest latency to first token.
Solid tool-use performance and broad general knowledge. Use it if you prefer OpenAI's ecosystem or already have an API key. Swap at runtime — no code changes needed.
fc> set_model_provider openai
— or fc> set_model_provider anthropic.
The change persists across reboots.
// Persistent storage
Every file lives on SPIFFS — flash storage that survives reboots. Scroll to see all files →
Agent personality and system prompt. Edit it to change who FlipperClaw is.
Your profile. Tell it your name, job, preferences — once. It won't forget.
Facts the agent has remembered via the remember tool across sessions.
Pending task checklist. Checked every 30 minutes. Completed items auto-marked.
Daily notes. Every session is logged automatically with timestamp and content.
Scheduled jobs. All cron entries are written here and survive power cycles.
Rolling conversation history in JSONL format. Injected as context each session.
// Early access
We're preparing build guides, pre-configured firmware binaries, and step-by-step setup videos. Join the waitlist to get notified the moment they're ready.
Join 247 others already on the waitlist.
MIT License. No cloud required. No subscription. No tracking.
Fork it, hack it, ship it. That's the point.