Home
NAMO Ain't Motion-Only.
Still here, even when you're still.
NAMO is a fully local mmWave spatial presence platform with live floorplan tracking, visual detection zones, multi-device coordinate fusion, and Home Assistant integration.
NAMO는 실시간 평면도 추적, 시각적 감지 구역, 다중 기기 좌표 융합과 Home Assistant 연동을 제공하는 완전 로컬 방식의 mmWave 공간 재실 플랫폼입니다.
| English | 한국어 | |
|---|---|---|
| First setup | Getting started | 시작하기 |
| Use the dashboard | Dashboard guide | 대시보드 사용법 |
| Set up a floorplan | Floorplan setup | 평면도 만들기와 편집 |
| Configure detection | Zone settings | 구역 설정과 오탐 조정 |
| Connect multiple devices | Multi-device setup | 다중 기기 연결과 좌표 융합 |
| Connect Home Assistant | Home Assistant integration | Home Assistant 연동 |
| Update or recover | Firmware, backup, and recovery | 펌웨어·백업·복구 |
| Solve a problem | Troubleshooting and FAQ | 문제 해결과 FAQ |
| Try without hardware | Open the dashboard demo | 대시보드 데모 열기 |
| Install firmware | Download the latest release | 최신 릴리즈 다운로드 |
| Build the hardware | Hardware and wiring | 하드웨어와 배선 |
| Place the radar | Radar placement | 레이더 설치 위치와 환경 |
| Check compatibility | Compatibility and limits | 호환성과 알려진 제한 |
| Understand system state | Status and terminology | 상태와 용어 |
| Secure the network | Network and security | 네트워크와 보안 |
| Develop or contribute | Developer guide | 개발자 안내 |
| Browse the source | NAMO repository | NAMO 저장소 |
For a first installation, use the factory image from GitHub Releases and flash it over USB with ESPHome Web. Use the ota image only when updating an installed NAMO device from its web dashboard.
최초 설치에는 GitHub Releases의 factory 이미지를 사용하여 ESPHome Web에서 USB로 설치하세요. 이미 설치된 NAMO 기기를 웹 대시보드에서 업데이트할 때만 ota 이미지를 사용하세요.
- Tracks up to three radar targets and displays them on a live radar map.
- Places radar observations on a shared floorplan with rooms, walls, doors, furniture, and user-defined zones.
- Combines observations from up to seven NAMO devices in one Fusion Group without requiring a cloud service.
- Supports secure device pairing, position calibration, role handover, and standalone sensing when distributed authority is unavailable.
- Integrates with Home Assistant while keeping sensing and coordination on the local network.
- Uses an optional LD2410C to help maintain an already established presence session when the primary radar loses a motionless person.
The reference hardware uses:
- Seeed Studio XIAO ESP32S3 with 8 MB Flash and 8 MB PSRAM
- LD2450-series radar
- Optional LD2410C presence-assist radar
- Optional PIR, ambient-light, temperature, and humidity sensors
The current public firmware and hardware files target this reference configuration. Review the hardware guide before changing pins, power, radar models, or board variants.
현재 공개 펌웨어와 하드웨어 파일은 위 기준 구성을 대상으로 합니다. 핀, 전원, 레이더 모델이나 보드 종류를 변경하기 전에는 반드시 하드웨어 제작 안내를 확인하세요.
NAMO v0.5.5 is a public beta. Core standalone sensing, floorplan workflows, secure pairing, calibration, authenticated observation transport, and fixed-memory fusion are implemented. Five-device pairing and physical role-handover scenarios have been tested; broader physical installation and rolling-upgrade matrices remain ongoing.
NAMO v0.5.5는 공개 베타입니다. 단독 감지, 평면도 설정, 보안 페어링, 위치 보정, 인증된 관찰 전송과 고정 메모리 좌표 융합이 구현되어 있습니다. 5대 환경의 페어링과 역할 승계 실기기 테스트를 완료했으며, 더 다양한 설치 환경과 순차 업데이트 검증은 계속 진행 중입니다.
The Wiki will contain installation and usage guides. Exact implementation contracts remain versioned with the source code:
- Documentation index / 문서 인덱스
- Platform architecture / 플랫폼 아키텍처
- Implementation roadmap / 구현 로드맵
- HTTP API contract / HTTP API 계약
- Firmware signing / 펌웨어 서명
Never expose a NAMO device directly to the public internet. NAMO is designed for trusted local-network use. Do not publish its dashboard or API through port forwarding, DMZ, a public IP address, a public reverse proxy, or an internet tunnel; HTTPS alone does not make direct exposure safe. Use a VPN to reach the trusted LAN when remote access is required. Each device should use its own ESPHome API encryption key, and firmware images built with private Wi-Fi credentials or personal keys must not be redistributed.
Read Network and security before connecting NAMO to a segmented network or configuring remote access.
NAMO 기기를 공개 인터넷에 절대로 노출하지 마세요. NAMO는 신뢰할 수 있는 로컬 네트워크 사용을 전제로 설계되었습니다. 포트 포워딩, DMZ, 공인 IP 직접 연결, 공개 리버스 프록시 또는 인터넷 터널로 대시보드와 API를 공개하면 안 되며, HTTPS만 적용한다고 안전해지지 않습니다. 원격 접속에는 신뢰할 수 있는 LAN으로 연결되는 VPN을 사용하세요. 기기마다 별도의 ESPHome API 암호화 키를 사용하고, 개인 Wi-Fi 정보나 개인 키가 포함된 펌웨어 이미지를 배포하지 마세요.
분리된 네트워크나 원격 접속을 구성하기 전에 네트워크와 보안을 읽으세요.