Lorax OS
------Z --- ----Operator sign-in
§01 · lorax watch · live ops
Lorax OS· operating system for the trees · I speak for the trees
v0.1.2·shipped·shipped 2026-05-17 · ~4 months ahead of Sep plan

Multi-sensor fusion meets operational intelligence, applied to trees.

§ active intelligence · north pasturenominal
soil moisture · Z03 · 12cm capacitive · 7-day
23.4%± 0.6 · trend ↗
min 17.2 · max 28.1 · avg 22.7threshold 17% · cycle armed
A05
23.4%soil moisture · 12cmnorth pasture
B02
6.812kglysimeter · pot 04container yard
C11
0.42leaf wetnesswest fenceline
D03
21.8°Cweather · air tempshop roof
§ ops status
irrigation
v0.2 · planned
defense
v0.4 · planned
mind agent
v0.3 · planned
alerts
0 · nominal
§ year-1 KPIs · live
plants live
in inventory · Y1 target met
165
accepted revenue · YTD 2026
from accepted quotes
$4,260
treatment events · YTD
Iowa 206 compliant
11
PHI plants gated
no harvest blocks
0

Lorax Watch · Range · Hammer · The Lorax · Ledger · Channel · Atlas · Lab — eight modules, one platform.

§02 · what lorax isone platform · production · sales · compliance · intelligence

A multi-sensor fusion platform that watches every plant, every sensor, every customer interaction, and every dollar.

01 · sensors

Watch every plant.

Multi-sensor fusion: soil moisture, leaf wetness, canopy temp, lysimeter mass, PoE camera vision, weather station, drone NDVI. Edge nodes on WiFi 6 mesh feed a Pi 5 + Hailo-8L gateway. Sensor reads land in the dashboard inside 30 seconds.

edge nodes
ESP32-S3 · M5Stack · Seeed XIAO
gateway
Pi 5 8GB · Hailo-8L M.2
telemetry
Postgres + TimescaleDB · MQTT
02 · sales

Sell every plant.

Customer CRM, quote drafting with live PDF preview, B2B wholesale portal with ACH net-30, a public DTC storefront with Stripe Tax. Quote-to-order conversion tracked. Year-5 endgame: per-plant photo timelines for premium specimens.

crm + quotes
shipped v0.1
storefront DTC
v0.4 · Stripe Checkout
wholesale B2B
v0.5 · Stripe Invoicing
03 · compliance

Stay legal automatically.

Iowa Code 206 pesticide records auto-generated from every treatment event. Iowa Nursery Grower annual inspection assembled from the schema, not maintained by hand. REI/PHI gating on plant transitions is enforced in code, not vibes. Multi-state modules queued for the SaaS pivot.

iowa code 206
shipped · auto from treatment_event
REI / PHI
schema-enforced · cannot bypass
states queued
WI · MN · NE · IL
§03 · eight modules · one platform

The named surface area.

Lorax OS is opinionated. Eight modules with hard responsibility lines. Each tile below is honest about what ships today versus what arrives with the sensor mesh in v0.2 and the AI agent in v0.3.

Lorax Watch

L/W

Live monitoring. Sensors, alerts, weather, defense status, and the common operating picture. Always-on at 30-second refresh on the shop tablet.

v0.1.2·shipped·KPI dashboard live

Lorax Range

L/R

Sensor mesh management. Node health, calibration, OTA firmware. Filter by pasture, zone, sensor type, status.

v0.2·planned

Lorax Hammer

L/H

Irrigation, frost protection, deer-deterrent actuators. Deterministic control loops — never an LLM in the path.

v0.2·planned·sensor-driven v0.3

The Lorax

L/M

The AI agent. Claude in the cloud, Llama 3.3 fallback on the Pi. Chat in the web admin, push-to-talk on phone, wake-word on LilyGo handheld.

v0.3·planned·voice v0.5

Lorax Ledger

L/L

Compliance records, financial reporting, tax exports, grant tracking. Iowa Code 206 pesticide log + Iowa Nursery Grower annual auto-assembled from the schema.

v0.1.2·shipped·EQIP grant ledger + CSV exports

Lorax Channel

L/C

Sales surfaces. Customer CRM, quote builder with live PDF, public DTC storefront, B2B wholesale portal with Stripe Invoicing ACH net-30.

v0.1.2·shipped·storefront v0.4 · wholesale v0.5

Lorax Atlas

L/A

Digital twin. Property twin from drone photogrammetry, zone twin with simulation mode, per-plant schematic twin and (later) Gaussian splat photoreal.

