TerraGemma: 휴대폰을 치우라고 알려주는 오프라인 엣지 AI 트레일 동반자

_이 글은 Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass에 제출하는 내용입니다.

제가 만든 것

현대의 하이킹 및 아웃도어 앱들은 비극적인 역설을 안고 있습니다: 오래된 숲과 고산 봉우리를 걸으면서 빛나는 화면만 내려다보도록 유도합니다. 방향 안내 알림음은 30초마다 손목에서 울립니다. 등산객들은 나뭇잎 스치는 소리, 축축한 hemlock 바늘의 향기, 그리고 산바람이 경고하듯 바뀌는 느낌을 놓칩니다.

더 심각한 것은, 트레일 헤드에서 1마일을 걸어 나가면 셀 타워가 사라진다는 것입니다. 깊은 야생에 진입하는 순간, 모든 독점 클라우드 AI 어시스턴트(ChatGPT, Claude, Gemini API)는 완전히 쓸모없는 돌아가는 로딩 휠이 됩니다. 등산객이 발목을 접지르거나, 벌에 쏘이거나, 해가 지면, 폐쇄된 AI는 그들을 고립시킵니다.

저는 TerraGemma를 만들었습니다: Google의 오픈 웨이트 모델인 Gemma 3가 온디바이스에서 100% 구동되는 오프라인 우선 백컨트리 탐험 동반자입니다.

핵심 철학:

1. NOAA 태양 엔진 및 네이즈미스 회전 수학 (Naismith Turnaround Math): 정확한 천문학적 일몰 시간, 골든 아워(golden hour), 그리고 엄격한 **회전 마감 시한(Turnaround Deadline)**을 계산합니다 (네이즈미스의 규칙에 따른 고도 상승 페널티 포함). 덕분에 어두워진 후에 산에서 갇히는 일이 없습니다.
2. '눈은 위로, 화면은 아래로' 감각 내비게이션 가이드: Gemma 3은 3~4가지의 실제 감각 단서(예: '0.8마일 지점의 계곡물 소리를 들어보세요; 트레일 경계를 벗어날 때 서쪽 계곡에서 불어오는 바람 변화를 느껴보세요')를 종합하여, 화면만 보는 대신 자연적인 인식을 통해 길을 찾도록 돕습니다.
3. 오프라인 야외 브리핑 ('듣기 & 주머니 속 휴대폰'): 트레일 헤드(trailhead)에서 브라우저의 네이티브 Web Speech API를 사용하여 간결한 오디오 브리핑을 재생합니다—클라우드 음성 API나 네트워크가 필요 없습니다. 한 번 듣고 기기를 주머니에 넣은 후 하이킹을 시작할 수 있습니다.
4. 오프라인 야생 지역 응급처치사(WFR) 분류: 휴대폰 신호가 전혀 없는 상황에서 응급 상황이 발생하면, Gemma 3은 저체온증, 열병, 독사에 물린 상처, 아나필락시스, 염좌에 대한 즉각적인 분류를 제공하며, 국제 표준의 3-blast 호루라기 구조 신호 프로토콜을 함께 안내합니다.
5. 현장 식물, 동물 및 독성 유사종 보호: 위험한 유사종(독미나리 vs 버지니아 크리퍼; 퀸 앤 레이스 vs 치명적인 독혈색; 흑곰 vs 그리즐리)을 나란히 식별하고, 마음챙김 '풀 만져보기(Touch Grass)' 감각 미션을 제공합니다.

데모

1. 태양 정밀도 및 안전한 회전 계획 수립

백컨트리(backcountry) 트레일을 선택하면 오프라인 NOAA 공식으로 천문학적 태양 타임스탬프(일출, 일몰, 민간 황혼)를 계산하고 네이즈미스의 규칙에 고도 상승 페널티를 적용합니다. 색상 코드가 지정된 일광 상태 배지 및 엄격한 회전 시간은 하이커가 어두워진 후에 산에서 갇히는 일이 없도록 보장하며, 이는 상호작용 가능한 OpenStreetMap 경로와 함께 표시됩니다.

2. "시선은 위로, 화면은 아래로" 오디오 브리핑

Gemma 3는 하이커가 경로 안내를 위해 휴대폰 알림을 확인하는 대신, 기억에 남는 물리적 감각의 닻(계곡물 소리, 변화하는 능선 바람 소리, 독특한 바위 더미 등)을 합성하여 자연적인 감각으로 길을 찾도록 합니다. "듣기 및 주머니 속 휴대폰"을 클릭하면 오프라인 Web Speech API가 브리핑 내용을 음성으로 읽어주어, 하이커가 기기를 보관하고 손쉽게 트레킹할 수 있도록 합니다.

