BugDex - 모든 벌레를 찾아라!

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

🌿 제가 만든 것

BugDex는 화면 시간을 야외 모험으로 바꾸기 위해 설계된 AI 기반의 실제 벌레 수집 게임이자 디지털 현장 일지입니다. 포켓몬 도감(Pokédex)과 같은 고전적인 괴물 수집 백과사전에 영감을 받아, BugDex는 사람들이 밖에 나가 뒷마당, 공원, 캠퍼스 정원, 하이킹 트레일 등을 탐험하며 우리 주변에 사는 매혹적인 작은 생명체들을 발견하도록 힘을 실어줍니다.

야생에서 곤충, 거미 또는 절지동물을 발견할 때마다 다음 단계를 따릅니다:

1. 스마트폰으로 사진을 찍거나 사진을 업로드합니다.
2. **AI 멀티모달 비전(Multimodal Vision)**이 실시간으로 표본을 식별하고, 생물학적 분류군(목(Order), 과(Family), 학명(Scientific Name), 일반명(Common Name)), 형태학적 특징(날개맥(wing venation), 딱지날개(elytra), 더듬이(antennae)), 서식지, 식단, 그리고 인체 안전 지침을 추출합니다.
3. 홀로그래픽 수집 카드 획득: 검증된 관찰 기록 하나하나가 희귀도 등급(Common, Uncommon, Rare, Very Rare, Legendary)에 따라 순위가 매겨진 수집 카드로 변환되며, 애니메이션 포일 광택, 신뢰 점수, 생태학적 메모를 갖춥니다.
4. 레벨 업 및 일일 야외 퀘스트 수행: 경험치(XP)를 얻고, 등급을 해금하고(초보 벌레 사냥꾼(Novice Bug Catcher)부터 마스터 곤충학자(Master Entomologist)까지), 매일 탐험 기록을 유지하며, 비전 AI가 직접 검증하는 일일 원정(예: _

• 데모 영상/워크스루:

✨ 주요 기능 한눈에 보기 (Key Features at a Glance)

• 📸 즉각적인 멀티모달 AI 현장 식별: 실제 생물학적 정확도를 갖춘 서브초(sub-second) 시각 분류.
• 🎴 홀로그래픽 포일 표본 카드: 역동적인 3D 기울임 효과, 애니메이션 희귀도 반짝임, 그리고 종합적인 생태 현장 노트 제공.
• 📜 상호작용 가능한 BugDex 및 저널: 분류군(Taxonomic order)별(Coleoptera, Lepidoptera, Hymenoptera, Mantodea, Odonata 등) 필터링과 스마트 중복 제거 및 발견 횟수 카운터를 통한 관리.
• 🎯 AI 검증 일일 원정: AI가 사용자의 실제 스냅샷이 그날의 생물 다양성 미션을 충족하는지 평가하는 일일 야외 탐험 기록 확인 기능.
• 🏆 업적 및 레벨링 시스템: 배지를 획득하고(🐛 첫 벌레, 🦋 수집가, 🌙 야행 사냥꾼, 🔥 연속 도전가) 6단계의 자연학자 등급을 거치며 성장.
• ⚠️ 야생 동물 안전 최우선: 침이나 독성이 있는 종에 대한 자동 경고와 함께, 존중하는 관찰 및 표본 손상 금지에 대한 조언 제공.
• 🔒 개인 정보 보호 우선 및 오프라인 지원: 광범위한 서식지 태그(공원, 정원, 산책로)를 가진 클라이언트 측 저장소—침해적인 GPS 추적 없음.

💻 코드 (Code)

전체 프로젝트는 오픈 소스이며 GitHub에 호스팅되어 있습니다:

GitHub - TarunTXE/BugDex

🔗 리포지토리: https://github.com/TarunTXE/BugDex

🛠️ 제작 과정 (How I Built It)

BugDex는 모던하고 반응형이며, 모바일 우선(mobile-first) 웹 아키텍처와 멀티모달 비전 모델을 결합하여 구축되었습니다:

🧠 오픈 소스 및 멀티모달 AI 아키텍처 (Open-Source & Multimodal AI Architecture)

BugDex는 Google Gemini Multimodal Vision REST API (@google/genai)를 활용하며, 복원력 있는 폴백(fallback) 처리를 갖춘 초저지연 모델 계층 구조를 구현합니다:

1. gemini-flash-lite-latest (즉각적인 야외 스캔용 주요 모델)
2. gemini-3.5-flash-lite
3. gemini-3.1-flash-lite
4. gemini-2.5-flash-lite
5. gemini-3.6-flash (심층 분석 폴백 모델)

🔍 엄격한 분류 체계 및 비전 파이프라인

환각(hallucinations)을 방지하고 과학적 정확성을 보장하기 위해:

• Base64 인라인 버퍼 수집 (Ingestion): 실시간 카메라 캡처 또는 사용자가 선택한 이미지는 모바일 데이터 사용량을 최소화하기 위해 클라이언트 측에서 다운스케일링 및 인코딩됩니다.
• 제약된 JSON 스키마 출력: AI 프롬프트는 구조화된 생물학적 스키마(response_mime_type: "application/json")를 낮은 온도(0.1)로 강제하여 정확한 과학적 이명법(binomial nomenclature), 과(family), 목(order), 신뢰도 등급, 외형 분석, 식단, 그리고 인간 안전 지침을 추출합니다.
• 부정 샘플 및 불확실성 거부: 업로드된 사진에 사람의 얼굴, 반려동물 또는 무생물이 포함되어 있는 경우, 모델은 우아하게 `

1. 생물다양성 교육의 민주화: 전통적인 현장 안내서나 분류학적 열쇠는 종종 학술적이고 복잡하여 일반 자연 애호가들이 접근하기 어렵습니다. OpenAI 모델은 복잡한 생물 분류학을 누구나 손안에서 사용할 수 있는 접근성이 좋은 인터랙티브 디지털 동반자로 변모시킵니다.
2. 대규모 시민 과학: 생물다양성 도구가 개방적이고, 확장 가능하며, 독점적인 종속성(proprietary lock-in)으로부터 자유로울 때, 누구나 지역 생태계 인식에 기여할 수 있습니다. 이는 도시의 꽃가루 매개자(pollinator)를 기록하고 거주지 커뮤니티 내 계절별 곤충 개체군을 추적하는 것을 포함합니다.
3. 투명성 및 안전: 자연 탐험은 벌레와 같은 실제 생물을 다루는 것이므로, 개방적이고 재현 가능한 프롬프트 아키텍처(prompt architectures)는 안전 지침, 비침습적 관찰 방식, 데이터 개인 정보 보호가 투명하게 유지되고 커뮤니티의 감사를 받을 수 있도록 보장합니다.
4. 기술과 살아있는 지구의 연결: 개방형 혁신은 기술이 우리를 가상 사일로(walled gardens) 속에 고립시켜서는 안 된다는 점을 상기시켜 줍니다. 대신, 기술은 우리 현관문 바로 밖에 있는 자연 생태계에 대한 우리의 경외심, 호기심, 존중을 깊게 하는 렌즈 역할을 할 수 있습니다.

🏆 수상 부문

• Hacktoberfest Week 1: Touch Grass (메인 트랙)
• 오픈 소스 AI 및 비전 혁신

밖으로 나가서, 지역의 녹지 공간을 탐험하고 즐거운 벌레 사냥을 하세요! 🐛🌿🔍