中文
KrillClaw — kawaii shrimp mascot with retro CRT aesthetic

The smallest AI agent runtime for edge devices.

180KB

full: ≤500KB

Zero dependencies · No OS required · Any LLM provider

Runs on a $3 ESP32. Written in Zig.

Smart RingESP32-C3Raspberry PiArduino NanoSteam DeckOld LaptopSmart WatchUSB StickCar ECUDrone BrainWeather Station3D PrinterCNC MachineRobot ArmSmart LockGarage DoorFish TankPlant MonitorSoil SensorBaby MonitorDoorbell CamSolar PanelWind TurbineSatellite ModemTest RigLab BenchIndustrial SensorNav ComputerFlight ControllerTraffic LightParking MeterVending MachinePOS System Smart RingESP32-C3Raspberry PiArduino NanoSteam DeckOld LaptopSmart WatchUSB StickCar ECUDrone BrainWeather Station3D PrinterCNC MachineRobot ArmSmart LockGarage DoorFish TankPlant MonitorSoil SensorBaby MonitorDoorbell CamSolar PanelWind TurbineSatellite ModemTest RigLab BenchIndustrial SensorNav ComputerFlight ControllerTraffic LightParking MeterVending MachinePOS System
nRF5340 DKPi PicoBeagleBoneJetson NanoMining RigNAS ServerEdge GatewayPOS TerminalKiosk DisplayDigital SignJukeboxPinball MachineArcade CabinetSlot MachineFitness BandHeart MonitorMedical DeviceWearable TechHealth MonitorLab EquipmentOscilloscopeLogic AnalyzerPower MeterSmart ThermostatHVAC SystemIrrigation HubGreenhouse BotBeehive SensorCattle TrackerPet FeederLitter RobotRoomba BrainPool MonitorHot Tub nRF5340 DKPi PicoBeagleBoneJetson NanoMining RigNAS ServerEdge GatewayPOS TerminalKiosk DisplayDigital SignJukeboxPinball MachineArcade CabinetSlot MachineFitness BandHeart MonitorMedical DeviceWearable TechHealth MonitorLab EquipmentOscilloscopeLogic AnalyzerPower MeterSmart ThermostatHVAC SystemIrrigation HubGreenhouse BotBeehive SensorCattle TrackerPet FeederLitter RobotRoomba BrainPool MonitorHot Tub
Colmi R02RISC-V BoardMilk-V DuoLilyGo WatchFlipper ZeroBadge SAOConference BadgeLED MatrixLaser CutterSewing MachineEspresso MakerSmart FridgeWine CellarSous VideSmoker GrillBread OvenHam RadioSDR ReceiverLoRa GatewayMesh NodeZigbee HubThread BorderMatter BridgeHomeKit PlugEV ChargerBattery BMSMotor DriverServo BoardStepper ControllerLidar ScannerDepth CameraThermal ImagerGeiger Counter Colmi R02RISC-V BoardMilk-V DuoLilyGo WatchFlipper ZeroBadge SAOConference BadgeLED MatrixLaser CutterSewing MachineEspresso MakerSmart FridgeWine CellarSous VideSmoker GrillBread OvenHam RadioSDR ReceiverLoRa GatewayMesh NodeZigbee HubThread BorderMatter BridgeHomeKit PlugEV ChargerBattery BMSMotor DriverServo BoardStepper ControllerLidar ScannerDepth CameraThermal ImagerGeiger Counter
zig build -Doptimize=ReleaseSmall
export ANTHROPIC_API_KEY=...
./krillclaw "read the temperature and adjust the fan"
🦐 I Want One!

Built Different

What you get that others don't ship.

🔐
Secure by Default
Built-in authentication. Your agent only responds to you. No open endpoints, no shared API keys, no surprise bills.
📡
Every Channel
WhatsApp. Telegram. Discord. Signal. IRC. Your agent meets you where you already are — not where it's convenient for the developer.
🧠
Real Memory
Your agent writes its own memories, searches them semantically, and builds context over days, weeks, months. Not a 3-day sliding window.
🧪
Tested & Leak-Free
40 tests, zero memory leaks, CI on every commit. Most embedded AI projects ship with zero tests. We ship with proof.
🔌
Skills & Plugins
Extend your agent with community skills. GPIO control, browser automation, home integration — if you can imagine it, someone's building it.
🌐
27 LLM Providers
Claude, GPT, Gemini, Llama, Qwen, Mistral, and 21 more. Switch providers in one line. Never locked in.
Architecture

