A Python-powered logical system and GUI application designed to solve stoichiometric equations, by breaking down each step as you would write them on a piece of paper. Thus building the needed knowledge — all for free. Stoichify is open-source and aimed at chemistry students and teachers to learn and better their experience with the daunting complexity of stoichiometry.
The initial release of Stoichify, being a Computer Science II project, being a command-line interface (CLI) application only solving mole-mole equations.
Done for a college project at Ivy Tech, where Stoichify is now a GUI application, designed for beginner chemistry students/teachers to understand the calculations, written out like someone would on a piece of paper. Using Tkinter and other libraries to compile an easily navigable GUI for all.
📖 Parse Substances, Equations, Special Characters, Concatenation, and other string inclusions
🔎 Find Elements, Subscripts, and Multipliers
✅ Check for Element's Validity
📐 Find Significant Figures
🤝 Accept Scientific Notation(s) (4.2e2, 4.2 x 10^27, 4.2 * 10^27, 1.2e-2, etc.)
⚖️ Balance Chemical Equations
🔄️ Convert From Measurement Units (moles, Liters, grams, and representative particles)
📝 Show All Work Performed
🪜 Multi-stepped and Multi-pathed GUI
https://youtu.be/Ou4IJQcHsRI?si=cYPVNoGFn5B_fS28
- Download ZIP (and unzip)
- Navigate to the highest sub folder (Stoichify-Main/Stoichify-Main (if unzipped and not altered))
- Open in Preferred Editor
- Download Python
3.12(https://www.microsoft.com/store/productId/9NCVDN91XZQP?ocid=pdpshare) - If you're using Visual Studio Code (VSC) install the Python Extension (https://marketplace.visualstudio.com/items?itemName=ms-python.python)
- Run the following commands (install needed libraries):
pip install sv-ttk# Tkinter Theme (Sun Valley)pip install pillow# Python Imagespip install sympy# Symbolic Mathematicspip install chemlib# Chemistry Library
- Close and Reopen your editor to refresh variables and to get rid of any "module could not be resolved from source"
- If you still have this error, try appending
-vto the end of a command to see if it's installed.
- If you still have this error, try appending
- Navigate to
main.py - Click 'Run' or execute command
python main.pyin your terminal in the root location. - Wait for the window to open, and enjoy the power of Stoichify.
Here! Download the complied zip, unzip it, find the .exe, and run!
- Dawn Paxson Sowders, Ph.D. — Quality Assurance
- Chemlib Creators — Molar Masses Provider
- Mohammad-Ali Bandzar — Balancing Algorithm
- Evgeny — Significant Figures Rounding (basis)
- Benedek Dévényi (rdbende) et al. — Tkinter Theme (sv_ttk)
- Jeffrey A. Clark et al. — Pillow (PIL) Image Library
- SymPy Development Team — Symbolic Mathematics
Due to the nature of this project, and how capable it'll be, this project will be protected by the GNU Affero General Public License Version 3 (AGPL-3.0). Intended to yield further projects to be open source for the public. Entities are free to change and upload Stoichify else-where — as long as it's instilled via AGPL-3.0.
