Lab
Live notes on integrations, API research, and tooling we are validating before anything ships to the main site narrative.
This page is noindex so search stays focused on the public story — use it as our shared scratch pad.
Active efforts
FarmBot Web App & API posture
Spike readyMapped the upstream stack (Rails JSON API, browser UI, MQTT) against my.farm.bot vs self-host. Captured required services and env surface from public staging docs — Postgres, Redis, MQTT/Rabbit, keys — without running their server stack.
TheOracle (`waft oracle`) still flags **production** integration or self-host as HALT until evidence and explicit approval. A **local env-only spike script** is in-repo: it logs in with email/password, then performs a read-only GET /api/device (no secrets committed; `.env` gitignored).
- Run: `python3 scripts/farmbot_api_spike.py` with `FARMBOT_EMAIL` and `FARMBOT_PASSWORD` (or `FARMBOT_TOKEN` for device GET only). Bogus credentials return 422 from my.farm.bot — useful smoke test without real secrets.
- Hardware README links Web App source, API docs, and work effort 00.02; Docker deferred for v1 spike per plan.
This page
ActiveThe Lab route is the public-facing scratch pad for what we are trying in the open: research threads, integration posture, and session notes that are not yet homepage material.
- Bookmark /lab for the latest ledger entry.
- Site map lists Lab under utility pages for discoverability.
Credentials for any API spike stay in your shell environment or a local .env that is never committed.
Prefer my.farm.bot for a first call; keep Docker as a later option if we need a disposable stack.
Recent lab log
- 2026-03-22
Shipped `scripts/farmbot_api_spike.py`: POST /api/tokens + read-only GET /api/device against my.farm.bot using env-only credentials; documented results in work effort 00.02; `.env` added to .gitignore.
- 2026-03-21
Lab page expanded into an experiment ledger; FarmBot Web App research summarized with upstream links and Oracle HALT reminder.
- 2026-03-21
Infrastructure work effort 00.02 filled from README, example.env, and DEPLOYMENT.md (staging); hardware README Inspiration updated (v1.3).
- 2026-03-21
Opened 00.02 and devlogs 01.00–01.01; consulted The Oracle for epistemic posture on integration.