3. 오프라인 응급 구조원 분류(Triage)

휴대폰 신호가 전혀 없는 깊은 백컨트리(backcountry)에서 응급 의료 결정은 기다릴 수 없습니다. Gemma 3는 급성 증상을 오프라인으로 평가하여, 즉각적인 3단계 분류 조치, 중요한 금기 사항(절대로 해서는 안 되는 것), 대피 시급성, 그리고 국제 3-blast 휘슬 구조 신호 프로토콜을 제공합니다.

4. 식물학적 안전 및 마음챙김 아웃도어 미션

위험한 유사종을 나란히 비교하는 오프라인 식물 및 야생 동물 필드 가이드(독미나리 vs 버지니아 크리퍼, 퀸 앤 레이스 vs 치명적인 독미, 흑곰 vs 그리즐리)와 함께, 숲과의 진정한 연결을 촉진하도록 설계된 마음챙김 "풀 만져보기(Touch Grass)" 미션을 제공합니다.

실제 트레일 헤드에서 TerraGemma가 작동하는 방식은 다음과 같습니다:

1. 탐험 준비 및 천문학적 계산: 백컨트리 트레일(backcountry trail)을 선택하거나 사용자 지정 좌표를 입력합니다. 오프라인 NOAA 태양 엔진이 일출, 일몰, 그리고 시민 황혼(civil dusk) 시간을 계산합니다. 네이즈미스 규칙(Naismith's rule)은 트레일 거리와 2,000피트 이상의 수직 상승을 고려하여 색상 코드로 된 일광 상태(🟢 안전, 🟡 주의, 🔴 위험)와 강제 회항 타임스탬프를 즉시 제공합니다.
2. 대화형 OpenStreetMap 경로: 웨이포인트(Waypoints), 계곡 횡단 지점(stream crossings), 스위치백(switchbacks), 고지대 체크포인트가 개방형 지리 정보 토포그래픽 지도에 표시됩니다.
3. 합성 및 휴대폰: **"감각 필드 브리핑 합성(Synthesize Sensory Field Briefing)"**을 누릅니다. 로컬 Gemma 3가 밀리초 단위로 감각적 랜드마크 앵커를 생성합니다. **"듣고 휴대폰에 넣기(Listen & Pocket Phone)"**를 클릭하면 음성 플레이어가 브리핑 내용을 소리 내어 읽어주므로, 사용자는 휴대폰을 배낭에 넣고 풀밭에 손을 대게 됩니다.
4. 오프라인 비상 분류: 응급 상황이 발생하면 WFR 탭으로 이동하여 에어플레인 모드에서도 침착하고 단계별 응급 처치 프로토콜을 얻을 수 있습니다.

코드

전체 소스 코드는 MIT 라이선스에 따라 GitHub에서 오픈소스로 공개됩니다:

👉 https://github.com/shivamgravity/terragemma

제작 과정

TerraGemma는 Streamlit을 사용하여 Python으로 구축되었으며, 소비자 하드웨어에서 100% 오프라인, 제로 클라우드 실행에 최적화되었습니다:

1. 로컬 오픈 웨이트 AI (Google Gemma 3):
   • gemma3:1b (주요 엣지 모델): 초경량(~815 MB)으로, 일반 노트북 CPU에서 약 500ms 만에 추론(inference) 실행 가능. 배터리 소모 없이 즉각적인 트레일 브리핑 및 현장 체크리스트 작성에 완벽합니다.
   • gemma3:4b (분석 모델): 복잡한 야생 비상 상황 및 식물학적 식별을 위한 심층적인 맥락 추론(contextual reasoning) 제공.
   • Ollama 엔진: keep_alive: 60m 설정을 통해 로컬 HTTP API로 연결되어, 따뜻하게 유지되는 모델 가중치(warm model weights)가 메모리에 머무르도록 보장합니다.
   • 탄력적 폴백 엔진 (Resilient Fallback Engine): 클라우드 데모에 배포될 때 다운타임이 없도록 내장된 휴리스틱 폴백을 제공합니다.
2. 결정론적 NOAA 태양 및 Naismith 엔진:
   • NOAA 태양 알고리즘의 순수 Python 수학 구현 (공식 일몰 기준 천정각 90.833°, 민간 황혼 기준 96°). 별도의 천문학 C 종속성(C-dependencies)이 없습니다.
   • Scarf의 등가성을 가진 Naismith 규칙: 기본 페이스에 수직 상승 거리 2,000 ft당 1시간과 필요한 안전 여유 시간(safety buffers)을 계산합니다.
3. 오프라인 웹 음성 API 오디오 합성기:
   • window.speechSynthesis를 활용하는 자체 포함 HTML/JS 컴포넌트로 구현되었습니다. 외부 클라우드 TTS(Text-to-Speech) API 호출 없이 사용자의 브라우저에서 자연스러운 음성을 로컬로 합성합니다.
4. 지리 공간 매핑 (folium & streamlit-folium):
   • 트레일 시작 지점, 수원지, 정상, 회전 지점(turnaround checkpoints)을 표시하는 OpenStreetMap 레이어입니다.

시스템 아키텍처

flowchart TD
    A[

국립공원, 협곡 또는 고산 통로를 지나면 휴대폰 신호가 0바(bar)로 떨어집니다. 폐쇄형 API는 무한 로딩 스피너가 됩니다. **Gemma 3**와 같은 오픈 웨이트 모델은 엣지 디바이스에서 네이티브하게 실행됩니다. 눈에 보이는 셀 타워 하나 없이도 세계적 수준의 자연사학자이자 야생 구조 전문가를 휴대하는 것과 같습니다.

### 2. 근본적인 위치 및 건강 프라이버시

상업용 트레일 앱들은 정밀 GPS 추적, 출발 시간, 개인 건강 지표 등을 패키징하여 광고 중개인(ad brokers)이나 데이터 중개인(data brokers)에게 판매하는 경우가 많습니다. TerraGemma는 100% 로컬에서 실행됩니다: **사용자의 좌표, 트레일 노트, 응급 증상은 기기를 벗어나지 않습니다.**

### 3. 제로 운영 비용 및 무제한 유틸리티

폐쇄형 API는 토큰 천 개당 사용료를 부과하고 속도 제한(rate limits)을 강제합니다. 다일간의 배낭여행 트레킹에서 오픈 웨이트 모델은 **$0.00**이며, API 속도 제한에 걸릴 일이 없고, 완전히 무기한으로 작동합니다.

### 4. 효율적인 양자화된 엣지 푸트프린트

Google의 **Gemma 3 (1B)**는 1GB 미만의 메모리를 요구합니다. 이는 소비자용 노트북과 엣지 하드웨어에서 수백 밀리초(milliseconds) 만에 실행되며, 생존 내비게이션에 필요한 중요한 배터리 잔량을 소모하지 않습니다.

## 나의 에이전트 세션

저는 DevRelay를 사용하여 TerraGemma를 구축하고 검증했습니다:

TerraGemma 구축: Gemma 3를 활용한 오프라인 엣지 AI 야생 동반자

당신

저는 hacktoberfest에 참여 중이며, 이것이 ABOUT.md에 주어진 도전 과제입니다. 눈에 띄고 실제로 어떤 문제를 해결할 수 있는 멋진 것을 만들 수 있도록 도와주시겠어요?

에이전트

Google Gemma 3를 활용하여 로컬 온디바이스로 구동되는 오프라인 우선 백컨트리 탐험 동반자인 TerraGemma를 만듭시다. 이 앱은 셀룰러 서비스가 끊겨 트레일헤드(trailhead)를 지나면 폐쇄형 AI 모델이 완전히 실패하는 중요한 문제를 해결합니다. TerraGemma는 천문학적 태양 계산, 네이즈미스 회전율 계산(Naismith turnaround calculations), 감각 랜드마크 가이드, 그리고 오프라인 웹 음성 브리핑을 통해 화면 사용 시간을 최소화하여 하이커들이 휴대폰을 주머니에 넣고 풀밭에 손을 댈 수 있게 합니다.

▸ verify_build python3 -m py_compile app.py

Input

python3 -m py_compile app.py

Output

Syntax OK, all modules verified.

2 of 2 messages

## 시상 부문 (Prize Categories)

-   **최우수 부문: Gemma 활용 최적 사례 ($200 USD)**: TerraGemma는 Google의 오픈 웨이트 모델인 **Gemma 3 (1B 및 4B)**을 Ollama를 통해 로컬에서 구동하여 완전히 구축되었습니다. Gemma는 독점적인 클라우드 의존성 없이 동적 감각 지표(dynamic sensory landmark) 생성, 구조화된 WFR 분류 평가, 그리고 오프라인 식물학적 식별 기능을 구현합니다.