v0.3·planned·photoreal v0.6+

Lorax Lab

L/L

Research mode. Control vs treatment cohort designer, methodology attachments, grant-format exports — SARE Farmer/Rancher, USDA SBIR, NIFA AFRI.

v0.3·planned
§04 · data model

The plant is the center.

Every table fans out from a single plant row. Sensor reads, treatment events, photo timelines, cost rollups, compliance gates, customer interactions — all addressable from one identifier.

PLT-A05-04-12Cercis canadensis
‘Forest Pansy’
live · growingintake 2026-04-18 · 30 days

Schema fields

plant_id
PLT-A05-04-12
species_cultivar
Cercis canadensis 'Forest Pansy'
intake_date
2026-04-18
location
Block A · Row 4 · Pos 12
sensor_zone
Z03 · north pasture
status
live · growing
size_caliper
0.875"
stock_plant_lineage
SP-007
phi_until
(none)
phyto_cert_required
Iowa interstate-ship 2026
treatment_events
4 logged · YTD
photo_count
11
cost_per_plant
$8.42 intake + $1.18 ops
research_cohort
EQIP control row 4

Every row carries organization_id — RLS isolates tenants from day one so the Year-5 SaaS pivot is free.

§05 · architecture

Four layers. Hard separation.

Local-first edge. The Pi is the operational system of record for control loops. Cloud is the system of record for business data. Loss of internet means irrigation and defense keep running with cached state; writes queue and replay.

01 · Edge

layer 1/4

ESP32-S3 · PoE cameras · solenoids · weather · lysimeters

  • Capacitive moisture · SHT41 air · BH1750 PAR · DS18B20 chains
  • HX711 + 50kg load-cell pot lysimeters
  • Reolink PoE PTZ + Duo 3 wide-area
  • OTA firmware · MQTT to Pi · TFLite-Micro motion classify

02 · Gateway

layer 2/4

Raspberry Pi 5 8GB · Hailo-8L M.2 · UPS · shop-mounted

  • Mosquitto MQTT · Postgres + TimescaleDB hypertables
  • Hammer control daemons · Hailo CV runtime
  • Whisper.cpp STT · Piper TTS · Ollama Llama 3.3 8B fallback
  • MCP server · sync agent · outbox + replay

03 · Cloud

layer 3/4

Supabase · Vercel · Anthropic · Stripe · Resend · Trigger.dev

  • Supabase Auth · Postgres · pgvector · PostGIS · Realtime · Storage
  • Next.js 16 on Vercel · admin + storefront + wholesale subroute
  • Stripe Checkout DTC · Stripe Invoicing B2B · Stripe Tax
  • Claude Sonnet via API · Sentry · PostHog · Grafana Cloud

04 · Interaction

layer 4/4

Tab S9 Ultra primary · phone PWA · LilyGo handheld

  • Admin: lorax.mlmpower.ai · dark · tablet-landscape-first
  • Storefront: dctreefarm.mlmpower.ai · public · softened brand
  • Wholesale: dctreefarm.mlmpower.ai/wholesale · auth-gated
  • Voice: PWA push-to-talk · LilyGo T-Display S3 wake-word
gateway uptime99.5% on Pi · UPS
outage tolerance≥7 days local
sensor latency≤30s to dashboard
voice tool-use≤5s end-to-end
§06 · roadmap · v0.1 → v1.0

Honest timeline through Sep 2030.

v0.1.2 shipped 2026-05-17 · ~4 months ahead of Sep plan
v0.1.2May 2026

Compliance + EQIP ledger close-out

Phyto certs CRUD · weather snapshot on treatments with NOAA pre-fill · grant_payment ledger · Iowa Nursery Grower annual scaffold.

v0.1.2·shipped
v0.2Jan 2027

First sensors land

5 sensor nodes · MQTT ingest · Pi Postgres + TimescaleDB · manual irrigation · container-yard lysimeters · mobile PWA.

v0.2·planned
v0.3May 2027

Sensor-driven ops + The Lorax

ET-driven irrigation · The Lorax chat · property twin v1 from drone · Lorax Lab v1 · SARE proposal data ready.

v0.3·planned
v0.4Oct 2027

Public storefront live

DTC storefront with Stripe Checkout · first container sales online · camera nodes · YOLO deer detection on Hailo.

v0.4·planned
v0.5Mar 2028

Wholesale + voice + leaf-vision

