BirdNET‑Go – 실시간 AI 기반 사운드스케이프 분석

무엇을 할 수 있나요

BirdNET‑Go는 실시간으로 오디오(사운드 카드 또는 네트워크 스트림에서)를 수신하여 새, 기타 야생동물, 박쥐를 식별하는 자체 호스팅 서비스입니다. BirdNET v2.4(6,500종 이상) 모델과 함께 Google Perch v2, BattyBirdNET 박쥐 분류기, BirdNET Geomodel v3.0을 실행합니다. 검출 결과는 실시간 스펙트로그램, 히트맵, 검색 가능한 종 목록이 포함된 웹 대시보드에서 확인할 수 있습니다.

왜 중요한가요

• 로컬 AI 추론 – 클라우드 구독 필요 없음. 모든 작업은 온프레미스(라즈베리파이에서도 가능)에서 실행. 데이터는 사생활 보호되며 오프라인에서도 작동 가능.
• 다중 모델 공감 – 여러 분류기를 병렬로 실행하여 일치하는 결과는 신뢰도를 높이고, 불일치는 검토 대상으로 표시해 정확도를 향상시킵니다.
• 풍부한 알림 기능 – Discord, Slack, Telegram, MQTT/Home Assistant, 웹훅 등으로 검출 결과를 전송 가능. 홈 오토메이션 또는 시민 과학 워크플로우와 쉽게 통합 가능.
• 터키 설치 – 1클릭 설치 스크립트, amd64/arm64용 Docker 이미지, PWA 대응 UI로 24/7 모니터링 스테이션을 몇 분 안에 구축할 수 있습니다.

작동 방식(개요)

1. 오디오 수신 – 서버는 로컬 사운드 카드 또는 RTSP/RTSPS 스트림(초음파 박쥐 탐지용 최대 256 kHz)에서 오디오를 캡처합니다. 워치독이 스트림 상태를 모니터링하고 불안정한 소스를 재시작할 수 있습니다.
2. 모델 추론 – 오디오 조각을 선택된 AI 모델( BirdNET는 TFLite, Perch/BattyBirdNET/Geomodel는 ONNX)에 입력합니다. 추론은 CPU에서 실행되며, 선택적 ONNX Runtime으로 비-TFLite 모델을 가속화할 수 있습니다.
3. 공감 및 필터링 – 각 모델의 결과를 통합합니다. 모델 간 일치는 신뢰도를 높이고, 설정 가능한 필터(지역 범위, 개 짖는 소리, 심층 검출 창, 종별 임계값)로 오류 탐지(false positive)를 제거합니다.
4. 저장 및 UI – 검출 결과는 SQLite(또는 MySQL)에 저장되며, Svelte 기반 싱글페이지 웹 앱에서 표시됩니다. UI는 실시간 스펙트로그램, 히트맵, "지금 듣고 있는 것" 카드를 제공합니다.
5. 알림 라우팅 – shoutrrr 라이브러리 기반의 규칙 엔진이 사용자 정의 조건에 따라 각 검출을 평가하고 다양한 채널로 알림을 전달합니다.

누구에게 적합한가요

• 피더, 둥지 상자, 또는 원격지에 사생활 보호가 가능한 항상 작동하는 녹음 장치가 필요한 새 관찰자, 연구자, 보존 자원봉사자.
• 특정 종이 등장할 때 조명, 카메라, 로그 등을 트리거하고 싶은 홈 오토메이션 애호가.
• 사용자 정의 TFLite 모델로 확장 가능한 준비된 AI 추론 파이프라인을 필요로 하는 개발자.

시작하기

# Debian/Ubuntu/Raspberry Pi OS
curl -fsSL https://github.com/tphakala/birdnet-go/raw/main/install.sh -o install.sh
bash ./install.sh

또는 Docker 이미지를 가져와 호스트 네트워크에서 실행(저지연 오디오용 추천). 프로젝트는 빠른 시작 워크숍, OIDC/SSO 로그인, TLS 인증서 처리, 헬스체크 페이지를 제공합니다.

커뮤니티 및 지원

• Discord: 실시간 도움과 기능 논의.
• GitHub: 이슈, 풀 리퀘스트, 기여자 목록.
• 광범위한 위키: 설치, 하드웨어 추천, 사용자 정의 분류기 훈련, 보안, 문제 해결 등.

---

라이선스: Creative Commons BY‑NC‑SA 4.0(비영리 사용만 허용). 모델 가중치는 원래 BirdNET 및 Perch 라이선스에 따라 제공됩니다.