CanopyRoute Pune: 오프라인 오픈소스 AI 트레일 오디오 러너

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

제가 만든 것 (What I Built)

대부분의 현대 아웃도어 및 트레일 러닝 앱은 역설적인 문제를 만듭니다. 즉, 우리를 자연으로 나가도록 장려하면서도, 방향 전환 안내(turn-by-turn prompts), 심박수 차트, 고도 등고선 같은 밝은 휴대폰 화면에 눈을 붙잡아 두게 합니다.

저는 CanopyRoute Pune를 만들어 이 역동성을 뒤집었습니다. 즉, 화면이 달리기에서 가장 짧은 부분이 되도록 하고, 휴대폰을 주머니에 넣고, 소리로 달리게 하는 것입니다.

Pune의 tekdis(언덕), 반얀나무 숲, 산등성이 등지에 특별히 디자인된 CanopyRoute는 로컬 오픈-웨이트 AI를 기반으로 하는 오프라인 우선의 경치 트레일 경로 계획 및 청각적 언덕 달리기 동반자입니다.

핵심 기능 (Core Features)

• '주머니 속 자연 경험 모드(Touch Grass Pocket Run Mode)': 트레일을 선택하고 **

파란 모름 나비(Blue Mormon Butterfly)와 반짝이는 꽃가루 흔적을 남기는 산골 벌(Hill Honeybee) 사이를 오갈 수 있습니다.

• 큐레이션된 푸네 사햐드리 트레일:
  • 베탈 테크디 & ARAI 포레스트 릿지 (Vetal Tekdi & ARAI Forest Ridge) (5.8 km • 푸네 최고 지점, 붉은 무룸 토양, 공작새, 야생 토끼)
  • 탈자이 언덕 & 공작 보호 구역 (Taljai Hills & Peacock Reserve) (4.6 km • 그늘진 반얀 나무 군락과 서식하는 춤추는 공작새가 있는 보호림)
  • 신하가드 요새 산길 (Sinhagad Fort Mountain Trail) (8.2 km • 역사적인 현무암 계단, 시원한 계곡 안개, 카르비 꽃 봉오리, 카다크와슬라 저수지 전망)
  • 파샨 호수 대나무 & 습지 보호 구역 (Pashan Lake Bamboo & Wetland Sanctuary) (4.2 km • 황금빛 대나무 군락, 연꽃, 그리고 왜가리가 있는 곳)
  • 바네르 언덕 & 풍차 고원 능선 (Baner Hill & Windmill Plateau Ridge) (5.2 km • 바네르-파샨 계곡을 내려다보는 파노라마 360도 능선 달리기 트레일)
• 푸네 식물학 및 야생 동물 필드 가이드: 서부 가트(Western Ghats)의 토종 나무(반얀 공중 뿌리, 굴모하르 진홍색 꽃, 카르비 대규모 개화 관목, 참파)와 야생 동물(인도 공작새, 파란 모름 나비, 검은 등 토끼, 산골 벌)에 대한 오프라인 필드 가이드.

데모

• 실시간 배포 앱: https://abh19avm.github.io/Touch-Grass-hacktober-week1-/
• 리포지토리: https://github.com/Abh19avM/Touch-Grass-hacktober-week1-

