https://github.com/karlomikus/bar-assistant

Bar assistant is a all-in-one solution for managing your home bar
https://github.com/karlomikus/bar-assistant

api bar cocktails home php rest

Last synced: about 2 months ago
JSON representation

Bar assistant is a all-in-one solution for managing your home bar

• Host: GitHub
• URL: https://github.com/karlomikus/bar-assistant
• Owner: karlomikus
• License: mit
• Created: 2022-10-03T16:30:46.000Z (over 1 year ago)
• Default Branch: develop
• Last Pushed: 2024-04-07T13:41:33.000Z (about 2 months ago)
• Last Synced: 2024-04-08T09:36:06.372Z (about 2 months ago)
• Topics: api, bar, cocktails, home, php, rest
• Language: PHP
• Homepage: https://barassistant.app
• Size: 113 MB
• Stars: 355
• Watchers: 7
• Forks: 19
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Security: SECURITY.md

Lists

• awesome-selfhosted - Bar Assistant - Bar assistant is a self hosted application for managing your home bar. It allows you to add your ingredients, search for cocktails and create custom cocktail recipes. ([Demo](https://bar.karlomikus.com/)) `MIT` `PHP/Docker` (Software / Recipe Management)
• awesome-stars - karlomikus/bar-assistant - Bar assistant is a all-in-one solution for managing your home bar (PHP)
• awesome-stars - karlomikus/bar-assistant - Bar assistant is a all-in-one solution for managing your home bar (PHP)
• awesome-stars - karlomikus/bar-assistant - Bar assistant is a all-in-one solution for managing your home bar (PHP)
• fucking-awesome-selfhosted - Bar Assistant - Bar assistant is a self hosted application for managing your home bar. It allows you to add your ingredients, search for cocktails and create custom cocktail recipes. 🌎 [Demo](bar.karlomikus.com/)) `MIT` `PHP/Docker` (Software / Recipe Management)
• awesome-selfhosted - Bar Assistant - Bar assistant is a self hosted application for managing your home bar. It allows you to add your ingredients, search for cocktails and create custom cocktail recipes. ([Demo](https://bar.karlomikus.com/)) `MIT` `PHP/Docker` (Software / Recipe Management)

README

        


    





    

    

    



## 🍸 Bar Assistant

Bar Assistant is a self hosted application for managing your home bar. It allows you to search and filter cocktails, add ingredients and create custom cocktail recipes.

This repository only contains the API server, if you are looking for easy to use web client, take a look at [Salt Rim](https://github.com/karlomikus/vue-salt-rim).



    Click here to view API demo.

    


    Click here to view frontend demo.

    


    Email: [email protected] · Password: password



## Features

- [Includes over 300 cocktail recipes with detailed information](https://github.com/bar-assistant/data)

- Includes over 150 base ingredients with categories

- Add and manage multiple bars and bar members

- Fine-grained user control with user roles

- Endpoints for managing and filtering ingredients and cocktails

- Filter recipes by ABV, base ingredient, tags and more

- Filter recipes based on whether you have the right ingredients or not

- Detailed cocktail and ingredient information

- Support for assigning multiple images to resources and image sorting

- Shopping list generation based on missing ingredients in your inventory

- Automatic indexing of data with Meilisearch

- Support for custom cocktail ingredient substitutes

- Support for glass types, utensils, tags, ingredient categories and more

- Cocktail recipe importing via URL, JSON, YAML or custom collections

- Support for cocktail ratings

- Create user-specific cocktail collections for easy referencing and sharing

- Support for cocktail and ingredient notes

- Supports sharing recipes by public links, custom recipe images and printing

- Create public bar menus

- Manage custom API personal access tokens with custom permissions set by users

- Detailed statistics about recipes and user tastes

## Cloud

Visit [barassistant.app](https://barassistant.app/) for more information about our cloud offering.

![Cloud offering screenshot](/resources/art/art1.png)

## Documentation

[Documentation is available here.](https://bar-assistant.github.io/docs/)

## Contributing

Contributions Welcome!

For more details, see [CONTRIBUTING.md](/CONTRIBUTING.md).

## License

The Bar Assistant API is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).