Repolode
keptinventory

keptinventory/kept

Um app de inventário self-hosted para acompanhar o que você tem, onde está e sua documentação, com mapa 3D dos locais e servidor MCP integrado.

Alternativa open source a:SortlyHomebox

Estrelas
512
Forks
35
Issues abertas
34
Último commit
há 3 horas

O que é?

Kept é um inventário open source e self-hosted para casas, garagens e depósitos. Ele registra locais, cômodos, prateleiras, caixas e o que há dentro delas, além de recibos, manuais, garantias e histórico. Os dados ficam no seu próprio servidor, sem telemetria e com a verificação de atualizações desativada por padrão.

O app oferece um mapa 3D dos locais, etiquetas com IDs curtos e QR codes que abrem a caixa correspondente quando escaneados, além de uma instalação adaptada para dispositivos móveis que funciona offline para registrar itens e fazer buscas. Provedores de IA opcionais, como OpenAI, Anthropic, Google, Ollama ou qualquer servidor compatível com OpenAI, podem sugerir detalhes dos itens, que o usuário confirma. Alterações feitas pelo assistente aguardam aprovação.

Kept também ajuda a cuidar da casa: locais compartilhados com funções, empréstimos, inventários, lembretes de garantia e manutenção, relatório para seguro e caixas de mudança numeradas. Inclui um servidor MCP em /mcp para conectar clientes de IA, backups noturnos criptografados em um diretório, S3 ou SFTP e importações do Homebox e de CSV. Pode ser implantado com Docker Compose ou pelo Helm chart para Kubernetes.

Recursos principais

  • 01Mapa 3D dos locais com andares, cômodos, prateleiras e caixas
  • 02Etiquetas com QR code e ID curto que abrem a caixa quando escaneadas
  • 03Cadastro de itens com auxílio de IA e escolha entre vários provedores, incluindo o Ollama local
  • 04Servidor MCP para conectar o Claude e outros agentes de IA
  • 05Backups noturnos criptografados em um diretório, S3 ou SFTP
  • 06Lembretes de garantia, manutenção e inventário

Casos de uso

  • Acompanhar ferramentas e suprimentos em uma garagem ou depósito
  • Registrar garantias, recibos e manuais junto dos itens a que se referem
  • Planejar e acompanhar uma mudança com caixas numeradas e escaneáveis
  • Gerenciar o inventário compartilhado de um homelab ou de uma casa com outras pessoas

Início rápido

  1. 1

    Baixe o arquivo compose.yaml

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

    Execute init para definir o endereço e gravar o .env

    docker compose run --rm init
  3. 3

    Inicie a stack

    docker compose up -d
  4. 4

    Abra o endereço, informe o código de configuração e crie a conta de administrador

Antes de usar

  • A licença é AGPL-3.0; portanto, se você permitir que outras pessoas executem versões modificadas, deverá oferecer o código-fonte a elas.
  • Os recursos de câmera, instalação do app, notificações push e localização exigem HTTPS, o que requer uma configuração adicional do Caddy.
  • A hospedagem própria requer Docker Compose e, no mínimo, 2 GB de RAM e 2 núcleos de CPU.

Em coleções

Tópicos

Perguntas frequentes

O que é kept?
Um app de inventário self-hosted para acompanhar o que você tem, onde está e sua documentação, com mapa 3D dos locais e servidor MCP integrado. Kept é um inventário open source e self-hosted para casas, garagens e depósitos. Ele registra locais, cômodos, prateleiras, caixas e o que há dentro delas, além de recibos, manuais, garantias e histórico. Os dados ficam no seu próprio servidor, sem telemetria e com a verificação de atualizações desativada por padrão.
kept é gratuito? Qual é a licença?
kept é open source sob a licença AGPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
kept ainda é mantido?
Manutenção ativa. O último commit de kept foi em 6 de nov. de 2026.
Para que posso usar kept?
Acompanhar ferramentas e suprimentos em uma garagem ou depósito Registrar garantias, recibos e manuais junto dos itens a que se referem Planejar e acompanhar uma mudança com caixas numeradas e escaneáveis Gerenciar o inventário compartilhado de um homelab ou de uma casa com outras pessoas
Como instalar kept?
Baixe o arquivo compose.yaml: mkdir kept && cd kept curl -fsSLO https://raw.githubusercontent.com/keptinventory/kept/v1.13.0/compose.yaml Execute init para definir o endereço e gravar o .env: docker compose run --rm init Inicie a stack: docker compose up -d Abra o endereço, informe o código de configuração e crie a conta de administrador
Onde consigo kept?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/keptinventory/kept

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados