본문으로 건너뛰기
블로그로 돌아가기
RuView 와이파이로 사람을 감지한다는데 진짜 될까요? 문서가 밝힌 한계와 점검표 (2026 기준)
[TUTORIAL]

RuView 와이파이로 사람을 감지한다는데 진짜 될까요? 문서가 밝힌 한계와 점검표 (2026 기준)

퀀텀점프클럽 정상록퀀텀점프클럽 정상록12분 읽기36 views

무료 자료

PDF · 무료

와이파이 감지 RuView, 써 보기 전 점검 순서

긴 글을 다 읽기 전에, 실무 가이드부터 먼저 챙겨가세요.

RuView 와이파이로 사람을 감지한다는데 진짜 될까요? 문서가 밝힌 한계와 점검표 (2026 기준)

RuView는 와이파이 신호로 사람의 존재와 자세를 추정한다고 내세우는 오픈소스입니다. 문서가 스스로 낮춘 수치와 사생활 쟁점, 써 보기 전 점검표를 정리했습니다.

와이파이로 사람을 감지한다는 RuView, 정말 될까요?

RuView(옛 이름 wifi-densepose)는 2026-11-11 기준 GitHub 별 103,869개(약 10만 4천 개)를 받은 MIT 라이선스 오픈소스예요. 와이파이 신호로 카메라 없이 사람의 존재와 움직임, 호흡, 심박, 자세를 추정한다고 내세우는 와이파이 센싱 프로젝트입니다. README는 소제목에서 "See through walls with WiFi"라고 내세웁니다.

별이 이렇게 많으니 '그래서 정말 되나요?' '우리 공간에 써도 괜찮을까요?' 싶죠. 도입을 저울질한다면 당연한 의문입니다.

이 글은 프로젝트 문서가 스스로 적은 한계를 기준으로 답합니다. 동작 원리, 수치의 지표와 조건, 재현 논란, 사생활 쟁점, MCP(AI 에이전트가 외부 도구를 부르는 연결 규약), 점검표 순서예요.

한 줄 답: README는 ESP32-S3 보드의 CSI로 사람의 존재와 자세를 추정한다고 내세웁니다. 같은 문서가 수치마다 지표와 한계를 따로 적었으니 숫자는 조건과 함께 읽고 시뮬레이션 데모와 실측부터 구분하세요.

RuView는 무엇이고 어떻게 동작한다고 하나요?

비유하면 방 안을 오가는 와이파이 전파는 연못의 잔물결 같아요. 사람이 움직이거나 숨을 쉬면 물결 모양이 미세하게 바뀝니다. CSI(채널 상태 정보)는 그 물결을 부반송파(주파수 칸)마다 기록한 측정값이에요.

RuView는 무엇이고 어떻게 동작한다고 하나요?RuView는 무엇이고 어떻게 동작한다고 하나요?

README는 ESP32-S3 보드에서 연결까지 4단계 흐름을 내세우지만, 같은 문서가 단계마다 단서를 함께 적어 둡니다

자료: github.com · QJC 재구성

README에 따르면 ESP32-S3 보드(와이파이 기능이 든 저가 칩 보드, README 표기 약 9달러)의 펌웨어가 수신 패킷에서 CSI를 뽑아 서버로 보냅니다. 서버의 신호 처리와 작은 모델이 존재, 움직임, 호흡, 심박, 자세를 추정하는 구조예요. CSI 추출 자체는 칩 제조사 Espressif의 공식 문서가 "Channel state information (CSI) refers to the channel information of a Wi-Fi connection."이라고 정의한 정식 기능입니다.

README가 같은 문서에 적은 조건도 있어요. 기능 표의 벽 너머 감지는 약 5m까지, 신호에 따라 다릅니다. 하드웨어 없이 돌리는 Docker 데모는 "The Docker image runs with simulated data for evaluation."라고 밝힌 대로 시뮬레이션 데이터를 씁니다. 일반 노트북 와이파이는 "Consumer WiFi laptops provide RSSI-only presence detection."라는 설명처럼 RSSI(수신 신호 세기)만 쓸 수 있어 대략적인 존재 여부만 나와요.

필요한 것은 CSI를 지원하는 보드입니다. README 하드웨어 표(2026-10-26 판)는 ESP32-S3 노드 1개를 약 9달러, 권장 구성인 Cognitum Seed 포함 세트를 약 140달러로 적었어요. ESP32-C3와 초기형 ESP32는 지원하지 않으며 노드를 한 대만 쓰면 공간 해상도가 제한돼 2대 이상을 권합니다.

내세우는 정확도 수치는 어떤 조건에서 나온 값인가요?

README와 모델 카드(모델 설명서)에 따르면 아래 네 수치는 지표도 조건도 다릅니다. 한 줄에 놓고 비교하면 안 돼요.

