terra  by modem-works

AI-powered GPS for mindful wandering

Created 1 year ago
623 stars

Top 53.0% on SourcePulse

GitHubView on GitHub
Project Summary

TERRA is a pocket-sized, standalone navigation device designed for mindful outdoor exploration, allowing users to wander without a smartphone. It generates AI-powered, improvised trails based on user prompts and returns them to their starting point, appealing to hikers and nature enthusiasts seeking a tech-minimalist experience.

How It Works

The system comprises a web application for route generation and an ESP32-based hardware device for navigation. The web app uses the ChatGPT API to create a sequence of GPS coordinates for a trail, considering user input like desired length and intentions. These coordinates are then compiled into a config.h file, which is uploaded to the ESP32. The ESP32 device, equipped with GPS, compass, and haptic feedback, guides the user along the generated path.

Quick Start & Requirements

  • Web App: Requires Node.js v21.5, body-parser, cors, express, and node-fetch. Needs ChatGPT API Key and Google Places API Key. Run with node server.js.
  • Hardware: ESP32 Feather V2, 1.28" Round LCD, Adafruit Push-button Power Switch, Beitian BN 880 GPS, Adafruit DRV2605L Haptic Controller, CMPS12 Compass.
  • Arduino: Requires ESP32 board support in Arduino IDE and libraries: TinyGPSPlus, TFT_eSPI, Adafruit_DRV2605.
  • Setup: Involves API key configuration, web server setup, and Arduino code upload with a custom config.h.

Highlighted Details

  • AI-generated, improvised trails based on user prompts and time constraints.
  • Standalone hardware design encourages phone-free exploration.
  • Minimalist interface with compass and haptic feedback for present-moment engagement.
  • Open-source software and 3D printable hardware support DIY assembly.

Maintenance & Community

The project is in an experimental phase with rapid development. Contributors include Modem (Vision + Concept), Panter&Tourron (Industrial Design), and Alice Stewart (Software + Hardware). No community links (Discord/Slack) are provided.

Licensing & Compatibility

Licensed under the GNU General Public License v3.0 (GPLv3). This copyleft license may impose restrictions on linking with proprietary or closed-source software.

Limitations & Caveats

The project is explicitly stated to be in an experimental phase with rapid development, suggesting potential instability or breaking changes. The reliance on external APIs (OpenAI, Google Maps) introduces potential costs and service dependencies.

Health Check
Last Commit

1 year ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
8 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.