Two Profiles. Every Use Case.

Choose the right build for your device.

💡 Lite and Full are independent builds. Use either one alone, or combine them in a fleet. Full does not require Lite.

Profile: Lite
BLE / Serial Agent — 180 KB
ESP32-C3
$3
BLE
📱
Phone / Gateway
WiFi
LLM API
Profile: Full
Full HTTP Agent — ≤500 KB
ESP32-S3
$5
WiFi / TLS
LLM API
180KB
BLE / Serial
No WiFi needed · No API keys on device · Ultra-low power (~10mA) · $3 ESP32-C3
Best for: wearables, vehicles, body-worn, battery-powered, anything near a BLE gateway (phone, Pi, laptop)
≤500KB
WiFi / HTTP / TLS
Direct LLM access · Self-contained · Coordinates lite nodes · Always-on
Best for: autonomous sensors, greenhouses, factories, home automation, fleet coordination

Profile Comparison

FeatureLite (180 KB)Full (≤500 KB)
Binary size180 KB≤500 KB
TransportBLE / SerialWiFi / HTTP / TLS
ReAct agent loop
Tool execution✅ local tools✅ full toolset
Persistent memory✅ flash✅ flash + filesystem
Config management
LLM API callsvia BLE gateway ⚡✅ direct
TLS / HTTPSnot needed ⚡
GPIO / sensors✅ direct
API key on device❌ secure! ⚡✅ required
Power draw~10 mA~100 mA
Min hardware$3 ESP32-C3$5 ESP32-S3 / Pi
Offline capable✅ local ops✅ queues calls

⚡ = by design, not a limitation

Use Case → Profile

🚗 Car OBD-IILITE
BLE to phone — no WiFi in the car needed
🏋️ Exercise BikeLITE
Streams metrics over BLE to gym app
💍 Smart RingLITE
Coin-cell power — every µA counts
🧸 ToysLITE
No API keys on device — gateway (phone, tablet, or Pi) handles the cloud
🦾 ProstheticsLITE
Ultra-low latency local tools, nearby gateway relays LLM
🌱 GreenhouseFULL
WiFi available — talks to LLM directly, no gateway needed
🏠 Smart FridgeFULL
Always on WiFi, full HTTP toolset
🏭 CNC MachineBOTH
Lite on spindle controller + Full node for job mgmt
🚜 Fleet / FarmBOTH
Lite nodes on vehicles, Full at base station

Build Commands

# Lite: BLE/Serial agent (180KB)
zig build -Dprofile=lite -Doptimize=ReleaseSmall

# Full: Full HTTP agent (≤500KB)
zig build -Dprofile=full -Doptimize=ReleaseSmall

BLE Bandwidth vs LLM Token Stream

LLM token stream — ~1 KB/sec
1 KB/s
BLE 5.0 throughput — ~80 KB/sec
80 KB/s

BLE has 80× more bandwidth than an LLM stream needs.
The bottleneck is always the AI, never the transport.

How it compares

Embedded AI agent runtimes — a new category.

KrillClaw™MimiClawPicoClawOpenClaw
LanguageZigCGoNode.js
Binary size180 KB / ≤500 KB~2 MB~8 MB~200 MB
RAM usage2 MB~512 KB~10 MB~200 MB
Source~3,500 LOC~7K LOC?~40K LOC
Dependencies0ESP-IDFGo stdlib~108 npm
Target hardware$3 ESP32+$5 ESP32-S3$10 LicheeRVPi / VPS / Mac
Needs OS?NoNoLinuxLinux / macOS
Memory safetyYes (Zig)No (C)Yes (Go GC)Yes (JS)
LLM providersAny compatibleClaude + OpenAI?Multi
BLE transportYesNoNoNo
Security✅ Built-in auth❌ None✅ Sandboxed✅ Full
Channels8+1N/A8+
Memory write
Media handling✅ Photos, voice, files❌ Dropped?
Skills / plugins✅ ClawHub❌ None
CI / testing✅ 40 tests, 0 leaks❌ Zero?
LicenseMITMITMITMIT

Works with any OpenAI-compatible provider

OpenAI · Anthropic · Ollama · Mistral · Groq · DeepSeek · OpenRouter · Azure · AWS Bedrock · Google Vertex · Cerebras · Cohere · SiliconFlow · Hugging Face · DeepInfra · LiteLLM · vLLM · OpenAI · Anthropic · Ollama · Mistral · Groq · DeepSeek · OpenRouter · Azure · AWS Bedrock · Google Vertex · Cerebras · Cohere · SiliconFlow · Hugging Face · DeepInfra · LiteLLM · vLLM