B2B wholesale subroute · Stripe Invoicing ACH net-30 · vision-language leaf diagnosis · voice agent on LilyGo.

v0.5·planned
v0.6Sep 2028

Defense + SBIR readiness

Defense robotics fully integrated · SBIR Phase I submission readiness · Gaussian splat per-plant pilot.

v0.6·planned
v0.7Mar 2029

Self-host shipped

Caliper-measurement CV · drone NDVI ingestion · harvest-readiness scoring · zone twin with sim · Docker Compose self-host installer.

v0.7·planned
v0.8Sep 2029

Harvest workflow + multi-tenancy

First major B&B harvest workflow · customer-facing photo timelines · multi-tenancy hardening begins · role-scoped seasonal-help PWA.

v0.8·planned
v0.9Mar 2030

First external self-hoster

Iowa compliance modularized · WI + MN modules drafted · SaaS auth flows · tenant onboarding self-serve · first external self-hoster.

v0.9·planned
v1.0Sep 2030

Hosted SaaS pilot

2–5 paying tenants · commercial license offering live · per-plant photoreal twins as premium feature.

v1.0·planned
§06b · functional epics · all 14

What ships under those version cuts.

Functional epics

  1. 01
    Plant Lifecyclev0.1.2·shipped

    Intake, location, batch operations, stock-plant lineage, REI/PHI gating, photo timelines.

  2. 02
    Sensor Meshv0.2·planned

    ESP32-S3 nodes on WiFi 6, MQTT to Pi, calibration history, OTA firmware.

  3. 03
    Irrigationv0.2·planned

    Manual zone control v0.2 · ET-model sensor-driven v0.3 · lysimeter feedback.

  4. 04
    Pest / Diseasev0.1.2·shipped

    Treatment-event log shipped · vision-language leaf diagnosis v0.5 · disease pressure modeling.

  5. 05
    Defensev0.4·planned

    PoE PTZ + YOLOv11 on Hailo · water spray, acoustic, strobe deterrents · deterministic firing only.

  6. 06
    Voice + Chat Agentv0.3·planned

    The Lorax chat web v0.3 · LilyGo wake-word v0.5 · MCP tool server on Pi · Claude + Llama fallback.

  7. 07
    Quotes + Salesv0.1.2·shipped

    Quote builder w/ live PDF + public access-token URL shipped · storefront v0.4 · wholesale v0.5.

  8. 08
    CRMv0.1.2·shipped

    Customer pipeline, interaction timeline, follow-up bookkeeping, stale-account flagging.

  9. 09
    Compliancev0.1.2·shipped

    Iowa Code 206 pesticide log + PDF · Iowa Nursery Grower scaffold · phyto certs · sales-tax routing · multi-state v0.9+.

  10. 10
    Financialv0.1.2·shipped

    Per-plant cost rollup · treatments-amortized COGS · EQIP grant ledger · Date/Account/Amount CSV for QB/Xero/Wave.

  11. 11
    Propagationv0.2·in dev

    Stock-plant lineage tracking, propagation events, success-rate analytics, cohort assignment.

  12. 12
    Customer-Facingv0.4·planned

    DTC storefront with Stripe Tax v0.4 · per-order photo timelines v0.8 · tier-priced wholesale catalog v0.5.

  13. 13
    Research Mode (Lab)v0.3·planned

    Control vs treatment cohort designer, methodology docs, SARE/SBIR/NIFA export packs.

  14. 14
    Digital Twin (Atlas)v0.3·planned

    Property twin from drone v0.3 · zone twin sim v0.7 · per-plant Gaussian-splat pilot v0.6 → production v1.0.

§07 · compliance is schema-first

Iowa is the v0.1 baseline.

Compliance is modeled in the schema from day one. Retrofitting it into a system designed without it is multi-week pain — so we don't. WI, MN, NE, IL modules queued for the multi-state SaaS pivot.

pesticide log YTD
100%compliant

All treatment events carry product, EPA reg no., rate, area, REI, PHI, applicator, weather snapshot, and signed PDF on demand.

PHI violations
0schema-gated

A plant cannot transition to harvest_ready until its phi_until has passed. This is legal compliance, not a UI suggestion.

Nursery Grower annual
ready to file

Inspection record auto-assembled from plant + treatment_event + phyto_cert. Submit via IDALS.

Iowa requirement → schema source

