{"id":13622192,"url":"https://github.com/karlomikus/bar-assistant","last_synced_at":"2026-03-08T12:05:45.543Z","repository":{"id":62463847,"uuid":"545016751","full_name":"karlomikus/bar-assistant","owner":"karlomikus","description":"Bar assistant is a all-in-one solution for managing your home bar","archived":false,"fork":false,"pushed_at":"2024-05-22T15:51:33.000Z","size":119661,"stargazers_count":401,"open_issues_count":14,"forks_count":20,"subscribers_count":7,"default_branch":"develop","last_synced_at":"2024-05-22T16:27:11.136Z","etag":null,"topics":["api","bar","cocktails","home","php","recipes","rest"],"latest_commit_sha":null,"homepage":"https://barassistant.app","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/karlomikus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-03T16:30:46.000Z","updated_at":"2024-06-01T14:46:30.989Z","dependencies_parsed_at":"2024-03-16T12:28:23.530Z","dependency_job_id":"e67a4297-f0cd-46e4-899e-cf7523db7e0c","html_url":"https://github.com/karlomikus/bar-assistant","commit_stats":null,"previous_names":[],"tags_count":92,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karlomikus%2Fbar-assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karlomikus%2Fbar-assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karlomikus%2Fbar-assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karlomikus%2Fbar-assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/karlomikus","download_url":"https://codeload.github.com/karlomikus/bar-assistant/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247415967,"owners_count":20935387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","bar","cocktails","home","php","recipes","rest"],"created_at":"2024-08-01T21:01:15.428Z","updated_at":"2026-03-08T12:05:45.538Z","avatar_url":"https://github.com/karlomikus.png","language":"PHP","funding_links":["https://www.paypal.com/ncp/payment/9L8T4YJZBRXAS"],"categories":["PHP","置顶","Drinks \u0026 Cocktails"],"sub_categories":["08、家庭与物联网"],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://barassistant.app\" target=\"_blank\"\u003e\u003cimg src=\"resources/art/readme-logo.png\" alt=\"Bar assistant Logo\" width=\"500\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://img.shields.io/docker/v/barassistant/server?style=for-the-badge\u0026sort=semver\" alt=\"Docker image\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/karlomikus/bar-assistant?style=for-the-badge\" alt=\"Docker image\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/karlomikus/bar-assistant/php.yml?branch=master\u0026style=for-the-badge\u0026label=Tests\" alt=\"Tests\"\u003e\n    \u003ca href=\"https://hub.docker.com/r/barassistant/server\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/barassistant/server?style=for-the-badge\" alt=\"Pulls\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## 🍸 Bar Assistant\n\nBar Assistant is all-in-one solution for managing your home bar. Compared to other recipe management software that usually tries to be more for general use, Bar Assistant is made specifically for managing cocktail recipes. This means that there are a lot of cocktail-oriented features, like ingredient substitutes, first-class ingredients, ABV calculations, unit switching and more.\n\nThis 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).\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://demo.barassistant.app/bar/docs\" target=\"_blank\"\u003eClick here to view API demo.\u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://demo.barassistant.app\" target=\"_blank\"\u003eClick here to view frontend demo.\u003c/a\u003e\n    \u003cbr\u003e\n    \u003cstrong\u003eEmail:\u003c/strong\u003e admin@example.com \u0026middot; \u003cstrong\u003ePassword:\u003c/strong\u003e password\n\u003c/p\u003e\n\n## Features\n- [Includes over 500 cocktail recipes with detailed information](https://github.com/bar-assistant/data)\n- Includes over 250 base ingredients with categories\n- Add and manage multiple bars and bar members\n- Fine-grained user control with user roles\n- Endpoints for managing and filtering ingredients and cocktails\n- Filter recipes by ABV, base ingredient, tags and more\n- Filter recipes based on whether you have the right ingredients or not\n- Detailed cocktail and ingredient information\n- Support for assigning multiple images to resources and image sorting\n- Shopping list generation based on missing ingredients in your inventory\n- Automatic indexing of data with Meilisearch\n- Support for custom cocktail ingredient substitutes\n- Support for glass types, utensils, tags, ingredient categories and more\n- Cocktail recipe importing via URL, JSON, YAML or custom collections\n- Support for cocktail ratings\n- Support for cocktail variations\n- Create user-specific cocktail collections for easy referencing and sharing\n- Support for cocktail and ingredient notes\n- Supports sharing recipes by public links, custom recipe images and printing\n- Create public bar menus\n- Manage custom API personal access tokens with custom permissions set by users\n- Detailed statistics about recipes and user tastes\n- Data export support in various formats\n- Support for multiple ingredient prices\n- Automatic cocktail price calculation based on ingredients\n- Single sign-on (SSO) support\n- Recipe recommendations based on your favorites and tags\n\n## Documentation\n\n[Documentation is available here.](https://docs.barassistant.app/)\n\n## Container images\n\nBar Assistant is available as a Docker image on [Docker Hub](https://hub.docker.com/r/barassistant/server) and [GitHub Container Registry](https://github.com/karlomikus/bar-assistant/pkgs/container/barassistant). There is no `latest` tag, so you need to specify version in the tag. For example:\n\n- `barassistant/server:v4.4.1` - This will pull the exact version\n- `barassistant/server:v4.4` - This will pull the latest minor release\n- `barassistant/server:v4` - This will pull the latest major release\n- `barassistant/server:dev` - This will pull the latest development version (not recommended for production)\n\nWe recommend that you always use the latest major release, as it will always be the most stable version.\n\n## Environment Variables\n\nHere's a list of interesting environment variables you can set to configure Bar Assistant:\n\n|Name|Default|Description|\n|----|-------|-----------|\n|REDIS_HOST|redis|The Redis host.|\n|CACHE_DRIVER|redis|The cache driver to use (`file` or `redis`).|\n|SESSION_DRIVER|redis|The session driver to use (`file` or `redis`).|\n|ALLOW_REGISTRATION|true|Allow or disallow user registration.|\n|MAIL_REQUIRE_CONFIRMATION|false|Require email confirmation for new user registrations.|\n|MEILISEARCH_HOST||The Meilisearch host URL.|\n|MEILISEARCH_KEY||The Meilisearch API key.|\n|METRICS_ENABLED|false|Enable or disable Prometheus metrics endpoint.|\n|METRICS_ALLOWED_IPS||Comma-separated list of IPs allowed to access metrics endpoint.|\n|ENABLE_PASSWORD_LOGIN|true|Enable or disable password login.|\n|SCRAPING_HTTP_PROXY||HTTP proxy URL for web scraping.|\n|SCRAPING_CLIENT_CERT||Path to client certificate for web scraping.|\n|MAIL_MAILER||The mailer to use.|\n|MAIL_HOST||The mail host.|\n|MAIL_PORT||The mail port.|\n|MAIL_ENCRYPTION||The mail encryption method.|\n|MAIL_USERNAME||The mail username.|\n|MAIL_PASSWORD||The mail password.|\n|GEN_AI_PROVIDER||Identifier of LLM provider. Supports any provider that PrismPHP supports.|\n|GEN_AI_MODEL||Specific model to use from the provider.|\n|GEN_AI_TIMEOUT|60|Timeout for LLM provider requests in seconds.|\n\n## Managed instance\n\nBar Assistant will always be open-source and MIT-licensed, but if you want to support the project or don't want to self-host, you can try our official managed instance. Visit [barassistant.app](https://barassistant.app/) for more information about our cloud offering.\n\n![Cloud offering screenshot](/resources/art/art1.png)\n\n## 3rd Party Integrations\n\nThere's an [unofficial Raycast extension](https://www.raycast.com/stupifier/barassistant) maintained by a [community member](https://github.com/zhdenny).\n\n## Contributing\n\nContributions Welcome!\n\nFor more details, see [CONTRIBUTING.md](/CONTRIBUTING.md).\n\n## Support and Donations\n\nBar Asistant is free, but maintaining any open source project takes time and resources. If you find Bar Assistant valuable and want to support its future development, consider donating.\n\n[Donate with PayPal](https://www.paypal.com/ncp/payment/9L8T4YJZBRXAS)\n\n## License\n\nThe Bar Assistant API is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarlomikus%2Fbar-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkarlomikus%2Fbar-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarlomikus%2Fbar-assistant/lists"}