16 files. ~3,500 lines. The entire runtime.

You can read the entire codebase in an hour.

# Both profiles
agent.zig    — core loop (250 lines)
json.zig     — hand-rolled JSON (500 lines)
context.zig  — token management (225 lines)
stream.zig   — SSE parser (344 lines)
transport.zig — BLE/serial abstraction

# Full only
api.zig      — multi-provider HTTP (329 lines)
tools_coding.zig — 7 tools (280 lines)

Works with any OpenAI-compatible LLM provider. Switch with a flag.

What becomes possible

When every device has an AI brain and WiFi, ordinary things become extraordinary.

🏠 Smart Home
Your fridge manages your groceries

A $3 ESP32 inside your fridge watches what gets consumed. It notices you're low on oat milk, checks your Instacart history, and pings you on WhatsApp: "You tried that new Greek yogurt last week but didn't reorder — want to go back to your usual Fage, or give it another shot?" It learns your preferences over time. No app. No screen. Just a chip that pays attention.

🏠 Smart Home
A garage door that sees you coming

You're walking home with hands full of grocery bags. KrillClaw on your garage monitors the house vicinity via your security camera. It sees you approaching with your hands full, recognizes you, understands the situation, and opens the garage door as you walk up — so you don't have to awkwardly dig for the clicker.

🌱 IoT & Agriculture
A greenhouse that farms itself

Soil moisture drops. Temperature spikes. A traditional sensor triggers a fixed rule. A KrillClaw node reads the sensors, checks the 5-day forecast, recognizes the tomatoes are in flowering stage (needs less water, more heat), and adjusts the irrigation schedule accordingly. It messages you a weekly report: "Tomatoes on track for harvest in ~12 days. Reduced watering 15% — soil was retaining more than usual after Tuesday's rain."

🏭 Industrial
Factory equipment that explains itself

A CNC machine's vibration pattern changes subtly. The KrillClaw node on the motor controller notices, cross-references the maintenance log stored in flash, and messages the floor supervisor: "Spindle vibration up 12% since Monday — similar to the pattern before the bearing replacement in October. Recommend inspection within 48 hours. Current job will finish fine." Predictive maintenance without a $50K platform.

🤖 Robotics
A prosthetic hand that downloads skills on demand

A research prosthetic with KrillClaw embedded. It reads context from sensors and a wrist camera, then downloads fine-motor skill profiles from the cloud in real time. Picking up chopsticks for the first time? It loads a precision-grip pattern. Learning to play piano? Finger independence profile, downloaded in seconds. A prosthetics research lab testing new grasp patterns across dozens of patients? Same hardware, infinite configurations — each hand adapts to its wearer.

This is where edge AI is heading. KrillClaw is the runtime that makes it possible.

🤖 Robotics
A 3D printer that fixes its own failures

Layer adhesion drops on hour 6 of a 10-hour print. KrillClaw reads the temperature sensor, checks the filament spool weight (running low = thinner feed), and adjusts the flow rate mid-print. It texts you: "Print 80% done. Compensated for low spool — increased flow rate 5%. Should finish clean by 2am." You wake up to a perfect part instead of spaghetti.

Every example runs on a $3-5 chip over WiFi. The intelligence lives in the cloud. The agency lives on the device.

Retrofit anything. Future-proof everything.

You already own incredible hardware. The electronics inside just never had a brain. A $3 KrillClaw chip and a WiFi connection brings the world's most capable AI models to any device — analyzing data, reacting in real time, taking initiative, running recurring actions. No replacement required.

Upgrade the brain, not the machine.

🚗 Automotive
Your 2018 car becomes a 2026 car

Your car's OBD-II port speaks data — but the car's own computer was frozen in time the day it shipped. Plug in a $3 ESP32 with KrillClaw. Now it reads engine codes, cross-references them with repair databases, monitors fuel efficiency trends, and texts you: "Your fuel economy dropped 8% this month — likely the air filter based on mileage. $12 part, 5-minute swap. Want me to order one?" A new car with these smarts costs $45K. This costs $3.

🏋️ Fitness
Your exercise bike gets a real coach

Your exercise bike has sensors for cadence, resistance, and heart rate — but its software is whatever the manufacturer shipped. Clip a KrillClaw node onto it. Now it reads your real-time performance, compares it to your training history, and adjusts coaching in context: "Your power output is down 15% from Tuesday — you might be under-recovered. Switching to an endurance zone ride instead of intervals today." A new smart bike with AI coaching: $3,000+. Retrofitting yours: $3.

