Loading repository data…
Loading repository data…
adamivar / repository
Explore chemical reactions and element properties with this Python Pygame app. Spawn elements using the periodic table and observe interactions based on chemistry principles. Adjust temperature to change state and see molar volume via dot size. Ideal for learning fundamental reactions.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
A Python/Pygame chemistry simulator that lets you spawn elements from the periodic table and watch them react with each other in real time.
Download (Windows .exe): MolEcule.zip
Visual conventions:
| Visual | Meaning |
|---|---|
| Dot size | Molar volume |
| Dot text | Chemical formula |
| Clear dot with solid ring | Gas |
| Solid colored dot with ring | Liquid |
| Solid colored dot, no ring | Solid |
| Element color | CPK standard |
| Compound color | Color at STP |
Requirements: Python 3.8+
git clone https://github.com/adamivar/MolEcule-Chemistry-Simulator.git
cd MolEcule-Chemistry-Simulator
pip install -r requirements.txt
python main.py
| Action | Control |
|---|---|
| Spawn a mol of the current element | Left-click |
| Add more to a dot | Hold left-click |
| Switch to the next element | Right-click (cycles by atomic number) |
| Change temperature | Drag the slider (top-left corner) |
Temperature is displayed in K, °C, and °F. Setting it to absolute zero (0 K) effectively pauses all reactions.
MolEcule is designed as a fun educational toy for anyone curious about chemistry. It lets you explore basic reactions, see at what temperatures they occur, and observe how molar volume and states of matter behave — all interactively.
Created by Adam Dobbins.