_(팁: 모바일 또는 데스크톱에서 라이브 링크를 열고, 일반 영어로 트레일을 설명한 다음,

Hacktoberfest 2026 오픈소스 AI 챌린지용 제작: 1주차 ('풀밭에 발을 디디다')
테마: 오픈소스 AI를 핵심으로 하여 사람들이 화면에서 벗어나 세상 속으로 나아가게 하는 무언가를 구축하기.
실시간 사이트: https://abh19avm.github.io/Touch-Grass-hacktober-week1-/
저장소: https://github.com/Abh19avM/Touch-Grass-hacktober-week1-

🌲 CanopyRoute Pune란 무엇인가?

CanopyRoute Pune는 로컬 오픈 가중치 AI(@huggingface/transformers)를 기반으로 하여, **마하라슈트라(Maharashtra) 주 푸네(Pune)**의 테크디스(tekdis), 반얀 무리(banyan groves), 산등성이를 위해 특별히 제작된 오프라인 우선 경관 트레일 경로 계획 및 청각적 언덕 달리기 동반자입니다.

현대 피트니스 및 지도 앱들은 러너들을 빛나는 화면에 붙잡아 두어, 끊임없이 디지털 방향 지시(turn-by-turn prompts), 고도 윤곽선(elevation contours), 페이스 알림 등을 응시하게 만듭니다. CanopyRoute는 정반대의 철학으로 구축되었습니다: 화면을 경험의 가장 짧은 부분으로 만들고, 휴대폰을 주머니에 넣고, 소리로 달리게 하는 것입니다.

✨ 핵심 기능

1. 풀밭 속 달리기 모드 (Touch Grass Pocket Run Mode)

   • 트레일을 선택하고 **

2. 로컬 오픈 웨이트 AI 추론 (@huggingface/transformers):

   WebAssembly / WebGPU를 통해 브라우저에서 Xenova/all-MiniLM-L6-v2를 로컬로 실행합니다. ONNX Runtime Web을 사용합니다.

   러너가 _"공작새와 부드러운 흙이 있는 우거진 우기 후의 반얀 나무 숲"_과 같은 감각적 질의를 입력하면, 모델은 기기(on-device)에서 384차원 벡터 임베딩을 계산하고 수집된 트레일 문서 벡터와 코사인 유사도를 밀리초 단위로 계산합니다.

   자원이 제한적인 모바일 브라우저에서도 즉각적인 질의 해결을 위해 결정론적(deterministic), 제로 네트워크 엣지 벡터라이저 폴백 기능을 포함합니다.

3. 절차적 청각 코칭 엔진 (Procedural Auditory Coaching Engine):

   셀룰러 네트워크를 통해 사전 녹음된 오디오 파일을 스트리밍하는 대신, CanopyRoute는 Web Audio API를 사용하여 핑크 노이즈 버퍼와 비쿼드 공진 필터(biquad resonant filters)를 이용해 주변 산들바람 소리와 바람 소리를 절차적으로 합성합니다.

   Web Speech Synthesis API와 결합하여, 화면이 주머니에 잠겨 있는 동안에도 헤드폰을 통해 마음챙김 명소 단서, 심박수 페이스 조절 알림, 식물학적 관찰 내용을 직접 구술(articulate)합니다.

4. 지도 제작 및 Leaflet 통합 (Cartography & Leaflet Integration):

   React-Leaflet과 Leaflet으로 구축되었으며, Pune([18.5240, 73.8180])에 중심을 두고 있습니다.

   지역 제약 조건 (maxBounds: [[17.80, 73.20], [19.20, 74.40]])은 러너가 고해상도 ESRI 지형 및 위성 타일 레이어를 갖춘 진정한 Pune 언덕 트랙을 탐험하도록 보장합니다.

5. 벡터 일러스트레이션 및 CSS 3D 애니메이션:

   범용 이모지 없이 완전히 구축되었습니다. 커스텀 SVG 벡터와 3D 변환 애니메이션(rotateY를 이용한 블루 모르몬 나비의 날갯짓, 벌꿀벌의 고주파 진동, 스프링이 부드러운 마우스 추적) 기능을 특징으로 합니다.

개방 혁신(Open Innovation)은 왜 중요한가요?

1. 산악 트레일에서는 셀룰러 서비스가 전무합니다:
   싱하가드 요새의 깊은 숲 계곡이나 탈자이(Taljai) 능선 뒤를 달릴 때, OpenAI나 Anthropic 같은 클라우드 기반 독점 API는 연결 부족으로 즉시 작동을 멈춥니다. 브라우저 캐시에 다운로드된 오픈 웨이트 모델은 셀룰러 신호가 전혀 잡히지 않는 산 정상에서도 끊김 없이 오프라인으로 실행됩니다.

2. 타협 없는 생체 인식 및 위치 프라이버시:
   달리기 경로, GPS 좌표, 페이싱(pacing), 심박수, 스케줄 패턴 등은 민감한 개인 원격 측정 데이터입니다. 폐쇄형 클라우드 API를 사용할 경우, 이 데이터는 전송선을 통해 원격 서버로 전송됩니다. 하지만 오픈 소스 온디바이스 AI를 사용하면, 생체 인식 또는 위치 데이터의 바이트 하나도 러너의 휴대폰을 벗어나지 않습니다.

3. 지역 기반 달리기 클럽에 대한 제로 비용:

4. 현지 생태계에 맞게 적응할 자유:
   오픈 혁신은 전 세계 개발자들이 자신들의 지역 생물군계(bioregion)에 맞춰 환경 모델을 조정할 수 있게 합니다. 마하라슈트라(Maharashtra)의 붉은 무룸 토양과 반얀 나무부터 전 세계의 고산 소나무 숲까지 가능합니다.

시상 부문

• Hacktoberfest 오픈소스 AI 챌린지: 1주차 (풀잎에 손대기)
• 최고의 오프라인/엣지 AI 경험
• 오픈 혁신 및 커뮤니티 영향력