Guides and documents
Everything here is also in the repository. Improve it by pull request.
- Green paper: an oracle for LifeWhy a living place needs its own way of answering, and how three cheap data streams become seven readings and one verdict.
- Specification v0.1Data model, the seven readings with their exact rules, the verdict, confidence and maturity, the API, and what is specified but not yet built.
- Hardware guide: what to buySound recorders, soil probes and LoRaWAN gateways available today, with prices, where to buy in Europe, and the three standard kits.
- Steward guide: from zero to seven readingsRegister a place, watch the satellite readings arrive, add a recorder and a probe, deliver the data. Step by step, with the exact commands.
- Installation protocol: sound recorderHeight, orientation, spacing, schedule and maintenance for each kit, so that recordings from different places are comparable.
- Installation protocol: soil probeDepth, position, backfill and marking for moisture and temperature probes, and the LoRaWAN join.
- Data delivery protocolsHow detections, acoustic indices and soil readings get into the oracle: direct API, The Things Stack webhook, BirdNET-Pi, AudioMoth cards, BirdWeather.
- Roles and user profilesWho does what in a life-oracle network: steward, installer, verifier, consumer, methodologist, operator, and software agents.
- APIEndpoints, authentication, and examples for reading verdicts and delivering data. Machine-readable spec at /api/v1/openapi.json.
- Satellite stream: how it is computedExactly what the oracle does with Sentinel-2 for each place, which free sources it uses, and the gotchas it handles.
- Contributing and running your own instanceRepository layout, how to run the stack, how to propose a method change, and the house rules.