▶ OFFLINE-FIRST  ·  NO CLOUD  ·  OPEN SOURCE

BLACKBOX

BUILT FOR WHEN THE INTERNET IS GONE

Local AI + LoRa mesh radio + off-grid payments.
Runs on your hardware. No servers. No accounts. No internet required.

SCROLL
5–15km LoRa radio range
$20–60 hardware cost
0 cloud dependencies
0.5–3B local LLM params
100% offline capable
// what is this

THREE SYSTEMS.
ONE NODE.

Blackbox Node combines a fully local AI, a LoRa mesh radio interface, and an off-grid payment layer into a single self-contained application that runs on commodity hardware — no cloud, no servers, no infrastructure.

LOCAL OFFLINE AI

Runs a quantized LLM via llama.cpp entirely on your machine. No API keys, no cloud calls. Other mesh nodes can query it over radio with @bot or !ask.

LORA MESH RADIO

Bridges to a Meshtastic device over USB serial. Tracks all nodes, telemetry, battery levels, GPS position, and environment sensors. Range: 5–15 km per hop, no towers needed.

OFF-GRID PAYMENTS

Built-in Bitcoin HD wallet and Cashu ecash wallet. Cashu tokens are plain text — send them over radio as messages. Economic activity over a mesh: no internet, no processors.


// quick start

TWO COMMANDS.
YOU'RE RUNNING.

The installer auto-downloads the llama.cpp runtime, a starter GGUF model, and sets up Python deps for Meshtastic. Requires Node.js 18+ and Python 3.11+.

cmd.exe — blackbox_node
Node.js 18+ Python 3.11+ Full Docs →

// how it works

THE MESH IS YOUR NETWORK

Each Blackbox Node acts as both an AI host and a mesh repeater. Messages hop through nodes until they reach one running the AI. The response travels back the same way — entirely over radio.

01

CONNECT A LORA DEVICE

Plug in any Meshtastic-compatible LoRa device via USB. The app auto-detects it and installs the Python bridge. No config needed.

02

ANY NODE CAN ASK

From any Meshtastic device in range, send @bot your question or !ask anything. The message routes through the mesh to your node.

03

AI PROCESSES LOCALLY

llama.cpp loads your chosen GGUF model. The response is generated fully on-device, then broadcast back over the mesh to the requester.

04

PAYMENTS TRAVEL THE SAME WAY

Cashu ecash tokens are plain text strings. Copy one into a message, send it over radio. The recipient redeems it when connectivity returns.

YOUR NODE USB LoRa AI BOT NODE N3 N4 N5 N6 @bot what is the weather? AI node relay node data pulse

// features

EVERYTHING BUILT IN

No plugins, no configuration hell. Works on a fresh machine after two commands.

AI
FULLY OFFLINE LLM

llama.cpp runs locally. No API keys. Choose models from 0.5B to 3B+ based on your hardware. Auto-downloaded on install.

AI
MESH-TRIGGERED QUERIES

Send @bot or !ask from any Meshtastic device in range. The mesh routes it, the AI answers, the response routes back.

AI
MODEL MANAGER

Download, switch, or delete GGUF models from a curated list via the web UI Settings panel. No terminal needed after first install.

RADIO
AUTO DEVICE DETECTION

Plug in your Meshtastic device and it just works. Serial port auto-detection with reconnect UI and port selection.

RADIO
NODE TELEMETRY

Battery, SNR, GPS position, environment sensors — all tracked per node. Query nodes or weather over the mesh.

RADIO
FULL MESSAGE LOG

All inbound and outbound Meshtastic messages logged and browsable. Direct messages and channel broadcasts both supported.

PAYMENTS
BITCOIN HD WALLET

BIP-39 mnemonic, HD derivation, on-chain receive. QR code generation for addresses and Lightning invoices.

PAYMENTS
CASHU ECASH

Bearer tokens as plain text. Send over radio, hold offline, melt to Lightning when connected. No counterparty needed at transfer time.

STORAGE
100% LOCAL DATA

Everything stored in ./data/ — messages, nodes, wallet, settings, Cashu proofs. No external databases, no telemetry.


// compatible hardware

PICK YOUR RADIO

Any Meshtastic-compatible LoRa device works. Plug it in, and Blackbox Node handles the rest.

HELTEC LoRa 32
~$20–30

Compact ESP32-based module. Great starter device, built-in OLED display.

LILYGO T-BEAM
~$35–45

Built-in GPS + battery management. Best for portable or vehicle nodes.

RAK WisBlock
~$40–60

Modular system, highly configurable. Great for permanent installations.

SEEED SenseCAP T1000
~$50–60

Card-sized GPS tracker form factor. Ultra portable, long battery life.

NOTE: No radio? The app still runs. Local AI and wallet work fine without a device connected.

// two modes

USE WHAT YOU HAVE

MODE 1

LOCAL AI ONLY

Node.js + Python + a GGUF model. No radio, no internet. Full web UI, local chat with the AI, wallet functions.

  • Node.js 18+
  • GGUF model file
  • No radio needed
MODE 2

FULL MESH NODE

Everything above plus a Meshtastic device connected via USB. Becomes an AI gateway and radio node for the entire mesh.

  • Node.js 18+
  • Python 3.11+
  • Meshtastic LoRa device