{"id":13477132,"url":"https://github.com/scheb/beer-analytics","last_synced_at":"2026-02-25T09:32:53.548Z","repository":{"id":37035546,"uuid":"290825313","full_name":"scheb/beer-analytics","owner":"scheb","description":"Analyzing the composition of beer recipes and visualize results in a human-friendly way 🕵️🍺","archived":false,"fork":false,"pushed_at":"2025-09-10T17:04:28.000Z","size":9364,"stargazers_count":45,"open_issues_count":1,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-10T20:31:37.835Z","etag":null,"topics":["analytics","beer","beer-analytics","beer-recipes","pandas","plotly","python"],"latest_commit_sha":null,"homepage":"https://www.beer-analytics.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/scheb.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-08-27T16:23:53.000Z","updated_at":"2025-09-10T17:04:31.000Z","dependencies_parsed_at":"2024-06-01T21:32:05.573Z","dependency_job_id":"8c40a768-e006-4308-9b95-14950c45a60a","html_url":"https://github.com/scheb/beer-analytics","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/scheb/beer-analytics","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scheb%2Fbeer-analytics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scheb%2Fbeer-analytics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scheb%2Fbeer-analytics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scheb%2Fbeer-analytics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/scheb","download_url":"https://codeload.github.com/scheb/beer-analytics/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scheb%2Fbeer-analytics/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29816070,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T05:36:42.804Z","status":"ssl_error","status_checked_at":"2026-02-25T05:36:31.934Z","response_time":61,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["analytics","beer","beer-analytics","beer-recipes","pandas","plotly","python"],"created_at":"2024-07-31T16:01:38.599Z","updated_at":"2026-02-25T09:32:53.510Z","avatar_url":"https://github.com/scheb.png","language":"Python","funding_links":["https://paypal.me/ChristianScheb"],"categories":["Python"],"sub_categories":[],"readme":"beer-analytics 🕵️🍺\n===================\n\n**Analyzing the composition of beer recipes and visualize results in a human-friendly way.**\n\nCheck out the live website: https://www.beer-analytics.com/\n\n\u003cp align=\"center\"\u003e\u003cimg alt=\"Logo\" src=\"screenshot.png\" width=\"480\" height=\"283\" /\u003e\u003c/p\u003e\n\nWhat is Beer Analytics?\n-----------------------\n\n*Beer Analytics* is a **database of beer brewing recipes**, built specifically for data analysis. It is made for beer\nenthusiasts and (home)brewers to provide detailed insights into brewing recipes, even when they're not an expert in data\nanalysis. The goal is to expand the knowledge how certain types of beer are typically brewed, ultimately helping\n(home)brewers to compose better recipes themselves, and potentially uncover some trends in craft/home brewing.\n\nThe project has two main components:\n\n1) a recipe database with (hopefully) reliable data (clean and normalized, reduce outliers and bad data)\n2) a user interface to execute data analysis (filtering, slicing and dicing) and to present results in a visually\n   appealing way\n\nApplication Setup\n-----------------\n\n### Requirements\n\n- Docker installed locally\n- [yarn](https://yarnpkg.com/) (JavaScript package manager) installed locally\n\n### Setup Steps\n\n- Install yarn dependencies: `yarn install`\n- Create a configuration file (see below)\n- Build and start the Docker container `docker compose up`\n- Jump into Docker container `docker exec -it beer_analytics_django bash`\n- Load initial data (known styles and ingredients) via `python manage.py load_initial_data`\n\n### Configuration\n\nProvide a `.env` file in the main folder. An example can be found in `.env.example`.\n\nPer default the application starts with \"dev\" settings, which is likely what you want. Use the `DJANGO_SETTINGS_MODULE`\nenvironment variable to use different settings according to the environment:\n\n```\n# Dev settings\nDJANGO_SETTINGS_MODULE=config.settings_dev\n\n# Production settings\nDJANGO_SETTINGS_MODULE=config.settings_prod\n```\n\nThe Docker container uses dev settings.\n\n### Development\n\nTo start the application for development run the Docker container\n\n`docker compose up`\n\nwhich starts a webserver at `localhost:8000`.\n\nIn a second terminal run\n\n`yarn start`\n\nto start the Webpack dev server to compile CSS and JS files.\n\nRecipe data\n-----------\n\nFor legal reasons the project does not come with any recipe data included. You have to retrieve and import recipe data \nfrom the sources you'd like to analyze.\n\nℹ️ It is planned to add a database with anonymized data samples at some point. Sorry for inconvenience.\n\n### Data Import\n\nRecipes can be imported via CLI in various formats. Each recipe must have a unique id assigned, which can be an\narbitrary string. The following recipe formats are supported with their respective commands:\n\n**[BeerXML](http://www.beerxml.com/)**:\n\n```bash\npython manage.py load_beerxml_recipe recipe.xml unique_id\n```\n\n**[MMUM format](https://www.maischemalzundmehr.de/):**\n\n```bash\npython manage.py load_mmum_recipe recipe.json unique_id\n```\n\n**[BeerSmith format](https://beersmithrecipes.com/):**\n\n```bash\npython manage.py load_beersmith_recipe recipe.bsmx unique_id\n```\n\n### Data Mapping\n\nOnce recipes are imported, they need to be mapped to the list of known styles and ingredients. Run the following\ncommands to execute the mapping. Any unmapped recipes will be processed:\n\n```\npython manage.py map_styles\npython manage.py map_hops\npython manage.py map_fermentables\npython manage.py map_yeasts\n```\n\nThese commands can be repeated any time and will process any recipes, which haven't been mapped yet. Please note that,\ndepending on the amount if recipes, this step can take a while.\n\n### Pre-calculate metrics\n\nThe application is pre-calculating and persisting some metrics for style and ingredients. To update these metrics, run:\n\n```\npython manage.py calculate_metrics\npython manage.py calculate_hop_pairings\n```\n\nSecurity\n--------\nFor information about the security policy and know security issues, see [SECURITY.md](SECURITY.md). \n\nLicense\n-------\nThis software is available under the [GPLv3](LICENSE) license.\n\nContributing\n------------\nYou're welcome to contribute new features, such as new analysis/chart types or bug fixes, by creating a Pull Request.\n\nPlease see [CONTRIBUTING.md](CONTRIBUTING.md) for more details.\n\nAcknowledgments\n---------------\n\nThank you [@kasperg3](https://github.com/kasperg3) for sharing data from his awesome [hops database](https://github.com/kasperg3/HopDatabase).\n\nSupport Me\n----------\nI love to hear from people using my work, it's giving me the motivation to keep working on it.\n\nIf you want to let me know you're finding it useful, please consider giving it a star ⭐ on GitHub.\n\nIf you love my work and want to say thank you, you can help me out for a beer 🍻️\n[via PayPal](https://paypal.me/ChristianScheb).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscheb%2Fbeer-analytics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscheb%2Fbeer-analytics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscheb%2Fbeer-analytics/lists"}