🏭 Industrial
A $50K CNC machine gets predictive maintenance for $3

Your CNC machine cost $50K but its controller is from 2015. Industrial predictive maintenance platforms cost $20K/year. Wire a KrillClaw chip to the vibration sensor and spindle temperature probe. It builds a baseline, detects anomalies, correlates with the maintenance log in flash memory, and messages the floor supervisor before things break. "Spindle bearing vibration trending up 12% since Monday — similar to the pattern before the October replacement. Recommend inspection within 48 hours." New CNC with smart diagnostics: $80K. Retrofitting: $3.

🏠 Home
Your "dumb" appliances become smart — for real

Your washer, dryer, pool pump, HVAC, water heater — all have sensors and control interfaces. None of them talk to each other or think for themselves. A KrillClaw chip on each one, connected to your home WiFi, and suddenly your house has a nervous system. The HVAC knows the dryer is about to dump heat and pre-adjusts. The pool pump shifts to off-peak rates. The water heater pre-heats before your usual shower time. A "smart home" retrofit from a contractor: $5K-15K. Doing it yourself with KrillClaw: $20 in chips.

Every device you own is an upgrade away. Not a replacement away.

Runs on a $3 chip

WiFi, BLE, and serial built in. Connects to any LLM over the air.

🦐 I Want One!

Sign up to get pre-flashed KrillClaw™ devices.

No spam. Just a ping when hardware ships.

What do you want to build?

Pick what excites you most. Helps us prioritize what ships first.

Get started

git clone https://github.com/yoctoclaw/KrillClaw
cd KrillClaw
zig build -Doptimize=ReleaseSmall
./zig-out/bin/krillclaw "monitor sensors and alert on anomalies"

🦐 I Want One!

FAQ

Does it need WiFi?
Lite (180KB): No. Connects via BLE or serial to a nearby gateway — your phone, a Raspberry Pi, a laptop, or any BLE-capable device with internet. The gateway handles LLM API calls. Your device never needs WiFi credentials or API keys.
Full (≤500KB): Yes. Connects directly to LLM APIs over WiFi/HTTP. Self-contained, no phone needed.
What's the difference between Lite and Full?
Lite is a 180KB BLE/serial agent that runs on a $3 chip — sensors, actuators, local logic, ReAct reasoning. It talks to a nearby BLE gateway (phone, Pi, laptop) for LLM calls. No WiFi, no API keys on device, ultra-low power (~10mA).
Full is a ≤500KB full agent with built-in HTTP/TLS. Runs on ESP32-S3, Raspberry Pi, or any Linux board. Talks directly to any LLM provider. Can also coordinate multiple lite nodes.
How much does the API cost?
Typical usage: $0.50–2/month. You bring your own API key (on the hub or phone) and control the budget. KrillClaw itself is free and open source.
What happens when connectivity drops?
Lite: Continues local operations (sensor reads, GPIO, scheduled tasks). Queues messages and syncs when BLE reconnects.
Full: Queues LLM calls, retries with exponential backoff, resumes seamlessly when WiFi returns. Local operations are uninterrupted.
Can I use it without an ESP32?
Yes — the full profile runs on any Linux ARM/RISC-V board, Raspberry Pi, routers, anything with 2MB RAM. ESP32 is the smallest target, not the only one.
Is it really 180KB?
The lite profile is 180KB — BLE/serial transport, no HTTP stack, no TLS. That's the real binary for real embedded use. The full profile is ≤500KB because it includes HTTP/TLS for direct LLM API calls. Both are smaller than any competitor.
How does BLE pairing work?
Automatic discovery: KrillClaw Lite devices advertise automatically on boot — no pairing button needed.
One-tap connect: The KrillClaw Bridge app (phone or desktop) discovers nearby agents and connects in one tap.
Secure bonding: Only authorized devices can connect — secure BLE bonding prevents unauthorized access.
Disconnect: Forget the device in your BLE settings to unpair.

⚠️ The KrillClaw Bridge app is currently in development. Early access coming soon — join the waitlist to be first in line.
Which profile should I use?
Use Lite when: your device is near a BLE gateway (phone, Pi, laptop), you want the smallest binary, you don't want API keys on the device, or you're optimizing for power.
Use Full when: your device needs to work autonomously without a nearby BLE gateway, or it's coordinating other lite nodes.