-
v.0.5.0-alpha Pre-release
released this
2026-01-06 23:33:11 +01:00 | 522 commits to main since this releaseIt compiles!
With the syntax becoming stable, the focus is shifting towards the Compiler.
The goal: instead of just parsing text, use the data to provide concrete help to the user. This update introduces logic to analyze ingredients and steps, enabling features like nutritional estimation, automatic mass conversions, and smart timings.Welcome to Codeberg! 🇪🇺
First and foremost, GRAM has moved to Codeberg.
This migration aligns with the values of open-source, ethical hosting, and community-driven development that drive this project. Born in France, Gram naturally supports Codeberg as a European platform dedicated to keeping software open and independent. We believe it is the perfect home for this project.
Release highlights
Mass Unification
To help with calculations, the system now tries to convert ingredient quantities into grams (hence this project's name 😅)
- Converts volumes (
cups,ml...) togramsusing average densities. - Distinguishes between Net Mass (what you eat) and Purchasing Mass (what you buy), accounting for waste (e.g., banana peels, egg shells — because we assume you don't eat those).
- You can specify custom densities in the recipe Frontmatter if the defaults are not accurate enough.
- New ingredients database: A basic internal database (Proof of Concept, generated by LLM for testing purposes) is used to help with these calculations. Note that data accuracy is not guaranteed yet.
Nutritional Calculation
The compiler can now estimate the nutritional value of a recipe (uses the new ingredients database).
- Estimates Calories, Protein, Carbs, Sugar, Fat, Fiber, and Salt.
- Define
portions: 4in your metadata to get per-serving metrics.
Time Estimation
The Playground now calculates and displays three distinct time metrics:
- Active Time: The actual work time (stirring, chopping, trying not to burn anything).
- Total Time: From start to finish, accounting for parallel background tasks.
- Prep Time (Est.): An automated estimation of the "Mise en place" based on the number of ingredients and their preparations.
There's more
Playground
- The preview mode has been updated with new icons and a cleaner design.
- New panel now shows the nutritional breakdown with an "Estimate" confidence badge (when available)
- New control to show/hide the calculated masses alongside the original text quantities.
Documentation Overhaul
The documentation has been completely restructured to make it easier to navigate:
- Separated into Syntax, Compiler Features, and Technical internal docs.
- Added diagrams to explain specific logic (like mass conversion).
- Updated with recent syntax and features additions.
Fixes
- Comments and notes in playground (Markdown and preview) are now visually distinct and no longer mess up the step numbering sequence.
- Fixed an issue where calculating percentages inside an alternative group (
@A{}|@B{10% @A}) would fail. - The parser is now more robust and correctly handles the "Torture Test" without breaking a sweat.
- Improved detection of ingredient modifiers and inline preparation notes.
See you in the next release ! 🤙
Downloads
-
Source code (ZIP)
0 downloads
-
Source code (TAR.GZ)
0 downloads
- Converts volumes (