Winemaking API

Winemaking and oenology maths as an API, computed locally and deterministically — the must-correction, sulfite and acid numbers a home or small-batch winemaker dials in. The sugar endpoint reads the must as Brix or specific gravity, gives the potential alcohol (potential ABV = (SG − 1) × 131.25), and works out the chaptalization sugar to reach a target ABV — sugar (g) = volume(L) × Δ potential-ABV × 16.83, since roughly 17 g/L of sugar ferments to about 1 % alcohol. The so2 endpoint handles sulfite protection: it converts between free and molecular SO2 at the wine's pH (molecular SO2 = free / (1 + 10^(pH − 1.81)), aiming for the protective 0.8 mg/L molecular), shows how the free SO2 needed plummets as pH drops, and doses the potassium metabisulfite (57.6 % SO2) and campden tablets (~0.44 g each) to hit a target free SO2 in a given volume. The acid endpoint moves titratable acidity to a target with tartaric acid to raise it (grams = ΔTA × volume) or potassium bicarbonate to lower it. Everything is computed locally and deterministically, so it is instant and private. Ideal for winemaking, cidery, mead, home-fermentation and craft-beverage app developers, must-calculator and cellar tools, and oenology education. Pure local computation — no key, no third-party service, instant. Metric: litres, grams, g/L, mg/L. Live, nothing stored. 3 compute endpoints. A planning aid — your lab numbers and palate always win. For beer ABV from gravity use a homebrewing API.