YoLuWa!

YoLuWa!는 무엇인가요?

YoLuWa!는 **Your YOLO Live Web Analyzer**의 약자로, 휴대폰 카메라를 활용하여 실시간으로 YOLO 기반 객체 인식을 수행하고, 이 결과를 웹 인터페이스를 통해 원격으로 제어하고 모니터링할 수 있는 혁신적인 파이썬 앱입니다. 사용자의 편의성, 강력한 기능, 그리고 견고한 보안을 최우선으로 설계되었습니다.

강력한 웹 기반 원격 제어 기능을 통해 PC에 직접 접근하지 않고도 카메라 스트림을 확인하고, YOLO 모델을 변경하며, 신뢰도 임계값을 조절하는 등 다양한 작업을 수행할 수 있습니다. 또한, 디스코드 웹훅 연동을 통해 분석 결과 이미지를 편리하게 공유할 수 있으며, 모든 설정은 마스터 비밀번호로 암호화되어 안전하게 보호됩니다.

게으른 로딩(Lazy Loading) 방식으로 YOLO 모델을 최적화하여 앱 시작 시 리소스 소모를 최소화하고, 필요한 시점에만 모델을 로드하여 쾌적한 사용 환경을 제공합니다. YoLuWa!는 AI 기반 비전 프로젝트를 더욱 쉽고 강력하게 만들어 줄 당신의 스마트 파트너가 될 것입니다.

YoLuWa! 설명 영상

YoLuWa!의 주요 기능과 사용 방법을 영상으로 쉽게 확인해보세요!

주요 기능

실시간 YOLO 분석

휴대폰 카메라를 웹캠으로 활용하여 실시간으로 YOLO 객체 인식을 수행하고, 분석 결과를 스트리밍합니다.

직관적인 웹 제어

PC 앱에 직접 접근하지 않고도 휴대폰 웹 브라우저를 통해 모든 기능을 원격으로 제어할 수 있습니다.

강력한 보안

마스터 비밀번호 설정 및 웹훅 URL 암호화로 앱과 데이터의 보안을 철저하게 지켜줍니다.

동적 모델 관리

실시간으로 YOLO 모델을 변경하고 신뢰도 임계값을 조절하여 다양한 환경에 최적화할 수 있습니다.

디스코드 연동

분석된 결과 이미지와 함께 원하는 메시지를 디스코드 채널로 즉시 전송할 수 있습니다.

성능 최적화

게으른 로딩 방식으로 앱 시작 시 리소스 소모를 최소화하고 쾌적한 사용 환경을 제공합니다.

설치 및 다운로드

Windows용 YoLuWa! 설치 (추천)

Windows 사용자분들께서는 다음 단계를 따라 간편하게 YoLuWa!를 설치하고 실행할 수 있습니다.

최신 버전 다운로드: 아래 버튼을 클릭하여 YoLuWa! Windows 실행 파일을 다운로드합니다.
YOLO 모델 파일 준비: 사용하실 .pt 형식의 YOLO 모델 파일을 미리 준비해 둡니다. (예: yolov8n.pt)
IP WebCam 앱 설치: 휴대폰에 IP WebCam (안드로이드) 또는 유사한 iOS 앱을 설치하고 실행하여 스트리밍 URL을 확인합니다.
YoLuWa! 실행: 다운로드한 .exe 파일을 실행하고, 안내에 따라 마스터 비밀번호를 설정합니다.
설정 입력: 앱 GUI의 설정 섹션에 휴대폰 웹캠 URL, 디스코드 웹훅 URL, 원하는 웹 스트리밍 포트 등을 입력하고 "설정 적용 및 저장" 버튼을 클릭합니다.
카메라 시작: "YOLO 카메라 시작/중지" 버튼을 눌러 분석을 시작합니다.

Windows용 최신 버전 다운로드

macOS용 YoLuWa! 설치 (Coming Soon)

macOS 버전은 현재 준비 중입니다. 조만간 편리한 설치 프로그램을 제공할 예정입니다.

PyInstaller를 이용한 앱 번들 제공 예정
최적화된 성능과 사용자 경험 제공

그동안 소스 코드를 통해 수동으로 설치하여 사용하실 수 있습니다.

GitHub 저장소로 이동

Linux용 YoLuWa! 설치 (Coming Soon)

Linux 버전은 현재 준비 중입니다. 다양한 배포판에서 안정적으로 동작하는 설치 패키지를 제공할 예정입니다.

AppImage 또는 Snap/Flatpak 패키지 제공 예정
커뮤니티와 협력하여 다양한 환경 지원

그동안 소스 코드를 통해 수동으로 설치하여 사용하실 수 있습니다.

소스 코드 보기

소스 코드로부터 설치 및 실행

개발자 또는 고급 사용자분들을 위한 소스 코드 설치 가이드입니다.

Python 설치: Python 3.8 이상 버전이 설치되어 있는지 확인합니다.
Git Clone 또는 다운로드: YoLuWa! GitHub 저장소에서 소스 코드를 다운로드합니다. (https://github.com/bearmanentp/yoluwa/archive/refs/tags/YoLuWa.zip)

가상 환경 설정 (권장):

python -m venv venv
./venv/Scripts/activate # Windows
source venv/bin/activate # macOS/Linux

필요 라이브러리 설치:

pip install -r requirements.txt
# 또는 다음 라이브러리들을 개별 설치
pip install opencv-python ultralytics PySide6 requests cryptography

YOLO 모델 파일 준비: .pt 형식의 YOLO 모델 파일과 templates 폴더 안의 index.html 파일을 yoluwaPC.py와 같은 디렉토리에 둡니다.
YoLuWa! 실행:
```
python yoluwaPC.py
```
최초 설정: 프로그램 최초 실행 시 마스터 비밀번호를 설정합니다.
설정 입력: 앱 GUI에서 필요한 설정값(웹캠 URL, 디스코드 웹훅 등)을 입력하고 저장합니다.

소스 코드 다운로드

이전 버전 다운로드

특정 환경이나 기능이 필요한 경우, 이전 버전의 YoLuWa!를 다운로드할 수 있습니다.

이전 버전 목록을 로드 중입니다...

직접 다운로드 링크 (수동 업데이트 필요 시)

각 플랫폼에 맞는 최신 버전을 다운로드하세요. 아래 링크는 수동으로 업데이트해야 합니다.

Windows (.exe) macOS (.zip) Linux (.AppImage) 소스 코드 (.zip)

자동 로딩되는 "이전 버전 다운로드" 섹션을 권장하며, 이곳의 링크는 수동으로 업데이트해야 합니다.