Soap Calc

The first Python-based soap formulation library.

Define recipes in JSON, calculate lye and water amounts, predict soap properties, and export printable instructions—all from the command line or through AI agents like Claude Code.

• Tutorials --- New to Soap Calc? Start here to build your first recipe.

  Your First Recipe

• How-to Guides --- Practical step-by-step guides for specific tasks.

  • Formulation Techniques
  • CLI Usage
  • Inventory Management

• Explanation --- Understand the chemistry and math behind the calculator.

  • The Math of Saponification
  • Soap Properties

• Reference --- Technical API reference for the Python package.

  • API Reference

• Skills --- Supercharge your workflow with AI agents.

  • Overview
  • Inventory Management
  • Formulation Assistant

Key Features

• Multi-Lye Support: NaOH (Bar), KOH (Liquid), and Dual-Lye (Hybrid).
• Transparent Math: No hidden formulas. Every calculation is open source.
• Ingredient Database: Customizable JSON-based oil library.
• Property Analysis: Predict hardness, cleansing, conditioning, and more based on fatty acid profiles.
• Markdown Export: Generate beautiful, printable recipe sheets.

Installation

pip install soap-calc

Quick Example

from soap_calc import SoapCalculator

# Load your recipe
calculator = SoapCalculator("my_recipe.json")
# Calculate
result = calculator.calculate()
# Print results
print(result)