EverShelf란?
EverShelf는 저장실에 무엇이 있는지, 언제 만료되는지, 다음에 무엇을 사야 하는지 기록하는 셀프 호스팅 웹 애플리케이션입니다. README는 이를 “self-hosted pantry manager — inventory, barcode scan, AI recipes, less waste”라고 소개합니다. PHP와 SQLite 데이터베이스, 싱글 페이지 프런트엔드로 만들어졌고 코드는 MIT 라이선스의 오픈소스입니다.
README에는 개발자 한 명, Stimpfl Daniel(GitHub: dadaloop82)이 표기되어 있으며 더 많은 기여자를 찾고 있습니다. Joshumi Technologies의 무관한 iOS 앱이 같은 이름을 쓰고 있는데, README는 아무 관련이 없다고 밝힙니다.
입수 방법
EverShelf는 직접 설치하는 서버입니다. 문서화된 방법은 Docker Compose이며, 휴대폰과 태블릿은 브라우저나 Android 키오스크 앱으로 접속합니다.
서버(Docker Compose)
- 입수 방법:
- README 빠른 시작: 저장소를 클론하고 .env.example을 .env로 복사한 뒤 docker compose up -d 실행
브라우저와 휴대폰
- 입수 방법:
- 브라우저에서 서버 주소를 엽니다(제공된 compose 파일에서는 포트 8080). 휴대폰에서는 홈 화면에 추가
Android 키오스크 태블릿
- 입수 방법:
- evershelf-kiosk.apk(버전 1.7.24, Android 7.0 이상)
Unraid
공식 웹사이트
- 입수 방법:
- evershelf.site
개인정보 안내
- 입수 방법:
- evershelf.site의 Privacy 섹션: 홈페이지의 짧은 설명이며 별도의 정책 문서는 찾지 못했습니다
소스 코드
데모
- 입수 방법:
- evershelf.site/demo, README에 따르면 AI가 포함되어 있음
확인한 버전: v1.16.16, GitHub 릴리스 기준으로 2026년 10월 25일에 공개되었고 저장소의 마지막 변경은 2026년 11월 1일입니다. 설치에는 터미널, Docker, 직접 편집하는 .env 파일이 필요하므로 더블클릭 설치가 아니라 개발자용 구성입니다. GitHub 릴리스 목록에는 Android 키오스크 APK만 있습니다.
요구 사항
출처에는 RAM이나 CPU 최소 사양이 없습니다. 명시된 조건은 Docker 또는 PHP 8.0 이상, 스캔용 카메라, AI용 제공업체 키 또는 Llama 서버입니다.
서버
- 출처의 설명:
- Docker와 Compose, 또는 쓰기 가능한 data/ 폴더가 있는 저장소 루트를 가리키는 PHP 8.0 이상 웹 서버
저장소
- 출처의 설명:
- 데이터 볼륨 안의 SQLite 데이터베이스. 내장 백업도 같은 볼륨에 저장되므로 다른 곳으로 복사해야 합니다
메모리와 CPU
- 출처의 설명:
- 읽은 출처에는 명시되어 있지 않음
카메라
- 출처의 설명:
- 바코드 스캔은 브라우저에서 기기 카메라를 사용(위키에 따르면 QuaggaJS)
키오스크
- 출처의 설명:
- Android 7.0(API 24) 이상. 블루투스 주방 저울 지원은 선택 사항
AI
- 출처의 설명:
- Gemini 또는 OpenAI API 키, 또는 Ollama, llama.cpp, vLLM 같은 OpenAI 호환 Llama 서버 주소
네트워크
- 출처의 설명:
- 신뢰할 수 있는 가정 내 네트워크를 전제로 설계됨. 인터넷에서 접속하려면 보안 정책상 자체 인증 계층이 필요합니다
이 항목들은 README, 위키, SECURITY.md에서 가져온 것이며 PromptQuorum은 리소스 사용량을 측정하지 않았습니다.
시작하는 방법
다음 단계는 프로젝트 README를 따른 것이며 PromptQuorum이 직접 실행하지는 않았습니다.
- 1코드와 설정 템플릿 가져오기
Why it matters: 저장소를 git clone한 다음 프로젝트 폴더에서 .env.example을 .env로 복사합니다. - 2AI 설정 고르기
Why it matters: .env에서 AI_ENABLED=false로 두면 AI 없이 쓸 수 있습니다. AI를 쓰려면 AI_PROVIDER를 gemini, openai, llama 중 하나로 설정하고 해당 키나 기본 URL을 추가합니다. - 3컨테이너 시작
Why it matters: docker compose up -d를 실행하고 http://localhost:8080을 엽니다. 나중에 업데이트할 때는 README에 docker compose pull 다음 docker compose up -d를 실행하라고 되어 있습니다. - 4기기 페어링
Why it matters: API_TOKEN을 설정하면 웹 화면에서 일회용 페어링 코드를 요구합니다. 이 코드는 이미 페어링된 기기의 설정, 시스템, 보안 메뉴 또는 서버 로그에 표시됩니다.
주요 기능
아래 항목은 모두 프로젝트의 README나 위키에서 가져온 것이며 PromptQuorum이 테스트한 것은 없습니다.
- 재고. 바코드 스캔, 보관 위치, 유통기한, 개봉한 제품, 즐겨찾기, CSV 가져오기와 내보내기.
- 장보기. 음식물 낭비를 줄이는 수량을 제안하는 스마트 장보기 목록, 가진 재료를 뺀 뒤 부족한 재료를 목록에 추가하는 레시피, 선택 사항인 Bring! 동기화.
- 요리. 음성 안내, 타이머, 낭비 제로 팁이 포함된 단계별 레시피.
- 알림과 캘린더. ntfy, JSON 웹훅, Home Assistant를 통한 유통기한 알림과 Google·Apple 캘린더용 ICS 피드.
- 연동. REST API, MCP 서버, 별도 저장소의 Home Assistant 연동, Fuel Mode가 있는 Health Bridge, 블루투스 저울 게이트웨이가 있는 Android 키오스크.
AI 기능과 실행 위치
AI 제공업체는 한 번에 하나만 활성화되며 .env에서 고릅니다. Gemini, OpenAI, 또는 직접 운영하는 OpenAI 호환 엔드포인트인 “llama”이고, AI를 끌 수도 있습니다.
- 상품 인식. AI는 카메라 사진으로 상품을 식별하며, Gemini 키가 있으면 다른 조회로 찾지 못한 바코드도 물어볼 수 있습니다.
- 유통기한. AI가 라벨 사진을 읽어 유통기한 칸을 채웁니다.
- 레시피와 채팅. AI는 저장실에 있는 재료로 레시피를 쓰고 채팅을 제공합니다. 레시피는 연결된 Mealie 인스턴스에서 가져올 수도 있습니다.
- 제공업체. 예시 설정에는 Gemini, 기본 URL과 모델을 바꿀 수 있는 OpenAI, Ollama·llama.cpp·vLLM용 Llama 옵션이 문서화되어 있습니다. 위키는 AI 기능을 Gemini 기준으로 설명하며 어떤 기능이 로컬 모델에서 동작하는지는 밝히지 않습니다.
- 비용 관리. 예시 파일에는 Gemini 분류 호출의 일일 상한이 있고 토큰 비용을 추정할 수 있습니다.
데이터 흐름과 개인정보
공식 사이트는 재고와 기록이 내 기기나 가정용 서버에 남고, AI는 선택 사항이며, 텔레메트리가 없다고 설명합니다. 아키텍처 문서에는 data 폴더의 SQLite 데이터베이스가 설명되어 있고, 보안 정책은 신뢰할 수 있는 가정 내 네트워크를 전제로 합니다.
출처에 언급된 외부 요청은 선택한 AI 제공업체(Llama 옵션이 아니라면 Gemini 또는 OpenAI), 알 수 없는 바코드를 위한 Open Food Facts, 가격 추정을 위한 Open Prices, 그리고 Bring!, ntfy, Google Drive 백업, PayPal 후원 링크 같은 선택 서비스입니다. 오류 보고서는 민감 정보를 가린 로컬 로그에 기록되며 GitHub로 보내는 것은 두 번째로 직접 켜야 하는 옵션입니다. README에 따르면 한 번만 표시되는 대화상자는 후원 또는 아무것도 하지 않기를 고르게 하며 광고는 표시되지 않습니다. 공개 데모는 클라우드 AI를 사용합니다.
📌참고: 이는 프로젝트의 선언일 뿐 감사 결과가 아닙니다. PromptQuorum은 네트워크 트래픽이나 소스 코드를 검사하지 않았습니다.
이런 분께 적합합니다
- Docker 서버나 NAS를 가진 셀프 호스팅 사용자로, 개인 저장실·유통기한 관리 도구가 필요한 분.
- 저장실에 있는 재료로 요리하는 가정으로, 공유 장보기 목록, 유통기한 알림, 있는 재료로 만든 레시피를 원하는 분.
- Home Assistant 사용자로, 유통기한과 장보기 데이터를 스마트홈이나 MCP로 연결한 에이전트에서 쓰고 싶은 분.
확인하지 못한 사항
- AI 품질. 상품 인식, 유통기한 읽기, 레시피 품질은 테스트하지 않았고, 어떤 AI 기능이 로컬 Llama 모델에서 동작하는지 출처에 나와 있지 않습니다.
- 성숙도. 프로젝트는 2026년 3월에 시작되었고 표기된 개발자는 한 명입니다. 안정성과 보안은 PromptQuorum이 평가하지 않았습니다.
- 보안 문서. SECURITY.md는 여전히 1.7.x를 지원 버전으로 적고 있어 현재 v1.16.16과 큰 차이가 있습니다.
- 데이터 관련 주장. “텔레메트리 없음”과 “데이터는 집에 남음”은 프로젝트의 설명이며 트래픽은 검사하지 않았습니다.
- 하드웨어 요구. 문서화된 RAM·CPU 최소 사양이 없고 Raspberry Pi 같은 소형 기기에서의 속도도 확인하지 않았습니다.
경쟁 제품과 대안
디렉터리에는 같은 스마트홈 계층의 다른 리뷰가 하나 있습니다. EverShelf가 연동을 제공하는 Home Assistant 안의 음성 어시스턴트입니다. 프로젝트 공식 사이트는 EverShelf를 Grocy, Mealie, KitchenOwl과 비교하는데, 이 저장실·레시피 관리 도구들은 디렉터리에 없고 PromptQuorum은 그 비교를 검증하지 않았습니다.
Home Assistant Assist
- 플랫폼:
- Home Assistant, 웹, iOS, Android
- 가격 / 라이선스:
- 무료 / Apache-2.0
- 핵심 차이점:
- 스마트홈 음성 제어용이며 저장실 관리 도구가 아님
Home Assistant Assist 관련 문서 (1개)
- Home Assistant Assist Review: Local Voice Control and LLM Agents업데이트 2026년 10월 24일
각 앱의 최신 가격, 라이선스, 플랫폼은 해당 앱의 공식 페이지에서 확인하세요.
자주 묻는 질문
EverShelf는 로컬 LLM인가요?
아니요. PHP로 작성된 저장실 관리 앱이며, AI는 Gemini, OpenAI 또는 직접 운영하는 Llama 서버에 맡깁니다. 공식 사이트에 따르면 저장실 기능은 AI 없이도 동작합니다.
데이터는 어떻게 백업하나요?
릴리스 노트에 따르면 매일 데이터베이스 스냅샷으로 백업이 실행되지만 데이터 볼륨 안에 저장되므로, 볼륨 밖으로 직접 복사해야 합니다.
Home Assistant나 AI 에이전트와 함께 쓸 수 있나요?
저장소에는 Home Assistant 연동(ha-evershelf)과 에이전트용 MCP 서버 링크가 있습니다. PromptQuorum은 둘 다 테스트하지 않았습니다.
휴대폰이나 태블릿에서 쓸 수 있나요?
브라우저에서 열어 홈 화면에 추가할 수 있고, Android 키오스크 앱은 벽걸이 태블릿용입니다. 공식 사이트와 README에는 App Store나 Google Play 페이지 링크가 없습니다.
인터페이스는 어떤 언어를 지원하나요?
README에는 이탈리아어, 영어, 독일어, 프랑스어, 스페인어, 중국어가 나와 있고, ?lang=de 같은 링크의 언어로 앱이 열립니다. 기여자가 translations/en.json을 번역하면 언어를 추가할 수 있습니다.
결론
EverShelf는 내가 관리하는 서버에서 저장실, 유통기한, 장보기를 관리할 수 있는 무료이며 업데이트가 활발한 방법으로, 상품 인식, 유통기한 라벨 읽기, 레시피 작성에 선택적으로 AI를 쓸 수 있습니다. 반면 설치에는 Docker와 직접 편집하는 .env 파일이 필요하고, 직접 Llama 서버를 설정하지 않으면 AI는 Gemini나 OpenAI에서 동작하며, 프로젝트는 1년이 채 안 되었고, AI와 개인정보 관련 주장은 여기서 확인할 수 없었습니다. 이미 집에서 서비스를 운영하는 가정에 어울리며, 더블클릭으로 설치하는 앱이나 언어 모델 어시스턴트를 원하는 분은 다른 곳을 찾아보는 편이 좋습니다.
출처
- EverShelf 공식 사이트 — 기능, FAQ, 개인정보 안내. 2026년 11월 1일 확인.
- GitHub의 EverShelf — README, 릴리스, 예시 설정, 보안 정책, 커밋 활동. 2026년 11월 1일 확인.
- 저장소 안의 EverShelf 위키 페이지 — 기능, 설치, AI 제공업체. 2026년 11월 1일 확인.
- EverShelf Android 키오스크 README — 버전, 최소 Android 수준, 다운로드. 2026년 11월 1일 확인.