프로젝트 소개

BirdNET-Go는 조류, 박쥐 및 기타 야생동물을 위한 자체 호스팅, 상시 가동 사운드스케이프 분석기입니다. 사운드카드 입력 또는 네트워크 오디오 스트림(RTSP/RTSPS)을 수집하고, 로컬 다중 모델 AI 분류를 실행하며, 빠른 웹 UI에서 감지 결과를 표시합니다. Raspberry Pi 4 또는 이에 준하는 64비트 싱글보드 컴퓨터와 같은 보통 수준의 하드웨어에서 지속적으로 실행되도록 설계되었습니다. 감지 모델 - BirdNET v2.4가 기본 내장되어 있으며 6,500종 이상의 조류를 포괄합니다. - Google Perch v2는 ONNX를 통해 실행되며 조류, 곤충, 양서류, 포유류에 걸쳐 14,795종을 포괄합니다. - BattyBirdNET은 초음파 지원 장치가 있는 Linux에서 11개의 지역별 박쥐 분류기(아프리카, 아메리카, 동아시아, 유럽, 중동, 남아시아, 동남아시아, 미국)를 제공합니다. - BirdNET Geomodel v3.0은 12,012종에 대한 위치 기반 범위 필터링을 추가합니다. - 모델은 재빌드 없이 앱 내 갤러리에서 설치할 수 있으며, 여러 모델을 별도의 오디오 소스에 대해 병렬로 실행할 수 있습니다. 모델 간 일치는 신뢰도를 강화하고 불일치는 검토용으로 표시할 수 있습니다. - 사용자 정의 TFLite 분류기와 레이블 세트를 지원합니다. 정확도 제어에는 Deep Detection(15초 창 내 반복 확인), 종별 동적 임계값, 위치 기반 범위 필터링, 프라이버시 및 개 짖음 필터, 분류기별 박쥐 오탐 수준이 포함됩니다. 오디오 처리 - 사운드카드 캡처 및 RTSP/RTSPS 스트림, 여러 소스의 병렬 처리와 독립적 모델 할당. - 초음파 박쥐 감지를 위한 최대 256kHz 샘플 레이트. - 단계별 복구 기능이 있는 오디오 활성 감시, 스트림 샘플 레이트 탐지, 이퀄라이저, 소스별 조용한 시간, 주광 필터 및 확장 캡처 모드. - 오디오 파일의 오프라인 분석. 인터페이스 - Svelte 5 + TypeScript 싱글 페이지 앱, PWA로 설치 가능. - 온보딩 마법사, 라이브 스펙트로그램 스트리밍, 감지 히트맵, 사용자 정의 가능한 대시보드 레이아웃 및 "현재 듣는 중" 카드. - 감지 결과에 대한 다중 선택 및 일괄 작업, 브라우저 터미널(WebSocket PTY를 통한 xterm.js). - UI는 여러 유럽 언어로 제공되며, 종 이름은 40개 이상의 언어로 제공됩니다. 알림 및 연동 - 규칙별 조건, 일정 및 전달 대상을 갖춘 구성 가능한 알림 규칙 엔진. - shoutrrr를 통해 Discord, Slack, Telegram, ntfy, Pushover, Gotify, Matrix, Bark, IFTTT 등으로 전달하며, 사용자 정의 템플릿이 있는 웹훅, 셸 스크립트 훅 및 브라우저 푸시도 지원합니다. - Home Assistant 자동 검색이 포함된 MQTT 게시, BirdWeather.com API 연동, Prometheus 메트릭 엔드포인트. - 새 모이통 스트림의 OBS 오버레이에 적합한 라이브 스펙트로그램 및 실시간 로그 출력. 저장 및 운영 - 기본적으로 SQLite 또는 MySQL, 재시도 인식 쓰기 경로, 자동 백업 및 형식 인식 오디오 클립 내보내기. - 오프라인 조회를 위한 내장 eBird/Clements 분류 체계(2,374속, 254과, 11,145종). - 시스템 상태 진단, 데이터베이스 닥터, 안내식 버그 보고 및 원클릭 지원 덤프. - Google, GitHub 및 일반 제공자를 통한 OIDC/SSO, TLS 인증서 관리 UI, 재시작 없이 설정 및 모델 설치를 위한 핫 리로드. - 기본적으로 로컬 전용이며, 선택적 Sentry 텔레메트리는 엄격히 옵트인 방식입니다. 플랫폼 및 설치 - Linux, Windows 및 macOS, BirdNET TFLite 모델이 내장된 단일 정적 바이너리, Perch, BattyBirdNET 및 지오모델을 위한 선택적 ONNX Runtime. - linux/amd64 및 linux/arm64용 멀티 아키텍처 Docker 이미지, Debian/Ubuntu/Raspberry Pi OS용 설치 스크립트, 사전 빌드된 릴리스 바이너리. 라이선스 및 데이터 - Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International에 따라 라이선스됩니다. - 분류 체계 데이터는 eBird API를 통해 eBird/Clements Checklist에서 파생되었으며, 비상업적 목적을 위한 eBird API 약관에 따라 사용됩니다. - Tomi P. Hakala가 제작 및 유지 관리하며, BirdNET 모델은 Cornell Lab of Ornithology와 Chemnitz University of Technology에서, Perch ONNX 변환은 Justin Chuby가, BattyBirdNET 모델은 R.D. Zinck이 제공했습니다.