robogreeno-cloud

Cloud layer for the RoboGreeno swarm robotics platform.

Small spider bots roam a greenhouse collecting sensor data and imagery. Carrier spiders shuttle that data to the main AgCloud server. This repo handles the simulation, routing algorithms, communication protocol, and storage strategy for that pipeline.

Quick start

pip install -e ".[dev]"

# Run simulator with visualization
python -m simulator

# Headless (no pygame window, prints summary)
python -m simulator --headless

# Choose a DTN algorithm
python -m simulator --config simulator/config/default.yaml
# Edit default.yaml → dtn.algorithm: prophet | spray_and_wait | epidemic

# Run tests
pytest

Repository layout

simulator/   Core simulation: spiders, carriers, greenhouse, DTN algorithms, visualization
comms/       Application-layer message schema + BLE transport abstraction + MQTT publisher
storage/     Compression benchmarks and eviction policies for on-spider SD card
server/      AgCloud server continuation (Sprints 8–9+)
tests/       Pytest test suite
docs/        Architecture, tutorials, contributing guide

Adding a DTN algorithm

See docs/tutorials/02_add_a_dtn_algorithm.md.

Running on Raspberry Pi

See docs/tutorials/03_run_on_rpi.md.