Repolode
Enviar
karlomikus

karlomikus/bar-assistant

Servidor de API auto-hospedado para gerenciar um bar em casa, desenvolvido especificamente para receitas de coquetéis, ingredientes e estoque.

Ver no GitHubSite
Estrelas
1,116
Forks
59
Issues abertas
15
Último commit
anteontem

O que é?

O Bar Assistant é um backend auto-hospedado para organizar um bar em casa. Ao contrário dos gerenciadores de receitas genéricos, ele foi desenvolvido para conceitos específicos de coquetéis, como substitutos de ingredientes, ingredientes-base, cálculos de teor alcoólico (ABV) e conversão de unidades. Ele inclui um catálogo com mais de 500 receitas de coquetéis e mais de 250 ingredientes-base categorizados.

Os usuários podem criar vários bares com membros e funções, acompanhar o que têm em estoque e filtrar receitas por ABV, ingrediente-base, tags ou pela disponibilidade dos ingredientes necessários. A ferramenta pode gerar listas de compras com os itens que faltam e calcular o preço dos coquetéis com base nos preços dos ingredientes. É possível importar receitas de URLs, JSON, YAML ou coleções, além de compartilhá-las por links públicos ou impressão.

Este repositório contém apenas o servidor de API, distribuído como uma imagem Docker. Ele usa Redis para cache e sessões e, opcionalmente, Meilisearch para buscas, além de oferecer um endpoint de métricas do Prometheus. Para ter uma interface gráfica, é necessário usar o cliente web separado, Salt Rim.

Recursos principais

  • 01Catálogo com mais de 500 receitas de coquetéis e mais de 250 ingredientes-base
  • 02Filtros de receitas com base no estoque e geração de listas de compras
  • 03Substitutos e variações personalizadas de ingredientes, avaliações e notas
  • 04Vários bares com membros, funções de usuário e tokens de acesso pessoal
  • 05Importação de receitas de URLs, JSON, YAML ou coleções
  • 06Cálculo automático do preço dos coquetéis com base nos preços dos ingredientes
  • 07Login único (SSO) opcional e buscas com tecnologia Meilisearch

Casos de uso

  • Controlar quais destilados e misturadores você tem em casa e encontrar drinques que pode preparar
  • Gerar uma lista de compras para uma festa com coquetéis ou para preparar uma nova receita
  • Gerenciar o cardápio de um bar em casa ou compartilhar receitas com amigos por links públicos
  • Hospedar sua própria API de receitas de coquetéis para usar com um frontend personalizado ou integrações

Início rápido

  1. 1

    Baixe a imagem Docker (especifique uma tag de versão; não há tag latest).

    docker pull barassistant/server:v4
  2. 2

    Execute o servidor com a imagem Docker e configure as variáveis de ambiente conforme necessário.

Antes de usar

  • Requer Redis e, opcionalmente, Meilisearch, portanto a hospedagem própria envolve vários serviços.
  • É apenas o servidor de API; para ter uma interface web, é necessário um cliente separado, como o Salt Rim.

Em coleções

Apps auto-hospedados

Tópicos

#cocktails#recipes#home-bar#php#rest-api#self-hosted#docker#inventory#api#bar

Perguntas frequentes

O que é bar-assistant?
Servidor de API auto-hospedado para gerenciar um bar em casa, desenvolvido especificamente para receitas de coquetéis, ingredientes e estoque. O Bar Assistant é um backend auto-hospedado para organizar um bar em casa. Ao contrário dos gerenciadores de receitas genéricos, ele foi desenvolvido para conceitos específicos de coquetéis, como substitutos de ingredientes, ingredientes-base, cálculos de teor alcoólico (ABV) e conversão de unidades. Ele inclui um catálogo com mais de 500 receitas de coquetéis e mais de 250 ingredientes-base categorizados.
bar-assistant é gratuito? Qual é a licença?
bar-assistant é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
bar-assistant ainda é mantido?
Manutenção ativa. O último commit de bar-assistant foi em 5 de nov. de 2026.
Para que posso usar bar-assistant?
Controlar quais destilados e misturadores você tem em casa e encontrar drinques que pode preparar Gerar uma lista de compras para uma festa com coquetéis ou para preparar uma nova receita Gerenciar o cardápio de um bar em casa ou compartilhar receitas com amigos por links públicos Hospedar sua própria API de receitas de coquetéis para usar com um frontend personalizado ou integrações
Como instalar bar-assistant?
Baixe a imagem Docker (especifique uma tag de versão; não há tag latest).: docker pull barassistant/server:v4 Execute o servidor com a imagem Docker e configure as variáveis de ambiente conforme necessário.
Onde consigo bar-assistant?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/karlomikus/bar-assistant

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

Projetos relacionados