이것은 Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass에 제출하는 작품입니다.
제가 만든 것 (What I Built)
개발자들은 키보드에 웅크리고 앉아 화면을 응시하며 코드를 디버깅하는 데 몇 시간을 보냅니다. 이번 주 "풀밭에 발 딛기 (Touch Grass)" 챌린지를 위해, 저는 야외 휴식을 흥미로운 탐험으로 바꾸는 프로젝트를 만들고 싶었습니다.
저는 **캠퍼스 식물 탐지기(Campus Flora Finder)**를 구축했습니다. 이 오프라인 우선(offline-first)의 식물학적 동반자는 화면이 경험에서 가장 짧은 부분이 되도록 설계되었습니다:
- 야외로 나가기: 책상에서 벗어나 캠퍼스나 지역 공원을 거닐며 현지 식물, 관목, 나무를 발견합니다.
- 사진 찍기: 낯선 식물의 사진을 빠르게 촬영합니다.
- 즉시 식별: 이미지를 업로드하여 일반명, 과학적 분류, 주요 식물학적 특징, 그리고 생태학적 재미있는 사실을 받습니다—그러고는 휴대폰을 치우고 계속 산책을 즐깁니다.
데모 (Demo)
(팁: 실행 중인 Streamlit 앱의 스크린샷이나 GIF를 여기에 드래그 앤 드롭하세요! 식물이 식별된 모습으로!)
이 인터페이스는 외부 네트워크 의존성 없이 브라우저에서 로컬로 실행되며, 업로드된 식물 사진을 몇 초 만에 처리합니다.
코드 (Code)
🌿 캠퍼스 식물 탐지기 (Campus Flora Finder)
Hacktoberfest 2026 주차 1 챌린지 출품작 (테마: "풀밭에 발 딛기")
Streamlit을 사용하고 Ollama를 통해 로컬에서 실행되는 오픈 가중치(open-weight) 비전 모델로 구축된, 상호작용적이고 100% 오프라인이며 개인 정보 보호에 중점을 둔 식물학적 식별 웹 애플리케이션.
🍃 개요 및 "풀밭에 발 딛기" 철학 (Overview & The "Touch Grass" Philosophy)
Hacktoberfest의 "풀밭에 발 딛기 (Touch Grass)" 챌린지 목표는 간단합니다. 개발자와 대학생들이 코드 에디터에서 벗어나 신선한 공기를 마시고, 캠퍼스 녹지 공간을 탐험하며, 자연 세계와 다시 연결하도록 장려하는 것입니다.
Campus Flora Finder는 기술과 자연을 연결합니다. 대학 캠퍼스를 거닐며 야생의 나무, 관목 또는 꽃 사진을 노트북이나 휴대폰 카메라로 찍으면, 개인 데이터나 이미지를 외부 클라우드 API로 전송할 필요 없이 즉각적인 현장 식물학 진단을 받을 수 있습니다.
✨ 주요 기능 (Features)
- 🌲 100% 오프라인 및 프라이버시 보호: 오픈 웨이트 비전 모델(
llava, moondream 등)을 사용하여 로컬 기기에서 완전히 실행됩니다.
GitHub에서 보기
제작 과정 (How I Built It)
이 애플리케이션은 프론트엔드에 Streamlit을 사용하고, 로컬 오픈 웨이트 비전-언어 모델을 Ollama를 통해 구동하여 Python으로 구축되었습니다.
- 아키텍처: 앱은 Ollama의 로컬 추론 런타임을 통해 오픈 웨이트
llava (또는 moondream) 비전 모델을 사용하여 이미지를 로컬에서 처리합니다.
- 파이프라인: Streamlit은 이미지(JPEG/PNG)를 가져와 이를 바이트 스트림으로 직접 변환하고, 구조화된 분류학 및 생태학적 세부 정보를 추출하기 위한 목표 식물학 프롬프트와 함께 로컬 모델 엔드포인트로 전송합니다.
- 복원력: 이 도구는 Ollama 데몬 또는 모델 가중치가 초기화되어야 할 경우 사용자에게 알리는 깔끔한 대체 처리(fallback handling)를 포함하고 있습니다.
오픈 혁신이 중요한 이유 (Why Does Open Innovation Matter?)
오픈 소스 AI와 로컬 추론은 야외 애플리케이션에 독특하게 적합합니다:
- 진정한 오프라인 활용성: 트레일, 식물원, 캠퍼스 경계 지역은 셀룰러 수신 강도가 약하거나 사각지대가 발생하는 경우가 잦습니다. 오픈 웨이트 모델을 로컬에서 실행하면 인터넷 연결 없이도 식별 파이프라인이 작동하도록 보장합니다.
- 비용 제로 및 높은 접근성: 클라우드 기반 멀티모달 API는 지속적인 토큰 및 이미지 수집 비용이 발생합니다. 오픈 웨이트를 사용하면 학생들과 야외 애호가들이 구독 장벽이나 API 비용 없이 수백 개의 표본을 스캔할 수 있습니다.
- 데이터 프라이버시: 탐험 사진과 메타데이터는 제3자 기업 서버에 업로드되는 대신 전적으로 로컬 기기에 남아 있습니다.
나의 에이전트 세션
IDE 코딩 어시스턴트를 사용하여 Streamlit 인터페이스와 이미지 바이트스트림 파이프라인을 구축하여 프롬프트 구조 및 로컬 추론 속도를 빠르게 테스트했습니다.