수치무엇을 잰 값조건문서가 밝힌 한계
철회한 100%예전 존재 감지 수치사람 한 명이 밤새 잔 단일 클래스 녹화, 6,063프레임 중 6,062프레임이 '있음'프로젝트가 스스로 철회. 무조건 '있음'이라 답하는 예측기도 99.98%가 나옴
82.3%사전학습 인코더 v2의 홀드아웃 temporal-triplet 정확도한 방, 녹화 하나, 노드 2대모델 카드는 임베딩 품질 지표이지 사람 감지·생체 정확도가 아니라고 밝힘
3.0%기기 안 17관절 자세 모델 pose_v1의 PCK@20217개 홀드아웃프로젝트 목표 35% 이상에 못 미침. 런타임은 confidence=0 스텁
82.69%공개 데이터셋 MM-Fi에서 RuView 자세 모델의 torso-PCK@20random_split(데이터를 무작위로 나눈 in-domain 평가)처음 보는 사람 기준 약 64%. 라이브 ESP32 한 대 수치가 아님

용어를 풀어 둘게요. 홀드아웃은 학습에 쓰지 않고 따로 떼어 둔 평가 데이터, temporal-triplet은 시간상 가까운 프레임을 더 가깝게 놓는지 보는 지표예요. PCK@20은 예측한 관절이 정답 위치에서 기준 거리 안에 든 비율, in-domain은 같은 데이터셋 안에서 나눠 잰 평가를 뜻합니다.

가장 헷갈리는 값은 82.3%입니다. README 표는 이 수치를 Presence 행에 적지만 모델 카드는 "measures embedding quality, not downstream presence/vitals accuracy"라고 밝혀요. 사람 감지 정확도가 아니라 인코더 지표로 읽어야 합니다.

82.69%는 공개 데이터셋 MM-Fi를 무작위로 나눈 in-domain 값입니다. README는 이를 "not a live single-ESP32 number"라고 구분해요. 현장 성능으로 읽으면 안 됩니다.

심박과 호흡은 프로젝트가 내세우는 기능입니다. README 안전 항목은 "Device-reported vitals are labelled as unvalidated."라고 적고 모델 카드는 진단용이 아니라고 밝혀요.

재현 논란은 어떻게 흘러갔고 프로젝트는 어떻게 답했나요?

문서가 스스로 낮춘 수치 뒤에는 재현 논란이 있었어요. 날짜는 UTC 기준입니다.

  • 2026-02-28에 저장소 소유자가 이슈 #37에 "No, this is not fake. Yes, it actually works. Read the docs."라고 썼습니다. 소유자는 하드웨어 문제라고 반박했어요.
  • 2026-05-07에 이슈 #509에서 한 사용자가 ESP32-S3 4대로 17관절 자세 재현에 실패했다고 보고했습니다. 펌웨어와 서버는 실제로 돌지만 AI 부분에 학습된 가중치가 없다는 분석이었어요.
  • 2026-06-17에 이슈 #1125가 "Has anyone got this project to work?"라는 제목으로 동작 증언을 구했습니다.
  • 2026-07-21에 프로젝트가 결정 기록 ADR-187을 채택해 모델을 세 등급(실제로 있고 검증된 것, 실제로 있지만 약한 것, 구조만 있고 가중치가 없는 것)으로 나눠 표기하기로 했어요.

재현 의문이 제기됐고 프로젝트가 정직 표기로 대응한 경과예요. ADR-187은 라이브 ESP32 자세 기능을 첫 시도, 목표 미달, 런타임 스텁이라는 단서 없이 홍보하지 않기로 했습니다. 문서가 내세운 원칙은 "Read the label, not the headline"입니다. 헤드라인 말고 라벨을 읽으라는 뜻이죠.

벽 너머 감지와 심박 추정은 사생활에 어떤 문제가 있나요?

벽 너머 재실 여부, 잠든 상태, 심박·호흡 추정치는 사생활 정보입니다. 한국 개인정보 보호법 제23조(2026-09-11 시행 판)는 건강에 관한 정보를 민감정보로 정해 처리를 제한해요. 특정 사례가 걸리는지는 이 글이 판단하지 않고 도입 전 검토 대상으로만 짚습니다.

홈어시스턴트(스마트홈 허브 소프트웨어) 연동 문서(2026-10-12 판)에 따르면 privacy-mode는 심박·호흡 값을 MQTT(기기끼리 주고받는 가벼운 메시지 규약) 전송과 녹화에서 뺍니다. 수면과 위급 가능성 상태는 서버 안에서 그 생체값으로 계산돼 켜짐·꺼짐 값이 그대로 나가요. 문서는 이 값도 건강 관련 정보라고 적습니다.

같은 문서에는 두 문장이 있어요. 하나는 "It is not a compliance certification, and RuView makes no HIPAA, GDPR or CCPA compliance claim."이고 다른 하나는 활용 예 표의 "no cameras, no privacy concerns"입니다. 두 문장이 한 문서에 함께 있다는 사실만 전합니다.

