Krill is a privacy-first, offline-first automation platform for home automation, IoT, and process control. It runs on Raspberry Pi and any Debian-based Linux machine, connecting your devices into a secure peer-to-peer mesh — no cloud account, no subscription, no internet required. Your data never leaves your network.

Everything in Krill is a typed Node: data points, triggers, executors, hardware pins, projects, peers. You wire nodes together and the system reacts in real time. State changes flow over Server-Sent Events to every connected client with sub-second latency.

• GPIO, PWM, and I²C — Drive relays, solenoids, pumps, and sensors via Raspberry Pi GPIO. Hardware access runs in a dedicated krill-pi4j gRPC daemon (JDK 25, Pi4J 4.x) so the main server stays on JDK 21.
• Cameras — Live feeds from Raspberry Pi Camera Module 3 streamed to every client at ~2 FPS, including web/mobile, with no extra ports or firewall rules.
• Time-Series Data Points — Store sensor readings as DOUBLE, DIGITAL, TEXT, JSON, or the new COLOR type. Filter incoming values with deadband, debounce, and discard-above/below filters; visualize with built-in mini graphs.
• Color sensing — First-class COLOR data points + a Color trigger that fires when an RGB reading falls within a target range. Pairs with TCS34725-style sensors for things like pH-indicator monitoring on a CO₂ reactor.
• Logic Gates & Calculations — Boolean automation via AND, OR, NOT, XOR, NAND, NOR, XNOR, IMPLY, NIMPLY gates. Calculation and Compute nodes for derived values, formulas, and rolling statistics (avg/min/max/stddev).
• Triggers — Buttons, cron timers (second precision), high/low thresholds, color, silent-alarm watchdogs, and incoming webhooks.
• Executors — Outgoing webhooks, SMTP email alerts, MQTT publish, and sandboxed Python lambdas (Firejail).
• Project Dashboards — Per-project live views that auto-organize child nodes into Visual (camera + diagram + mini graph), Controls (digital toggles), Data, Hardware, and Automation sections. QR-code share built in.
• Custom SVG Diagrams — Upload SVGs in Inkscape and bind anchor regions to data points for live process-control overlays. Stock templates ship in cookbook/SVG Templates/.
• Peer Mesh Networking — Servers auto-discover each other on the LAN (UDP beacon), authenticate via a shared 4-digit PIN, and form a self-healing mesh. Nodes on any server can reference nodes on any other.
• MQTT & Zigbee — Pub/Sub nodes integrate with any MQTT broker and bridge to thousands of Zigbee devices via Zigbee2MQTT.
• Serial Devices — Connect Arduinos, QTPy, RP2040, Atlas Scientific probes, and other CircuitPython-friendly hardware over USB/UART.
• Local LLM Integration — Add a local Ollama instance as an LLM Node and chat with your swarm: troubleshoot sensors, draft logic chains, generate SVG dashboards, run safety reviews — all without sending data to a cloud provider.
• Cross-Platform Apps — Native Android, iOS, Desktop (Linux/macOS/Windows), and Web (WASM) clients built from one Kotlin Multiplatform codebase.
• MCP for Claude — A Model Context Protocol server (krill-mcp/) and bundled krill skill let Claude Code or Claude Desktop drive your swarm directly.

This repo is the public, open half of the Krill platform. Each Gradle root has its own wrapper — there is no umbrella build.

The fastest path is to install a server on a Raspberry Pi or Debian box, then point an app at it:

curl -fsSL https://krillswarm.com/apt/krill.gpg | sudo gpg --dearmor -o /usr/share/keyrings/krill.gpg
echo "deb [signed-by=/usr/share/keyrings/krill.gpg] https://krillswarm.com/apt stable main" | sudo tee /etc/apt/sources.list.d/krill.list
sudo apt update
sudo apt install krill

# For Raspberry Pi GPIO support:
sudo apt install krill-pi4j

You'll be prompted for a 4-digit cluster PIN during install — every server, app, and MCP client in your swarm shares it. The server listens on https://<hostname>:8442.

Apps:

• Android — Google Play
• iOS — App Store
• Desktop — sudo apt install krill-desktop or download from krillswarm.com
• Web — open https://<server-ip>:8442 in a browser (accept the self-signed cert)

Full walkthrough: Getting Started.

Krill is free to download and use — every app, every server, every release. The Kotlin Multiplatform platform source is synced daily to GitHub under a source-available license: read it, learn from it, audit the security model, fork for personal use, or build integrations on top. Redistribution and competing products are the only things off limits — that's what keeps the project sustainable.

These pieces are fully open source under permissive licenses with no restrictions:

• krill-pi4j — Standalone gRPC service for Pi GPIO/PWM/I²C. Use it from any JVM project, with or without Krill.
• krill-sdk — KMP client SDK on Maven Central.
• krill-mcp + the krill Claude skill — MCP server and the bundled markdown/JSON specs that drive Claude integrations.
• Python lambda cookbook — Ready-to-run scripts for sensors, actuators, and CircuitPython boards.
• SVG dashboard templates — Diagrams and graphics for your projects.

Pull requests welcome on any of the above. See Our Open Source Philosophy for the long-form version.

• Open an issue
• r/krill_zone on Reddit
• Krill website
• Weekly stability & capability reports

Krill is offline-first by design. By default it does not collect personally identifiable information, and all data stays on your local devices. See the Privacy Policy for details.