explaingit

luciobaiocchi/heard

Analysis updated 2026-05-18

46PythonAudience · researcherComplexity · 4/5LicenseSetup · hard

TLDR

HEARD is an embedded LoRa mesh device system that tracks hiking groups off the grid, plus a Python-based simulator and 3D browser viewer for testing it.

Mindmap

mindmap
  root((repo))
    What it does
      GPS tracking
      LoRa mesh radio
      Route corridor checks
    Tech stack
      Python
      ESP32
      MapLibre
    Use cases
      Hiking safety
      Protocol simulation
      Route deviation alerts
    Audience
      Researchers
      Outdoor enthusiasts

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Track a hiking group's real-time position over a LoRa mesh with no cell signal.

USE CASE 2

Get alerted when a hiker strays outside a defined corridor around the planned route.

USE CASE 3

Simulate hiking scenarios in Python using the actual firmware protocol logic.

USE CASE 4

Replay simulated runs in a 3D browser viewer showing radio transmissions on real terrain.

What is it built with?

PythonESP32LoRaMapLibre

How does it compare?

luciobaiocchi/heardbetta-tech/harness-sddsecureagentics/adrian
Stars464646
LanguagePythonPythonPython
Setup difficultyhardeasyhard
Complexity4/52/54/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires ESP32 hardware plus a GPS module and LoRa transceiver, not a certified safety device.

Apache 2.0: use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

In plain English

HEARD (Hiking Emergency Assistance and Rescue Device) is an embedded system project for keeping hiking groups safe in areas with no phone signal. Each hiker carries a small device with a GPS chip and a LoRa radio, which is a long-range, low-power wireless technology that works without any cellular or internet infrastructure. The devices talk to each other directly, forming a mesh so that the group leader can see where everyone is in real time. The system works around a planned route loaded onto each device as a GPX file. A continuous check compares each hiker's position against a corridor around that route, defaulting to plus or minus 100 meters, and marks them as either on-path or off-path. The group leader's device, called the Core, periodically polls the rest of the group for their positions. If a hiker is too far for a direct radio connection, other devices in the group relay the message, passing it along hop by hop. Three simple message types handle the whole protocol: a broadcast request from the Core, a relay acknowledgment from intermediate devices, and a position reply that can carry aggregated location data. The prototype hardware is an ESP32 microcontroller paired with a GPS module, a LoRa transceiver, and a small e-ink display showing the group status. Field tests reported roughly one meter of GPS accuracy, a radio range of about three kilometers in open terrain, and around 300 to 400 meters in obstructed areas. Alongside the firmware, the repository includes a full software simulator. The actual protocol code from the firmware is compiled into a Python module so that simulated hiking runs can execute the real firmware logic rather than a reimplementation. The simulator models a probabilistic radio channel with optional terrain obstruction using real elevation data. Recorded simulation runs can then be replayed in a 3D browser viewer built with MapLibre, showing device positions, radio transmissions, and protocol state on actual terrain. This is a Bachelor's thesis project from the University of Bologna. The README notes that the standalone Node firmware build is not yet finished and that the project is not a certified safety device. It is licensed under Apache 2.0.

Copy-paste prompts

Prompt 1
Explain how HEARD's LoRa mesh relays position messages between hikers with no phone signal.
Prompt 2
Walk me through running HEARD's Python simulator with a sample GPX route.
Prompt 3
What hardware does the HEARD prototype use, and what range did field tests report?
Prompt 4
How does the 3D MapLibre viewer visualize a recorded HEARD simulation run?

Frequently asked questions

What is heard?

HEARD is an embedded LoRa mesh device system that tracks hiking groups off the grid, plus a Python-based simulator and 3D browser viewer for testing it.

What language is heard written in?

Mainly Python. The stack also includes Python, ESP32, LoRa.

What license does heard use?

Apache 2.0: use freely for any purpose, including commercial use, as long as you keep the copyright and license notice.

How hard is heard to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is heard for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.