README.md

---
title: SAM3 Layer Segmentation Tool
emoji: 🎨
colorFrom: blue
colorTo: indigo
sdk: gradio
sdk_version: 5.9.1
app_file: app.py
pinned: false
license: apache-2.0
short_description: Layer-based object segmentation and area analysis with SAM3
---

# SAM3 Layer Segmentation Tool 🎨

**레이어 기반 객체 분리 및 면적 분석 도구**

SAM3 (Segment Anything Model 3)를 활용한 직관적인 이미지 세그멘테이션 도구입니다.

## ✨ 주요 기능

- 🎯 **레이어 기반 세그멘테이션**: 여러 객체를 레이어별로 분리하여 관리
- 🖱️ **Include/Exclude 포인트**: 빨간색 점(포함) 및 파란색 점(제외)으로 정밀한 영역 선택
- 📊 **면적 분석**: 각 레이어의 픽셀 수 및 비율 자동 계산
- 🎨 **시각화 설정**: 투명도, 테두리 두께 조정 가능
- 💾 **다중 레이어 관리**: 여러 객체를 동시에 세그멘테이션

## 🚀 사용 방법

1. **이미지 업로드**: 좌측에 이미지를 업로드합니다
2. **레이어 생성**: 분리하고 싶은 객체마다 레이어를 생성합니다 (예: 벤치, 나무, 사람)
3. **포인트 모드 선택**: Include Point (빨강) 또는 Exclude Point (파랑) 선택
4. **포인트 추가**: 이미지를 클릭하여 포인트를 추가합니다
5. **세그멘테이션 실행**: "Run All Segmentation" 버튼을 클릭합니다
6. **결과 확인**: 우측에서 결과 이미지와 면적 분석 테이블을 확인합니다

## 🎯 포인트 모드

- **Include Point (빨간 원 ●)**: 이 영역을 포함시킵니다
- **Exclude Point (파란 X)**: 이 영역을 제외합니다

## 📊 기술 스택

- **SAM3**: Meta의 최신 세그멘테이션 모델
- **Gradio**: 웹 인터페이스
- **PyTorch**: 딥러닝 프레임워크

## ⚡ 성능

- CPU 모드 지원 (GPU 권장)
- 첫 실행 시 모델 다운로드로 시간 소요

## 📝 License

Apache 2.0

tmd9564@gmail.com