RequirementIowa refSchema sourceStatus
Pesticide application records (24-month retention)Iowa Code 206 §21-45treatment_eventcompliant
REI / PHI enforcement on plant transitionsIowa Code 206 + label lawplant.status gatingcompliant
Iowa Nursery Grower annual inspection recordsIDALS Entomology & Plant Scienceplant + treatment_event + phyto_certcompliant
Phyto cert tracking (5-year retention)USDA APHIS · IDALSphyto_certcompliant
Iowa sales tax handling (taxable / resale / statutory exempt)Iowa DORcustomer.tax_treatment + Stripe Taxcompliant
Iowa LLC biennial report reminderIA Sec. of Stateorganization.next_biennial_report_duecompliant
1099 tracking for contracted laborIRS + IA DORvendor_paymentv0.2 pending
§08 · safety doctrine

AI suggests. Deterministic systems act.

LLMs draft, summarize, advise, and route. Deterministic code fires actuators, enforces compliance rules, and runs control loops. No LLM in the irrigation path. No LLM in the defense path. No LLM in any path where a hung API call could kill a tree.

The Lorax · advisor

draft only
operator

Anything off in Block A this morning?

the lorax

PLT-A05-04-12 (Forest Pansy) shows powdery mildew on three lower leaves in last night's PoE-04 frame. Pressure forecast moderate (RH 78%, low wind). Suggested treatment: PHC ESP at 15 ml/gal, REI 4h, PHI 0. Block A REI window clears 2026-05-19 06:00 CDT. Draft a treatment_event?

operator

Yeah, draft it.

runtime · Anthropic Claude Sonnet (cloud) · Llama 3.3 8B (Pi offline read-only fallback) · MCP server on Pi

Lorax Hammer · actuator log

armed
  1. 181430ZZ03 · soil-moisture 18.2% · threshold 17% · skip
  2. 181400ZZ01 · scheduled cycle · ON · 8 min · 4.2 gal
  3. 181352ZZ01 · solenoid-02 · OPEN ack
  4. 181244Zlysimeter L-04 · pre-mass 6.812kg
  5. 180230ZZ05 · soil-moisture 12.4% · threshold 17% · CYCLE
  6. 180200ZZ05 · scheduled cycle · ON · 12 min · 6.3 gal

runtime · Python control daemon on Pi · MQTT to ESP32 solenoid drivers · no network dependency · same code runs offline

§09 · local-first edge

Lose internet. Plants live.

The Pi is the operational system of record for control loops. Internet drops, cloud goes dark, Anthropic 500s — irrigation keeps running, defense keeps watching, treatments still get logged. Writes queue locally and replay on reconnect. Full 7-day operational tolerance is the design target.

Cloud · unreachable

offline

Supabase unreachable · Anthropic API timeout · Stripe webhooks queueing. Vercel admin loads cached read views from service worker.

Pi · system of record

armed · UPS-backed

Postgres + TimescaleDB local · Mosquitto routing MQTT · Hammer control daemon scheduling irrigation · outbox queue accumulating writes for replay.

Plants · watered

nominal

Z01 irrigation cycle completed 4.2 gal. Z03 skipped (soil 18.2% > threshold). Z05 cycle armed. Lysimeter pre/post masses logged locally.

queued writesoutbox · 142 events
outage tolerance≥ 7 days
fallback agentLlama 3.3 8B · Ollama · read-only
backup posturedaily Postgres dump · monthly restore drill
§10 · open source posture

Built in the open. AGPL v3.

Lorax is open source from v0.1. The hosted SaaS at lorax.mlmpower.ai is the commercial offering — self-hosting is supported and welcomed. The AGPL network-share clause preserves the hosted SaaS as the default commercial play while keeping the code genuinely free.

Why AGPL v3

Genuine OSI-recognized open source matters for SBIR credibility, university and extension service adoption, and the “built in the open” narrative. AGPL is battle-tested by Plausible, Cal.com, Mastodon, and Matrix.

license
AGPL-3.0-or-later
cla / dco
DCO sign-off on every PR
trademark
USPTO TEAS Plus pending

Repository

pnpm workspaces monorepo · Next.js admin + Pi edge agent + shared packages. CI runs license audit (REUSE) on every build — a single GPL-incompatible dependency blocks the merge.

github.com/dbavey22/lorax →

Every file is signed

REUSE-compliant SPDX headers on every source file. Validated in CI via pnpm reuse:check.

// SPDX-FileCopyrightText: 2026 Major League Measurables
// SPDX-License-Identifier: AGPL-3.0-or-later
self-host
free · AGPL v3
hosted SaaS
$99–149/mo · v1.0 Sep 2030
commercial license
available · v1.0+