keptinventory/kept

어떤 프로젝트인가요?

핵심 기능

• 01층, 방, 선반, 상자를 보여 주는 3D 위치 지도
• 02스캔하면 해당 상자를 여는 QR 코드 및 짧은 ID 라벨
• 03Ollama 등 제공자를 선택할 수 있는 AI 지원 물품 등록
• 04Claude 및 기타 AI 에이전트 연결을 위한 MCP 서버
• 05디렉터리, S3 또는 SFTP로 보내는 야간 암호화 백업
• 06보증, 유지보수 및 재고 조사 알림

활용 사례

• 차고나 창고에 있는 도구와 물품 관리
• 물품과 함께 관련 보증서, 영수증, 설명서 기록
• 번호가 매겨진 스캔 가능한 상자로 이사 계획 및 추적
• 다른 사용자와 홈랩 또는 가정의 공유 재고 관리

빠른 시작

1. 1

   compose.yaml 파일을 다운로드합니다

   mkdir kept && cd kept curl -fsSLO https://raw.githubusercontent.com/keptinventory/kept/v1.13.0/compose.yaml
2. 2

   init을 실행해 주소를 설정하고 .env를 작성합니다

   docker compose run --rm init
3. 3

   스택을 시작합니다

   docker compose up -d
4. 4

   주소를 열고 설정 코드를 입력한 다음 관리자 계정을 만듭니다

사용 전 알아둘 점

• !AGPL-3.0 라이선스에 따라 수정한 버전을 다른 사람이 실행하도록 제공하는 경우 소스 코드를 제공해야 합니다.
• !카메라, 앱 설치, 푸시 알림, 위치 기능에는 HTTPS가 필요하며, 이를 위해 Caddy를 추가로 설정해야 합니다.
• !셀프 호스팅에는 Docker Compose와 최소 2GB RAM 및 2개의 CPU 코어가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

kept은(는) 무엇인가요?

소유한 물건과 보관 위치, 관련 서류를 관리하는 셀프 호스팅 재고 관리 앱으로, 3D 위치 지도와 내장 MCP 서버를 제공합니다. Kept는 가정, 차고, 창고에서 사용할 수 있는 셀프 호스팅 오픈 소스 재고 관리 앱입니다. 위치, 방, 선반, 상자와 그 안에 든 물건을 기록하고, 영수증, 설명서, 보증서와 이력도 함께 관리합니다. 데이터는 자체 서버에 보관되며, 텔레메트리가 없고 업데이트 확인 기능은 기본적으로 꺼져 있습니다.

kept은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

kept은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

kept은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. kept의 마지막 커밋은 2026년 11월 6일입니다.

kept은(는) 어디에 사용할 수 있나요?

차고나 창고에 있는 도구와 물품 관리 물품과 함께 관련 보증서, 영수증, 설명서 기록 번호가 매겨진 스캔 가능한 상자로 이사 계획 및 추적 다른 사용자와 홈랩 또는 가정의 공유 재고 관리

kept는 어떻게 설치하나요?

compose.yaml 파일을 다운로드합니다: mkdir kept && cd kept curl -fsSLO https://raw.githubusercontent.com/keptinventory/kept/v1.13.0/compose.yaml init을 실행해 주소를 설정하고 .env를 작성합니다: docker compose run --rm init 스택을 시작합니다: docker compose up -d 주소를 열고 설정 코드를 입력한 다음 관리자 계정을 만듭니다

kept은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/keptinventory/kept