무선랜 감지는 IEEE 802.11bf-2025(2025-09-26 발행)로 국제 표준이 됐어요. RuView 사생활 연구 문서가 인용한 바로는 LeakyBeam(NDSS 2025)이 약 20m 떨어진 곳에서 벽 너머 재실 여부를 감지합니다.

AI 에이전트(MCP)를 연결하면 정확도도 올라가나요?

아니요. MCP는 에이전트가 장치 상태를 읽고 확인받은 명령을 실행하게 해 주는 운영 도구이지 감지 정확도를 올리는 기능이 아닙니다.

서버는 npx @ruvnet/ruview mcp start로 띄웁니다. 에이전트 연결 묶음인 하네스의 README(2026-10-29 판)에 따르면 읽기 도구는 별도 권한 없이 쓰이고 보정·학습은 workspace-write, 펌웨어 굽기는 hardware-write 권한과 각각 confirm:true가 있어야 돌아가요.

하네스는 "refuse to overstate accuracy"(정확도를 부풀리지 않는다)를 원칙으로 적고 근거 없는 정확도 주장을 걸러 내는 ruview_claim_check 도구를 둡니다. 걸러 내는 대상은 주장의 표기이지 센서가 읽는 값 자체가 아니에요.

써 보기 전에 무엇을 점검해야 하나요?

아래 여섯 가지를 먼저 따져 보세요.

  1. 시뮬레이션 데모부터 구분하세요. 이슈 #509 작성자는 하드웨어를 뽑아도 뼈대가 움직이는 현상을 시뮬레이션 대체 경로로 설명했어요.
  2. CSI 지원 하드웨어인지 확인하세요. ESP32-S3나 연구용 카드가 필요하고 노트북 와이파이는 RSSI만 나옵니다.
  3. 수치는 지표와 함께 읽으세요. 82.3%는 인코더 지표입니다. 82.69%는 공개 데이터셋 벤치마크 값이에요. 3.0%는 기기 안 자세 모델의 PCK@20입니다.
  4. 모델 파일과 문서 상태를 직접 보세요. 이슈 #1522에 따르면 허깅페이스(AI 모델 공유 사이트)의 model.safetensors 헤더 결함이 2026-08-03에 보고됐고 2026-11-11 기준 열려 있어요. 노드당 홈어시스턴트 기기 항목 수도 README는 21개, 연동 문서는 15개로 달라요.
  5. 내 공간과 동의한 사람만 대상으로 삼으세요. 업무나 돌봄 현장 도입이면 개인정보 담당자 검토를 먼저 받으세요.
  6. 상업 연관과 라이선스를 보세요. 권장 구성의 Cognitum Seed는 저장소 홈페이지(cognitum.one)에서 파는 제품이고, README 끝에는 추천으로 생긴 Cognitum 판매액의 25%를 주는 크리에이터 제휴 프로그램 안내가 있어요. 코드는 MIT지만 MM-Fi 자세 모델은 CC BY-NC 4.0(비상업)입니다.

마무리

RuView는 와이파이 센싱의 가능성과 한계를 같은 저장소 안에 함께 적어 둔 프로젝트예요. 저희 해석으로는 AI로 문서와 코드를 빠르게 만드는 시대일수록 별 수나 README 소제목보다 프로젝트가 직접 적은 한계 표와 측정 조건을 먼저 읽는 습관이 도구 선택의 실패를 줄입니다. 써 보기 전 점검표를 저장해 두세요.


자주 묻는 질문

노트북 와이파이만으로도 RuView가 되나요?

일부만 됩니다. README에 따르면 일반 노트북 와이파이는 RSSI만 쓸 수 있어 대략적인 존재 여부 정도만 나와요. 생체 신호나 벽 너머 감지 같은 고급 기능은 ESP32-S3 같은 CSI 지원 하드웨어가 필요하고 노드 1개는 README 표기 약 9달러예요.

82.3%는 사람을 82.3% 맞힌다는 뜻인가요?

아니요. 모델 카드에 따르면 82.3%는 사전학습 인코더 v2의 홀드아웃 temporal-triplet 정확도이며 한 방, 녹화 하나, 노드 2대에서 잰 임베딩 품질 지표입니다. 사람 감지나 생체 정확도가 아니에요.

RuView로 가족이나 직원을 감지해도 법적으로 문제없나요?

이 글은 위반 여부를 판단하지 않습니다. 개인정보 보호법 제23조는 건강에 관한 정보를 민감정보로 정하고 RuView 홈어시스턴트 문서도 규정 준수 주장을 하지 않는다고 밝혀요. 동의한 사람과 내 공간에서만 쓰고 업무·돌봄 도입이면 개인정보 담당자 검토를 먼저 받으세요.


참고 자료