📘 OGEN Field Guide

🌬️ 1. Breathe — Control the Lungs

Open ogenbuild.com on any device with a microphone (phone, laptop, tablet).

• Click “enable BREATH” and allow microphone access.
• Inhale deeply → your lungs heal (green aura).
• Exhale sharply → your lungs take damage (red flash).
• The organism’s mood (calm → stressed → ill → critical) changes with your breath and overall health.

🐦 BIRD INSTINCT Your breath also affects the flock’s anxiety level – rapid breathing simulates a pressure drop, triggering migration.

🐜 2. Leave Pheromone Trails

Every action in the organism leaves a digital pheromone trail.

• Manual drop: Click “DROP PHEROMONE” to leave a high‑potency trail.
• Automatic: Walkers (virtual ants) automatically drop trails as they move.
• Decay: Trails fade over time (potency drops 5% per second).
• Reinforcement: If multiple walkers or users cross the same area, the trail strengthens – this is stigmergy (the network learns).

Use trails to mark resources (water, food, power) – other users will see the strongest paths.

🐝 3. Scout Resources (Bee Dance)

When you find a real‑world resource (e.g., a working water tap, a charged power bank, a medical kit):

1. Open the “SCOUT RESOURCE” panel on the right.
2. Select resource type: Water, Food, Power, Medical.
3. Enter distance (meters) and direction (N, NE, E, etc.).
4. Click “SCOUT RESOURCE” – the organism performs a bee dance, broadcasting the resource to all connected peers.

Other users will see the resource appear on their map, along with confidence level (reinforced by multiple scouts).

🐦 4. Trigger Migration (Bird Flock)

The organism senses “infrasound” – simulated barometric pressure drops that raise flock anxiety.

• Simulate a storm: Click “TRIGGER STORM” or “SIMULATE PRESSURE DROP”.
• When anxiety exceeds 70%, the flock automatically calculates a migration vector (direction to flee).
• All birds align with the migration vector – no central command, just collective instinct.
• The MIGRATION VECTOR panel shows which way the flock is moving (North, East, etc.).

In a real disaster, this would be triggered by actual barometric sensors on ESP32 nodes – the organism becomes an early warning system.

🌐 5. Join the Swarm (WebRTC Mesh)

The organism forms a serverless, offline mesh between devices.

• Click “CONNECT MESH” – the organism connects to a public signaling server (only for peer discovery).
• Once connected, “BROADCAST TO FLOCK” sends your current anxiety, migration vector, and emergency messages to all peers.
• When another device opens the same URL and clicks “CONNECT MESH”, they automatically discover each other.
• No internet required after initial discovery: WebRTC creates direct device‑to‑device data channels.

🔗 OFFLINE MODE To use without any internet, generate a QR handshake (v14+) and scan it from another device – they pair directly over local Wi‑Fi or Bluetooth.

🔧 6. Deploy ESP32 Hardware Nodes

Extend the mesh into the physical world with solar‑powered ESP32 beacons.

• Flash the firmware: The complete Arduino code is in the v15 section of the main OGEN thread (or included in the OGEN repository).
• Hardware needed: ESP32 dev board, 18650 battery, TP4056 charger, 6V solar panel, waterproof box.
• Functions: The ESP32 broadcasts an open Wi‑Fi hotspot, hosts a local web UI, and uses ESP‑NOW radio to talk to other ESP32s up to 500m away.
• Triage & SOS: The beacon listens for emergency broadcasts and flashes an LED if it detects a distress signal.

Place beacons at 500m intervals in a city – they form a self‑healing, solar‑powered mesh that works even when cell towers are down.

⚡ 7. Advanced: Pheromone Routing & Stigmergy

Behind the scenes, the organism uses a stigmergic algorithm (inspired by ant colonies).

• Every message is a pheromone packet with a potency value (initial 100).
• Potency decays by 5% per second – old information fades.
• If two devices carry the same message, the potency reinforces (increases).
• Result: The network automatically learns the most frequent paths – no central routing table needed.

This is how the organism finds the fastest route to a resource without any node having a map.