Install the Wheel
Save the wheel in your project folder and open PowerShell (Windows) or a terminal (Linux) in that folder. Choose one of the two methods below. Both install the wheel and its Python dependencies.
The examples use a Light wheel for CPython 3.12. Substitute your wheel’s full
filename and Python version. For a Development wheel, change
from chemapplight import basic to from chemapp import basic in the final
command. It prints the path of the loaded ChemApp module (.pyd on Windows
or .so on Linux).
With uv in a virtual environment
Install uv for your operating system using the
uv installation instructions.
The first command creates a virtual environment named .venv in your
project folder. uv can download the matching Python version if needed.
The remaining commands use that environment directly without activating it.
Windows (PowerShell)
uv venv --python 3.12
uv pip install --python .venv .\chemapplight-837.0.0-cp312-cp312-win_amd64.whl
.\.venv\Scripts\python.exe -c "from chemapplight import basic; print(basic.__file__)"
Linux
uv venv --python 3.12
uv pip install --python .venv ./chemapplight-837.0.0-cp312-cp312-manylinux_2_34_x86_64.whl
.venv/bin/python -c "from chemapplight import basic; print(basic.__file__)"
Use that same Python executable to run your scripts or select it as the interpreter in your editor.
With pip in an existing Python installation
Use this method if you manage your own Python installation and want ChemApp available to other scripts that use it. Choose a 64-bit CPython interpreter that matches your wheel and has pip installed. On Windows you can obtain Python from the Python downloads page.
Run pip through that interpreter. The --user option installs the packages
for your account. These examples use the CPython 3.12 Light wheels.
Windows (PowerShell)
py -3.12 -m pip install --user .\chemapplight-837.0.0-cp312-cp312-win_amd64.whl
py -3.12 -c "from chemapplight import basic; print(basic.__file__)"
Linux
python3.12 -m pip install --user ./chemapplight-837.0.0-cp312-cp312-manylinux_2_34_x86_64.whl
python3.12 -c "from chemapplight import basic; print(basic.__file__)"
If pip reports externally-managed-environment, your Linux distribution
manages that Python installation. Use the uv method or choose a separate
Python installation that you manage.