ChemEq is a simple chemical equations balancer written in Python.

This program constructs a matrix based on the number of atoms of each element in each substance. Coefficients are then found by calculating the null space of the matrix.

Any contributions to this project are greatly appreciated.

If run from source code:

• Python 3.10-3.11
• NumPy and SciPy Python packages

The above packages are not required for binaries found on the Releases page.

• Run from source code:

1. Enter cd src/chem_eq/ into the command line.
2. Enter python __init__.py into the command line.
3. Input an unbalanced equation, e.g. CH4 + O2 = CO2 + H2O

• Pre-packaged releases are also available on the Releases page
• You can import the package named chem_eq into your project, should you wish to utilize the balance() function.

• Reactants and products are separated by an equal sign (=)
• Each substance in the reactants or the products is separated by a plus sign (+)
• Atoms are grouped using round (()) or square ([]) brackets. Curly brackets ({}) must only be used to specify charges.

E.g.

Fe{2+} + Cl2 = Fe{3+} + Cl{-}

(Cr[CO(NH2)2]6)4[Cr(CN)6]3 + KMnO4 + HNO3 = K2Cr2O7 + CO2 + KNO3 + Mn(NO3)3 + H2O

Distributed under the MIT license. Please see LICENSE for further information.

• My GitHub: https://github.com/nxhduong