Самостоятельно размещаемый веб-сервис для учёта катушек филамента для 3D-принтера, их веса и расхода с интеграцией с OctoPrint и Klipper/Moonraker.
3 тыс.+25 за неделю320PythonMITАктивно поддерживаетсяОбновлён 3 дня назад
karlomikus/bar-assistant
API-сервер для самостоятельного хостинга и управления домашним баром, созданный специально для коктейльных рецептов, ингредиентов и запасов.
- Звёзды
- 1,117
- Форки
- 59
- Открытые issues
- 15
- Последний коммит
- позавчера
Что это?
Bar Assistant — это серверная часть для самостоятельного хостинга, которая помогает организовать домашний бар. В отличие от универсальных менеджеров рецептов, она учитывает специфику коктейлей: замены ингредиентов, базовые ингредиенты, расчёт ABV и конвертацию единиц измерения. В комплекте есть каталог из более чем 500 коктейльных рецептов и свыше 250 базовых ингредиентов, распределённых по категориям.
Пользователи могут создавать несколько баров с участниками и ролями, отслеживать запасы и фильтровать рецепты по ABV, базовому ингредиенту, тегам или наличию всех необходимых ингредиентов. Сервис формирует списки покупок на основе недостающих ингредиентов и рассчитывает стоимость коктейлей по ценам ингредиентов. Рецепты можно импортировать из URL, JSON, YAML или коллекций, а затем публиковать по общедоступным ссылкам или распечатывать.
В этом репозитории находится только API-сервер, распространяемый в виде Docker-образа. Для кэширования и сессий используется Redis, а для поиска можно подключить Meilisearch. Также доступна конечная точка с метриками Prometheus. Для графического интерфейса потребуется отдельный веб-клиент Salt Rim.
Ключевые возможности
- 01Каталог из более чем 500 коктейльных рецептов и свыше 250 базовых ингредиентов
- 02Фильтрация рецептов по запасам и формирование списков покупок
- 03Пользовательские замены ингредиентов, вариации, оценки и заметки
- 04Несколько баров, участники, роли пользователей и персональные токены доступа
- 05Импорт рецептов из URL, JSON, YAML или коллекций
- 06Автоматический расчёт стоимости коктейлей по ценам ингредиентов
- 07Дополнительные возможности: единый вход (SSO) и поиск на базе Meilisearch
Сценарии использования
- Отслеживание запасов алкоголя и миксеров дома и поиск коктейлей, которые можно приготовить
- Формирование списка покупок для коктейльной вечеринки или нового рецепта
- Управление меню домашнего бара или обмен рецептами с друзьями по общедоступным ссылкам
- Самостоятельный хостинг API коктейльных рецептов для собственного фронтенда или интеграции
Быстрый старт
- 1
Загрузите образ Docker (укажите тег версии — тега latest нет).
docker pull barassistant/server:v4 - 2
Запустите сервер с помощью образа Docker и при необходимости настройте переменные окружения.
Что важно знать
- Требуется Redis и, при необходимости, Meilisearch, поэтому для самостоятельного хостинга понадобится несколько сервисов.
- Это только API-сервер; для веб-интерфейса потребуется отдельный клиент, например Salt Rim.
В подборках
Темы
Частые вопросы
- Что такое bar-assistant?
- API-сервер для самостоятельного хостинга и управления домашним баром, созданный специально для коктейльных рецептов, ингредиентов и запасов. Bar Assistant — это серверная часть для самостоятельного хостинга, которая помогает организовать домашний бар. В отличие от универсальных менеджеров рецептов, она учитывает специфику коктейлей: замены ингредиентов, базовые ингредиенты, расчёт ABV и конвертацию единиц измерения. В комплекте есть каталог из более чем 500 коктейльных рецептов и свыше 250 базовых ингредиентов, распределённых по категориям.
- bar-assistant можно использовать бесплатно? Какая у него лицензия?
- bar-assistant распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
- bar-assistant всё ещё поддерживается?
- Активно поддерживается. Последний коммит в bar-assistant — 5 нояб. 2026 г..
- Для чего можно использовать bar-assistant?
- Отслеживание запасов алкоголя и миксеров дома и поиск коктейлей, которые можно приготовить Формирование списка покупок для коктейльной вечеринки или нового рецепта Управление меню домашнего бара или обмен рецептами с друзьями по общедоступным ссылкам Самостоятельный хостинг API коктейльных рецептов для собственного фронтенда или интеграции
- Как установить bar-assistant?
- Загрузите образ Docker (укажите тег версии — тега latest нет).: docker pull barassistant/server:v4 Запустите сервер с помощью образа Docker и при необходимости настройте переменные окружения.
- Где скачать bar-assistant?
- Исходный код и инструкции по установке — на GitHub: https://github.com/karlomikus/bar-assistant
Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.
Похожие проекты
Проверка TCP-портов с открытым исходным кодом, REST API и веб-интерфейсом; можно развернуть самостоятельно через Docker, проект создан на Litestar.
19810PythonGPL-3.0Активно поддерживаетсяОбновлён 6 дней назад
Самостоятельно размещаемый REST API для создания статичных картинок карт с маркерами, полигонами, окружностями, линиями и текстовыми наложениями.
1308TypeScriptOtherАктивно поддерживаетсяОбновлён 8 часов назад
Самостоятельно размещаемый менеджер рецептов и планировщик питания: импортирует рецепты по ссылкам и составляет списки покупок.
13,8 тыс.+86 за неделю1,7 тыс.PythonAGPL-3.0Активно поддерживаетсяОбновлён 3 часа назад
Самостоятельно размещаемый менеджер рецептов для хранения рецептов, планирования меню и составления списков покупок; устанавливается с помощью Docker.
8,7 тыс.+20 за неделю897HTMLOtherОбновлён 7 дней назад
Самостоятельно размещаемое приложение с рецептами для дома: планируйте меню, делитесь списками покупок и готовьте вместе в реальном времени.
1,5 тыс.+39 за неделю134TypeScriptAGPL-3.0Обновлён 6 часов назад