handcalcs is a Python library that converts calculations written in code into rendered LaTeX that mimics hand-written mathematical work.
The library solves the problem of making numerical calculations transparent and verifiable by rendering Python code as formatted mathematical expressions. It displays the symbolic formula, followed by the numeric substitution of values, and then the final result, mirroring how an engineer or scientist would write calculations by hand on paper. This approach makes calculations significantly easier to check and verify because all intermediate substitutions are visible.
The tool is designed for engineers and scientists working in Jupyter Notebook or Jupyter Lab who need to document calculations in a clear, auditable format. It works as either a cell magic for quick rendering or as a decorator on functions for more structured use. The library supports PDF printing directly from Jupyter, making it suitable for generating formal calculation reports. Users can also chain multiple notebooks together so that results from one calculation become inputs for the next, enabling the creation of larger engineering automation workflows.
Almost all open issues are raised by outside users rather than the core team, indicating a substantial base of adopters reporting real-world use. A first response to issues or pull requests typically takes one to two weeks. Work in the issue tracker is dominated by enhancement requests.
