손누리 🤚

손누리는 "손"과 순우리말 "누리(세상)"을 합친 이름으로, 손으로 세상을 배우고 소통한다는 의미를 담고 있습니다. 손누리는 단순한 기술 구현을 넘어, 소통의 장벽을 허물고 모두가 함께 배우는 세상을 만들고자 합니다.\

📌 프로젝트 소개

수어(수화 언어)를 디지털 환경에서 효과적으로 학습하고 실습할수있도록 설계된 AI 기반 수어 학습 웹입니다. 핵심 기술은 사용자의 수어 동작을 웹캠을 통해 실시간으로 인식하고 평가하는 인공지능 모델로, 이는 사용자가 올바른 손모양과 동작으로 수어를 수행하고 있는지를 판단하는 데 활용합니다.

🧑‍💻 주요 기능

• 실시간 수어 인식
• 자모/단어 예측 및 정확도 표시
• 수어 영상 기반 학습 모드
• 번역기 기능: 한국 수어 → 미국 수어

👥 팀원 소개

이름	학번	역할
박서현	22112100	프론트엔드 개발 및 프로젝트 통합, 팀장
박윤호	22012124	인공지능 모델 학습 및 수어 실시간 인식 개발
송유진	22113654	UI 디자인 및 프론트엔드 개발
정현아	22210572	인공지능 모델 학습
최효정	22212052	백엔드 개발 및 websocket 통신 구현

🛠️ 기술 스택

• 프론트엔드: React + Vite + TypeScript + Tailwind CSS
• 백엔드: FastAPI + WebSocket
• AI 모델: TensorFlow / TFLite
• 데이터: OpenPose 기반 KSL 데이터셋
• 배포/환경: Docker + Docker Compose

📄 관련 문서

• 프로젝트 제안서
• 프로젝트 발표 자료

🚀 실행 방법

1. 레포 클론 및 환경 준비

git clone https://github.com/ParkTjgus/sonnuri.git

2. Docker 환경에서 실행

1. 본 프로젝트를 실행하기 위해서는 docker가 필요합니다.
   • docker download: https://www.docker.com/products/docker-desktop/
2. docker를 실행합니다.
3. 프로젝트를 다운로드(클론)한 폴더에서 cmd 창을 켜 아래 명령어를 입력하여 프로젝트를 실행합니다.
   • 주의: 폴더명에 한국어가 포함될 시, 실행이 안될 수 있습니다.

   docker-compose up --build

4. http://localhost:5173/ 에 접속합니다.

👩‍🏫 데모 시연

1. 수어 학습하기: 자음
2. 수어 학습하기: 모음
3. 수어 학습하기: 단어
   • 아니요
   • 얼마
4. 학습 내용 테스트하기
5. 수어 번역하기

---

이 외 문의사항이 있거나 실행에 문제가 있을 시, psh22112100@gmail.com으로 연락바랍니다.