Repolode
Enviar
karlomikus

karlomikus/bar-assistant

Servidor API autohospedado para gestionar un bar en casa, diseñado específicamente para recetas de cócteles, ingredientes e inventario.

Ver en GitHubSitio web
Estrellas
1,115
Forks
59
Issues abiertos
15
Último commit
anteayer

¿Qué es?

Bar Assistant es un backend autohospedado para organizar un bar en casa. A diferencia de los gestores de recetas de propósito general, está diseñado en torno a conceptos propios de los cócteles, como los sustitutos de ingredientes, los ingredientes base, el cálculo del ABV y la conversión de unidades. Incluye un catálogo de más de 500 recetas de cócteles y más de 250 ingredientes base con sus categorías.

Los usuarios pueden crear varios bares con miembros y roles, llevar un control de lo que tienen disponible y filtrar recetas por ABV, ingrediente base, etiquetas o disponibilidad de los ingredientes necesarios. Puede generar listas de compras a partir de los ingredientes que faltan y calcular el precio de los cócteles según el precio de sus ingredientes. Las recetas se pueden importar desde URLs, JSON, YAML o colecciones, y compartir mediante enlaces públicos o imprimir.

Este repositorio contiene únicamente el servidor API, distribuido como imagen de Docker. Usa Redis para la caché y las sesiones, y permite usar Meilisearch para las búsquedas. También ofrece un endpoint de métricas de Prometheus. Para disponer de una interfaz gráfica, se necesita un cliente web independiente, Salt Rim.

Funciones clave

  • 01Catálogo de más de 500 recetas de cócteles y más de 250 ingredientes base
  • 02Filtrado de recetas según el inventario y generación de listas de compras
  • 03Sustitutos de ingredientes, variaciones, calificaciones y notas personalizadas
  • 04Varios bares con miembros, roles de usuario y tokens de acceso personal
  • 05Importación de recetas desde URLs, JSON, YAML o colecciones
  • 06Cálculo automático del precio de los cócteles según el precio de los ingredientes
  • 07Inicio de sesión único (SSO) opcional y búsquedas con Meilisearch

Casos de uso

  • Llevar un control de las bebidas alcohólicas y mezcladores que tienes en casa y encontrar cócteles que puedes preparar
  • Generar una lista de compras para una fiesta de cócteles o para preparar una receta nueva
  • Gestionar la carta de un bar en casa o compartir recetas con amigos mediante enlaces públicos
  • Autohospedar una API de recetas de cócteles para conectarla con un frontend personalizado u otras integraciones

Inicio rápido

  1. 1

    Descarga la imagen de Docker (especifica una etiqueta de versión; no hay etiqueta latest).

    docker pull barassistant/server:v4
  2. 2

    Ejecuta el servidor con la imagen de Docker y configura las variables de entorno según sea necesario.

Antes de usarlo

  • Requiere Redis y, opcionalmente, Meilisearch, por lo que el autoalojamiento implica varios servicios.
  • Es solo el servidor de API; para disponer de una interfaz web se necesita un cliente independiente, como Salt Rim.

En colecciones

Apps autoalojadas

Temas

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

Preguntas frecuentes

¿Qué es bar-assistant?
Servidor API autohospedado para gestionar un bar en casa, diseñado específicamente para recetas de cócteles, ingredientes e inventario. Bar Assistant es un backend autohospedado para organizar un bar en casa. A diferencia de los gestores de recetas de propósito general, está diseñado en torno a conceptos propios de los cócteles, como los sustitutos de ingredientes, los ingredientes base, el cálculo del ABV y la conversión de unidades. Incluye un catálogo de más de 500 recetas de cócteles y más de 250 ingredientes base con sus categorías.
¿bar-assistant es gratuito? ¿Qué licencia tiene?
bar-assistant es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿bar-assistant sigue mantenido?
Mantenimiento activo. El último commit de bar-assistant fue el 4 nov 2026.
¿Para qué puedo usar bar-assistant?
Llevar un control de las bebidas alcohólicas y mezcladores que tienes en casa y encontrar cócteles que puedes preparar Generar una lista de compras para una fiesta de cócteles o para preparar una receta nueva Gestionar la carta de un bar en casa o compartir recetas con amigos mediante enlaces públicos Autohospedar una API de recetas de cócteles para conectarla con un frontend personalizado u otras integraciones
¿Cómo se instala bar-assistant?
Descarga la imagen de Docker (especifica una etiqueta de versión; no hay etiqueta latest).: docker pull barassistant/server:v4 Ejecuta el servidor con la imagen de Docker y configura las variables de entorno según sea necesario.
¿Dónde consigo bar-assistant?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/karlomikus/bar-assistant

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados